前言¶
DeepSeek Harness（DSH）把能力拆成插件来组合。实际开发中，profile 配置、依赖或插件状态异常时，常见问题有两类：一类是 Web UI 还能打开，但 prompt 或 Agent 失败；另一类是 Harness 无法启动。
DSH Doctor 就是针对这些状态给出的诊断和恢复入口。它先发现问题，再执行有限的恢复动作，并在需要时把 profile 配置回滚到健康检查点。
这是什么¶
DSH Doctor 是 DeepSeek Harness 的诊断与恢复插件，定位为 “Deterministic diagnostics and recovery for DeepSeek Harness”。项目由 astra3294 维护，许可证为 MIT。
它主要解决两个问题：
- Web UI 可用时，从界面侧发现失败并触发恢复；
- Web UI 无法启动时，用 CLI 做扫描、启动探测、恢复和回滚。
核心功能¶
DSH Doctor 提供的能力包括：
- 在 sidebar 的 Settings 旁边保留一个持久 Doctor action；
- 在 prompt 或 Agent 失败后，于 composer 上方显示自动恢复 banner；
- 在 Settings 中提供完整 Doctor page，包含 findings、checkpoints 和 rollback；
- 当 profile 损坏时，在 frame overlay 中显示 floating emergency entry；
- 提供 loopback-only Host recovery service；
- 提供 standalone CLI，支持 scan、boot probe、recover、checkpoint、launch 和 rollback 命令；
- 支持一键重置到最后一个健康检查点；
- 安全的一键动作会把 profile 配置重置到最新健康检查点。
安装与启用¶
先把它加入 web profile，再启动 Harness：
dsh plugin --profile web add dsh-doctor
dsh --profile web
如果 Web UI 无法启动，可以直接用 CLI 做恢复：
npx dsh-doctor recover --profile web
典型用法¶
下面按常见路径给出命令。
扫描¶
npx dsh-doctor scan
扫描默认离线进行，并对路径做匿名化。
启动探测¶
npx dsh-doctor boot
用于探测 Harness 是否能启动。
恢复¶
npx dsh-doctor recover --profile web
npx dsh-doctor recover --profile web --yes
recover 用于执行恢复流程。恢复中的安全一键动作会把 profile 配置重置到最新健康检查点。
recover 的退出码如下：
0：只有 warnings，除非使用--strict；1：仍有 errors，或 boot verification 失败；2：参数无效或内部失败。
检查点与启动¶
npx dsh-doctor checkpoint --profile web
npx dsh-doctor launch --auto-recover
npx dsh-doctor rollback <checkpoint-id>
checkpoint 用于创建检查点，rollback 用于恢复指定检查点，launch --auto-recover 用于启动流程。
行为边界¶
DSH Doctor 对恢复动作做了明确限制：
- 依赖安装、禁用导致启动崩溃的插件、隔离损坏的会话文件、重新启用被 Doctor 禁用的插件，都需要显式确认；
- Doctor 不会禁用 connection、layout、settings、conversation、runtime、module-loader 或 Doctor rescue 条目；
- checkpoints 保存在本地
$DSH_HOME/doctor/checkpoints/下，不会包含在报告中，也不会上传； - API keys 不会被打印、修改或发送；
- DeepSeek Harness 是 developer preview；未知版本会以保守的只读模式扫描。
适用场景与注意¶
DSH Doctor 适合需要频繁调整 DSH profile、依赖或插件状态的开发者。它提供的价值在于：出现问题时，不是手工改配置，而是先扫描、再恢复、最后用检查点兜底。
使用时注意：
- 插件以当前 dsh 进程权限运行，安装前应检查源码与许可证；
- DSH 社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系，不应理解为官方应用商店；
- 开发环境要求 Node 24 和 pnpm。
结尾¶
DSH Doctor 把 DSH 的常见异常处理变成了一组可执行的命令：先扫描，再恢复，必要时回滚。对于希望保持可实验、可回滚的 DSH 开发环境来说，它是一个直接可用的处理工具。
GitHub 仓库：
https://github.com/astra3294/dsh-doctor
社区目录（项目资料提供）：
