任务后电源控制 white-sparrow/dsh-power-after-task

dsh-power-after-task

当前智能体任务结束后，让 Windows 睡眠 / 关机 / 重启——一个紧凑的 DeepSeek Harness 插件，默认关闭。

它不会自己动手：只有你按下 Arm、智能体确实停止工作、宽限倒计时走完，电源命令才会执行。任何时候按 Cancel 都会回到关闭状态。

环境要求

- Windows 主机——电源命令只适用于 Windows；其他平台会直接报错拒绝。
- Web 组合（dsh web）：停靠栏控件通过插件自己的 HTTP 路由与 Host 通信；Desktop 页面没有 Web 服务器，所以那里不会出现控件。
- Harness Host 需要 Node 20+。无需构建步骤，无依赖。

安装与启用

Plugin Manager → Install bundle → dsh-power-after-task

bundle 的补丁插入插件行时带 disabled: true，所以安装不会改动其他任何东西。需要时到 Settings → Plugins → Power after task 启用；停靠栏入口约两秒内出现，禁用该行（同时清空所有待执行的 Arm）后入口又会消失——不用刷新页面。

界面

输入框停靠栏里有一个入口，就在 Activity 和 Usage 旁边：

- Idle——只有一个小电源图标。
- 点击——就地展开成两个下拉框（Action、Grace）和一个 Arm 按钮。
- Armed——图标缩小并亮起（等待时用品牌色，倒计时时用琥珀色），出现 Cancel 按钮；悬停显示动作 + 剩余时间。按设计不显示状态文字。

倒计时进行中，一条宽幅半透明横幅（注册在 shell.overlay）会显示大号 m:ss.mmm 计时器、一行小字 Until sleep / Until shut down / Until restart，以及 Cancel 按钮。这一层可点击穿透——只有 Cancel 接收指针事件——电源命令失败时横幅保持可见并显示错误。

所有颜色都用 --dsw-alias- 主题 token，所以深色/浅色自动跟随 Harness 主题。

任务何时算完成

任务指从你发出提示词到智能体这一轮停止的整段过程——跨步骤、续跑和子代理。智能体给出回答、出错且没有结果、或你取消，都算完成；已 Arm 时会话被归档/移除也算。目标驱动或续跑还在运行时不会触发，任何新消息都会把倒计时退回等待。检测用的是会话状态信号（api-session/status），不是猜测。

Arm → waiting → agent goes idle → grace countdown → power command
↑ new activity returns here Cancel → off
Grace（默认 45 秒，可选 15 秒 / 30 秒 / 1 分 / 2 分 / 5 分，上限 3600 秒）是「任务结束」到「执行电源操作」之间可取消的等待窗口，留足时间救回误点或未保存的工作。

执行的命令：shutdown.exe /s /t 0、shutdown.exe /r /t 0，或通过 kernel32!ApplicationSuspend 进入睡眠（刻意不用 rundll32 SetSuspendState，因为开启休眠后它会转成休眠；rundll32 只作兜底）。

智能体工具

power_after_task —— action: status | arm | cancel | execute、session、power: sleep | shutdown | restart、grace_seconds。execute 立即触发，HTTP 路由无法调用它；页面只能 Arm 和 Cancel。

配置

在 cordis.patch.yml 中设置（可用你自己的补丁覆盖）：

| 键 | 默认值 | 含义 |
| defaultAction | shutdown | 预选动作：sleep · shutdown · restart |
| graceSeconds | 45 | 结束后的倒计时；上限 3600 |

安全

Arm/Cancel 会拒绝那些能证明*自己不是本页面的请求：非回环 Host（DNS 重绑定）、浏览器上报的跨站 Sec-Fetch-Site、非回环 Origin。不带这些证据的请求放行——那是 Harness 页面传输（它转发 Cookie，但不转发 fetch 元数据），或者本地进程，而本地进程本来就能直接跑 shutdown.exe。路由：POST /power-task/arm、POST /power-task/cancel、GET /power-task/state、GET /power-task/debug。见 SECURITY.md。

文件

| 文件 | 作用 |
| index.js | 宿主侧：/power-task 路由、会话监听、倒计时、Windows 电源命令、工具 |
| client.js | UI 侧：输入框停靠区控件 + shell.overlay 倒计时横幅 |
| cordis.patch.yml | 插件行，默认禁用，带 config |
| locale/en.json、locale/fa.json | 插件管理器的标题/描述 |
| icon.svg | 插件管理器图标 |

故障排查

| 现象 | 处理 |
| 没有停靠区入口 | 插件行被禁用——到 设置 → 插件 里启用 |
| Arm 返回 403 | 看 GET /power-task/debug → lastPost：host、secFetchSite、origin、accepted。host 非回环说明走了代理或用了外部主机名 |
| 升级后横幅不见了 | 刷新一次页面，加载新的客户端 bundle |
| 横幅显示 … failed | 命令被拒绝——电源设置、休眠/快速启动、关机权限；Cancel 可清除状态 |
| 什么都不触发 | 会话还在跑（目标续跑、子代理、排队消息） |

开发与发布

见 CONTRIBUTING.md —— 检查（npm run check）、本地调试，以及分阶段的 npm 发布流程。

许可证

MIT —— 见 LICENSE。