virggle/dsh-shutdown-after-task

dsh-shutdown-after-task

任务完成后自动关机 —— DeepSeek Harness 插件（零依赖，Windows）。

跑长任务（批量迁移、模型生成、过夜任务）时，点一下右下角的「任务完成后关机」按钮，
任务成功完成后电脑自动关机；倒计时期间可一键取消。

English

功能

- 右下角浮动文本按钮（可拖动）：点击切换「任务完成后关机」模式（默认关闭，绝不自动武装）；拖到任意位置，位置自动记住
- 自动避让：其他插件的角落弹窗（如价格提示）与按钮重叠时，按钮自动让开，弹窗消失后归位
- 可取消倒计时：任务完成 → 60 秒倒计时横幅（实时剩余秒数）+「取消关机」按钮
（POST /cancel → shutdown /a）——不依赖系统层那个无法取消的通知；横幅跟随按钮位置
- 新任务打断：倒计时期间任一会话开始新任务 → 自动撤消关机，模式保持开启
- 取消即退出：点「取消关机」= 取消本次关机 + 退出模式（下个任务不再触发）
- 仅成功时关机：本批次有会话出错则不关机，横幅提示原因，模式保持开启
- 多会话判定：全部 root 会话空闲才算任务完成（子代理并入其 root 统计）

安装

npm（推荐，已发布）：

dsh plugin --profile web add dsh-shutdown-after-task

或从 GitHub：

dsh plugin --profile web add github:virggle/dsh-shutdown-after-task

重启 DSH 后生效：右下角出现按钮。若按钮未出现，刷新页面（Ctrl+R）。

也支持本地路径 / tarball 安装：dsh plugin --profile web add ./dsh-shutdown-after-task

使用

1. 点右下角「任务完成后关机」→ 按钮变黄（已开启）；按钮可拖到任意位置
2. 正常跑任务
3. 全部会话空闲且无错误 → 按钮上方弹出倒计时横幅
4. 倒计时内点「取消关机」→ 本次关机取消、模式退出；不点则到点关机

配置

编辑 profile 的 cordis.patch.yml（或设置 > 插件配置）：

- id: dsh-shutdown-after-task
config:
countdownSec: 60      # 倒计时秒数（10–600，默认 60）
marginSec: 5          # 系统 shutdown /t 额外余量（0–60，默认 5）
onlyOnSuccess: true   # 仅成功时关机（false = 完成即关，含出错）

行为细节

| 项 | 说明 |
|---|---|
| 触发时机 | 模式开启后，全部 root 会话从 running 回到 idle |
| 成功判定 | 本批次无 agent/error（仅 onlyOnSuccess: true 时） |
| 倒计时 | countdownSec 秒，GUI 横幅实时显示，可点「取消关机」 |
| 系统指令 | 倒计时开始时执行 shutdown /s /t  |
| 取消方式 | GUI 取消按钮（退出模式）/ 倒计时内发新消息（保持模式） |
| 状态查询 | GET http://127.0.0.1:/api/dsh-shutdown-after-task/state |

运行日志

$DSH_HOME/dsh-shutdown-after-task.log（挂载、武装、触发、取消全记录）。

工作原理

- 纯配置层 cordis 插件：webServer.tapIndex 把 UI 脚本注入每次 index 响应，
宿主 HTTP 路由提供状态与操作——无需 client bundle、无需构建
- 事件依据 agent/status / agent/error（见 @deepseek-ai/dsh-agent runtime-types）
- 卸载时自动注销路由与注入（fiber disposer）

已知限制

- 仅 Windows：执行 shutdown.exe；其他平台插件保持惰性并记日志
- 模式状态在内存中：DSH 重启后默认关闭，需重新点按钮
- root 会话 idle 但 inbox 有排队消息时也会触发（按「全部 root 空闲」判定）
- 页面需刷新一次才出现按钮（脚本随 index 响应注入）

卸载

dsh plugin --profile web remove dsh-shutdown-after-task

致谢与参考

- 事件挂接参考 yang040709/dsh-win-toast-notify（MIT）
- 插件结构参考 keyiadiannao/dsh-power-button（MIT）

License

MIT