---

为什么需要它

生态里最大的插件索引站精选了 23 个插件，其中 15 个被判定为「运行时测试失败」，失败率 65%。

失败原因几乎清一色是同一句：

peer 依赖 @deepseek-ai/dsh-* 为私有包 / npm 上不存在 / 无法解析

但这些判定大多不准确。 我用官方方式重新验了一遍其中 8 个：

结论	数量
✅ 完全可用（被误判）	4
⚠️ 装得上但未自动启用（不是插件的错）	3
❌ 确实装不上	1

根因

DSH 生态里大多数插件不在 npm registry 上，是从 GitHub 直装的。

• 用 npm install 装 → 必然失败，报 peer 依赖找不到
• 用官方 dsh plugin add 装 → 2 秒装好

原因写在 profile 目录的 pnpm-workspace.yaml 里：

autoInstallPeers: false

peer 依赖由 bundle 提供，本来就不需要单独解析。 安装时那几行 Peer dependencies that should be installed 是提示，不是错误。

把 npm 报错当成插件失效，就会把大量可用插件误判为坏的 —— 用户被劝退，作者被冤枉。

用法

作为技能装进 DSH

git clone https://github.com/pingfanfan/dsh-verify.git
cp -R dsh-verify/skills/verify-dsh-plugin ~/.dsh/skills/

然后直接问 DSH：

帮我看看 omdsh-dev/dsh-tool-calculator 这个插件能不能用

或者直接跑脚本

node skills/verify-dsh-plugin/scripts/verify.mjs omdsh-dev/dsh-tool-calculator

验证 omdsh-dev/dsh-tool-calculator ... ✅ pass

✅ omdsh-dev/dsh-tool-calculator
   包名: @deepseek-ai/dsh-tool-calculator
   结论: 安装后出现在组装配置中，DSH 可正常加载

可用 1 / 1

批量验证：

node skills/verify-dsh-plugin/scripts/verify.mjs --file repos.txt
node skills/verify-dsh-plugin/scripts/verify.mjs --file repos.txt --json

它怎么判定

1. 读仓库的 package.json 拿到声明的包名
2. 记录安装前 dsh --dump-config 里已有的包
3. 用 dsh plugin --profile web add github:<repo> 安装
4. 再读一次配置，看这个包名出现了没有
5. 默认验证完自动卸载，不污染环境

五种结论

结论	含义
pass	装上且出现在配置里，可以用
installed-not-loaded	装上了但没自动启用 —— 不等于坏了
install-failed	安装阶段失败
not-a-plugin	没有 package.json，可能是纯 skill 仓库
env-error	本机 DSH 环境不可用

相关

• hello-dsh — DSH 零基础入门教程
• learn-dsh.com — 配套网站

许可

MIT

---

非官方社区项目，与 DeepSeek 无隶属关系。 所有数据实测于 DSH 0.1.0-rc.6，2026-08-14。