重启自动续跑shengyvself/dsh-autoresume

dsh-autoresume（重启后自动继续）

自动继续恢复链路修复（v0.0.20＋v0.0.21，2026-09-13，用户实报「自动继续没有在这里生效」）：① 0.1.5 的 ctx.sessionPersistence 移除了 inspect()（旧调用每次都抛、异常只进 logger.warn 不进 journal）→ 改 open(id,'read')／read()／close()。② 0.1.5 的 AgentSetup 回调签名变为 (agentCtx, agent)，旧代码读 agentCtx.agent 会抛错使 agents.resume() 整体 reject → 会话被部分挂起但不注入「继续（自动）」；现按新签名传参、缺失时显式报错。
会话读取契约修复（v0.0.20，2026-09-13）：DSH 0.1.5 的 ctx.sessionPersistence 移除了 inspect()（只剩 create/open/flush/stat/list），旧调用每次都抛、异常只进 logger.warn 不进 journal → 重启后自动继续静默失效。现改为 open(id,'read') → handle.read() → handle.close()（会话不存在则不动作）。
队列守卫（v0.0.19，2026-09-13，用户实报 bug 修复）：inbox 里若有别人（用户/客户端）的挂起消息，插件一律不动作——既不注入「继续（自动）」也不 resume。旧行为下 send(..., wakeup=true) 会把挂起的用户消息一并唤醒冲进会话，而我们这条「继续」排在其后表现为「进入排队」。判据双路：持久化流 agent/inbox/spliced 折叠（未 resume 路径）＋ 活体 agent.inbox.nextTurn/nextStep（已在线路径）；skipWhenInputPending: false 可关闭（回到旧行为）。
DSH 0.1.5 会话代际（v0.0.19）：0.1.5-rc.2 起当前代际会话日志为 session.v3.jsonl.zstd（session.jsonl.zstd 为历史代际），扫描按代际取最高。
跨平台（v0.0.19，2026-09-09）：插件本体已跨平台——源码用 Node os.homedir() + node:path 解析家目录与路径分隔（Linux/macOS: ~ 与 /，Windows: %USERPROFILE% 与 \），行为完全一致；本 README 里所有  占位符即指用户家目录，请按你实际系统替换。
全域模式（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 及 429 直出码 rate_limit_exceeded/too_many_requests，或消息命中网络特征如 upstream error/429/5xx/timeout/fetch failed/ECONNRESET/service temporarily unavailable；支持 DSH/OpenAI 风格错误信封 {error:{code,type,message}}（含 type=service_unavailable））同样注入「继续（自动）」让其自动重跑；配置/模型类错误（UNKNOWN_MODEL/MISSING_CREDENTIAL/NO_ADAPTER 等）维持 settled 不注入，避免死循环。
504/网关超时强化（v0.0.12，2026-08-31）：错误信封解包改为递归（任意深度 {error:{...}} 嵌套、failure 负载字段均剥到最内层），NETWORK_FAILURE_PATTERN 补 gateway time-?out 特征——外部环境 504 Gateway Time-out（ALB 网关超时 HTML）无论以单层/多层信封、带/不带状态码数字呈现均正确判 network-stopped 注入。
OpenRouter 上游 provider 故障（v0.0.13，2026-08-31）：NETWORK_FAILURE_PATTERN 补 provider returned error 特征——OpenRouter 对上游 provider（如 minimax）故障的标准文案（pi-ai adapter 兜底归类 PI_AI_ERROR，属瞬时上游故障、同 provider 稍后可恢复）同样判 network-stopped 注入。
402/400/中文瞬时可继续（v0.0.15，2026-09-01）：① 402/余额类（QUOTA/insufficient_balance/payment_required/402/insufficient balance）注入后再次以余额类错误失败一律转 settled——余额不足是持久性状态（充值/换 provider 前每次调用必失败），防「真没余额」时自动继续无限循环（此前 usage/finish 元数据被误计为产出导致 loop-guard 失效）；首次 402 仍注入一次（覆盖充值后恢复）。② 400 status code (no body)（tokenrhythm 兜底形态）与中文瞬时特征（模型服务暂时不可用/请稍后重试/当前繁忙 等）判 network-stopped 注入；新增 PERMANENT_LLM_CODES 排除永久码（UNKNOWN_MODEL/CONTEXT_WINDOW_EXCEEDED 等）——上下文超限即使携带 400 message 也 settled 不注入。
启动崩溃修复（v0.0.16，2026-09-01）：ctx.agents 是惰性注入服务，在插件上下文未活性/服务注入未就绪时直接访问会触发 cordis inactive context 守卫拦截 → 插件树加载 fatal 崩溃循环（DSH 0.1.2-alpha.3 升级后实证）。checkOnce()/injectIfIdle() 改用防御助手 getAgent()（try/catch 捕获异常 → warn 降级 → 返回 undefined，下轮 poll 重试），不再中断插件树加载。
tpm/rpm 限流识别（v0.0.17，2026-09-02）：sensenova 429 直出 code=insufficient_quota、type=rate_limit_error、message inference exceeds tpm/rpm limit——限流窗口重置后可恢复，属瞬时网络故障，判 network-stopped 注入「继续（自动）」（修复前三路特征全漏判 settled 不注入）。insufficient_quota 由余额类移入瞬时可重试类；DSH 把 429 包装成外层 code=QUOTA（message 内嵌 429/rate_limit_error/insufficient_quota）的形态亦覆盖——isBalanceFailure 新增限流消息特征先行仲裁（余额类仍为 QUOTA/insufficient_balance/payment_required/402 特征，防无限循环语义不变）。
连续两次自动继续（v0.0.18，2026-09-08，商汤日日新裁决）：网络瞬时类失败（429/限流等）在注入「继续（自动）」后再次失败且无产出时，允许再注入一次（maxResumeAttempts 默认 2，即「注入→败→再注入→败→停」），适配商汤日日新限流窗口长、常连续两次 429（rpm exhausted / tpm-rpm limit）的场景；余额类（402/QUOTA 等）保持「注入后再次失败一次即停」防无限循环（v0.0.15 语义不变）。新形态识别：type=quota_exceeded_error、message rpm exhausted/tpm exhausted、数字码 8/429001 均判 network-stopped 注入。
兼容模式：配置 targetSessionId 时退化为旧行为（只服务该会话）。
运行期间再次网络失败（v0.0.9，2026-08-24）：liveWatch（默认 true）使插件在 boot 扫描后保持轮询，补 catch 同一会话在运行期间再次以网络/瞬时失败停止（此前只有在 web 重启后才一次性生效）；并加死循环守卫——若上次注入「继续」之后未产生任何内容/工具调用便再次以同类网络错误失败（模型持续返回空内容，例如某些强制推理的隐身模型），判定为持续故障转 settled 不再注入，交由用户手动处理；会话之后有产出或新用户消息则重新武装。

行为
- 通过 ctx.sessionPersistence.inspect() 读取目标会话的持久化事件流（dsh-session 官方 API，底层即 /.dsh/sessions///session.jsonl.zstd 的平衡视图；路径分隔由 Node 的 node:path 按平台自动处理）。
- 判定被打断：turn/step 打开未闭合、存在没有对应 tool/result 的 tool/call、或最后一个 turn/end 原因为 interrupted。
- 判定网络故障停止：最后一个 turn/end 原因为 error 且错误属网络/瞬时故障（错误码在 DSH 可重试集合（含 429 直出码 rate_limit_exceeded）或 type=service_unavailable，或消息命中网络特征正则 NETWORK_FAILURE_PATTERN（含 OpenRouter 上游 provider 故障文案 provider returned error，支持 {error:{...}} 信封解包））→ 同样注入「继续（自动）」；配置/模型类 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 | Infinity | web 进程启动后允许判定的宽限窗口（v0.0.10 起默认永久不睡；可显式配数值回归旧行为） |
| initialDelayMs | 3000 | 首次检查延迟（等会话恢复） |
| pollIntervalMs | 5000 | 会话未就绪时的重查间隔 |
| promptText | 继续（自动） | 注入正文 |
| liveWatch | true | boot 后保持轮询补 catch 运行期间再次网络/瞬时失败；配 loop-guard 防模型持续空返回死循环 |
| maxResumeAttempts | 2 | 网络瞬时类失败连续自动继续次数上限（2026-09-08 商汤日日新裁决：允许连续两次，第二次失败后停）；余额类不受此限制（一次即停） |
| skipWhenInputPending | true | 队列守卫（2026-09-13）：inbox 有非我方挂起消息时不注入、不 resume；false 回到旧行为 |

安装与验证

前置：依赖链接（v0.0.4 起）

依赖 @deepseek-ai/dsh-agent。npm 直装会 peer 冲突（dsh-brand rc.8 vs rc.2），
用符号链接复用 DSH 运行时同一份（版本零漂移）。DSH 全局安装路径：
- Linux：/usr/lib/node_modules/@deepseek-ai/dsh/node_modules/@deepseek-ai/dsh-agent
- macOS（Homebrew/全局 npm）：同 Linux 路径；若 npm root -g 输出不同请以此为准
- Windows：/@deepseek-ai/dsh/node_modules/@deepseek-ai/dsh-agent，其中  通常为 %APPDATA%/npm，可用 npm root -g 确认

Linux / macOS
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

Windows PowerShell（管理员）
New-Item -ItemType Directory -Force node_modules\@deepseek-ai | Out-Null
$target = Join-Path (npm root -g) "@deepseek-ai\dsh\node_modules\@deepseek-ai\dsh-agent"
cmd /c "mklink /D node_modules\@deepseek-ai\dsh-agent $target"

构建 + 加载

npm run build
node --input-type=module -e "import('./lib/service.js').then(()=>console.log('loads ok'))"
dsh plugin --profile web add /path/to/dsh-autoresume   # 替换为实际插件目录（Windows 用 \\ 分隔）
dsh --profile web --dump-config                         # 应出现 id: dsh-autoresume、name: dsh-autoresume

装完不要立即重启；等开发完成后再重启 DSH web 服务生效（按你安装方式选一条）：
- Linux（systemd）：sudo systemctl restart dsh-web
- macOS（Homebrew services）：brew services restart dsh-web；或 launchctl kickstart 视安装方式
- Windows（PowerShell 管理员）：Restart-Service dsh-web；或任务管理器手动重启 DSH 进程
实测（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。