dsh-doctor

English | 中文

DeepSeek Harness diagnostic plugin: collect home, leftover processes, ports, oversized sessions, and version problems into one paste-ready report. It does not replace Desktop / TUI.

This is a bundle, not a profile. Install it into an existing web / tui / custom profile. There is no doctor profile and no third chat UI.

Install

You already have official Web:

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

Then run /doctor in the UI.

After npm publish the install command becomes dsh plugin --profile web add dsh-doctor.

Restart the profile after install. If dump-config has no doctor row, the manifest failed — do not debug check logic first.

Verify the bundle landed

dsh --profile web --dump-config

The composed config must contain both:

• id: doctor
• name: dsh-doctor

Host log on boot must include doctor loaded.

Isolated development home (do not touch ~/.dsh)

Windows PowerShell:

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

Then run /doctor. Reports are written to $DSH_HOME/logs/doctor-.md and .json.

What v0.1 checks

Check	Behavior
DSH_HOME / profile / bundles	Reads the current home, profile name, and dsh.profile.bundles
dsh / Node version	Node ^22.19 || >=24; best-effort dsh version from the CLI package
Ports	Default 3080 or argv --port; who is LISTENING; current process tree is not an error
Leftover node / dsh	Windows process tree; marks “possibly this profile”; never kills; ignores unrelated Node apps
Oversized sessions	stat on $DSH_HOME/sessions/**/*.jsonl and *.jsonl.zstd; reports path + bytes only

Default session warning threshold: 50 MiB. v0.1 does not delete files and does not open the event stream.

Report

/doctor echoes Markdown and saves:

• $DSH_HOME/logs/doctor-.md
• $DSH_HOME/logs/doctor-.json (schema: dsh-doctor/v1)

Paste the Markdown into GitHub Discussions. Conclusion is PASS / WARN / FAIL.

Not in v0.1

• Desktop shell / Electron / Wails / Tauri
• A new TUI
• Settings card (v0.2)
• Auto-kill as the default
• Optional bin CLI for when Host cannot start (v0.2)
• Edits to official packages/client/*
• A second session history

Sample report

A paste-ready example lives in docs/sample-report.md. Real runs write $DSH_HOME/logs/doctor-.md.

GitHub topics

Set repository topics to: dsh-plugin, deepseek-harness, dsh.

A topic without dsh.bundle is an empty shell. This package declares:

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

package.json files includes cordis.patch.yml. The patch references the package name dsh-doctor, not a relative source path.

License

MIT