dsh-plugin-compat-checker（插件兼容性测试器）

August 19, 2026 · View on GitHub

📦 仓库地址：https://github.com/SongYuhui14/dsh-plugin-compat-checker

演示

DeepSeek Harness (DSH) 插件：装新插件前，先测试它会不会和现有插件冲突/崩溃。

解决什么问题

插件生态爆发（1500+ 插件），用户最怕的是**"装个插件把 DSH 搞崩了"**——这是真实发生过的事 （社区插件 dsh-plugin-vetting 0.5.1 就曾因 bug 导致 profile 启动失败）。

本插件在安装前做预检：预测新插件与现有插件的兼容性，避免"装完就崩"。

检测矩阵（新插件 vs 每个现有插件）

检测严重度说明
UI 插槽冲突⚠️多个插件注册同一插槽 → 界面重叠
PromptSection 重名🚨同名提示词段 → 官方机制抛异常
complete 段冲突🚨多个 complete → 组装失败
依赖冲突🚨/⚠️同一依赖版本不一致 → loader 冲突
功能重复ℹ️同类功能共存 → 可能干扰
cordis 版本不匹配⚠️插件要求不一致 → 加载失败

使用方式

对话中直接说：

  • "测试插件 xxx 的兼容性"
  • "这个插件能装吗"
  • "装了会不会崩"
  • "/plugin-compat xxx"

输出示例

🔧 插件兼容性测试报告
==================================================
被测插件: my-plugin
现有插件: 12 个

【总体判定】🚨 不兼容（1 个致命问题）（得分 70/100）
发现 2 个兼容性发现（致命 1 / 警告 1 / 提示 0）

--- 检测详情 ---

🚨 [致命] prompt-section-collision
  新插件 'my-plugin' 与 'plugin-a' 注册同名系统提示词段 'system-instructions' — 重复注册会抛异常
  建议: 安装 'my-plugin' 会导致启动错误；需先停用 'plugin-a'

开发

lib/compat.js  — 兼容性检测引擎（6 项检测 + 评分判定）
lib/index.js   — 插件入口（读取现有插件 + 注册工具/命令）

相关作品

许可

MIT