dsh-autoresume — dsh 会话重启自动续跑插件

web 进程重启后，若目标会话停在"被打断的中间态"（open turn / 无结果的 tool call / turn/end interrupted）， 自动向该会话注入一条「继续」，让 agent 接着干活——无需人工干预。

特性

• 只服务一个配置的 targetSessionId，绝不扫描其他会话
• 通过 ctx.sessionPersistence.inspect() 读取会话持久化事件流做状态判定
• 判定逻辑：

- interrupted（注入「继续」）：turn/step 打开未闭合、存在无对应 tool/result 的 tool/call、最后一个 turn/end 原因为 interrupted - completed（不动作）：最后是 assistant/message，或 turn/end 为 completed 且其后无新用户消息 - settled（不动作）：cancelled / error 等已闭合终态；以及闭合轮次后出现的手动用户消息

• 注入方式：ctx.agents.get(target) → agent.followup(userMessage)（消息 source.kind=plugin, form=notice）
• 进程级一次性：每个 web 进程只判定/注入一次；bootGraceMs 宽限窗口内有效（profile HMR 装卸插件不误触发）
• 目标会话未就绪时按 pollIntervalMs 重查

安装

# 1. 构建
npm run build

# 2. 注册到 web profile
dsh plugin --profile web add /path/to/dsh-autoresume

# 3. 配置目标会话（编辑 web profile 的 cordis.patch.yml）
- insert:
    - id: dsh-autoresume
      name: 'dsh-autoresume'
      config:
        targetSessionId: '<your-session-id>'   # 必填

# 4. 验证注册
dsh --profile web --dump-config   # 应出现 id: dsh-autoresume

# 5. 重启生效
sudo systemctl restart dsh-web

配置项

工作原理

web 重启 → 插件加载 → 宽限窗口内 inspect(目标会话)
  ├─ interrupted → agent.followup('继续（自动）') → 自动接续
  ├─ completed / settled → 不动作（避免重复注入）
  └─ 会话未就绪 → 5s 后重查

架构

src/
├── service.js    # 服务端：状态机判定 + 注入（构建到 lib/）
└── client.js     # 客户端占位（构建到 lib/）
scripts/
├── build.mjs     # 构建：src → lib
└── self-test.mjs # 状态机单测（9 用例）

开发

npm run build   # src → lib
npm test        # 状态机自测

故障排查

卸载

dsh plugin --profile web remove dsh-autoresume

License

Apache-2.0