前言¶
DeepSeek API 按峰谷价计费：工作日北京时间 09:00–12:00、14:00–18:00 为高峰价，约为低谷价的两倍；午休、夜间、周末与法定节假日为低谷价。官方价目见 DeepSeek 定价说明。Harness 里的 Agent 常会连续跑数小时，若不做干预，很容易在高峰时段持续消耗 token。
手动盯表停任务既费事又容易漏。下面介绍 dsh-peak-guard（维护者 Aily-DSH，GitHub 仓库 Aily-DSH/dsh-peak-guard）：在高峰前提醒、到点停掉你勾选的会话、低谷回来再自动续做，并内置中国法定节假日与调休判定。
这是什么¶
dsh-peak-guard 是 DeepSeek Harness（DSH）的工作流类插件。它把「何时提醒、何时停、停哪些会话、何时恢复」做成可配置的状态机，且只作用于你在设置里勾选过的会话——并非所有任务都会被自动停启。
插件全程本地运行：只读本地配置与会话索引，不联网、不上报。宿主进程必须保持运行；DSH 客户端关闭后，停启逻辑不会生效。
核心功能¶
以下能力均来自仓库 README 与实现说明。
- 高峰前预告：默认提前 30 分钟向勾选了「高峰停止」的会话发提示，可关闭或改提前分钟数。
- 高峰开始时停止：先发停止提示（要求把进度写入
NEXT.md并收尾），宽限期默认 3 分钟后，若回合仍未结束则强制中断（与 GUI「停止」同路径）。 - 低谷开始时恢复：向勾选了「低谷恢复」的会话发恢复提示，读
NEXT.md后继续任务。 - 按会话授权：每个会话独立开关「高峰停止」「低谷恢复」，可只开其一。
- 工作区树与批量操作：会话按工作区分组；工作区行内可批量开/关停止与恢复；顶部可「高峰停止：全部开/全部关」「低谷恢复：全部开/全部关」。
- 节假日与调休：依赖
chinese-days日历；法定节假日不算高峰；支持在配置里手动覆盖某一天（例如2026-10-01=holiday、2026-10-11=workday）。 - 手动测试：设置页可立即触发一次预告、停止或恢复，无需等到真实时间点。
- Super Agent 项目：Super Agent 托管仓库下的工作区会话带「Super Agent」标签，可与其他会话一样勾选停启。
环境要求：
- DeepSeek Harness >= 0.2.1-rc.2（桌面客户端或带宿主服务的 Web 部署）
- Node.js
^22.19.0 || >=24.0.0
当前 package 版本为 0.3.1，许可证 MIT。
安装与启用¶
从 GitHub 安装（推荐）¶
用 DSH 自带 CLI 安装（资料原文命令如下）：
dsh plugin --profile desktop add "git+https://github.com/Aily-DSH/dsh-peak-guard.git"
若 dsh 不在 PATH，需进入客户端自带的 CLI 目录再执行等价命令（Windows 示例路径见 README）。
本地开发时可指向目录：
dsh plugin --profile desktop add "file:/D:/path/to/dsh-peak-guard"
安装会写入 profile 的 package.json（dependencies 与 dsh.profile.bundles），并把文件复制进 node_modules。
装完后必须重启一次 DeepSeek Harness 客户端：宿主半只在启动时挂载，设置页注入也只在启动时计算。重启后打开 设置 → 峰谷价自动停启 即可看到面板。修改插件源码后同样需要重启；若直接改 node_modules 内文件，需同步到 ~/.dsh/profiles/desktop/node_modules/dsh-peak-guard/lib/ 再重启。
卸载¶
dsh plugin --profile desktop remove dsh-peak-guard
可选删除配置目录 ~/.dsh/dsh-peak-guard/。
典型用法¶
- 打开 设置 → 峰谷价自动停启，看顶部状态徽章（高峰价时段 / 即将进入高峰 / 低谷价时段）。
- 在「会话」列表里，为需要托管的任务勾选 高峰停止、低谷恢复；可用顶部与工作区行的批量按钮速选；排序支持工作区顺序、最近运行、会话数量、名称等。
- 点 测试：发预告，确认勾选会话能收到消息。
- 保持 DSH 宿主运行：下一次进入高峰会自动预告并停止，回到低谷会对勾选「低谷恢复」的会话发恢复提示。
配置文件路径：~/.dsh/dsh-peak-guard/config.json（首次启动自动生成，也可在设置页修改）。常用字段示例：
| 字段 | 默认 | 说明 |
|---|---|---|
enabled |
true |
总开关 |
warnMinutes |
30 |
高峰前多少分钟预告；0 表示不预告 |
graceMinutes |
3 |
停止提示发出后，宽限多少分钟再强制中断 |
notifyOnWarn |
true |
是否发送高峰预告 |
sessions |
{} |
各会话的 autoStop / autoResume |
days |
{} |
日期覆盖，如 "2026-10-01": "holiday" |
宿主提供本地 HTTP 路由（仅回环地址）：GET /api/dsh-peak-guard/state 读状态；POST /api/dsh-peak-guard/config 增量更新配置；POST /api/dsh-peak-guard/action 手动触发 warn / stop / resume / cancel-now。
状态机约每 20 秒 tick 一次，结合北京时间日期与 chinese-days 判定阶段，在阶段变化时向授权会话投递消息或取消回合。
适用场景与注意¶
适合谁：长时间让 Agent 在 Harness 里跑任务、又希望尽量避开 DeepSeek 高峰计价的开发者。只勾选值得暂停与续做的会话即可；低谷「恢复」本身也会消耗 token。
权限与安全：插件以当前 DSH 宿主进程的权限运行，能调度你勾选的会话、读取本地会话投影缓存。安装前建议浏览 仓库源码 与 MIT 许可证，确认符合你的环境策略。
已知限制（README 原文要点）：
- 「停止」是两段式：先发收尾消息，宽限期后才
cancel；若会话卡在长工具调用里，消息可能要等到下一步边界才会被读到。 - 手动改 profile
package.json里的会话开关不会立即生效，应通过设置页或/config写入。 - 节假日按北京时间的日期判断；跨时区部署需自行确认。
- 恢复会唤醒冷会话并跑一轮，请谨慎勾选。
DSH 生态强调「一切皆插件」；社区目录站点与 DeepSeek / 幻方无官方从属关系。本插件已标记 GitHub topic dsh-plugin，并向社区 awesome 列表提交收录；若客户端插件市场索引有延迟，仍可用上述 git+https://... 命令直接安装。
结尾¶
dsh-peak-guard 把 DeepSeek 峰谷价规则落到 Harness 会话层：预告、停、恢复都可配置，且只影响你授权的会话。适合作为长期挂机 Agent 工作流里的成本控制环节。
- 目录页：skillhub.cn 插件页
- 源码与完整说明：github.com/Aily-DSH/dsh-peak-guard
