让插件通过 awesome-dsh-plugin 的 Review：维护者 Checklist

August 15, 2026 · View on GitHub

作者：zoahdev · 2026-08-15 · 依据 awesome-dsh-plugin 维护者 fkysly 在 PR #352 的真实评审

收录边界（先搞清楚）

awesome-dsh-plugin 只收录 dsh plugin add 一行能装进 DeepSeek Harness 的插件（边界见 PR #248）。

纯 CLI 工具不在收录范围内——除非发到 npm 用 npx 分发。维护者原话："一个能被 agent 调用的插件体检器，对整个生态的价值比 CLI 大得多"。所以：要么是插件，要么别投这个榜单。

逐项 Checklist

#检查项不过的样子自查方式
1package.json 有 dsh.bundle只有 bin，没有 dsh 字段node -e "console.log(require('./package.json').dsh)"
2dsh.bundle.patch 指向存在的 cordis.patch.yml装完 dump-config 没有你的插件dsh --profile web --dump-config
3cordis.patch.yml 合法、有带 id 的 insertYAML 报错 / 空列表doctor 的 patch 检查
4files 白名单包含构建产物装到别人机器只有 src/pnpm pack --dry-run
5prepare 脚本git 安装不构建npm pkg get scripts.prepare
6至少一个模型工具（agent 能调）装了但 agent 用不了插件 apply() 里 ctx.tools.register
7CI 证明"真实可调用"只证明"能加载"CI 里装 tarball → 注册 → 真实执行 handler → 断言
8README 说明安装方式与用法用户不知道装完干嘛照 README 自己走一遍
9真实安装验证本地没装过dsh plugin --profile web add <tarball>

一条命令跑完 80% 的检查

git clone https://github.com/zoahdev/dsh-plugin-doctor.git
cd dsh-plugin-doctor && pnpm install && pnpm build
node lib/bin.js --build --full /path/to/your-plugin

输出覆盖：manifest / patch / entry / files / build / pack / 全新 DSH profile 安装 / dump-config 含插件 id。

最常被退回的三个原因（维护者原话）

  1. 缺 dsh.bundle —— 只有 bin，没有插件外壳；
  2. files 只列了 src/ —— 构建产物 lib/ 没进白名单，也没有 prepare；
  3. 纯 CLI 当插件投 —— 装不上，也不属于榜单边界。

被拒之后怎么办

维护者关闭 PR 不等于项目不行。以 PR #352 为例：

  1. 维护者给了两条路（纯 CLI → npm npx；或加插件外壳）；
  2. 我们选了"插件外壳"：cordis.patch.yml + dsh.bundle + 一个 plugin_check 模型工具，bin 保留；
  3. 用真实 CI（打包安装 + 真实调用 + 自检）证明每一条，再回帖请维护者重开。

把评审意见当验收标准，而不是争论点。

相关资源