前言¶
DeepSeek Harness 的插件生態支持通過配置擴展 Web UI 的功能。對於需要精細化控制成本、時刻關注賬戶餘額以及利用離峯折扣的開發者來說，手動查看頁面或依賴臨時的動態插件效率較低。dsh-deepseek-cost-watch 插件將離峯時刻表、實時賬戶餘額和會話成本估算直接集成到 Harness Web UI 中，提供一種無需離開應用即可掌握成本狀況的方案。
插件信息¶
- 名稱：
webificio/dsh-deepseek-cost-watch - 作者：Webificio
- 類別：聯網工具
- 許可證：MIT
核心功能¶
該插件通過一個安裝包替換了原本需要動態生成的兩個功能，提供了以下能力：
- 離峯狀態徽章：在界面右下角顯示一個浮動卡片。卡片實時顯示當前是離峯還是高峯，綠色表示享受 50% 折扣，琥珀色表示高峯。卡片包含倒計時，顯示距離下一次峯谷切換的時間。同時展示 UTC 和本地時區（含跨天標記）的固定折扣窗口。
- 賬戶餘額顯示：顯示 DeepSeek 賬戶的剩餘餘額。餘額數據由 Host 端獲取，不會在瀏覽器端暴露 API Key，保障安全。支持手動點擊刷新，系統也會每 5 分鐘自動輪詢一次（Host 端有 60 秒緩存）。餘額不足時金額會顯示爲琥珀色。
- 會話成本估算：位於對話編輯器上方。估算值基於會話歷史記錄，記錄發生時的費率進行計算，而非僅基於當前費率。顯示內容包含估算總花費、當前餘額、輸入/輸出 Token 消耗、緩存命中情況以及模型信息。
安裝與啓用¶
插件需要通過 dsh plugin 命令安裝到 web profile。
- 在終端執行安裝命令：
dsh plugin --profile web add github:Webificio/dsh-deepseek-cost-watch
- 安裝完成後，必須重啓
dsh web進程以使配置生效：
dsh web
- 重啓後，在瀏覽器頁面刷新即可看到右下角的離峯卡片和編輯器上方的成本行。
使用說明¶
- 查看離峯狀態：卡片默認展開，顯示詳細的時間表。按下鍵盤
–鍵可摺疊爲膠囊狀（如PEAK · 18m 04s），點擊膠囊可再次展開。 - 刷新余額：直接點擊卡片中的餘額行，可立即從 Host 端重新獲取最新余額。
- 查看成本明細：點擊編輯器上方的成本行（默認顯示爲帶顏色的圓點和金額），可展開查看詳細的 Token 消耗和費率計算。
技術細節¶
- 運行環境：插件分爲 Host 端和 Browser 端兩部分。Host 端負責獲取餘額和摺疊會話日誌進行成本計算；Browser 端負責渲染 UI。餘額請求只發送到
api.deepseek.com，且 API Key 僅保存在 Host 進程中。 - 要求：需要 DeepSeek Harness 版本 0.1.5-rc 或更高，且系統 PATH 中需配置
pnpm和git。
注意事項¶
- 不是賬單金額：插件提供的成本估算基於官方費率表，但不等同於最終賬單金額。
- 依賴版本：確保 Harness 版本滿足要求，否則可能無法識別插件配置。
總結¶
dsh-deepseek-cost-watch 適用於需要在開發過程中實時監控 DeepSeek API 消費情況並利用離峯折扣的開發者。它通過將計算邏輯下沉到 Host 端，在保障安全的同時提供了直觀的 UI 反饋。
