DeepSeek 的計費採用峯谷分時策略，高峯時段價格翻倍。對於使用 DeepSeek Harness (DSH) 開發智能體的開發者來說，若不加控制，在高峯期運行大量任務會迅速增加成本。dsh-peak-gate 插件旨在解決這一問題，它通過代碼層面的 hook，在高峯時段自動限制任務執行、壓縮輸出預算，並提供一鍵放行口令。
插件定位與維護者¶
- 名稱：dsh-peak-gate
- 定位：DSH 主機端插件，負責在宿主側根據時間規則攔截或調整請求。
- 維護者：CNyaotian-Lunar
- 許可：MIT
- 性質：社區自研插件，與 DeepSeek / DeepSeek Harness 官方無關
核心功能¶
插件主要在以下五個層面進行控制：
- 峯時攔重活：在
agent/pre-step鉤子中攔截高耗時的任務步驟。 - 峯時工具預算：限制單輪工具調用的最大步數。
- 峯時壓縮輸出：強制將
maxTokens壓縮到上限。 - 峯時精簡輸出：修改
systemPrompt，要求模型在高峯期減少廢話輸出。 - 一鍵放行口令：提供特定口令，可在高峯期強制放行特定請求。
安裝與啓用¶
該插件不通過插件市場安裝，而是通過 Web Profile 的依賴掛載方式集成。請確保你的 DSH 版本在 0.1.7 以上。
- 放置源碼
將插件源碼文件夾dsh-peak-gate-src放入 Profile 的 vendor 目錄：
<DSH_HOME>/profiles/web/vendor/dsh-peak-gate-src
- 修改配置
編輯<DSH_HOME>/profiles/web/package.json，在dependencies中添加本地鏈接，並在dsh.profile.bundles列表中加上dsh-peak-gate：
{
"dependencies": {
"dsh-peak-gate": "link:vendor/dsh-peak-gate-src"
},
"dsh.profile.bundles": [
"dsh-peak-gate"
]
}
-
執行與重啓
運行pnpm install安裝依賴，然後重啓dsh web。 -
配置命名空間
在profiles/web/cordis.patch.yml中添加peak-gate命名空間配置。DSH 0.1.7+ 版本支持熱改，無需重啓即可生效。
計費邏輯¶
插件判定邏輯基於北京時間，採用“UTC+8 位移後讀 UTC 字段”的方式，不依賴本機時區，因此不受夏令時影響。
根據 DeepSeek 官方定價規則：
| 時段（北京時間） | 價格 |
|---|---|
| 週一至週五 09:00–12:00、14:00–18:00 | 高峯 ×2 |
| 其餘時間、週末全天、中國法定節假日全天 | 空閒 ×1 |
法定節假日自動日曆¶
插件內置了一套完整的 2026 年中國法定節假日日曆，並支持聯網更新和本地緩存。
多層緩存與校驗¶
- 聯網源：默認從
NateScarlet/holiday-cn獲取，按序嘗試 jsDelivr、raw.githubusercontent、gh-proxy，僅拉取當年數據。 - 磁盤緩存：默認緩存至
<DSH_HOME>/data/peak-gate/holidays-cn.json，30 天內不重複拉取。聯網失敗時使用舊緩存並告警。 - 內置兜底：代碼中包含
DEFAULT_HOLIDAYS，支持離線使用。 - 數據校驗：單年放假日數必須在 15 ~ 45 天之間。緩存時間戳在未來時會被判定爲損壞並重新拉取。
調休規則¶
根據官方 2026-09-19 的補充說明：
* 調休上班日按空閒計費：國家標定的補班日（如週六）無條件按空閒價計算，不恢復高峯價。
* 緩存合併：緩存中的 workdays 與內置的 DEFAULT_MAKEUP_DAYS 會合並進日曆。
配置項¶
holidays：追加自定義日曆（默認即內置表）。useBuiltinHolidays：是否合併內置表（收窄時設爲 false）。autoHolidayCalendar：關閉聯網。holidayCalendarUrls、holidayCacheMaxAgeDays、holidayFetchTimeoutMs、holidayCachePath。
⚠️ 注意：若想僅使用自定義日曆，需同時設置
holidays: []、useBuiltinHolidays: false、autoHolidayCalendar: false。
適用場景與注意¶
- 適用場景：需要嚴格控制 DeepSeek API Token 花費，希望避免在高峯時段執行非關鍵任務的開發者。
- 運行環境：以當前 DSH 進程權限運行，需確保
schemastery和@deepseek-ai/dsh-llm依賴可用。 - 生態說明：DSH 理念爲“一切皆插件”，本插件來自社區目錄 SkillHub，與 DeepSeek 官方無從屬關係。
