dsh-keep-awake

DeepSeek Harness 防休眠插件（界面跟随 DSH 全局语言）

任意 agent / subagent / 后台任务运行时阻止系统休眠 · 全部空闲后按宽限期自动释放 · 手动保持唤醒 · 可选阻止屏幕关闭 · Windows / macOS / Linux · 设置持久化 · 多语言 Web 设置页

English | 中文

功能总览

| 功能 | 位置 | 说明 | |---|---|---| | 实时状态 | 设置页「防休眠」 | 状态徽章（保持唤醒中 / 宽限中 Ns / 待机 / 已停用 / 助手异常）、运行中 agent 数、后台任务数、辅助进程平台 + PID | | 活动判定 | — | 运行中的 agent（主 agent / subagent / workflow 子代理）+ 运行中的后台任务（run_in_background 命令 / 后台 subagent 任务） | | 宽限期 | 设置页可配 | 全部活动结束后 15s–5m（默认 60s）自动释放防休眠 | | 手动保持 | 设置页 | 无视活动状态强制保持唤醒，点击取消 | | 阻止屏幕关闭 | 设置页可选 | 默认只防系统休眠、允许熄屏；勾选后屏幕也保持 | | 多语言 | 全局 | 跟随 DSH 全局语言（zh/en），未显式设置时跟随浏览器/系统，切换即时生效（含侧边栏标签） |

工作原理

每 5 秒轮询 + 事件即时重扫（agent/status、subagent/start|end、job 集变更）：

• 运行中的 agent：agents.list() 中 status === 'running' 的 agent（覆盖主 agent、subagent、workflow 子代理）
• 后台任务：jobs.list() / jobs.list(agent) 中 running/stopping 的任务（覆盖 run_in_background 命令与后台 subagent 任务）

检测到活动时通过 subprocess 服务启动一个平台辅助进程（树级终止，进程退出即释放休眠标志）：

| 平台 | 机制 | |---|---| | Windows | PowerShell SetThreadExecutionState(ES_CONTINUOUS \| ES_SYSTEM_REQUIRED)（勾选“同时阻止屏幕关闭”时加 ES_DISPLAY_REQUIRED） | | macOS | caffeinate [-d] -i -s | | Linux | systemd-inhibit --what=idle --mode=block sleep 1e8 |

设置

持久化在 profile 的 settings.yaml（namespace keep-awake）：

| 键 | 默认 | 说明 | |---|---|---| | enabled | true | 总开关 | | graceMs | 60000 | 全部活动结束后的宽限期（15s–5m） | | preventDisplaySleep | false | 同时阻止屏幕关闭 | | manualHold | false | 手动保持唤醒 |

多语言

界面使用框架 locale 服务（namespace keep-awake，zh/en 字典）：未显式设置语言时自动跟随浏览器/系统语言；在 DSH 语言设置中切换后即时生效（设置页正文与侧边栏标签均跟随）。

HTTP 路由（loopback）

• GET /dsh-keep-awake/state — 当前状态（活动计数、助手进程、配置）
• PUT /dsh-keep-awake/config — 更新配置，body { "section": {...} }

安装

# 在 profile 目录内（如 ~/.dsh/profiles/web）
pnpm add "dsh-keep-awake@<来源>"   # npm / github:bearice/dsh-keep-awake / link:<本地路径>
# 并把 "dsh-keep-awake" 加入 package.json 的 dsh.profile.bundles
pnpm install
# 重启 profile

开发

• 本地开发建议以 link: 方式挂入 profile（见上方安装步骤），node --check lib/*.js 做语法校验
• 包结构：lib/index.js（Host）、lib/client.js（Web 设置页）、cordis.patch.yml（挂载行）