插件兼容审核器HYY-King/dsh-plugin-auditor

dsh-plugin-auditor

DSH 插件审核器 —— 在安装新插件之前，扫描 profile 的插件组合，预测会不会导致启动崩溃。

DeepSeek Harness 启动时会加载 profile 中的全部 bundle。第三方插件未配置或互相冲突（重复注册工具、entry id 冲突、peer 版本不匹配、缺 token/app id）会让整个插件树启动失败。本插件把这些教训固化成一次只读体检。

安装

从 git 仓库安装
dsh plugin --profile web add github:HYY-King/dsh-plugin-auditor

或本地目录安装（开发调试）
dsh plugin --profile web add D:\path\dsh-plugin-auditor

重启 dsh web 后生效

使用

重启后在会话里让 agent 调用 audit_plugins 工具：

- 全量体检：不带参数，扫描当前 profile 的全部 bundle
- 新插件预判：传 newPlugins: ["包名"]，对拟新增插件做名称级冲突预判

示例输出：

审核结果: PASS
--- 检查项 ---
OK 记忆插件唯一：@modusensus/dsh-mneme
OK 渠道插件 dsh-im-bridge 已被禁用，不参与加载
结论: 可以放心用

检查项

| 检查 | 说明 |
|---|---|
| 工具名重复注册 | 扫描各插件源码里的 defineTool/register 的 name，抓重复（如两个记忆插件都注册 memory_forget） |
| entry id 冲突 | 多个 bundle 的 cordis.patch.yml 挂载同一 id |
| peer 版本不匹配 | 插件要求的 @deepseek-ai/* 版本与已装版本不符 |
| 记忆插件唯一性 | 多个记忆插件同时启用会互相踩工具，保留一个即可 |
| 渠道插件凭据 | telegram/lark/im 等已启用但可能缺 token/app id，建议禁用或配置 |

原理

- 只读：读取 profile 的 package.json、cordis.patch.yml 和 node_modules 下各插件的包信息，从不执行被审核插件的代码
- 零依赖：迷你 YAML 解析（cordis.patch.yml 结构简单），不引入 YAML 库

免责声明

审核是静态启发式信号，不构成兼容性承诺。安装任何第三方插件前请自行审查源码、权限与许可证。

License

MIT