Aki2519/dsh-auto-continue ↗★ 0
dsh-auto-continue
重启后自动继续未完成的任务:host 启动时找到最近一个未完成的会话并注入“继续”消息;web UI 弹出可见提示
安装
$
npx -p @deepseek-ai/dsh dsh plugin --profile web add github:Aki2519/dsh-auto-continue说明文档
阅读完整 README ↗dsh-auto-continue — 重启后自动继续任务
host + web client 插件。每次启动 DeepSeek Harness 时,扫描持久化的会话:
- 找到最近一个最后回合未正常完成的会话(崩溃留下的 open turn、
interrupted、error、max-tokens、aborted); - 用
ctx.agents.resume()恢复该会话,按会话自己记录的模型配置(最后一条request/header)和 agent 预设(agent-preset/selected事件或 header,经agentPresets.mount挂载)重建 agent,再注入一条"继续"消息; - Web UI 端启动后轮询
/api/auto-continue/status,弹出可见横幅(「已自动恢复上次未完成的任务」+「打开会话」按钮,可一键跳到该会话),并尽力发一条系统通知。
安装
cd
dsh plugin --profile web add file:/path/to/dsh-auto-continue
配置
配置写在插件 bundle 的 cordis.patch.yml 里(安装后随 bundle 层加载):
- insert:
- id: dsh-auto-continue
name: dsh-auto-continue
config:
enabled: true
prompt: 系统刚刚重启。请从上次中断的地方继续完成任务,并在完成后简要汇报。
continueOn: [interrupted, error, max-tokens, aborted]
skipSubagents: true
onlyMostRecent: true
| 字段 | 默认 | 说明 |
|---|---|---|
enabled | true | 总开关 |
prompt | 见 patch | 注入的“继续”消息文本 |
continueOn | [interrupted, error, max-tokens, aborted] | 哪些结束原因算“未完成” |
skipSubagents | true | 跳过子代理/派生的会话 |
onlyMostRecent | true | 只恢复最近一个未完成会话 |
logFile | $DSH_HOME/auto-continue.log | 运行日志路径 |
行为
- host 启动、
loader树沉降后执行(与 headless runner 同款时机),服务未就绪会短暂重试; - 判定“未完成”:事件日志里存在未配对的
turn/start(崩溃现场),或最后一个turn/end的 reason 落在continueOn里; - 本进程已经 live 的会话(API 网关刚恢复过)跳过,避免双驱动写同一个日志;
- 恢复后注入一条
source: { kind: 'plugin', plugin: 'dsh-auto-continue' }的用户消息,agent 自动跑完; - 全部会话都正常结束时不动作,只记一条
SKIP日志。
观察
每次执行追加一行到 $DSH_HOME/auto-continue.log:RESUME / SKIP ... / FAIL / WARN ...。
已知限制
- 跨进程互斥:插件启动时通过
$DSH_HOME/.auto-continue.lock(目录锁 + pid)保证同一份~/.dsh同时只有一个实例执行自动恢复——多个 dsh 进程并发恢复同一会话会把事件写重复、损坏会话日志(已因此损坏过会话)。拿不到锁的实例会记一条SKIP another instance holds the resume lock并退出;崩溃残留的死锁会被自动回收。 - 恢复使用的 agent 预设取会话自己记录的值;从未记录过预设的会话会跟随当前默认预设(与 harness 自带行为一致)。
- 横幅只在「本次启动确实恢复了会话」时显示;全部完成时无横幅(正确行为)。
开发注意
dsh plugin add file:... 会把插件复制进 profile 的 node_modules,而不是符号链接。改 lib/ 或 cordis.patch.yml 后需重新 dsh plugin add(或手动同步到 node_modules// 下)再重启才生效;客户端 bundle 在启动时由 host 组装,同样需要重启。