前言¶
DeepSeek Harness (DSH) 的插件生態允許擴展 Web UI 的功能。開發者通常需要直觀地查看賬戶餘額和當前的計價時段，以控制成本。dsh-balance-usage 插件直接在側邊欄展示這些信息，並按官方規則估算每一輪對話的花費。
這是什麼¶
這是一個由 LZ-jun 維護的開源插件，採用 MIT 許可證。它不依賴任何第三方服務，僅通過 DSH 官方賬號服務和本地會話日誌獲取數據，在側邊欄左下角以綠色顯示餘額與峯谷時段，並實時估算每個會話與每一輪的花費。
核心功能¶
側邊欄餘額與時段顯示¶
插件在側邊欄左下角顯示賬戶餘額。當側邊欄展開時，顯示錢包圖標、餘額金額膠囊以及時段狀態（空閒/忙碌）。當側邊欄收起（56px 軌道）時，以緊湊模式顯示金額膠囊，圓點顏色依舊錶示峯谷。
* 餘額狀態着色：
* 充足：綠色
* 偏低（默認閾值 10 元以下）：琥珀色
* 爲 0：紅色
* 時段判定：綠色圓點代表空閒時段，琥珀色圓點代表忙碌時段。懸停提示會顯示餘額、當前時段以及距切換還有多久。
展開面板詳情¶
點擊側邊欄的餘額條目，會向上展開一個浮層面板，包含以下內容：
* 賬戶餘額：顯示總額、充值/贈送拆分、餘額來源。點擊餘額可直接跳轉至官方賬號頁或充值頁。
* 當前計價時段：顯示空閒/忙碌膠囊、當前北京時間，以及距下一次切換的實時倒計時。
* 忙碌時段（高峯計價）：列出週一至週五 09:00–12:00 和 14:00–18:00（北京時間），並說明高峯價 = 空閒價 × 2；週末與法定節假日全天按空閒計價。
* 近期用量統計：提供今日、近 7 天、近 N 天的 Token 估算費用與請求次數；包含近 14 天每日 Token 柱狀圖；按模型拆分的詳細表格。鼠標懸停在柱狀圖上可查看當日明細。
* 交互與刷新：面板通過 React Portal 渲染，支持點擊外部或按 Esc 關閉。支持自動刷新間隔設置（默認 60 秒）和外觀主題切換（跟隨/深色/淺色）。
會話與單輪花費估算¶
插件在輸入框下方與每一輪的用量旁邊，按官方高峯/空閒價估算費用：
* 本會話消耗：在輸入框下方的 dock 區域顯示膠囊“本會話消耗 ≈ ¥x”。點擊後向上展開，顯示高峯花費、空閒花費、請求次數、緩存命中率及模型信息。
* 本輪花費：在每一輪的用量行右側，顯示“本輪花費 ≈ ¥x”觸發器。點擊後查看該輪的詳細花費拆分。
計價規則與數據來源¶
- 定價規則：遵循 DeepSeek 官方定價文檔。高峯爲週一至週五 09:00–12:00 和 14:00–18:00（北京時間），價格翻倍；週末與法定節假日全天按空閒計價。
- 節假日表：內置了 2026 年法定節假日表。
- 判定時刻：峯谷歸屬按請求發起時刻（
step/start事件時間）判定，取不到時回退到消息完成時刻。 - 數據來源：不依賴 DSH 官方賬號服務與本地會話日誌，不接入任何第三方服務。
價格表¶
插件內置了空閒時段的官方價格表（元 / 百萬 tokens）。高峯時段價格按 ×2 計算。
| 模型 | 輸入（緩存未命中） | 輸入（緩存命中） | 輸出 |
|---|---|---|---|
deepseek-flash |
1 | 0.02 | 4 |
deepseek-v4-pro |
4.5 | 0.15 | 13.5 |
deepseek-chat（舊） |
2 | 0.5 | 3 |
deepseek-reasoner（舊） |
4 | 1 | 16 |
安裝與啓用¶
本插件是一個標準的 DSH bundle 包（package.json 中包含 dsh.bundle.patch 與 dsh.client）。安裝後由 profile 的 bundle 棧自動掛載，無需手動修改配置文件。
典型用法¶
- 點擊側邊欄的餘額條目，查看餘額、倒計時、時間表與用量統計。
- 點擊輸入框下方的“本會話消耗”膠囊，查看會話總花費的拆分詳情。
- 點擊每輪用量行右側的“本輪花費”觸發器，查看本輪對話的費用。
注意事項¶
- 定價遵循官方規則，本地按官方價表估算，非官方賬單。
- 不支持跨時段請求的精確邊界判定，按請求發起時刻（step/start）判定。
- 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
結語¶
該插件通過側邊欄和輸入框兩處的直觀展示，解決了開發者對 DeepSeek 賬戶餘額和實時成本的關注需求。更多細節可查閱插件目錄頁或 GitHub 倉庫。
