前言¶
DeepSeek Harness（DSH）通過插件擴展智能體工作流。對於在 DSH 中調用 DeepSeek V4 系列 API 的用戶來說，峯谷定價會讓高峯時段和空閒時段的模型成本、質量取捨不同：高峯時段更關注成本，空閒時段更關注模型能力。
deepseek-peak-valley-router 是一個 DeepSeek Harness 插件：它按當前時段自動路由模型，高峯時段使用 deepseek-v4-flash，空閒時段使用 deepseek-v4-pro；如果用戶顯式選擇模型，插件不會覆蓋用戶選擇。
這是什麼¶
deepseek-peak-valley-router 是 Eligahyu 維護的 DSH 峯谷定價自動模型路由插件，許可證爲 MIT。
它解決的問題是：
- 不需要手動在
deepseek-v4-flash和deepseek-v4-pro之間切換。 - 插件按峯谷時段自動路由到對應的 V4 型號。
- 用戶顯式選擇的模型始終優先。
- 非目標 provider 或非這兩個 V4 型號的請求保持原樣。
核心功能¶
下面介紹該插件的主要行爲。
1、自動識別峯谷時段。參考時區默認是 Asia/Shanghai，也可以配置爲其他 IANA 時區。
2、按峯谷路由模型。
- 高峯時段自動路由到
deepseek-v4-flash。 - 空閒時段自動路由到
deepseek-v4-pro。
3、用戶顯式選擇的模型始終優先。插件不會覆蓋用戶在模型選擇器中做出的選擇。
4、不越界處理請求。非 DeepSeek 官方 provider，或非 deepseek-v4-flash、deepseek-v4-pro 這兩個 V4 型號的請求，一律不動或原樣放行。
5、切換可審計。每次模型切換會記錄進會話 request/header 事件，方便查看實際使用的模型。
6、提供對話級工具。
peakvalley_status：查看當前時段、目標模型和路由模式。peakvalley_reset：恢復自動路由。
7、配置容錯。如果 timeZone 配置非法，插件會回退到默認時區並告警，避免請求失敗。
8、邊界處理。從 deepseek-v4-pro 切到 deepseek-v4-flash 時，插件會自動丟棄 reasoningEffort，避免請求被拒絕。
安裝與啓用¶
插件要求 Node >=20。
插件運行在 DeepSeek Harness 內，@deepseek-ai/dsh-tools 由宿主提供，無需手動安裝。
組合插件安裝¶
從 GitHub 安裝插件：
dsh plugin --profile web add github:Eligahyu/deepseek-peak-valley-router
安裝後重啓對應 profile 生效：
dsh --profile web
動態插件安裝¶
如果想在當前 Harness 對話裏直接試用，可以用動態插件方式。
在 Harness 對話裏使用 cordis_define 工具創建插件，把 dynamic/host-code.js 中 HOST_CODE 的完整內容粘貼到 code.host 參數，然後使用 cordis_run 激活。
動態版會額外暴露 harness.handle('peak-valley-status') Host 通道。組合版沒有 Host 通道，狀態查詢通過 peakvalley_status 完成。
時區配置¶
默認參考時區爲 Asia/Shanghai。如果需要修改，在 profile 的補丁層追加插件配置：
# ~/.dsh/profiles/web/cordis.patch.yml 追加
- id: deepseek-peak-valley-router
config:
timeZone: 'America/New_York'
如果配置了非法的 timeZone，插件會回退默認時區並告警。
典型用法¶
安裝並啓用後，可以在對話中查看當前路由狀態：
調用 peakvalley_status
它會返回當前時段、目標模型和路由模式。
如果之前用戶顯式選擇了某個模型，需要恢復自動路由時，可以調用：
調用 peakvalley_reset
該操作會清除內存中的用戶選擇記錄，讓插件重新進入自動路由狀態。
適用場景與注意¶
適合在 DSH 中使用 DeepSeek V4 系列 API，並且希望按峯谷定價自動切換 deepseek-v4-flash 與 deepseek-v4-pro 的用戶。
使用前注意以下幾點：
- 峯谷時段和價格以 DeepSeek 官方公告爲準。插件按公告實現，不保證與未來價格政策一致。
- 自動切換模型可能改變回答質量或行爲。重要任務請留意會話
request/header中實際使用的模型。 - 插件激活前已創建的會話，自動路由會在下次頁面刷新或重連後對該會話生效；手動選擇模型會立即生效，並且插件尊重該選擇。
- 插件以當前
dsh進程權限運行。安裝前應檢查源碼、許可證和行爲是否符合預期。 - 本插件與 DeepSeek 官方無任何隸屬關係，非官方作品。
結尾¶
deepseek-peak-valley-router 的價值在於把峯谷定價下的模型選擇變成自動路由：高峯用 deepseek-v4-flash，空閒用 deepseek-v4-pro，同時保留用戶顯式選擇的優先權。
GitHub 地址：https://github.com/Eligahyu/deepseek-peak-valley-router
目錄頁地址未在本文覈實，建議直接按插件名 deepseek-peak-valley-router 在 DSH 社區目錄中檢索。
