Preface¶

DeepSeek Harness (DSH) breaks down capabilities into combinable plugins. In real development, when profile configurations, dependencies, or plugin states become abnormal, two common types of issues arise: one is that the Web UI remains accessible, but prompts or Agents fail; the other is that the Harness fails to start.

DSH Doctor is the diagnostic and recovery entry point designed to address these states. It first identifies problems, then executes limited recovery actions, and rolls back profile configurations to a healthy checkpoint when necessary.

What This Is¶

DSH Doctor is a diagnostic and recovery plugin for DeepSeek Harness, positioned as “Deterministic diagnostics and recovery for DeepSeek Harness”. The project is maintained by astra3294 and is licensed under MIT.

It primarily solves two problems:

• When the Web UI is available, detecting failures from the interface side and triggering recovery;
• When the Web UI fails to start, using the CLI for scanning, boot probing, recovery, and rollback.

Core Features¶

DSH Doctor provides the following capabilities:

• A persistent Doctor action in the sidebar next to Settings;
• An automatic recovery banner displayed above the composer after a prompt or Agent failure;
• A full Doctor page in Settings, including findings, checkpoints, and rollback;
• A floating emergency entry displayed in a frame overlay when a profile is corrupted;
• A loopback-only Host recovery service;
• A standalone CLI supporting scan, boot probe, recover, checkpoint, launch, and rollback commands;
• One-click reset to the last healthy checkpoint;
• Safe one-click actions that restore profile configuration to the latest healthy checkpoint.

Installation and Activation¶

First add it to the web profile, then start Harness:

dsh plugin --profile web add dsh-doctor
dsh --profile web

If the Web UI fails to start, recovery can be performed directly via the CLI:

npx dsh-doctor recover --profile web

Typical Usage¶

Below are commands for common paths.

Scan¶

npx dsh-doctor scan

Scanning runs offline by default and anonymizes paths.

Boot Probe¶

npx dsh-doctor boot

Used to probe whether Harness can start.

Recovery¶

npx dsh-doctor recover --profile web
npx dsh-doctor recover --profile web --yes

recover is used to execute the recovery process. Safe one-click actions during recovery reset the profile configuration to the latest healthy checkpoint.

The exit codes for recover are as follows:

• 0: Only warnings, unless --strict is used;
• 1: Errors remain, or boot verification failed;
• 2: Invalid arguments or internal failure.

Checkpoint and Launch¶

npx dsh-doctor checkpoint --profile web
npx dsh-doctor launch --auto-recover
npx dsh-doctor rollback <checkpoint-id>

checkpoint is used to create a checkpoint, rollback restores a specified checkpoint, and launch --auto-recover starts the launch process.

Behavioral Boundaries¶

DSH Doctor imposes clear limits on recovery actions:

• Dependency installation, disabling plugins that crash on startup, isolating corrupted session files, and re-enabling plugins disabled by Doctor all require explicit confirmation;
• Doctor will not disable connection, layout, settings, conversation, runtime, module-loader, or Doctor rescue entries;
• Checkpoints are stored locally under $DSH_HOME/doctor/checkpoints/ and are not included in reports or uploaded;
• API keys will not be printed, modified, or sent;
• DeepSeek Harness is a developer preview; unknown versions will be scanned in a conservative read-only mode.

Use Cases and Notes¶

DSH Doctor is suitable for developers who frequently adjust DSH profiles, dependencies, or plugin states. Its value lies in this: when issues arise, instead of manually editing configurations, you first scan, then recover, and finally fall back on checkpoints.

Notes for use:

• Plugins run with the permissions of the current dsh process; source code and licenses should be reviewed before installation;
• The DSH community directory is an independent site with no official affiliation to DeepSeek or High-Flyer, and should not be understood as an official app store;
• Development environment requires Node 24 and pnpm.

Conclusion¶

DSH Doctor turns common DSH exception handling into a set of executable commands: scan first, then recover, and roll back when necessary. For developers seeking an experimental yet reversible DSH development environment, it is a practical and directly usable tool.

GitHub Repository:

https://github.com/astra3294/dsh-doctor

Community Directory (provided by project materials):

https://www.skillhub.cn/plugins/astra3294/dsh-doctor