前言¶
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
