完成即关机 ypx01/dsh-auto-shutdown

dsh-auto-shutdown — 每会话「任务完成后自动关机」开关

English: README.en.md

给 DSH 的每个会话在标题栏右侧加一个开关：

| 开关 | 行为 |
| 关（默认） | 任务全部执行完后什么都不做 |
| 开 | 本会话（以及所有也开了开关的会话）手上的活全部执行完 → 倒计时 → 电脑自动关机 |
| 多个会话都开 | 必须全部会话都完成才关机；任何一个还在跑就等 |

- 新建会话默认是关。
- 开关状态不落盘：DSH 重启后全部复位为关（重启后不会莫名其妙关机）。

它怎么判断「任务执行完了」

不是猜的，也不是数事件，而是直接问 harness 自己：

await ctx.waterfall('workspace/session-activity', { sessionId }, () => [])
// [] => 这个会话没活干了

这是 DSH 用来「拒绝归档还有活干的会话」的同一个判据，已经汇总了四类活动源： turn（正在跑的一轮对话）、job（后台任务）、subagent（子代理）、schedule（定时/计划中的执行）。
所以子代理没跑完、后台 job 还在转，都不会被误判成「完成」。

事件订阅（session/event / api-session/status）只作为瀑布不可用时（例如手动重载插件）的降级路径，另外负责在会话一有动作时立刻取消倒计时。

三级可反悔

1. 冷静期（默认 120 秒）：所有目标会话都空闲后开始倒计时，按钮上会显示 118 秒后关机，点一下即可取消。
倒数期间任何会话重新开始干活，倒计时自动作废。
2. 系统倒计时（默认 20 秒）：冷静期到点后执行 shutdown.exe /s /f /t 20。
此时按钮变成红色的 正在关机 18 秒，点它等于执行 shutdown.exe /a 撤销。
3. 真正关机。

判定范围（可配置）

默认 requireGlobalQuiet: true：除了开了开关的会话，其它任何在线会话（包括子代理会话）也都要空闲，才会关机——避免出现「A 会话挂了自动关机，结果把 B 会话正在写的稿子关掉」。
只想看开了开关的会话，把它设为 false。

安装

插件目录：D:\deepseek-workspace\plugins\dsh-auto-shutdown

用 plug-in manager 装本地目录（软链，改了源码重载插件即生效）：

plugin_manager { action: "install_bundle", target: "D:\\deepseek-workspace\\plugins\\dsh-auto-shutdown" }

装完刷新 Web GUI（地址以 dsh web 启动时打印的为准，形如 http://127.0.0.1:6673），会话标题栏右侧应出现「自动关机」按钮。

配置

cordis.patch.yml 里的 config（也可直接在 profile 的组合里覆盖）：

| 键 | 默认 | 说明 |
| countdownMs | 120000 | 冷静期毫秒数（最小 1000） |
| shutdownGraceSeconds | 20 | 真正调 shutdown /t N 的 N，期间可 /a 撤销 |
| requireGlobalQuiet | true | 是否要求所有在线会话都空闲 |
| force | true | 是否加 /f 强制结束阻止关机的程序（不加可能卡在确认界面，自动化就白做） |
| dryRun | false | 只演练不真关机，日志里记录将要执行的命令 |
| ignoreKinds | [] | 不想让某类活动阻止关机时填，如 ["schedule"] |
| debug | false | 同时打到 stdout |
| logFile | .dsh/auto-shutdown.log | 日志路径；填 null 关闭落盘（测试用） |

日志：%USERPROFILE%\.dsh\auto-shutdown.log（JSON 行，含每次 arm/disarm/倒计时/下发命令/撤销）。

自检

16 项离线状态机测试（假 ctx，不发真关机）
node D:\deepseek-workspace\plugins\dsh-auto-shutdown\test\state-machine.test.mjs

11 项客户端冒烟测试（真跑 client.js，检查每种状态下的文案与请求体）
node D:\deepseek-workspace\plugins\dsh-auto-shutdown\test\client-smoke.test.mjs

运行时只看判定、不触发（<port> = dsh web 打印的端口，下同）： GET http://127.0.0.1:<port>/api/auto-shutdown/probe

运行时验证「下发链路真的通」（只起子进程，不改电脑状态）： POST http://127.0.0.1:<port>/api/auto-shutdown/self-test {"realShutdown":false} → 跑 cmd /c exit 7，返回 exitCode 7 即证明 spawn + cwd 正常

probe 里两类字段最有用：

- blocking / otherBusy：谁还在忙、忙的是哪一类（turn / job / subagent / schedule）。空 = 随时可以关机。
- stats.clientAlive：最近 15 秒内浏览器有没有在轮询 /state。它证明「按钮真的加载并活着」，不需要看 UI 也能自检。

HTTP 面（仅供本机 UI 使用）：

| 方法 | 路径 | 用途 |
| GET | /api/auto-shutdown/state?sessionId= | 全量状态（含倒计时、阻塞原因） |
| GET | /api/auto-shutdown/probe | 只算判定，不改任何状态 |
| POST | /api/auto-shutdown/set | {sessionId, armed} |
| POST | /api/auto-shutdown/cancel | 撤销倒计时 / shutdown /a |
| POST | /api/auto-shutdown/self-test | {realShutdown}：真起子进程验证下发链路；true 会下发 shutdown /s /t 6000 并在 1.5 秒后 /a |

开发注意（踩过的坑）

- ctx.subprocess.spawn(spec) 的 cwd 是必填的（2026-10-26 修）：harness 的
validateNoNullByte("options.cwd", spec.cwd) 会对 cwd 直接调 .includes("\0")，
缺省即 TypeError: Cannot read properties of undefined (reading 'includes')。
类型声明里 cwd 看起来可省，实现里不行——所以 spec 一律显式给 cwd。
- 下发失败绝不能静默关掉开关：早期的 fire() 先 armed.clear() 再 spawn，spawn 抛错后开关已经没了、pending 也没设，用户看到的就是「倒计时结束 → 按钮变回关闭 → 电脑没关」。
现在只有 spawn 成功才清开关并进入 pending；失败保留开关、写 lastError，按钮显示「关机失败」。
- apply 的返回值不会被当作 disposer：cordis 只执行 ctx.effect(fn) 返回的清理函数。
卸载/重载必须靠 ctx.effect，否则旧路由留在 webServer 里，再次启用会撞 duplicate prefix route，并且旧 handler 会闭包住已死的 core（僵尸路由）。
本插件用模块级 state.core + 统一 dispatch 派发：残留的旧路由也只会指向新实例，插件未激活时返回 503。
- host 的 index.js 不会热重载：改完要禁用再启用这一行（plugin_manager set_plugin， target 用 include:auto-shutdown 这个 entryId，不是包名），或者在会话里重启 DSH。
- 客户端模块同样要重新下发：装好后刷新页面才会加载 client.js。
- CLI 接口没有鉴权限制（仅本机可用），所以不要把这个前缀暴露到公网。

已知边界

- 仅 Windows（非 Windows 会显示「仅支持 Windows」并拒绝开启）。
- DSH 进程必须活着：它是执行关机的那一方；退出 DSH 就等于放弃这次自动关机。
- 开关不持久化（见上）。要在重启后也生效，需要接 ctx.storageDomain，目前刻意没做——重启后自动关机是更危险的行为。
- requireGlobalQuiet: false 时，若其它会话正在跑长任务，到点会照样关机；反过来 true 且某个会话卡在「一直有活」的状态，会一直不关机（probe 会告诉你是谁、为什么）。