dsh-doctor
在终端中运行以下命令:
dsh plugin install henrytian1998/dsh-doctor
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 终端中执行 dsh plugin install henrytian1998/dsh-doctor 安装该插件,开源地址见 https://github.com/henrytian1998/dsh-doctor,安装完成后重启当前 Profile 即可通过 /doctor 命令生成诊断报告。
插件介绍
当 DeepSeek Harness 跑起来之后,环境小毛病——残留进程占着端口、会话文件悄悄膨胀到几百兆、Node 版本不再匹配——往往要花一番功夫才能排查清楚。dsh-doctor 把这些零散检查收拢成一条 /doctor 命令,在已有的 Web、TUI 或自定义 Profile 里直接运行,不额外引入任何独立进程或第三套 UI。
每次运行时,插件会读取 DSH_HOME、Profile 名称与 Bundle 清单,校验 Node 与 dsh 版本是否在支持范围内;探测默认端口 3080(或 --port 指定值)查看谁在 LISTENING;遍历 Windows 进程树标记疑似属于当前 Profile 的 node 或 dsh 进程(只做标记,绝不 kill);对 sessions 目录下所有 .jsonl 与 .zstd 文件做 stat,超出 50 MiB 阈值时报告路径与字节数。全部结果汇总成一份带 PASS / WARN / FAIL 结论的 Markdown 报告及对应 JSON,写入 logs 目录,可直接粘贴到 GitHub Discussions。
它面向已经在使用 DeepSeek Harness、偶尔遇到端口冲突、会话膨胀或版本不匹配问题的开发者。插件不替代 Desktop Shell 或 TUI,不修改任何官方包,保持轻量:装好、跑一次命令、看结论,排查完毕。
使用场景
- 端口冲突时快速定位占用进程
- 排查会话文件是否超出大小阈值
- 向社区提交问题时生成标准化诊断报告
适合人员
- 遇到端口或进程冲突的 DeepSeek Harness 用户
- 会话文件膨胀后需要快速排查的开发者
- 需要标准化诊断流程的技术团队