dsh-shutdown-after-task

Readme

# dsh-shutdown-after-task

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

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

[English](README.en.md)

## 功能

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

## 安装

npm（推荐，已发布）：

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

或从 GitHub：

```sh
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`（或设置 > 插件配置）：

```yaml
- 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 <countdownSec + marginSec>` |
| 取消方式 | GUI 取消按钮（退出模式）/ 倒计时内发新消息（保持模式） |
| 状态查询 | `GET http://127.0.0.1:<port>/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 响应注入）

## 卸载

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

## 致谢与参考

- 事件挂接参考 [yang040709/dsh-win-toast-notify](https://github.com/yang040709/dsh-win-toast-notify)（MIT）
- 插件结构参考 [keyiadiannao/dsh-power-button](https://github.com/keyiadiannao/dsh-power-button)（MIT）

## License

MIT