DeepSeek Harness 的理念是「一切皆插件」。在調用大模型時，峯谷電價差異顯著，且餘額不足會直接中斷工作流。dsh-peak-price-panel 旨在解決這兩個問題，將價格表與餘額狀態直接展示在主界面側邊欄，讓開發者能實時掌握計費情況並提前充值。
插件定位¶
這是一個 DeepSeek Harness 主界面信息面板插件，由 LucienLL 維護，屬於「聯網工具」類別。它集成了峯谷價格顯示、餘額輪詢與三檔閾值變色預警功能，並提供充值按鈕聯動。
核心功能¶
- 峯谷時段顯示與倒計時：按北京時間顯示當前處於高峯（工作日 9:00–12:00、14:00–18:00）還是低谷，帶下次切換倒計時。週末全天按低谷價計費（自 2026-08-23 起）。臨近切換（默認提前 30 分鐘）彈出橫幅，提示漲價或半價。
- 側邊欄實時單價展示：側邊欄卡片實時顯示當前時段所配置模型的輸出單價（高峯全價 / 低谷半價）。
- 價格表過期提醒：價格表數據版本超過
staleAfterDays（默認 30 天）未更新時，側邊欄「輸出單價」標題變黃並提示「價格表可能過期」。 - 餘額輪詢與閾值變色預警：輪詢
GET https://api.deepseek.com/user/balance，顯示總餘額，按三檔閾值（默認 50 / 20 / 5）變色並預警。 - 低餘額時充值聯動：低餘額（告急/極低檔）時按鈕紅色脈衝聯動、餘額數字變紅加粗。
數據與代碼解耦¶
自 v0.2.0 起，價格表與峯谷時段已從代碼解耦，改爲數據配置。實際生效值來自設置層 prices / peakWindows，不再硬編碼在代碼中。
- 實時生效：在設置層修改 JSON 可實時生效，無需重裝插件。
- 重啓生效：通過
cordis.patch.yml修改配置則需重啓 web 生效。 - 調價方式：DeepSeek 調價後，只需更新配置層的
prices（以及需要時更新peakWindows、scheduleVersion），無需改代碼、無需發版。
安裝與啓用¶
使用以下命令安裝插件：
dsh plugin --profile web add dsh-peak-price-panel
API key 通過同名環境變量（默認 DEEPSEEK_API_KEY）解析：優先取同名環境變量，未設置時回退 DSH 憑據庫。
配置項¶
主要配置位於設置頁面的「Plugins → Cost panel」：
- 餘額閾值：
warnThreshold（50）、criticalThreshold（20）、extremeThreshold（5）。分別對應提醒、告警、極低閾值。 - 輪詢與提示：
refreshSeconds（60）控制餘額刷新間隔；peakLeadSeconds（1800）控制峯谷切換提前提示時間。 - 價格數據：
prices爲單價表（¥/1M tokens，峯價）；scheduleVersion（默認 2026-08-23）用於判斷過期；peakWindows（如 [[9,12],[14,18]]）定義工作日高峯時段。 - 顯示控制：
models留空則顯示價格表裏全部模型；currency僅影響餘額的幣種顯示符號，不換算單價。
驗證與依賴¶
項目提供單元測試驗證：
node --test test/*.mjs
插件依賴 @deepseek-ai 系列庫。
適用場景與注意¶
適合需要精細控制成本、頻繁調用 DeepSeek API 的開發者。安裝前建議檢查源碼與許可證（MIT）。
