前言¶
DeepSeek API 採用峯谷定價機制，工作日 09:00-12:00 和 14:00-18:00 爲高峯時段，價格翻倍；其餘時間（包括週末）爲谷價，價格減半。在使用 DeepSeek Harness (DSH) Web GUI 進行開發或調用時，如果不清楚當前時間是否處於高峯期，容易在計費上產生不必要的開銷。
原生 DSH 界面未提供此類實時狀態指示。下面介紹 dsh-peak-status 插件，它通過在會話頭部右上角注入一個原生膠囊，實時顯示當前北京時間是否處於 API 高峯時段。
插件介紹¶
dsh-peak-status 是一個 DeepSeek Harness Web GUI 的高峯時段指示燈插件，由 xiaoyi-xx 維護，遵循 MIT 協議。插件在原生 conversation.session.header.utilities 工具位顯示一個小膠囊，實時告知用戶當前北京時間是否處於 DeepSeek API 的高峯時段，並提供秒級時鐘、下一轉折倒計時和價格提示。
核心功能¶
該插件主要提供以下能力：
- 實時狀態顯示：判斷當前北京時間是否處於 DeepSeek API 高峯時段。
- 時鐘顯示：顯示秒級時鐘（格式 HH:MM:SS），使用北京時間（Asia/Shanghai 時區）。
- 倒計時功能：顯示下一轉折倒計時。
- 價格提示：提示當前價格倍率（高峯 ×2，谷價半價）。
- 日曆識別：支持法定節假日和調休上班的週末識別與提示。調休上班的週末和法定節假日全天按谷價計費。
- 交互詳情：點擊膠囊可展開詳情卡片，顯示高峯時段、倒計時和進度條。
- 界面集成：與 Web UI 原生主題變量（
--dsw-alias-*）深度集成，融入界面。 - 持久存活：支持
dsh web重啓後持久存活。 - 數據緩存：自動聯網獲取官方節假日表，並在本地緩存。
安裝與啓用¶
在終端中執行以下命令進行安裝：
dsh plugin --profile web add dsh-peak-status
安裝完成後，重啓 dsh web 或刷新頁面。膠囊會出現在會話頭部右上角。
使用方法¶
- 查看：在會話頭部右上角查看膠囊，插件每秒自動更新狀態。
- 交互：點擊膠囊可展開或摺疊詳情卡片。
- 判斷：通過膠囊顏色和文字判斷當前是否爲高峯時段或谷價。
適用場景與注意事項¶
適用場景：所有使用 DSH Web GUI 的開發者或用戶，特別是對 API 計費敏感，希望避免在高峯時段消耗預算的用戶。
注意事項：
1. 插件僅在 Web GUI 環境下有效（profile web），不適用於其他環境。
2. 節假日數據通過聯網獲取，支持三層回退機制（Host 路由、Browser 直接請求、週末規則）。
3. 計費規則：工作日 09:00-12:00 和 14:00-18:00 爲高峯時段；週末全天谷價；法定節假日和調休上班的週末全天按谷價計費。
總結¶
dsh-peak-status 通過原生膠囊形式，解決了 DSH Web GUI 缺乏實時高峯時段提示的問題，幫助用戶通過秒級時鐘和倒計時精準把握 API 調用時機，從而控制成本。該插件維護活躍，開源在 GitHub。
