能力管理器 easun-zhu/dsh-cap-manager

dsh-cap-manager

在 DeepSeek Harness Web UI 中一个面板统一管理 MCP 服务、技能与 Claude Code 插件。

一款 DeepSeek Harness（dsh）插件：在 Web UI 侧边栏增加 MCP 与技能 面板：

- 🔌 MCP 服务 —— 按全局 / Profile / 项目三作用域分组的卡片，实时显示连接状态与工具数。新增、编辑、开关、删除即时生效；支持从 Claude / Cursor / Cline / Roo / VS Code 导入 mcpServers JSON，也支持导出。
- 🧠 技能 —— 项目与用户全部可写技能根汇成一份可搜索列表。就地编辑、导入 .zip 压缩包或 URL、一键导出、回收站恢复、.cap-bak 备份历史。
- 🧩 Claude Code 插件 —— 在 dsh 里浏览 Anthropic 官方 claude-plugins-official 市场（315+ 个插件）：安装、更新、卸载、开关。插件技能经原生 skill provider 实时供给；manifest 里的 mcpServers 挂载为实时 MCP 连接。

完整设计与兼容性说明见 DESIGN.md。当前版本：v1.2.0 （MCP 页新增只读的 Claude Code 插件服务分组）。

🖼️ 截图

面板以 MCP 与技能 出现在侧边栏。下图是 MCP 页 —— 项目 / 全局 / Profile 三个作用域分组，每张卡片带实时状态、工具数与启停开关（已停用的行保留配置但不挂载）。

技能页 —— 项目 / 全局分组 + 只读插件提供分组插件页 —— 已安装卡片 + 官方市场（315+）

深色模式自动跟随宿主主题

📦 安装

前置：DeepSeek Harness ≥ 0.2.1-rc.2（全局安装 dsh，或全部通过 npx -y @deepseek-ai/dsh 运行）。

免编译 —— 从 npm 安装：

dsh plugin --profile web add dsh-cap-manager

若 pnpm 的发布冷却期拒绝解析刚发的版本，可显式固定版本：
dsh plugin --profile web add dsh-cap-manager@1.2.0。

或安装 Release tarball（效果相同，不依赖 npm）：

浏览器 Web UI
dsh plugin --profile web add https://github.com/easun-zhu/dsh-cap-manager/releases/download/v1.2.0/dsh-cap-manager-1.2.0.tgz
桌面客户端
dsh plugin --profile desktop add https://github.com/easun-zhu/dsh-cap-manager/releases/download/v1.2.0/dsh-cap-manager-1.2.0.tgz

web / desktop 换成你自己的 profile 名即可；重启 dsh，然后在左侧边栏打开 MCP 与技能。（github: git 简写等于从源码装 —— 仓库不含编译产物 lib/，优先用 npm 或 tarball。）

从本地目录安装：

pnpm install && pnpm build # 产出 lib/index.js + lib/client.js
dsh plugin --profile web add /absolute/path/to/dsh-cap-manager
dsh --profile web # 重启以加载插件

可选：通过插件市场安装

把下面这个已托管的索引 URL 添加到 dsh 的发现页（或 plugin-market 的 indexes 配置），即可一键安装：

https://easun-zhu.github.io/dsh-cap-manager/market/index.json

索引声明了 engines.dsh >= 0.2.1-rc.2，安装源为 npm。自托管：把 market/index.json 复制到任意 http(s) 位置即可。可随时用上游校验器验证：

node --experimental-strip-types test/m5-smoke.ts # 含 market/index.json 校验

🔌 MCP 服务

每个项目可携带 .dsh/mcp.yml（手改或面板管理）：

mcpServers:
projmini:
enabled: true # false = 保留配置，不挂载 transport: stdio command: node
args: [./scripts/mcp.mjs]
env:
TOKEN: !!js process.env.MY_TOKEN # 挂载期求值

- 文件是唯一事实源：项目存在活动会话（或被面板项目选择器选中）时，其 enabled 的服务被挂载；外部修改即时生效（watcher + 差异挂载）。
- serverName 跨所有层唯一 —— 冲突在挂载前即被拒绝。
- URL 导入（⇩）：按 URL 直接抓取 mcpServers JSON 文档或技能 .zip。抓取由浏览器执行，目标需发送 CORS 头（GitHub raw 与多数静态托管都支持）；载荷随后进入与粘贴文本 / 本地文件完全相同的预览 / 解包管线。
- 新增表单内置模板下拉（filesystem、memory、sequential-thinking、fetch、github、 puppeteer），一键填充起步配置。

🔁 导入与导出

- 导入（MCP 页 → ⇩）：粘贴、选文件或 URL 抓取 mcpServers JSON —— 容忍 VS Code 的 JSONC 方言（注释、尾逗号），sse 条目映射为 streamable-http 并警告，非法键自动 slug 化并标记。${VAR} / ${env:VAR} 引用转为 !!js process.env.VAR 表达式（嵌入时为反引号模板）；VS Code 的 ${input:…} 占位渲染凭据表单，应用时替换。
预览列出每条转换、改名与失败；应用复用常规写入路径（共享校验、HMR 实时生效）。
- 导出（MCP 页 → ⇧）：全部受管行 + 选中项目文件合并为标准 {"mcpServers": …} 文档；!!js 表达式还原为 ${VAR}。已停用行跳过（标准格式无停用位）。密钥以明文导出 —— UI 明示。
- 技能导入（技能页 → ⇩）：.zip（允许多一层包装目录 —— 按 SKILL.md 位置识别技能根）、文件夹、散 .md 或 zip URL；上限 10 MB / 200 文件，拒绝 zip-slip 路径，丢弃 macOS 垃圾文件。文件逐字节原样落盘；同名默认跳过，勾选覆盖才替换。
- 技能导出（卡片上的 ⇧）：目录技能下载为 .zip（含资源），文件技能为 .md。
- 回收站与备份（♻）：已删技能列出原路径并可一键恢复；受管文件旁的每份 .cap-bak-（patch、项目 mcp.yml、SKILL.md —— 每文件保留 5 份）可恢复到目标或删除。

🧠 技能

技能页扫描四个可写根（<project>/.dsh/skills、<project>/.agents/skills、 ~/.dsh/skills、~/.agents/skills），按 provider 自身规则处理，同名冲突按 rank 顺序裁决（项目胜过用户）；被遮蔽条目与无法解析的文件以角标显式呈现而不是消失。
编辑原子写 SKILL.md（保留未知 frontmatter 键与注释，开关统一为 true/false）；删除把目录移入 ~/.dsh/cap-manager/trash/（trash-meta.json 记录来源），同名遮蔽浮出时给出警告。

🧩 Claude Code 插件

面板第三个 tab 管理来自 Anthropic 官方 claude-plugins-official 市场的 Claude Code 插件 —— 唯一内置源。

| 市场 | 315+ 个插件，宿主 10 分钟缓存，刷新按钮强制重拉，支持搜索 |
| 安装 | 下载 pin 住的 GitHub tarball（codeload），严格 tar 解包器落盘（逃逸路径拒绝、符号链接跳过），存入 ~/.dsh/cap-manager/plugins/store/<名称>/<版本>/ |
| 技能 | 插件的 skills//SKILL.md 经 ctx.skills provider 实时供给 —— 启用即出现在技能页的只读插件组（rank 排在你自己的技能之后，同名时用户技能优先） |
| MCP 服务 | manifest 声明的 mcpServers 挂载为实时连接 —— 与项目级服务同一套转换与 diff/挂载纪律，含跨层 serverName 预检；同时出现在 MCP 服务页的只读「Claude Code 插件」分组（实时状态、工具数、来源插件），随插件开关启停 |
| 开关 | 技能 + MCP 一起即时启停 |
| 精确更新 | 点「刷新市场」顺带取 marketplace 仓库的 HEAD commit sha，每个已装插件（外部 git 源比对条目 sha，仓库内源比对 HEAD sha）都得到精确的"有更新"判定；sha-pin 源显示更新角标。点「更新」先下载并逐字节内容比对：相同只采纳新 pin 不重装，不同才重装 |
| 卸载 | 卸挂载、删 store 目录、清登记（registry.json 原子写 + .cap-bak 历史） |
| 超时 | 所有网络调用限时（索引 20 s / tarball 120 s）；刷新失败自动回退缓存 |

dsh 没有对应机制的内容（commands/、agents/、hooks/）保留在磁盘，并在已安装
卡片上如实标注"未接入"。

🛠️ 开发

- pnpm typecheck —— 对 src/ 跑 tsc
- pnpm build —— 宿主半（esbuild ESM，包全部 external）+ 浏览器半（esbuild CJS， window.__ModuleLoader__.load 注册契约，构建期断言）
- 冒烟测试：node --experimental-strip-types test/m4-smoke.ts（转换器）、 test/m5-smoke.ts（模板 + 市场索引）、test/m6-smoke.ts（tar 解包、子树下载、 manifest 转换）
- harness 各包是 peerDependencies；运行期 profile 链接到正在运行的 dsh 的副本，绝不打包。

从源码检出运行

deepseek-harness 源码检出必须先完成一次 pnpm run build:artifacts 才能服务 Web 客户端：启动会扫描所有声明 dsh.client 的包，缺 lib/client.js 即失败。只构建过服务端产出的检出会在启动时报 ENOENT .../lib/client.js。

⚠️ 绝不要把 --from-default-profile 指向已存在的 profile：它会重置该 profile 的 package.json、patch 和 node_modules —— 清空已装插件。启动一律用 --profile；--from-default-profile 只作一次性初始化。

📁 目录结构

| 路径 | 职责 |
| src/index.ts | 宿主半入口（挂载 CapabilityManagerService） |
| src/service.ts | capabilityManager Typert Remote 服务（patch + 项目 + 技能路由） |
| src/scopes.ts | 适配层：profile patch 组合 + 作用域归属 |
| src/config-view.ts | 原始行配置 ↔ 脱敏视图，!!js 标签化（共用） |
| src/patch-writer.ts | 保注释编辑 cordis.patch.yml 各层 |
| src/project-config.ts | <project>/.dsh/mcp.yml 解析（含 !!js 求值）+ 写入 |
| src/project-mounter.ts | 会话跟随 + watcher + 差异挂载项目服务 |
| src/skills-store.ts | 技能根扫描、frontmatter 读写、回收站（+元数据）、压缩包导入/打包 |
| src/import-mcp.ts | mcpServers JSON → wire 配置转换 + 导出反演 |
| src/cc-market.ts | claude-plugins-official 目录缓存 + 安全 tar.gz 解包器 |
| src/cc-store.ts | 插件 registry、技能 provider（rank 550）、MCP 挂载 |
| src/status-tracker.ts | 适配层：fiber 状态（数字 FiberState）+ mcp__ 工具计数 |
| src/client/index.ts | 浏览器半入口（locale + remote $mount + slots） |
| src/client/CapabilitiesPage.tsx | 面板（卡片、tab、搜索、项目选择器） |
| src/client/McpEditor.tsx | MCP 表单编辑器（模板 + 目录预填） |
| src/client/SkillEditor.tsx | 技能表单 + Markdown 正文编辑器 |
| src/client/ImportWizard.tsx | mcpServers JSON 导入向导（粘贴/文件/URL） |
| src/client/SkillImport.tsx | zip/文件夹/.md/URL 技能导入 |
| src/client/catalog.ts | 模板下拉起步数据 |
| src/client/CcPluginsPanel.tsx | Claude Code 插件市场 + 已安装卡片 |
| src/client/TrashPanel.tsx | 回收站恢复 + .cap-bak 备份浏览 |
| src/client/files.ts | base64/zip 编解码（fflate）、下载、URL 抓取 |
| market/index.json | plugin-market format-1 索引（发现页用） |
| test/ | node 冒烟检查（m4 转换器、m5 模板 + 市场索引、m6 tar/manifest） |

📤 发布（维护者）

1. 把 package.json（repository、homepage）与 market/index.json（homepage、 repository.url）中的 OWNER 占位替换为真实 GitHub 用户名；补上 LICENSE 文件（包声明 MIT）。
2. pnpm typecheck && pnpm build && node --experimental-strip-types test/m4-smoke.ts &&
node --experimental-strip-types test/m5-smoke.ts —— 全部通过。
3. npm publish（包内容为 lib/ + cordis.patch.yml；harness 各包保持 peerDependencies）。
4. 给仓库加上 dsh-plugin GitHub topic（社区发现惯例， awesome-deepseek-harness 按此收录）。
5. 托管 market/index.json（GitHub Pages 或 raw URL）并分享该 URL；每次发版更新 publishTimestamp / 增加版本条目。

📄 许可

MIT · 完整设计文档：DESIGN.md。