崩溃报错，无法启动？

两行命令接住你的情绪，解决你崩溃的源头。

# ① 安装
dsh plugin --profile web add @jorinyang/dsh-doctor

# ② 修复
dsh-doctor

自带 CLI，安装自动注册到系统 PATH，直接执行即可。修复全程可逆，改坏了随时回滚。

💡 它是什么

DeepSeek Harness 没有内置 doctor 命令。当 DSH 崩溃、启动失败、或某个插件破坏了 profile 时，你只能对着报错干瞪眼，靠重启进程碰运气。

dsh-doctor 是 DSH 的第一款「诊断 + 修复 + 回滚」一体化工具，同时也是一个运行时自愈服务：

✨ 为什么选择它

🎯 两行命令，救活崩溃的 DSH

不需要读懂报错，不需要手改配置文件：

dsh-doctor          # 先诊断，看问题出在哪
dsh-doctor fix      # 再修复，自动处理

↩️ 修复可逆，敢改才敢修

每次修复都会生成一个 journal，记录每个改动的 undo 步骤。改坏了？一条命令回到解放前：

dsh-doctor rollback              # 回滚最近一次修复
dsh-doctor rollback --list       # 列出所有修复日志
dsh-doctor rollback --id <id>    # 回滚指定日志

⚡ 运行时自愈，DSH 活着也能调

不是只能「停机修复」。dsh-doctor 通过 Cordis 原生能力接入运行时：

• ctx.provide('dsh-doctor') — 暴露诊断/修复/回滚 API 给其他插件
• ctx.on('internal/status') — 响应式监控插件生命周期，检测 FAILED 自动告警
• ctx.effect() — 可逆效应，卸载无残留

🌍 跨平台，开箱即用

安装后自动注册到系统 PATH，Windows / macOS / Linux / fish 全覆盖，无需手动配置。

🚀 快速开始

方式一：DSH 插件（Agent 内使用）

# 从 npm 安装
dsh plugin --profile web add @jorinyang/dsh-doctor

# 重启 dsh web
dsh web

安装后，在对话中告诉 agent：

运行 dsh_doctor          # 诊断
用 safe 范围运行 dsh_doctor_fix   # 修复
运行 dsh_doctor_rollback           # 需要时回滚

方式二：全局 CLI（命令行直接使用）

npm install -g @jorinyang/dsh-doctor
# 或
npx @jorinyang/dsh-doctor

演示

$ dsh-doctor diagnose --profile web

DSH Diagnostic Report  (profile: web, port: 3080)
DSH home: ~/.dsh

  [OK]   Node.js v24.15.0
  [OK]   pnpm 11.9.0
  [OK]   DSH 0.1.0-rc.6
  [OK]   DSH home exists
  [OK]   profile dir exists: web
  ...
  [XX]   bundle missing: some-broken-plugin
         fix: Run pnpm install in profile dir

  48 pass  0 fail  3 warn
  ✓ No blocking issues found; DSH should start normally.

📖 命令速查表

通用选项

修复范围（scope）

🏗️ 工作原理

dsh-doctor 对齐 DeepSeek Harness / Cordis 的「时空可组合（Spatiotemporal Composability）」范式：

flowchart LR
    subgraph CLI["🔧 dsh-doctor CLI（离线）"]
        D[诊断]
        F[修复]
        R[回滚]
    end

    subgraph Runtime["⚡ 运行时服务（在线）"]
        SVC[dsh-doctor 服务]
        WATCH[生命周期监控]
    end

    DSH["🖥️ DeepSeek Harness"]

    D -->|发现问题| F
    F -->|记录 journal| R
    R -->|LIFO 恢复| DSH
    F -->|可逆改动| DSH

    SVC -->|diagnose/repair/rollback| DSH
    WATCH -->|internal/status| DSH

时间可组合（Temporal）— 修复可逆

每个改动都记录反向撤销函数，回滚按 LIFO 逆序执行：

• 覆盖文件 → 保存原始内容，回滚时恢复
• 新建文件/目录 → 回滚时删除（仅空目录）
• 系统边界操作（pnpm install、杀进程）→ 标记「需手动补偿」

空间可组合（Spatial）— 运行时自愈

通过 Cordis 原生能力声明依赖、响应变化：

• ctx.provide — 提供服务
• ctx.on — 响应式监听
• ctx.effect — 可逆效应

🆚 为什么不用传统方案

❓ FAQ

Q：DSH 崩溃到连插件都加载不了，还能用吗？

能。dsh-doctor 是自包含 CLI，不依赖 DSH 运行。DSH 崩了也能直接 dsh-doctor fix。

Q：修复会破坏我的配置吗？

不会。每个可逆改动都先记录 undo 步骤，改坏了 dsh-doctor rollback 一键恢复。

Q：safe / deps / full 怎么选？

先用 safe（仅文件/配置，零风险）。没解决再升级 deps（重装依赖），最后 full（清理进程）。

Q：它和 DSH 自带的命令冲突吗？

不冲突。dsh-doctor 是独立插件 + 独立 CLI，不修改 DSH 核心。

🤝 贡献

欢迎提 Issue、PR。Bug 报告请附带 dsh-doctor diagnose 的输出。

📄 许可证

MIT