YpipaQ/dsh-s-m-c-center

🌏 中文 · English

三合一工具台 · dsh-s-m-c-center

把智能体的「技能 / MCP / CLI」三类工具收进 DeepSeek Harness 的同一张设置页，并让每个对话按需注入自己的技能。

技能联接 · 会话注入 · 影子目录 · MCP 真实连接 · CLI 探针 · 中英双语 · 零源码侵入

它是什么 · 界面一览 · 功能亮点 · 两条通道 · Agent 工具 · 架构 · 安装 · 配置 · 权限声明 · 开发 · 许可

「设置 → Web UI 插件 → 工具管理」：统一储存库、技能联接与「会话默认」，三个页签分管三类工具。

[!NOTE]
0.1.2 起技能目录由本插件接管（影子目录）：目录成员严格跟随会话的注入选择；目录变化只发一条替换帧，不再每步追加；容器目录（只有 DESCRIPTION.md）可注入、可加载。已经过三轮外部实测（16/16 通过）。

✨ 它是什么

中文别名：三合一工具台 ｜ 别名：工具管理、工具中心、技能管理、MCP 服务器管理、CLI 工具管理、Skills / MCP / CLI 管理器

一个自包含的 DSH Web 插件：在设置页新增一个一级页面，统一管理 agent 的三类工具（技能 / MCP 服务器 / 本地 CLI），并新增一层按对话生效的技能注入；另有一个使用说明页，讲清三者各自的工作方式，并在最下方负责把它们干净地还回去。

| 能力 | 原生 dsh web | 装上本插件后 |
|---|---|---|
| 技能浏览 / 启停 | 到技能目录手动增删 | 设置页一键联接 / 断开，正本统一入库，SKILL.md 一字不改 |
| 会话级技能组合 | — | 会话默认 + 侧边栏小窗 + skill_select，每个对话只存与默认的差异 |
| 技能目录（AI 视角） | 静态目录扫描 | 影子目录：严格跟随会话选区，附 smc-skill-index 索引行 |
| MCP 服务器 | 手编 mcp.json | 表单 / JSON 新建 + 一次性测试连接 + 激活 / 归档开关 |
| 本地 CLI | — | 自动发现 skill 内嵌 CLI，登记系统 CLI，探测安装 / 版本 / 子命令 / API-Key |
| 侵入性 | — | 零源码改动：一个 npm 包 + 一行 profile bundle patch |

| 页签 | 管理 | 底层 |
|---|---|---|
| Skills 技能 | 浏览 / 启用 / 不启用 / 删除 / 导入技能；「会话默认」决定新对话起始注入哪些技能 | 用户级走 ~/.dsh/S-M-C/skills 正本 + 目录联接；项目级改写 SKILL.md 前言 |
| MCP 服务 | 新建 / 编辑 / 测试 / 激活 / 归档 / 删除 MCP 服务器 | 真实 @deepseek-ai/dsh-mcp-client 连接（mcp____）；归档移入 S-M-C/mcp-archive.json |
| CLI 工具 | 发现 / 探测本地 CLI 工具；登记系统 CLI | skill 内嵌 scripts/run-cli + S-M-C/cli.json |
| 使用说明 | 三类工具各自的工作方式，以及卸载前的准备 | 说明集中在此页；卸载准备在最下方 |

完整说明见 docs/功能介绍.md、docs/架构.md。

📷 界面一览

| | |
|---|---|
| 会话技能小窗 ｜ 侧边栏随手调整本对话的注入 | MCP 服务 ｜ 真实连接，激活 / 归档一键切换 |
|  |  |
| CLI 工具 ｜ 发现 / 探测 / 登记本地 CLI | 使用说明 ｜ 三类工具讲解 + 卸载撤退口 |
|  |  |

截图中的技能名、描述与 MCP 服务器信息已打码。

💡 功能亮点

- 技能：按项目级 / 用户级与来源分组（.dsh/skills、.agents/skills、~/.dsh/skills、~/.agents/skills）。用户级技能迁入统一储存库 ~/.dsh/S-M-C/skills，「启用」= 在技能根目录注入目录联接，「不启用」= 移除联接（SKILL.md 一字不改）；项目级技能就地管理，仍用前言开关。删除为两步确认的物理删除，且只删储存库里的正本（见下）。点开可看详情（description / whenToUse / 正文）；支持从任意目录扫描导入。
- 会话默认与按对话注入：会话默认 是新对话的起始技能；每个对话还能有自己的差异（关掉某个、追加某个）。对话里的 agent 可以自己开关（写入该对话自己的配置），侧边栏还有一个「会话技能」小窗供你随时手动调整——两处列表都只列已联接的技能。详见下一节。
- MCP：分「管理 / 新建」两个子页——管理页一台服务器一个 激活 / 归档 开关（外加删除），新建页提供表单或 JSON 编辑，保存前可测试连接（一次性真实探测）；激活 / 归档真实连接 / 断开并注册 mcp____ 工具；实时状态（连接中 / 运行中 / 失败 / 已停止）。
- CLI：自动发现 skill 包装的 CLI（scripts/run-cli. / cli-state.），并登记系统 CLI（gh、git …，存于 S-M-C/cli.json）。每条都会探测：是否安装 / 版本 / 是否需更新 / API-Key 状态 / 子命令，并在行上标出来源与位置。公告 / 隐藏开关只决定是否把这个 CLI 写进给 AI 的公告（插件无法启停系统装的 CLI，因此默认隐藏）。
- 使用说明：按三类讲清工作方式，最下方是卸载前的总撤退口。「撤销迁移」把储存库技能移回原始位置；储存库空着时同一按钮变为绿色的「迁移」，双向可逆；「MCP 全部注入」把归档服务器一次性移回并重连；页面同时列出卸载后需手动删除的目录与配置块。
- 界面：全量文案 zh / en 双语（各 202 键，英文环境零中文）；破坏性操作两步确认，且点开别处即复位。

🧠 两条通道：联接 vs 注入

| | 启用（联接） | 注入（会话选择） |
|---|---|---|
| 载体 | ~/.dsh/skills/ 目录联接 | 会话技能表 ~/.dsh/S-M-C/contexts.json 里每个对话一行 |
| 作用范围 | 全局：所有对话、所有工作区、含子智能体 | 仅本对话 |
| 谁维护 | 技能页的「启用 / 不启用」 | 「会话默认」开关、小窗、以及模型自己的 skill_select |
| 谁看得见 | dsh 原生文件系统扫描 | 本插件的会话注入 |

会话选择的存储方式：文件里存的是与默认的差异（overrides: { on, off }），有效集合 = 默认 ∪ on \ off。这样改了默认，未单独配置过的对话立刻跟着变；而你在某个对话里手动关掉的技能不会被默认拉回来。

🤖 交给 agent 的两个工具

| 工具 | 作用 |
|---|---|
| skill_select | 为本对话启用 / 停用某个技能；写入该对话自己的差异并立即生效。接受所有已联接的条目——容器目录同样可以（其 DESCRIPTION.md 即可加载的正文）。 |
| skill_query | 只读查询本工作区可见的技能清单（名称 / 描述 / 分组 / 是否已联接 / 本对话是否已注入），调用时动态计算，可关键词与分组过滤。 |

技能目录也由本插件生成（影子目录）：目录里会多出一行 smc-skill-index —— 索引技能，加载它即可拿到本工作区的完整技能列表（格式与目录层一致）；未注入的技能不能加载（提示 "not enabled in this conversation"）；/技能名 手势不受影响。

此外，「使用说明」页可开启向 AI 公告：把插件能力与三类工具的现状写进每个 agent 的系统提示——

向 AI 公告：展开后声明插件能力；设置持久化在 dsh-s-m-c-center 命名空间，切换即时生效。

🧱 架构

挂载与双面结构 —— 插件只是一个 npm 包 + 一行 profile bundle patch，dsh 源码零改动：

Host 半区注册路由、公告 agent、真连 MCP；Client 半区只提供设置页，两者通过 /api/dsh-s-m-c-center/* 通信。

储存库布局 —— 插件的数据全部收在 ~/.dsh/S-M-C，而 dsh 扫描的两个目录刻意留在库外（插件只往里面注入 / 移除联接）：

技能的「正本」始终在储存库里；~/.dsh/skills 下那个条目只是指向正本的联接。

三个开关在磁盘上的真实动作 —— 不是改配置字段，是真的动文件 / 动连接：

技能 = 增删联接；MCP 激活 / 归档 = 定义在 mcp.json 与 mcp-archive.json 之间搬家；CLI = 只切可见性。

🚀 安装

环境要求：DeepSeek Harness >= 0.1.2-alpha.2（@deepseek-ai/ 统一发版）；Node ^22.19.0 || >=24。
现状：0.1.6-alpha.1、0.1.6-alpha.2 与 0.1.5-rc.2 上完整实测；0.1.2-alpha.2 起所用 API 已逐一核对存在且签名一致。

必须按普通包安装 —— 切勿 junction 链接。 junction 会让依赖（schemastery / react 等）无法向上解析，并导致包名与 cordis.patch.yml 不一致；两者都会让 DSH 启动失败。

从 npm 安装
dsh plugin --profile web add dsh-s-m-c-center
或：npm install dsh-s-m-c-center

从源码（本仓库 / 克隆后）
dsh plugin --profile web add

或安装打包产物
dsh plugin --profile web add /dsh-s-m-c-center-0.2.1.tgz

或使用一键脚本
bash scripts/install.sh                                        # macOS / Linux / Git Bash
powershell -ExecutionPolicy Bypass -File scripts/install.ps1   # Windows

首次安装后需要重启 DSH 并硬刷新浏览器（Cmd/Ctrl+Shift+R），然后进入「设置 → Web UI 插件 → 工具管理」。

升级：只改界面时，覆盖文件 + 硬刷新即可；改到 Host 侧（路由 / 引擎 / 工具）时需要重启一次 DSH 进程。

🔧 配置

插件配置完全自管，存放在储存库内的 ~/.dsh/S-M-C/settings.json —— 不写入 dsh 的 settings.yaml（dsh 0.1.7 起会在升级时把该文件归档为 settings.yaml.imported，里面的第三方配置块会全部丢失）：

{
"enabled": true,        // 总开关（路由、MCP 连接、CLI 探测）
"announceToAgent": true // 向每个 agent 的系统提示说明本插件
}

运行时状态：

- 插件设置：S-M-C/settings.json，随储存库走；从旧版本升级时首次启动会把 settings.yaml（或其归档）里的旧配置块一次性迁入。
- 统一外挂储存库：~/.dsh/S-M-C/（Skills / MCP / CLI）—— skills/（正本与 index.json 清单）、skills-links.json（联接账本）、skills-registry.json（登记的外部技能）、mcp.json、mcp-archive.json、cli.json。旧位置在首次启动时自动迁入；整个库可用 DSH_STORE_ROOT 挪到别处（插件会重建目录联接）。
- 会话选择：全机一张表 —— ~/.dsh/S-M-C/contexts.json，default 是会话默认，sessions. 是该对话与默认的差异（on / off）。不涉及工作区：键就是会话 id，所以设置页与小窗读的是同一份文档。旧版每个工作区一份文件，首次挂载（表不存在时）会一次性并入。
- MCP：激活的 S-M-C/mcp.json，归档的 S-M-C/mcp-archive.json（凭证 / headers 明文保存 —— 请保持这两个文件 0600）。
- CLI 注册表：S-M-C/cli.json。

🔒 权限与依赖声明

插件以 DSH 进程权限运行，会用到文件、网络、命令与凭据四类能力 —— 逐项说明用途与边界：

| 能力 | 做什么 | 范围与边界 |
|---|---|---|
| 文件 | 读写储存库 ~/.dsh/S-M-C/；在技能根目录创建 / 移除目录联接；读写会话技能表 ~/.dsh/S-M-C/contexts.json（以及旧布局的 /.dsh/S-M-C/contexts/.json，仅由导入读取一次）；读取 SKILL.md 与 skill 内嵌脚本 | 只动储存库与 dsh 扫描的四个技能根目录；就地技能只改写前言标记；不读写其它路径 |
| 网络 | 连接用户自己配置的 MCP 服务器（stdio 走子进程，streamable-http 走 HTTP） | 只连用户在管理页填写的服务器地址；插件自身无内置外部服务、无遥测、不上报任何数据 |
| 命令 | 探测本地 CLI 工具：执行其 --help / --version 或 cli-state 声明的探测命令 | 只执行注册表内、管理页可见的命令；不执行用户未登记的其它命令 |
| 凭据 | 保存 MCP 的 env / headers / API-Key，读取 CLI 的 cli-state | 只在本机 ~/.dsh/S-M-C/.json 明文读写、不外发；建议将这两个文件权限设为 0600 |

外部依赖：运行时依赖仅 schemastery（设置项校验）；@deepseek-ai/ 与 react 是 peer 依赖，由 DSH 提供；无原生模块，无 postinstall / prepare 等生命周期脚本。

失败边界：目录扫描或路由失败降级为空列表与占位提示；迁移失败只记入 failures 并继续，不阻塞 DSH 启动；MCP 连接失败只改变状态显示、不动文件；会话注入失败不会否决会话创建，只在日志里说明原因。任何一项都不会让 DSH 启动失败。

已知风险：技能删除是物理删除、不可恢复（且只删储存库正本：native 技能需先「迁移入库」，registered 用「取消登记」，「删除联接」只解联、从不删目标）；MCP 凭证明文保存；技能启用 / 禁用经目录联接生效，手动剪切储存库会让联接失效（需要时用 DSH_STORE_ROOT 搬迁，插件会自建联接）。

📦 展开查看仓库结构

dsh-s-m-c-center/
├── src/
│   ├── index.ts            # 宿主组合根（挂载、设置、公告、工具注册）
│   ├── routes.ts           # 路由汇总（按域拼装）
│   ├── setup.ts            # 身份常量 + 面向 agent 的说明文案
│   ├── shared/             # 跨域原语：paths / fs-utils / frontmatter / http / protocol
│   ├── features/           # 垂直切片，每域自持 manager + routes + index 桶
│   │   ├── skills/         #   技能：roots / scanner / linking / links / registry /
│   │   │                   #        adopt / delete / migration / store-index / catalog
│   │   ├── mcp/            #   MCP：document / manager / routes
│   │   ├── cli/            #   CLI：probe / registry / manager / routes
│   │   ├── context/        #   会话注入：engine / apply / tools / routes
│   │   ├── announce/       #   系统提示公告
│   │   └── settings/       #   插件设置命名空间
│   └── client/             # 浏览器半区
│       ├── shell/          #   设置卡片外壳、侧边栏「会话技能」小窗
│       ├── shared/         #   api / ui / locales(zh+en) / format / css module
│       └── features/       #   四个页签各自的面板 + hook
├── lib/                    # 构建产物（宿主 index.js；客户端 client.js；types/）
├── tests/                  # vitest（14 个文件）
├── 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 + compatibility）
├── LICENSE                 # MIT
├── README.md / README.zh.md
├── docs/
│   ├── 功能介绍.md / 架构.md / development.md
│   ├── arch-.svg          # 架构图（本文档引用）
│   ├── social-preview.png  # 仓库社交预览图
│   └── shots/              # 界面截图（本文档引用）
└── scripts/install.*       # 一键安装进 DSH profile

🧰 开发

见 docs/development.md：双半区构建（tsdown 重建 lib/index.js + lib/client.js）、类型检查（tsc --noEmit）与测试套件（vitest，14 个文件 / 206 个用例）。

📄 许可

MIT。

English: README.md.