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

跨平台（v0.0.19，2026-09-09）：插件本体已跨平台——源码用 Node os.homedir() + node:path 解析家目录与路径分隔（Linux/macOS: ~ 与 /，Windows: %USERPROFILE% 与 \），行为完全一致；本 README 里所有 <home> 占位符即指用户家目录，请按你实际系统替换。 **全域模式（v0.0.5，2026-08-23）**：web 重启后，**任何被重启中断任务的会话**都会自动继续——扫描 <home>/.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，底层即 <home>/.dsh/sessions/<cwd>/<id>/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 商汤日日新裁决：允许连续两次，第二次失败后停）；余额类不受此限制（一次即停）

安装与验证

前置：依赖链接（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：<npm-global>/@deepseek-ai/dsh/node_modules/@deepseek-ai/dsh-agent，其中 <npm-global> 通常为 %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。