前言¶
DeepSeek Harness (DSH) 是一個基於插件架構的 Web 客戶端。在使用 DeepSeek API 進行開發時，區分高峯時段（費率較高）和空閒時段（谷價）有助於控制成本。dsh-client-ui-peak-valley 插件直接在對話框的模型選擇按鈕左側顯示當前 API 的價格狀態，無需手動查詢官方定價表。
核心功能¶
該插件專注於在 UI 層提供實時的價格狀態反饋。
- 狀態可視化：根據北京時間自動判斷當前時段。綠色方塊代表谷價（空閒時段），橙色方塊代表峯價（高峯時段）。
- 自動刷新：每 30 秒自動檢查一次時間狀態，跨時段切換時無需手動操作。
- 條件顯示：僅噹噹前會話選中的模型 ID 包含
deepseek（不區分大小寫）時才顯示狀態。 - 兼容性：支持官方模型（如
deepseek-official）及中轉網關模型（如opencode-go、commandcode等）。同時自動適配淺色和深色主題。
安裝與啓用¶
該插件爲組合包（Bundle），註冊行（id: peak-valley）已包含在包內的 cordis.patch.yml 中，無需手動在宿主配置文件中添加插入行。
在目標 profile 目錄（例如 ~/.dsh/profiles/desktop/）下執行以下命令進行安裝：
dshpm add file:./plugins/dsh-client-ui-peak-valley --profile desktop
安裝完成後，必須重啓 dsh 進程才能生效。通過 DSH 插件頁的「已安裝」區域開啓或關閉該插件。
使用示例¶
插件根據模型 ID 的子串匹配進行顯示判定。
顯示狀態：
- deepseek-chat
- deepseek/reasoner
- deepseek/deepseek-v4.1-flash
不顯示狀態：
- ds-v3（模型 ID 中不含 deepseek）
- minimax-m3（非 DeepSeek 模型）
注意事項¶
- 時區依賴：插件基於
Asia/Shanghai時區計算，不依賴瀏覽器的本地時區設置。 - 渲染位置：UI 註冊在
conversation.input.right座位，位於模型選擇按鈕的左側，不替換原生 UI。 - 安裝方式：安裝和管理依賴
dshpm命令。由於是組合包，宿主無需手動維護cordis.patch.yml的插入行。 - 重啓要求：安裝或卸載後，必須重啓 DSH 應用。
結尾¶
dsh-client-ui-peak-valley 通過在開發環境中實時展示 API 價格狀態，輔助開發者選擇合適的調用時段。其核心價值在於將繁瑣的定價查詢轉化爲可視化的 UI 反饋。
