dsh-plugin-graph-engine
DSH（DeepSeek-Harness）生态级基建插件：插件依赖图与冲突检测引擎。
扫描已安装/待安装插件，静态解析元数据（不执行代码），构建插件依赖图，检测缺失依赖、循环依赖、工具/服务冲突、管道拦截重叠，并提供 DSH 版本兼容性检查 与 安装预检（冲突即拦截）。
特性
- 零侵入：静态解析插件源码与
package.json，不执行插件代码，安全通用 - 四类冲突检测：工具冲突（error）、服务冲突（error）、管道拦截重叠（warning）、事件监听重叠（info）
- 依赖图：缺失依赖、循环依赖（DFS 三色标记）
- 版本兼容性：核对插件声明的 DSH 版本要求与当前运行版本（简化 semver：
*/x.y.z/^/~/>=） - 安装预检：模拟安装新插件后的增量风险，冲突即拦截
- CLI / CI 就绪：零依赖命令行入口，
--json机器可读输出，退出码 0/1 可直接接入 CI 门禁
安装
# 作为 DSH 插件安装
dsh plugin add dsh-plugin-graph
# 或作为 CLI 全局安装
npm install -g dsh-plugin-graphCLI 用法
# 扫描插件目录，构建依赖图并检测冲突
dsh-plugin-graph scan <dir> [--json]
# 冲突检查（无 error 级冲突即健康）
dsh-plugin-graph check <dir> [--json]
# 安装预检：模拟安装新插件后的增量风险
dsh-plugin-graph preflight <existingDir> <incomingDir> [--json]
# DSH 版本兼容性检查
dsh-plugin-graph compat <dir> <dshVersion> [--json]退出码：0 = 健康 / 可安全安装；1 = 存在 error 级冲突或参数错误。
CI 集成示例
# .github/workflows/plugin-check.yml
- run: npm install -g dsh-plugin-graph-engine
- run: dsh-plugin-graph check ./plugins --json插件内工具
| 工具 | 说明 |
|---|---|
plugin_graph_scan | 扫描插件目录，构建依赖图并检测冲突 |
plugin_graph_check | 对给定插件清单做冲突检查 |
plugin_graph_preflight | 安装预检：模拟安装新插件后的增量风险 |
plugin_graph_compat | DSH 版本兼容性检查 |
检测维度
| 类型 | 严重级 | 说明 |
|---|---|---|
tool_conflict | error | 两个插件注册同名工具 |
service_conflict | error | 两个插件提供同名服务 |
missing_dependency | error | 插件 inject 的服务无人提供 |
cycle_dependency | error | 插件间存在循环依赖 |
interceptor_overlap | warning | 多个插件拦截同一工具管道 |
event_overlap | info | 多个插件监听同一事件 |
开发
# 冒烟测试（不依赖 DSH 运行时）
node temp/plugin-graph-smoke.mjs
node temp/plugin-graph-smoke2.mjs业务逻辑全部为纯函数（lib/*.js），可独立测试；运行时（index.js）只做薄封装。
License
MIT