DeepSeek Harness（DSH）的 Web 界面主要用於交互，開發者通常需要關注 API 調用的成本與賬戶餘額。dsh-ui-billing 插件在 Web GUI 的側邊欄底部增加了一個計費組件，用於顯示當前會話的費用和實時 API 餘額。
這是一個顯示當前會話成本和 API 餘額的小組件。它屬於客戶端插件，由 HenryHwong 維護，遵循 MIT 許可證。
核心功能¶
Current-session cost
顯示當前對話的總成本。插件會摺疊 assistant/message 的使用記錄，根據加載時的價格表計算 CNY 成本。切換會話會更新顯示；翻頁和壓縮不會改變顯示的金額。如果存在未定價的 token，會標註 (+N tokens unpriced)。
Live API balance
顯示提供商賬戶餘額。通過 harness 的 provider facts 讀取，每 60 秒刷新一次，或在連接重置時刷新。點擊行刷新按鈕可手動刷新。
Collapsed-rail glyph
當側邊欄摺疊時，顯示單個 ¥ 符號，鼠標懸停顯示兩行信息，點擊刷新余額。
Idle by default
沒有訂閱者掛載時不獲取數據，節省資源。
安裝與啓用¶
該插件通過 DSH 的插件管理器安裝。在 Web 配置文件目錄下執行以下命令：
dsh plugin --profile web add @huanghanheng/dsh-ui-billing
配置與價格表¶
插件默認使用內置價格表和計費規則。如需自定義，需在插件配置中指定：
- id: ui-billing
name: '@huanghanheng/dsh-ui-billing'
config:
prices:
'deepseek-v4-pro':
offPeak: { inputPerM: 4.5, cacheReadPerM: 0.15, outputPerM: 13.5 }
peak: { inputPerM: 9, cacheReadPerM: 0.3, outputPerM: 27 }
peakHours: [[540, 720], [840, 1080]]
utcOffsetMinutes: 480
配置項說明：
* prices：自定義各模型的輸入、緩存讀取、輸出價格。
* peakHours：高峯時段配置（分鐘數）。
* utcOffsetMinutes：時區偏移（480 代表北京時間 UTC+8）。
依賴與前置條件¶
- DSH 版本：需要 DSH 0.1.7-rc.1 或更新版本。
- Projection Registry Composed：Web 界面需加載
@deepseek-ai/dsh-session-projection包以支持成本行顯示。 - API Key：必須配置 DeepSeek API Key（通過憑證服務或環境變量
DEEPSEEK_API_KEY）。 - 權限：插件以當前 dsh 進程權限運行。
安全說明¶
- Display only：僅展示數據，不寫入會話日誌，不發送給模型，不產生額外的 RPC 調用（除只讀的
/api/billing.balance）。 - Credentials host-side：API 密鑰通過宿主機憑證服務解析，不會進入瀏覽器包。
該插件解決了 Web 界面下查看成本和餘額的痛點，適合需要精細控制 API 調用成本的開發者。
