henrytian1998/dsh-doctor

诊断 DSH home、残留进程、端口与过大 session，并生成可粘贴的 /doctor 报告。

‍ 开发与运行时deepseek-harnessdsh

查看源码

dsh-doctor

English | 中文

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-<timestamp>.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-<timestamp>.md
$DSH_HOME/logs/doctor-<timestamp>.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-<timestamp>.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