dsh-revive · 一键复活

DSH 进程经常在跑任务时被杀死（自己杀自己、OOM、崩溃……），重启之后每个被打断的会话都要手动点开、手动发一句「继续」。这个插件把这件事变成一键：

• 扫描全部持久化会话，识别「被打断」的（回合没跑完、消息没处理、上次回合以中止/出错/阻塞/超长收尾的）；
• 按官方 GUI 同款路径冷恢复它们：从持久化日志重建会话、挂回它原来的 preset 组合、沿用上次的模型；
• 给每个被打断的会话发送「继续」指令，让它们接着干活；
• 子代理会话不直接复活（它们会随父会话的恢复被自动接管），正在运行的会话不动。

触发方式（三选一，同一套核心逻辑）

被打断的判定

对每个会话日志折叠出以下结论之一：

安装

# 已登录私有 npm registry 的 DSH 部署机
dsh plugin --profile web add dsh-revive@0.1.4

# 本地开发 checkout
dsh plugin --profile web add link:/path/to/dsh-revive

插件自带 Profile Bundle；dsh plugin 会自动维护 profile 依赖和 dsh.profile.bundles。不要手工编辑 profile manifest，也不要再插入同名 revive loader entry，否则会触发 duplicate loader entry id。重启 DSH 后，任意会话输入框 下方出现「⚡复活」按钮即安装成功。

兼容性

0.1.4 以 npm DSH 0.1.0-rc.3 的 commands、agent resume、raw session persistence 和 dsh-client-ui-conversation 契约为准。

配置

在 profile 自己的 cordis.patch.yml 中更新插件行；不要修改安装包内的 patch：

- update:
    id: revive
    config:
      resumePrompt: 继续
      autoReviveOnStartup: false
      startupDelayMs: 5000
      scanTtlMs: 120000

所有键均可选：

开发

npm install --legacy-peer-deps
DSH_RUNTIME_NODE_MODULES=/path/to/dsh-0.1.0-rc.3/node_modules npm run setup:dsh-workspace
npm run typecheck
npm test
npm run build                 # tsc（host 半部）+ tsdown（浏览器半部 lib/client.js）
npm run test:oom              # 128 MiB V8 heap 下扫描 32 MiB raw JSONL
npm pack                      # prepack 会重跑全部 gate

依赖的真实类型在 setup:dsh-workspace 时从已安装的私有 npm DSH 运行时软链而来；用 DSH_RUNTIME_NODE_MODULES=<path> npm run setup:dsh-workspace 指定该运行时的 node_modules。

已知限制

• 复活后的会话沿用上次记录的模型；会话内切换模型需通过官方模型选择入口（插件恢复的会话不在 web 选择器的注册表里）。
• 冷扫描只使用持久化后端的 raw artifact 接口：逐会话串行读取，从 JSONL 尾部反向折叠到最近的 turn 边界，不构造完整事件数组，也不会把日志放入 DSH 的 prepared-session 缓存。结果按后端 revision 缓存在进程内，扫描前后 revision 不一致时最多重试一次，仍在变化的会话会跳过而不是误报。
• 当前只有声明 supportsRawArtifacts 的持久化后端能安全扫描冷会话；SQLite 等不提供独立 raw artifact 的后端会把冷会话记为 skipped，不会回退到完整日志读取。raw artifact 本身仍会以字符串形式短暂驻留，因此峰值内存与最大单个 artifact 大小相关，但不会再随多份完整事件图累积。
• 为保持尾部扫描有界，冷会话候选不会额外回溯标题；命令和界面在标题缺失时显示 session ID。