sakikoTGW/dsh-plugin-resolver

简体中文 · English

_{45 项检查 · dsh.so L5 运行已验证 · dshbase Verified · DSH ≥0.2.0-rc.2 <0.3.0 · Node ≥20}

我做这个插件，是因为让 agent 装插件这件事一直不太靠谱。社区目录 8MB，从 GitHub Pages 拉一次要一分半；406 组同名，dsh-browser 一组就有 9 个 owner；npm 上的 latest 不一定兼容当前内核，装上会被静默禁用；GitHub-only 的仓库没有构建产物，main 指向一个不存在的文件，装完永远不加载。

这些判断每次都要重来。我把它们做进插件里，之后装插件就是一次工具调用。

如果你就是 agent，先看 llms.txt，完整契约在 agent.json。

这是它跑起来的样子

_{真实 DSH 会话，装的是 dsh-ws-recency@0.26.0。它自己搜目录、解析版本、装完回读状态。}

同一件事手工做要 45 次工具调用、20 多分钟；它 6 次，约 3 分钟，中间没有重试。测法和消融在 BENCHMARK 和 ABLATION。

安装

插件市场	npm

我平时直接跟 agent 说：

安装 dsh-plugin-resolver，然后用它安装 dsh-browser。

自己敲命令

市场索引源：

https://sakikoTGW.github.io/dsh-plugin-resolver/market/index.json

dsh plugin --profile <profile> add dsh-plugin-resolver

GitHub 源码或 tarball：

dsh plugin --profile <profile> add github:sakikoTGW/dsh-plugin-resolver#<commit>

它怎么工作

阶段	工具	结果
搜索	plugin_search	目录命中、owner、星数、npm 名、同名标记
解析	plugin_resolve	package、install spec、registry、是否需要源码构建
安装	plugin_install	profile、lockfile、plugin-sources 的变更
校验	plugin_status	bundle、loader entry、fiberPhase
上报	返回值	应用状态、restart 判定、下一步

只有 plugin_install 会写环境，其余三个只读。

生态

• dsh-plugins：插件集和 catalog
• dsh.so：L5 运行已验证
• dshbase：Verified
• 市场索引源：https://sakikoTGW.github.io/dsh-plugin-resolver/market/index.json

能做什么

能力	npm	GitHub-only	显式 spec
同名消歧	✓	✓	✓
兼容版本	✓	✓	你给定
源码构建	—	✓	按 spec
装后校验	✓	✓	✓
重启判定	✓	✓	✓

几个细节（Features）

• 同名插件它不替你选。搜索结果会把 owner、星数、npm 名都列出来，你给 owner= 或者完整 spec 就行。
• 兼容版本按 engines.dsh 和同命名空间的 peer 求解；解析结果是一份可以复核的 install spec。
• GitHub-only 的包缺构建产物时，它会先 pnpm install / pnpm run build，再以 link: 装进去。
• 装完回读 bundle、loader entry 和 fiberPhase，重启与否看插件管理器实际应用的结果。

验证

npm test   # 45 passing: 35 logic + 10 harness

机器可读的验证入口在 agent.json 的 validation；CI 在 test.yml。

给 agent 的契约

{
  "tools": ["plugin_search", "plugin_resolve", "plugin_install", "plugin_status"],
  "versionRule": "engines.dsh first; otherwise same-namespace @deepseek-ai/dsh peers",
  "ambiguity": "owner= or a full spec",
  "writes": ["profile", "lockfile", "plugin-sources"],
  "restart": "plugin manager result"
}

完整契约在 agent.json，给 agent 的索引入口是 llms.txt。有问题来 Issues，或者看 dsh-plugins。

参考

网页版：sakikoTGW.github.io/dsh-plugin-resolver/docs/

内容	位置
四个工具	docs/TOOLS.md
版本选择规则	docs/VERSION-SELECTION.md
安装路径与重启判定	docs/INSTALL-PATHS.md
结构	docs/ARCHITECTURE.md
效果与证据	docs/EVIDENCE.md · BENCHMARK · ABLATION
测试与 CI	docs/TESTING.md
已知限制	docs/LIMITATIONS.md
反馈与安全	docs/SECURITY.md · Issues
License	LICENSE

_{MIT · DeepSeek Harness · 回到顶部}