dsh-autoresume
Agent 与工作流shengyvself/dsh-autoresume
为 DeepSeek Harness 在重启或网络故障后自动继续被中断的会话。
- agent
- ai
- automation
- chatbot
- deepseek
- deepseek-harness
- dsh
- dsh-plugin
- plugin
- resume
- session
README
dsh-autoresume(重启后自动继续)
全域模式(v0.0.5,2026-08-23):web 重启后,任何被重启中断任务的会话都会自动继续——扫描
~/.dsh/sessions全部会话(仅处理最后活动在scanWindowMs(默认 24h)内的),持久化事件流停在被打断中间态的注入「继续」;completed/settled 一律不动;正在运行的会话绝不打断。 网络故障停止(v0.0.8,2026-08-24):会话因网络/瞬时故障停止(最后一个turn/end为error,错误码属 DSH 可重试集合EMPTY_RESPONSE/RATE_LIMIT/SERVER/TIMEOUT/TRANSPORT,或消息命中网络特征如upstream error/429/5xx/timeout/fetch failed/ECONNRESET)同样注入「继续(自动)」让其自动重跑;配置/模型类错误(UNKNOWN_MODEL/MISSING_CREDENTIAL/NO_ADAPTER等)维持 settled 不注入,避免死循环。 兼容模式:配置targetSessionId时退化为旧行为(只服务该会话)。 运行期间再次网络失败(v0.0.9,2026-08-24):liveWatch(默认 true)使插件在 boot 扫描后保持轮询,补 catch 同一会话在运行期间再次以网络/瞬时失败停止(此前只有在 web 重启后才一次性生效);并加死循环守卫——若上次注入「继续」之后未产生任何内容/工具调用便再次以同类网络错误失败(模型持续返回空内容,例如某些强制推理的隐身模型),判定为持续故障转settled不再注入,交由用户手动处理;会话之后有产出或新用户消息则重新武装。
行为
- 通过
ctx.sessionPersistence.inspect()读取目标会话的持久化事件流(dsh-session 官方 API,底层即~/.dsh/sessions/<cwd>/<id>/session.jsonl.zstd的平衡视图)。 - 判定被打断:turn/step 打开未闭合、存在没有对应
tool/result的tool/call、或最后一个turn/end原因为interrupted。 - 判定网络故障停止:最后一个
turn/end原因为error且错误属网络/瞬时故障(错误码在 DSH 可重试集合EMPTY_RESPONSE/RATE_LIMIT/SERVER/TIMEOUT/TRANSPORT,或消息命中网络特征正则NETWORK_FAILURE_PATTERN)→ 同样注入「继续(自动)」;配置/模型类 error(如UNKNOWN_MODEL/MISSING_CREDENTIAL/NO_ADAPTER/INVALID_MODEL_INFO)维持 settled 不注入。 - 判定已完成:最后是
assistant/message,或最后一个turn/end为completed且其后没有新用户消息 → 不动作。 - 判定后不动作:
cancelled/error等已闭合终态,以及闭合轮次后新出现的手动用户消息。 - 注入方式:
ctx.agents.get(目标)→agent.followup(userMessage);消息source.kind=plugin, form=notice,正文为「继续(自动)」。 - 进程级一次性(liveWatch 关闭时):每个 web 进程只判定/注入一次;另有
bootGraceMs(默认 30 分钟)窗口,profile HMR 装卸插件不会误触发。liveWatch: true(默认)时在bootGraceMs窗口内持续重扫(仅处理每会话 mtime 变化者,避免反复读大事件流),补 catch 运行期间的再次网络失败;isResumableState的 loop-guard 对「continue→无产出再失败」转 settled,防模型持续空返回死循环。 - 2026-08-22 修复(v0.0.3):目标会话 agent 不在线时不再干等到宽限过期。插件现在会先直接读持久化流判定状态(无需 agent 在线);若判定为被打断,则自行
ctx.agents.resume()恢复该会话(挂载会话当前 preset,与浏览器打开同构),随后注入「继续(自动)」。判定为已完成/已闭合则立即收手,不产生恢复副作用。 - 2026-08-22 修复(v0.0.4):自我恢复时补装模型选择(
installModelSelection,读会话 requestHeader 模型配置,回退默认模型)。否则 prompt 组装报{{model}} has no value、恢复出的 agent 跑不了轮。依赖@deepseek-ai/dsh-agent用符号链接复用运行时副本(npm 装会 peer 冲突),安装方式见下。 - 目标会话不在线时每
pollIntervalMs(默认 5 秒)重查,直到判定完成或宽限到期。
配置(cordis.patch.yml)
| 键 | 默认 | 说明 |
|---|---|---|
targetSessionId | 上面写死的开发会话 | 只允许改这一个目标,绝不扫描其他会话 |
bootGraceMs | 120000 | web 进程启动后允许判定的宽限窗口 |
initialDelayMs | 3000 | 首次检查延迟(等会话恢复) |
pollIntervalMs | 5000 | 会话未就绪时的重查间隔 |
promptText | 继续(自动) | 注入正文 |
liveWatch | true | boot 后保持轮询补 catch 运行期间再次网络/瞬时失败;配 loop-guard 防模型持续空返回死循环 |
安装与验证
npm run build
# v0.0.4 起依赖 @deepseek-ai/dsh-agent:npm 直装会 peer 冲突(dsh-brand rc.8 vs rc.2),
# 用符号链接复用运行时同一份(版本零漂移):
mkdir -p node_modules/@deepseek-ai
ln -sfn /usr/lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai/dsh-agent node_modules/@deepseek-ai/dsh-agent
node --input-type=module -e "import('./lib/service.js').then(()=>console.log('loads ok'))"
dsh plugin --profile web add /path/to/dsh-autoresume
dsh --profile web --dump-config # 应出现 id: dsh-autoresume、name: dsh-autoresume
装完不要立即重启;等开发完成后再 sudo systemctl restart dsh-web 生效。
实测(2026-08-17):重启后目标会话日志出现 user/message(source.plugin=dsh-autoresume,正文「继续」),开发会话自动接续;每进程只注入一次。
实测(2026-08-22 v0.0.4):真实会话双测全链路通过——early inspect(7s)→ self-resumed → 注入「继续(自动)」→ request/header 带出会话模型(deepseek-v4-flash)→ agent 正常继续干活,无 {{model}} 报错。
卸载/禁用
- 卸载:
dsh plugin --profile web remove dsh-autoresume - 热禁用:在 web profile
cordis.patch.yml给dsh-autoresume入口加disabled: true。