henrytian1998/dsh-doctor

dsh-doctor

DeepSeek Harness 诊断插件：把 home、残留进程、端口、过大 session、版本问题收成一份可粘贴的报告。不替代 Desktop / TUI。

这是 bundle，不是 profile。把它装进已有的 web / tui / 自制 profile。没有 doctor profile，也没有第三个聊天 UI。

安装

已有官方 Web 时：

dsh plugin --profile web add github:henrytian1998/dsh-doctor
dsh --profile web

然后在界面执行 /doctor。

npm 发布后安装命令改为 dsh plugin --profile web add dsh-doctor。

装完必须重启 profile。dump-config 看不到 doctor 行，就是 manifest 失败，不要先怀疑检查逻辑。

验证 bundle 已挂上

dsh --profile web --dump-config

合成配置里必须同时出现：

- id: doctor
- name: dsh-doctor

启动日志必须包含 doctor loaded。

开发隔离（禁止污染 ~/.dsh）

Windows PowerShell:

$env:DSH_HOME = "C:\work\dsh-doctor-home"
dsh plugin --profile web add .
dsh --profile web
dsh --profile web --dump-config

然后执行 /doctor。报告写到 $DSH_HOME/logs/doctor-.md 与 .json。

v0.1 检查项

| 检查 | 行为 |
| --- | --- |
| DSH_HOME / profile / bundles | 当前 home、profile 名、dsh.profile.bundles |
| dsh / Node 版本 | Node ^22.19 \|\| >=24；尽量从 CLI 包读取 dsh 版本 |
| 端口 | 默认 3080 或 argv --port；谁在 LISTEN；本进程树不算故障 |
| 残留 node / dsh | Windows 看进程树；标注是否可能是本 profile；默认不杀；不误报其它 Node 应用 |
| 超大 session | 只 stat $DSH_HOME/sessions 下 jsonl / zstd；只报路径和字节 |

默认 session 告警阈值：50 MiB。v0.1 不删除、不打开全量事件。

报告

/doctor 回显 Markdown，并保存：

- $DSH_HOME/logs/doctor-.md
- $DSH_HOME/logs/doctor-.json（schema: dsh-doctor/v1）

把 Markdown 粘贴到 GitHub Discussions。结论为 通过 / 警告 / 失败。

v0.1 明确不做

- 完整桌面壳 / Electron / Wails / Tauri
- 新的 TUI
- Settings 卡片（v0.2）
- 自动杀进程作为默认行为
- Host 起不来时的可选 bin 入口（v0.2）
- 修改官方 packages/client/*
- 另一套 session 历史

示例报告

可粘贴示例见 docs/sample-report.md。真实运行写到 $DSH_HOME/logs/doctor-.md。

GitHub Topics

仓库 Topics 打上：dsh-plugin、deepseek-harness、dsh。

只有 topic 没有 dsh.bundle 会被当成空壳。本包声明：

"dsh": { "bundle": { "patch": "./cordis.patch.yml" } }

package.json 的 files 包含 cordis.patch.yml。patch 用包名 dsh-doctor 引用插件，不用相对源码路径。

许可

MIT