DeepSeek Harness (DSH) 是一個基於插件架構的客戶端環境。在實際開發或使用中，頻繁打開官方定價頁或計費頁面來覈對餘額和費用會打斷對話流。下面介紹 dsh-ui-balance，它通過直接在界面中展示這些數據來解決這個問題。
插件簡介¶
dsh-ui-balance 是一個由 EasyTZ 維護的客戶端插件，核心功能是將 DeepSeek API 的餘額、花費以及峯谷時段標記直接顯示在會話的側邊欄中。它通過解析會話日誌和官方定價頁，爲用戶提供實時的費用估算和用量彙總。
核心功能¶
該插件主要提供以下能力：
- 側邊欄概覽：在側邊欄顯示一行數據，包含餘額和當日花費（實時跳動）。
- 詳情面板：點擊側邊欄行可彈出詳情面板，展示 API 供應商、餘額、用量彙總、費用匯總及目前單價。
- 多供應商支持：支持 DeepSeek、Kimi (Moonshot) 等多供應商，但僅 DeepSeek 和 Moonshot/Kimi 支持直接查詢餘額接口。
- 價格同步：從官方定價頁自動同步價格。啓動時抓取一次，之後每 20 秒或半天再次同步。若同步失敗，繼續使用最後一份真實價格。
- 峯谷時段與節假日：支持自定義高峯時段規則（
peakDays,peakWindows）和法定節假日配置（peakHolidays）。
安裝與啓用¶
安裝前請確保已配置 DEEPSEEK_API_KEY 憑據。
使用以下命令安裝（<name> 爲必填的 profile 名，桌面版通常爲 web，TUI 爲 tui）：
dsh plugin --profile <name> add @easytz/dsh-ui-balance
安裝完成後重啓 DSH 即可使用。
典型用法¶
側邊欄顯示：安裝後，側邊欄會出現一行數據，包含“餘額：xx 元”和“花費：xx 元/日”。花費會隨着消息生成實時跳動。最右側會顯示綠色“谷”或藍色“峯”，標識當前計費時段。
查看詳情：點擊側邊欄的該行，會彈出費用詳情面板。面板從上到下依次爲：API 供應商、餘額、用量彙總（支持日/周/月切換）、費用匯總和目前單價。
自定義規則：若需自定義高峯時段，可配置 peakDays（如 1-5）和 peakWindows（如 9:00-12:00,14:00-18:00）。填 none 表示沒有高峯時段。
注意事項¶
- 餘額查詢限制：餘額查詢僅 DeepSeek 和 Moonshot/Kimi 有公開接口，其他廠商顯示“無法查詢餘額”。
- 費用性質：面板中的費用是按當前單價折算的估算值，並非官方賬單。它統計的是本機會話日誌中的調用。
- 日誌掃描：會話數量多時，首次啓動插件會將全部日誌掃一遍。之後按文件尺寸增量更新。
- 路徑依賴：如果你在本地 patch 中修改了
dsh-session-persistence-l的root路徑，請確保將插件的sessionsRoot配置爲相同路徑，否則費用統計可能全部爲 0。
總結¶
dsh-ui-balance 通過將官方定價、實時用量和估算費用集成到界面中，解決了在 DSH 中頻繁查看費用的痛點。它支持多供應商、自動同步價格以及自定義峯谷規則，適合需要精細控制 API 使用成本的 DeepSeek 開發者。項目源碼位於 GitHub：https://github.com/EasyTZ/dsh-ui-balance。
