前言¶
用 DeepSeek Harness（DSH）跑长任务时，常见情况是：浏览器在前台，但操作系统仍会在空闲一段时间后熄屏或进入休眠。任务若由 DSH 后端继续执行，主机一旦休眠，网络与进程行为可能受影响，排查也不直观。靠手动改系统电源策略，或装全局防休眠工具，往往要管理员权限，且和「只有任务在跑时才需要保活」的需求对不齐。
下面介绍社区插件 dsh-keep-awake（npm 包名 @zi7tian/dsh-keep-awake）：在 DSH 判定有活跃任务时，通过各平台原生电源断言保持运行 DSH 后端的设备清醒；任务全部结束后自动释放，不长期占用系统策略。
这是什么¶
dsh-keep-awake 是 DSH 的客户端类插件，维护者为 zi7tian。它解决的是：AI 任务运行期间，让承载 DSH 后端的主机尽量不因系统休眠而中断或变难观测；保活逻辑由 DSH 后端协调，而不是依赖当前网页是否在前台。
插件当前版本为 0.4.1（MIT 许可证），针对 DSH 0.2.0-rc.2 开发。目录页：SkillHub - dsh-keep-awake；源码与说明：GitHub - zi7tian/dsh-keep-awake。
核心功能¶
后端驱动的保活范围¶
保活由 DSH 后端控制，支持多个会话和子 Agent。关闭网页或把浏览器切到后台，不会因此停止对已运行任务的保活；与「只在前台 tab 里阻止休眠」的做法不同。
侧边栏控制¶
安装并在 Web 端启用后，侧边栏设置同一行会出现太阳图标。点击可查看状态、当前运行任务数量，以及手动开启或关闭保活。
原生接口、普通用户权限¶
插件使用普通用户权限下的临时电源断言，不需要管理员权限，不修改全局电源设置，也不模拟鼠标或键盘：
| 平台 | 机制 |
|---|---|
| Windows | Power Request |
| macOS | IOKit |
| Linux | D-Bus ScreenSaver 与 logind |
若系统接口不可用，界面会反映部分生效或失败状态。保护对象是运行 DSH 后端的设备；手动锁屏、合盖以及系统强制策略仍可能覆盖保活效果。
生命周期¶
保活作用域为当前 DSH 进程；进程重启后保活默认再次开启。插件停止或 DSH 宿主退出时会释放电源请求。
文档说明：Linux 已实机验证；Windows 与 macOS 已实现，尚待实机验证。
安装与启用¶
DSH 生态里插件可通过 npm、GitHub 或本地链接安装；以下命令均来自项目 README。
从 npm 安装（推荐）¶
dsh plugin --profile web add @zi7tian/dsh-keep-awake
从 GitHub 安装¶
dsh plugin --profile web add github:zi7tian/dsh-keep-awake
本地开发与链接安装¶
若需从源码目录链接安装，先在本地克隆仓库并完成依赖安装，再将 link: 路径换成你的绝对路径（Windows 使用对应本地路径）：
git clone https://github.com/zi7tian/dsh-keep-awake.git
cd dsh-keep-awake
npm ci
dsh plugin --profile web add link:/absolute/path/to/dsh-keep-awake
插件依赖 Koffi（package.json 中为 3.3.2），安装时会拉取适合当前平台的原生组件。Linux 还需系统提供 libdbus-1 及相应会话服务。
安装或升级后，应等待当前任务结束，重启 dsh web 并刷新页面。设置旁出现太阳图标，表示控制面板已加载。桌面版请通过其插件管理器安装。
卸载¶
dsh plugin --profile web remove @zi7tian/dsh-keep-awake
典型用法¶
日常使用中通常无需额外配置文件：安装并重启 Web 端后，有活跃任务时后端会自动申请保活，任务结束后释放。
需要人工干预时：
- 打开 DSH Web 侧边栏，在设置同一行找到太阳图标。
- 点击查看当前保活状态与运行任务数量。
- 按界面选项开启或关闭保活（例如在调试电源行为时临时关闭）。
适用场景与注意¶
适合谁： 在笔记本或台式机上本地跑 DSH 后端、任务耗时较长、又不想全局改电源方案或常驻第三方防休眠软件的用户。
权限与安全： 插件以当前 dsh 进程 的权限运行，会通过原生 API 申请临时电源断言。安装前建议阅读 仓库源码 与 MIT 许可证，确认符合你的环境策略。
边界： 保活针对系统休眠/屏保类行为，不能替代对锁屏、合盖休眠、企业 MDM 策略的约束。多平台实现进度以 README 为准。
生态说明： DSH 采用「一切皆插件」的扩展方式；SkillHub 等为社区目录站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的是社区维护的插件，而非官方应用商店条目。
结尾¶
dsh-keep-awake 把「有任务才保活、无任务就释放」接到 DSH 后端任务生命周期上，并用各平台原生电源断言实现，侧边栏太阳图标提供状态与开关。若你经常在本地 DSH 上跑长任务，可以按上文命令安装，重启 dsh web 后在设置旁确认图标是否出现。
- 目录页：https://www.skillhub.cn/plugins/zi7tian/dsh-keep-awake
- GitHub：https://github.com/zi7tian/dsh-keep-awake
