kid-tea

dsh-plugin-conflict-checker

Name: dsh-plugin-conflict-checker
Author: kid-tea

DeepSeek Harness plugin conflict checker: pre-flight duplicate loader-entry-id detection + optional real startup smoke test (CLI + Web GUI tab).

Introduction

DeepSeek Harness 插件冲突检测器（host + client bundle plugin）。

安装后：

静态检查当前 profile 的插件 patch 合成结果：
- 重复 loader entry id（会导致 duplicate loader entry id 启动崩溃）
- patch 目标不存在 / name mismatch / insert 非 group
可选 smoke：
- 用 OS 分配的空闲端口真实拉起一次 dsh web
- 等待 dsh web: http://... 就绪输出
- 超时或提前退出则判定启动失败/卡死

如果路径含空格，pnpm 的 dsh plugin add 可能把路径拆开；建议先用无空格 junction 再安装：

mklink /J D:\cfchk-plugin "D:\deepseek harness\plugin\dsh-plugin-conflict-checker"
dsh plugin --profile web add D:\cfchk-plugin

然后重启对应 profile。

在 DSH 会话中让 Agent 调用：

{
  "profile": "web",
  "smoke": true,
  "smokeTimeout": 60000
}

返回 JSON：

{
  "ok": true,
  "fatal": [],
  "warnings": [],
  "entryCount": 146,
  "smoke": { "ok": true, "url": "http://127.0.0.1:30706" }
}

静态检查只覆盖已知的启动失败模式：重复 loader entry id、patch 目标不存在、name mismatch、insert 非 group、bundle 缺失/无 dsh.bundle 声明。它不能保证覆盖所有未知插件冲突。
smoke 模式会真实拉起一次 dsh web，但只验证“能输出就绪 URL、不会在超时时间内卡死”；无法覆盖所有运行时问题（外部服务不可用、网络、浏览器端报错、端口被占用等）。
当前检测逻辑通过子进程运行 bundled checker，而不是在 host 进程内直接合成；这样实现简单，但会额外启动一个 Node 子进程。
当前 GUI 标签页默认检测 web profile，可在页面里手动改成其他 profile。
Windows 下 dsh plugin add 对含空格路径支持不好，安装时建议使用无空格 junction。
本项目仍属早期工具，DSH 的 slot/版本契约可能随版本变化；如果遇到新版不兼容，请以当前已安装的 @deepseek-ai/* 包类型和实际行为为准。

npm run typecheck
npm run build
npm run verify

当前实现：