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