DeepSeek Harness (DSH) 的插件化架构虽然灵活,但开发者在扩展功能时容易遇到模块冲突或内部运行时错误。排查这些问题通常需要深入代码。dsh-conflict-checker 插件提供了直接在设置页检测冲突、管理插件状态的能力,旨在简化这一维护过程。
这是什么¶
这是一个由 TussalZeus18028 维护的 DSH 客户端插件。它主要解决两个问题:一是检测 DeepSeek Harness 的插件冲突与内部运行问题,二是在设置页面提供插件管理(启用、禁用、卸载)功能。
核心功能¶
1. 冲突检测
插件会扫描多种潜在冲突源,包括:
* 重复的模块加载
* 失败或挂起的 fibers
* 重复的设置命名空间
* 重复的工具名称
* 启动图问题
* 重复的 typert 包
2. 插件管理
在设置页面,用户可以对插件进行启用/禁用切换。卸载操作包含两步确认机制,防止误删。每个插件均可查看详细信息。
3. 一键修复
对于检测到的问题,界面会展示问题详情和对应的解决方案,并提供修复按钮(在适用的情况下)。
4. 界面风格
该插件在设置中渲染为“插件冲突检查”页面,采用官方主题令牌,保持视觉一致性。
安装与启用¶
通过命令行安装:
dsh plugin --profile web add dsh-conflict-checker
或者,直接将条目添加到配置文件 cordis.patch.yml:
- id: dsh-conflict-checker
disabled: false
典型用法¶
安装完成后,打开 设置 页面,进入 插件冲突检查。
该页面会展示:
* 健康概览:插件数量、启用/禁用状态、问题统计。
* 问题列表:显示检测到的问题及其解决方案。
* 插件列表:包含搜索和过滤功能,支持通过开关控制启用/禁用,以及卸载和查看详情操作。
工作原理¶
该插件采用客户端渲染与主机端接口结合的方式工作:
- 主机端:在共享 Web 服务器的
/plugins/dsh-conflict-checker/*路径下注册 JSON 端点,负责扫描插件、设置启用状态和移除插件。 - 客户端:负责渲染设置页面,并调用上述主机端提供的 JSON 接口。
在检测逻辑上,插件枚举读取 Cordis Loader 的条目,并进一步检查 Loader、设置命名空间、工具架构、Web 启动图以及 typert 注册表。
注意事项¶
本插件以当前 DSH 进程的权限运行。安装前请务必检查源码与许可证。DSH 理念是“一切皆插件”,社区目录与 DeepSeek 或幻方无官方从属关系。
总结¶
dsh-conflict-checker 通过提供可视化的冲突检测和插件管理界面,降低了排查 DSH 插件问题的门槛。开发者可以在遇到运行问题时快速定位并尝试修复。