概览
dsh-capability-pack
README / ZH
插件文档
目录摘要
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **专家只做「召唤」（复制开场提示词），不做运行时人设注入**：DSH 的“专家”等价物是智能体预设， 要真正换人设得在「设置 → 智能体预设」切换；把 WorkBuddy 的 448 个 agent 逐个改写成 DSH 预设不现实。 - **工具 schema 有硬规则**：每个 object 必须显式 `additionalProperties`，否则整块插件激活失败 （实测踩过）。改完 schema 先跑 `node tools/validate-tools.mjs` 再重启。 - **界面渲染未在真实会话里验证**：本包是在同一台机上用假 ctx 跑通 Host 全部动作、并把 `/capability-pack/*` 路由处理跑通；Client 面板要重启 DSH 后由浏览器加载 `client.js` 才能看到。重启后若按钮不出现，先看 `~/.dsh/logs` 里 `capability-pack` 的 slot 注册告警。 - **索引构建 1.5–4 秒**（3400+ 个 `SKILL.md` 读 frontmatter）。放在启动后 3 秒后台执行，不阻塞启动；界面读的是磁盘索引，所以不受影响。 - **MCP Streamable HTTP 只实现请求-响应**，未处理服务器主动推送的 notification；stdio 是主路径。 - **未做增量索引**：新增技能后要么等下次启动后台重建，要么点界面右上角刷新（`rebuild-index`）或跑 CLI。 - **DSH 只按 `pnpm-lock.yaml` 建立模块映射**：只写 `file:` 依赖而不更新 lockfile 的包会被**静默跳过** （表现：patch 里能看到行，但模块从未被 import，日志无提示）。`tools/install.mjs` 现在会自动跑一次 `pnpm install --prefer-offline --ignore-scripts` 补 lockfile；跑不了时会打印手动命令。 `tools/verify-live.mjs` 的 `[3] 插件加载痕迹` 就是用来抓这个坑的。 - **依赖登记用 `file:`**：安装会往 profile `package.json` 写 `"dsh-capability-pack": "file:./vendor/dsh-capability-pack"`。 正常情况这不会触发联网安装。若某台机器的 DSH 在启动时抱怨 profile 依赖不一致，把这一行删掉即可 —— `node_modules/dsh-capability-pack` 与 `dsh.profile.bundles` 里的名字仍然能让插件加载。 ---