dsh-verify
开发工具 活跃维护

dsh-verify

pingfanfan/dsh-verify

官方安装流程实测对应插件的真实可用性,排除npm安装报错等非核心问题干扰,直接给出插件能否正常工作的明确结论,无需自行排查冗余报错。

0
Stars 标星
0
Forks 分支
0
Watchers 关注
0
Open Issues
JavaScript
主要语言
MIT
开源协议
8 KB
仓库大小
1 个月前
最后推送
一键安装扩展 / 插件指令
dsh plugin --profile web add github:pingfanfan/dsh-verify
git clone https://github.com/pingfanfan/dsh-verify.git
git clone git@github.com:pingfanfan/dsh-verify.git
README.md main
# dsh-verify **判断一个 DeepSeek Harness 插件到底能不能用** 用官方安装方式实测,以「是否出现在组装配置中」为唯一判据 [![Skill](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/形态-DSH%20技能-blue)](https://raw.githubusercontent.com/pingfanfan/dsh-verify/main/skills/verify-dsh-plugin/) [![DSH](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/DSH-0.1.0--rc.6%20实测-orange)](https://github.com/deepseek-ai/deepseek-harness) [![License](https://cdnimage-cache.doubi.ren/?url=https://img.shields.io/badge/License-MIT-lightgrey)](https://raw.githubusercontent.com/pingfanfan/dsh-verify/main/LICENSE)

为什么需要它

生态里最大的插件索引站精选了 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 环境不可用

相关

许可

MIT


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