DeepSeek Harness plugin

dsh-plugin-conflict-checker

DeepSeek Harness plugin conflict checker: pre-flight duplicate-id detection and optional real startup smoke test.

Jump to install

Source facts

Repository
kid-tea/dsh-plugin-conflict-checker
Latest update
Aug 16, 2026
Category
Development & Runtime
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/kid-tea/dsh-plugin-conflict-checker
Plugin: dsh-plugin-conflict-checker
Author: kid-tea

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

dsh-plugin-conflict-checker

DeepSeek Harness 插件冲突检测器(host + client bundle plugin)。

安装后:

  • host 侧注册工具 check_plugin_conflicts
  • Web 设置 → 插件 里新增「冲突检测」标签页,点击按钮即可检测,结果直接显示在页面里

功能

  • 静态检查当前 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。

使用

GUI 按钮

1. 打开 Web 设置 2. 进入「插件」 3. 找到「冲突检测」标签页 4. 勾选“同时进行真实启动测试(smoke)”可选 5. 点击「检测插件冲突」 6. 结果直接显示在下方

Agent 工具

在 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" }
}

局限性 / Limitations

  • 静态检查只覆盖已知的启动失败模式:重复 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

说明

当前实现:

  • host 注册工具 + HTTP 路由 /dsh-plugin-conflict-checker/check
  • client 注册 settings.plugins.tab,渲染检测按钮和结果
  • 检测逻辑仍由 bundled checker 子进程执行,避免在 host 进程里重复实现一整套合成器