dsh-skill-mcp-nexus
DSH 面板：在一个界面里统一管理 skill 与 MCP。
侧边栏管全局和工作区，输入栏管当前会话。每条都能改名、加备注、分组，悬停看详情。
它解决什么
DSH 的 skill 和 MCP 分散在几处：~/.dsh/skills 下的文件、profile 的 cordis.patch.yml、会话级配置。想关掉某个 skill 得手动改文件名，想临时在某个会话里屏蔽某个 MCP 又没地方点。
这个插件把两件事合到一处：
- 一处开关 —— skill 和 MCP 在同一个列表里，点一下就行
- 三层隔离 —— 全局改磁盘、工作区改本目录、会话临时屏蔽，互不干扰
安装
# 从 npm
dsh plugin --profile default add npm:dsh-skill-mcp-nexus
# 从 GitHub
dsh plugin --profile default add github:nyvaelefluffRuaRua/dsh-skill-mcp-nexus
# 从本地目录
dsh plugin --profile default add <本仓库路径>
没有全局 dsh 命令的话，用 npx @deepseek-ai/dsh 代替 dsh。
从本地目录装要多一步：那条路走的是 link:，pnpm 不会替你装被 link 包自己的 dependencies。进仓库根目录补一次 pnpm install，否则启动时报 ERR_MODULE_NOT_FOUND: Cannot find package 'zod'——报错长得像"包名写错了"，其实是依赖没装。从 npm / GitHub 装是 tarball，依赖由 pnpm 正常解析，不需要这一步。
装完重启 DSH。
要求 DSH >=0.2.0-rc.1 <0.3.0，Node >=22.15（读了 zlib.zstdDecompressSync，用来解析会话存档）。
低于这个版本装不上是有意的——本插件用了 ctx.typert 服务，老版本没有它，装了会静默失效。
首次启动会在 $DSH_HOME/skill-mcp-nexus/ 下自建 state.json 与 last-load.json，不用预先建目录。
如果 $DSH_HOME 下还留着旧版目录 skill-mcp-hub/，插件会把它整目录改名成新名（跨盘或文件被占用时不搬，读的时候回退旧路径）。
三层开关怎么理解
只有全局会真的动磁盘（把 SKILL.md 改名为 SKILL.md.disabled）。工作区和会话只能在全局的基础上做减法。
| 层 | 能做什么 | 存在哪 |
|---|---|---|
| 全局 | 真开真关（改文件名） | state.json 的 globalEnabled |
| 工作区 | 只能关，不能开 | <工作区>/.dsh/skills/ 放同名壳 |
| 会话 | 只能关，不能开 | sessionOverlays['ss:<会话id>'] |
为什么下层不能反向开：全局关掉的 skill，磁盘文件已经改名，宿主根本扫不到。此时在工作区点「开」没有对象可开——那只是假按钮。
所以全局关掉的条目，在下层显示为灰色不可点。 要开就去全局开。
开关的四种样子
| 样式 | 含义 |
|---|---|
| 蓝色、白点在右 | 开 |
| 灰色、白点在左 | 关 |
| 橙色、白点在中间 | 全局视图专用——这层关了，但别处还开着 |
| 灰色虚线、点不动 | 全局已关，本层无法操作 |
界面
侧边栏面板（sidebar.panellist）
[编辑层级] │ [列表 58%] │ [详情 42%]
全局 ● │ 名称 来源 开关 │ 标题
default │ ───────────────────── │ 完整描述
qq-bridge │ skill-a dsh ● │ 别名
aa │ skill-b dsh ○ │ 备注
│ │ 分组 / 路径
│ │ [测试] [删除] [保存]
左边每一行带自己的「全开/全关」聚合开关。点中间任意一条，右边显示它的详情——从哪来、干什么用、怎么改。
输入栏按钮（conversation.input.right）
一个 skill&mcp 胶囊，点开是本会话的开关浮层。有东西被关掉时显示 skill&mcp · N。这里的改动只影响当前会话。
其他功能
- 别名 / 备注 —— 长名字可以改成好认的，悬停 0.8 秒显示
- 分组 —— skill 可以归类，列表顶部切换
- 依赖提示 —— 关掉某个 MCP 后，正文里提到过它的 skill 会显示橙色
⚠ - 自建 MCP —— 表单填名称/命令/参数/环境变量，写进插件自己的受管块，你手写的行不动
- 连接测试 —— 对某个 MCP 跑一次
initialize+tools/list，看它到底活没活
关于「连接测试」
点测试会真的按配置里的 command 起一个子进程（或向配置的 url 发 HTTP 请求），做一次独立的 MCP 握手，8 秒超时不回就杀掉。
这是有意的：借用宿主已有的连接测不出问题——那条链路可能是坏的，分不清是服务器有问题还是宿主有问题。独立起一个才知道这份配置本身能不能用。
所以别对来路不明的 MCP 点测试。 测试执行的就是你写进配置的那条命令。
已知限制
disable-model-invocation: true 的 skill 开不了
有些 skill 在 SKILL.md 的 frontmatter 里写死了 disable-model-invocation: true，作者主动关掉了模型调用。改名法改不回来，界面上会显示为「已停用」并归到折叠区。要恢复只能直接改它的 SKILL.md。
全局关掉的 skill 在宿主里是真的不可见
不是视觉上隐藏——文件名改了，宿主扫描时根本不会读到它。
会话级关闭靠「读目录时过滤」，不是靠排名顶替
会话/工作区层的关闭走的是另一条路：插件读宿主的技能目录时，把被关闭的名字从结果里剔掉。所以模型看不到它，你显式 /名字 用也会报 unknown。
早先试过「注册一个 rank 更靠前的同名 provider 顶掉原条目」，2026-11-13 确认行不通：skill 工具执行时宿主传的 scope 是 AgentLoop（没有父链），provider 候选进得了合并流程却进不了工具拿到的最终结果。排名、挂全局层、挂 ctx.root 都试过，都不生效。
改 MCP 的配置需要完全退出 DSH
cordis.patch.yml 只在进程启动时读一次，重载插件不会重读。
配置文件
状态存在 ~/.dsh/skill-mcp-nexus/state.json：
{
"version": 1,
"skills": { "<名>": { "alias": "", "note": "", "group": "", "globalEnabled": true } },
"groups": [],
"mcp": { "<serverName>": { "alias": "", "note": "", "globalEnabled": true, "dependents": [] } },
"sessionOverlays": { "ws:<路径>": {...}, "ss:<会话id>": {...} }
}
从旧名 dsh-skill-mcp-hub 升级的：首次运行会把 ~/.dsh/skill-mcp-hub/ 整目录改名到 skill-mcp-nexus/，别名、备注、分组、开关全部保留。迁移成功会在 last-load.json 里记 stateMigratedFrom: "skill-mcp-hub"。
另有一份 last-load.json，记录插件上次加载的状态：
{
"typertBaseOk": true,
"typertRegistered": true,
"endpoints": ["skillMcpHub/list", "..."],
"gateReady": true
}
面板打不开时先看这个文件——typertBaseOk: false 说明宿主包没解析到，typertRegistered: false 说明 manifest 没登记上，两种都是 404 的原因，但修法不同。
开发
node selftest.mjs # 纯逻辑自检，66 项
node manifest-check.mjs # manifest 合规，13 项
服务端改 lib/index.js 重载插件即可；客户端改 lib/client.js 必须重启应用。
代码地图
服务端一切操作的唯一真源是 state.json；读盘、求值、执行分在下面这些文件里，各管一件事。
| 文件 | 管什么 |
|---|---|
lib/index.js |
宿主半区。Typert 服务 skillMcpHub，把下面的模块拼起来对外暴露方法 |
lib/manifest.js |
Typert wire manifest。网关认识我们方法的唯一凭据，漏登记 endpoint 就是 404 |
lib/codec.js |
strictCodec 构造器，只实现 0.2.x 起的 create() 工厂契约 |
lib/state.js |
状态存储。tmp + rename 原子写；旧目录 skill-mcp-hub/ 自动 migrate |
lib/layers.js |
局部层覆盖的纯函数（不 import 宿主包，所以能离线自检） |
lib/skills.js |
skill 扫描与启停标记。两种停用姿势（改名法 / frontmatter）并存，判断可用性要两个条件都为假 |
lib/workspace-layer.js |
工作区层「文件位置即真源」——放合法但禁用的壳，靠宿主 rank 胜过全局 |
lib/skill-shadow.js |
会话级关闭：包住宿主 skills.list / snapshot / get 做结果级过滤 |
lib/mcp.js |
MCP 状态与工具名解析。不写 patch，运行时靠 tools.restrict |
lib/managed.js |
自建 MCP 的受管块（# >>> dsh-skill-mcp-hub:mcp:begin），块外逐字节保留 |
lib/probe.js |
MCP 连接测试：独立握手 + 8 秒超时强杀，不借用宿主连接 |
lib/tool-gate.js |
按 agent 施加工具限制。三件事缺一就会 CPU 100%（重入守卫 / 签名比对 / 监听器独占） |
lib/client.js |
浏览器半区（面板 + 输入栏浮层），改它必须重启应用 |
想改什么，动哪里：
| 需求 | 落点 | 生效方式 |
|---|---|---|
| 加一个远程方法 | lib/manifest.js 登记 + lib/index.js 实现 |
重载插件 |
| 改开关语义 | lib/layers.js（求值）+ index.js（执行） |
重载插件 |
| 改面板 UI / 浮层 | lib/client.js |
重启应用 |
| 改自建 MCP 的写盘格式 | lib/managed.js |
重载插件 |
| 改会话关闭的实现 | lib/skill-shadow.js |
重载插件 |
几条写代码时的硬约束（踩过的坑，改之前先看）：
- 调
skills.list / snapshot / get传scope时必须传 agent 对象本体，chainLayers用同引用比较，传 id 或新造对象会静默不生效。 - 浏览器包只能 require 外壳种子（react / react/jsx-runtime / ui-primitives），打包格式是
window.__ModuleLoader__.load({ id, factory })。 - 样式一律用宿主 token（
--dsw-font-*/--dsw-radius-*/--dsw-alias-*）；本插件尺寸走--hub-*令牌集中在.HUB_root里。不要写裸 px 字号或编造 token 名——名字不存在时var()会整体失效。 - grid/flex 里的文本子项必须
min-width:0，否则长名字会撑破格子把兄弟列挤成 0 宽。 - 悬停浮层
z-index:200，输入栏浮层z-index:60——新增浮层要么高过 200，要么明确放它下面。 state.json里sessionOverlays的ws:层跨会话共享，会话销毁只许清ss:。
加断言：selftest.mjs 是纯逻辑（不碰宿主包），新逻辑尽量先抽成 layers.js 这类纯函数再测；manifest-check.mjs 管 manifest 与包元数据一致性。判断一条断言有没有用：把对应代码整段删掉，它必须变红。
依赖说明
zod 在代码里被直接 import（lib/index.js、lib/manifest.js），已写进 dependencies，由 pnpm 从自己的 .pnpm 装副本（锁文件解析到 4.6.7），不指向宿主。
@deepseek-ai/dsh-typert-protocol 只随宿主发布，npm 上的版本对不上，所以既不进 dependencies、也不该出现在 node_modules 里。插件加载时依次尝试裸包名、<execPath>/node_modules/…、<execPath>/resources/app/node_modules/…，都失败就用一个最小桩类顶上——插件照常加载，只是面板会 404，而不是整个插件猝死。原因写进 last-load.json，typertBaseOk: true 就说明这条路走通了。
改依赖时注意：这个目录的 node_modules 由 pnpm 一个人管，只同步锁文件请用 pnpm install --lockfile-only，别裸跑 pnpm install 顺手把锁也改了。2026-11-14 拆掉了两条手工搭的 junction（zod → 宿主 profile、@deepseek-ai/dsh-typert-protocol → 宿主安装目录），现在顶层只剩 pnpm 自己的软链，干净 clone 后 pnpm install 即可复现。
为什么代码里还留着 skill-mcp-hub
包与仓库在 2026-11-13 改名为 dsh-skill-mcp-nexus，但下面这些内部标识符不能跟着改——它们已经写进了用户的数据和宿主的配置：
| 标识符 | 出处 | 改了会怎样 |
|---|---|---|
# >>> dsh-skill-mcp-hub:mcp:begin / :end |
lib/managed.js，会落到用户的 cordis.patch.yml |
旧的受管块认不出来，变成孤儿行 |
dsh-skill-mcp-hub:workspace-shadow |
lib/workspace-layer.js，会落到工作区 SKILL.md 的 frontmatter |
已标记的壳文件失联，工作区开关失效 |
ui-skill-mcp-hub / skill-mcp-hub（locale NS、面板 id） |
lib/client.js |
已保存的面板状态和挂载点对不上 |
skill-mcp-hub（LEGACY_STATE_DIR） |
lib/state.js |
老用户的状态目录迁不过来 |
该一致的地方已统一收口：包名与版本只有一个来源（package.json → lib/version.js），客户端 descriptor 的 id 用同一个 PKG 常量拼，last-load.json 与探活 clientInfo 都读 PKG_VERSION。manifest-check.mjs 有三条断言盯着别再写死（package.json 的 name 对得上 manifest、lib 里没有旧包名 #、除 version.js 外没有版本字面量）。
版本号沿革
package.json 的 version 与 git tag 自 v0.1.2 起才对齐。此前打了 tag 却没同步包元数据，两个 tag 里的 package.json 一律写着 0.1.0——不改写历史提交，只在此记录事实：
| tag | 提交 | 包内 version |
|---|---|---|
v0.1.0 |
0b7cb6b |
0.1.0 |
v0.1.1 |
f1dbcd1 |
0.1.0（错位） |
v0.1.2 |
本版 | 0.1.2（对齐） |
顺带两件事：bad-pending 是个没有语义的临时 tag（指向 b5ec765），不要拿它做发布锚点，也别推到远端；git describe 显示的 v0.1.1-3-g<sha> 只说明"离最近 tag 三个提交"，不代表包版本。
License
MIT © 2026 奈薇
本项目部分代码结构参考了同类插件，其原始版权声明与许可条款见 THIRD-PARTY-NOTICES.md。
No comments yet. Be the first to write one.