` 工具（归档的定义移到 `S-M-C/mcp-archive.json`，不连接、不公告，但完整保留可随时移回）；实时状态（连接中 / 运行中 / 失败 / 已停止）。
- **CLI**：自动发现 skill 包装的 CLI（其 `scripts/run-cli.*` / `cli-state.*`，即 tencent-news 模式）；探测是否安装 / 版本 / 需更新 / API-Key 状态（解析 `cli-state` JSON）并列出子命令（解析 `help`）；`S-M-C/cli.json` 登记系统 CLI（`gh`、`git`、`tencent-news-cli` …），提供 **公告 / 隐藏** 开关（**默认隐藏**——它只决定是否把这个 CLI 写进给 AI 的公告，插件无法启停系统装的 CLI）与删除；每行标出来源与位置（`技能 CLI · <路径>` / `系统 CLI · <路径>`）。
- **卸载准备**：卸载插件前的总撤退口。「撤销迁移」（红）把储存库技能移回原始位置；储存库空着而 skills 目录还有技能时，同一按钮自动变为绿色的「迁移」，随时把技能再收进储存库——**双向可逆**；「MCP 全部注入」把归档服务器一次性移回 `mcp.json` 并重新连接；页面同时明确列出卸载后需手动删除的储存库目录与配置块。
- **界面**：全量文案 zh / en 双语（各 160 键，英文环境零中文）；「向 AI 公告」的长说明折叠进标题行，默认收起、点击展开；删除等破坏性操作为两步确认。
## 🧭 独立实现
**自 0.5.0 起，本项目的代码库已经彻底重构，现在是一个独立实现。** 早期 0.1.x 是一次基于既有同类实现的验证性改版；那条代码线如今已不复存在——两代代码在实现层面不再有共同之处，本项目与其他任何项目之间也不存在上游关系。
| 版本 | 重构内容 |
|---|---|
| **0.5.0** | 统一外挂储存库 `~/.dsh/S-M-C` 与目录联接语义：技能 / MCP / CLI 的「启用」全部变成真实的文件系统动作（注入 / 移除联接、定义文档搬家），不再改写用户文件 |
| **0.6.0** | 新增「卸载准备」页：技能迁移双向可逆、归档的 MCP 服务器一键注回、列出卸载前需手动清理的文件 |
| **0.6.2** | 重写全部基础设施层——MCP 文档读写与连接收敛、技能 frontmatter 解析、HTTP 客户端、路由守卫 |
- GitHub 上这是**独立仓库**（并非 fork，无 upstream 关联），git 历史为单一提交。
- `src/` 为独立编写；与早期代码仅剩少量不可避免的通用样板（例如 CSS Modules 的 `*.module.css` 通配类型声明）。
- 运行时只依赖 Node 标准库、dsh 官方 `@deepseek-ai/*` 包，以及通用工具库（`schemastery`）。
> 早期版本已从 npm 上标记废弃；本 README 描述的行为以 **0.6.x** 为准。
## 📷 界面预览
四个页签：技能（统一储存库 + 联接）、MCP（真实连接）、CLI（发现 / 探测 / 登记）、卸载准备（双向可逆的迁移与手动清理清单）。个人路径已打码。
## 🏗️ 架构
**挂载与双面结构** —— 插件只是一个 npm 包 + 一行 profile bundle patch，dsh 源码零改动：
Host 半区注册路由、公告 agent、真连 MCP；Client 半区只提供设置页，两者通过 /api/dsh-skills-mcp/* 通信。
**储存库布局** —— 插件的数据全部收在 `~/.dsh/S-M-C`，而 dsh 扫描的两个目录刻意留在库外（插件只往里面注入 / 移除联接）：
技能的「正本」始终在储存库里；~/.dsh/skills 下那个条目只是指向正本的联接。
**三个开关在磁盘上的真实动作** —— 不是改配置字段，是真的动文件 / 动连接：
技能 = 增删联接；MCP 激活 / 归档 = 定义在 mcp.json 与 mcp-archive.json 之间搬家；CLI = 只切可见性。
## 🚀 安装
> **环境要求**：DeepSeek Harness **`>= 0.1.2-alpha.2`**（`@deepseek-ai/*` 全部统一发版）。
> 现状：**`0.1.5-rc.2` 上完整实测**；`0.1.2-alpha.2` 起所用 API 已逐一核对存在且签名一致。
> **必须按普通包安装 —— 切勿 junction 链接。** junction 会让依赖（`schemastery` / `react` 等）无法向上解析，并导致包名与 `cordis.patch.yml` 不一致；两者都会让 DSH 启动失败。
> **npm 发布说明**：因作者个人原因，**0.6.3 在 npm 上的发布时间顺延至 9 月 17 日之后**。
> 目前 npm 上仍是旧版（`0.6.1`）；在此之前要用 0.6.3，请改用下方的源码或打包产物方式安装。
```sh
# 从 npm 安装：https://www.npmjs.com/package/dsh-skills-mcp-cli-manager
# 注：0.6.3 因作者个人原因将于 9/17 之后发布，此前 npm 上为旧版 0.6.1
dsh plugin --profile web add dsh-skills-mcp-cli-manager
# 或：npm install dsh-skills-mcp-cli-manager
# 从源码（本仓库 / 克隆后）
dsh plugin --profile web add <本文件夹绝对路径>
# 或安装打包产物
dsh plugin --profile web add /dsh-skills-mcp-cli-manager-.tgz
# 或使用一键脚本
bash scripts/install.sh # macOS / Linux / Git Bash
powershell -ExecutionPolicy Bypass -File scripts/install.ps1 # Windows
```
安装后**重启 DSH 并硬刷新浏览器**（Cmd/Ctrl+Shift+R），进入「设置 → Web UI 插件 → **工具管理**」即可。
> **更新无需重启**：装好之后，后续升级这个插件**理论上不需要重启 DSH** —— 覆盖文件后直接硬刷新浏览器即可。
> （只有改动涉及 Host 侧路由或后端逻辑时才需要重启一次 DSH 进程；纯界面上的改动刷新即生效。）
## ⚙️ 配置
```yaml
# 本插件自己的设置命名空间（dsh settings）
skills-mcp-manager:
enabled: true # 总开关（路由、MCP 连接、CLI 探测）
announceToAgent: true # 向每个 agent 的系统提示说明本插件
```
运行时状态：
- **统一外挂储存库**：本插件的数据全部收在 `~/.dsh/S-M-C/`（**S**kills / **M**CP / **C**LI）—— `skills/`、`mcp.json`、`mcp-archive.json`、`cli.json`。旧位置在首次启动时自动迁入；整个库可用 `DSH_STORE_ROOT` 挪到别处（插件会自动重建目录联接）。
- MCP：激活的 `S-M-C/mcp.json`，归档的 `S-M-C/mcp-archive.json`（凭证 / headers 明文保存 —— 请保持这两个文件 `0600`）。
- CLI 注册表：`S-M-C/cli.json`。
## 🗂️ 仓库结构
```
dsh-skills-mcp-cli-manager/
├── src/ # TypeScript 源码（宿主 + 客户端两半区）
│ ├── index.ts # 宿主入口（插件加载、设置命名空间、agent 公告）
│ ├── skills.ts # 技能文件系统引擎
│ ├── mcp.ts # MCP 配置存储 + 真连接管理器
│ ├── cli.ts # CLI 发现 / 探测 / 注册表 + cli-state 解析
│ ├── routes.ts # /api/dsh-skills-mcp 路由族
│ ├── protocol.ts # 共享类型 + API 路径
│ └── client/ # 浏览器半区（入口、SettingsCard、manager、api、locales、css）
├── lib/ # 构建产物（宿主：index.js；客户端：client.js；types/*）
├── cordis.patch.yml # DSH bundle patch（包名必须与 package.json 一致）
├── dsh.plugin.json # DSH 插件清单（id / version / main / client.main）
├── package.json # npm 包（dsh.bundle.patch + dsh.client）
├── LICENSE # MIT
├── README.md / README.zh.md
├── docs/
│ ├── 功能介绍.md # 完整功能说明
│ ├── development.md # 开发说明（构建、测试、储存库布局）
│ ├── arch-*.svg # 架构图（本文档引用）
│ ├── social-preview.png # 仓库社交预览图（在仓库设置里上传）
│ └── shots/ # 界面截图（本文档引用）
└── scripts/install.* # 一键安装进 DSH profile
```
## 🛠️ 开发
见 [`docs/development.md`](./docs/development.md)：双半区构建（`tsdown` 重建 `lib/index.js` + `lib/client.js`）、类型检查与测试套件。
## 📄 许可
[MIT](./LICENSE)。
---
*English: [`README.md`](./README.md).*
