前言¶
在 DeepSeek Harness（DSH）里長時間跑對話和子代理時，賬戶裏還剩多少錢、今天大概燒了多少 token，往往要切到別處查。官方賬戶頁能看到餘額，但和「當前這一天的會話用量、按對話拆分的估算花費、以及現在是不是高峯計費時段」並不在同一塊 UI 裏。社區插件 @b9p79rgh6f-sudo/dsh-balance-widget（GitHub：b9p79rgh6f-sudo/dsh-balance-widget）把這幾項收進側邊欄底部一行常駐掛件，點開面板再看明細。下面介紹它做什麼、數據從哪來，以及如何安裝。
這是什麼¶
維護者 b9p79rgh6f-sudo 在插件市場分類爲客戶端。插件在 DSH Web 側邊欄底部掛一行小部件：DeepSeek 賬戶餘額、今日 token 用量與估算花費；展開後可看今日各對話花費、累計 token 與請求數，以及當前處於高峯還是空閒計費窗口。許可證爲 MIT（見 GitHub README）；當前 package 版本爲 0.3.2。
核心功能¶
側邊欄底部一行¶
- 左側顯示餘額，後跟今日花費估算。
- 右側小標籤寫「空閒半價」或「高峯全價」；圓點在空閒時段爲綠色，高峯時段爲黃色。
點開後的面板¶
- 餘額卡與今日花費進度條（相對最近 7 天日均）。
- 今日累計 token、請求數。
- 每個對話的花費列表；子代理費用歸併到發起它的對話。
- 下一次計費時段切換的時間。
數據從哪來¶
餘額：通過 DSH 官方賬戶服務 deepseekAccount 讀取充值餘額與贈送餘額，不經過第三方。
今日用量：宿主側掃描各會話日誌裏帶 usage 的 assistant/message 事件，按事件時間歸到北京時間的自然日，結果緩存在：
~/.dsh/storages/balance-widget-cache.json
花費：按 DeepSeek 官方價目從 token 折算，僅爲估算，不是賬單。價目取自官方文檔，README 記載抓取日期爲 2026-11-03；官方調價後需在插件 index.js 中更新 PRICES 常量。
計費時段：北京時間週一至週五 9:00–12:00 與 14:00–18:00 爲高峯（全價），其餘時段半價。README 說明：法定節假日仍按工作日規則處理，因此估算可能偏高。
安裝與啓用¶
可從 SkillHub 插件目錄頁 安裝，或在終端執行（將 <profile> 換成你的 DSH profile）：
dsh plugin --profile <profile> add @b9p79rgh6f-sudo/dsh-balance-widget
也可以直接從 GitHub 安裝：
dsh plugin --profile <profile> add github:b9p79rgh6f-sudo/dsh-balance-widget
裝完後刷新頁面；若宿主頁有改動，按 README 建議重啓 DSH。
依賴：
- DSH Web 0.2.x 及以上（使用
sidebar.footer.action與shell.overlay槽位，以及deepseekAccount服務）。 - Node >= 20（見 package.json
engines）。 - 讀用量需要會話日誌與官方賬戶服務可用；登錄狀態下才能顯示餘額。
典型用法¶
安裝並登錄 DSH 後，無需額外配置項即可在側邊欄底部看到餘額與今日花費一行。需要覈對某對話或子代理貢獻時，點擊掛件打開面板，查看「每個對話的花費」與 token、請求數彙總。
維護者在倉庫 tools/ 下提供了開發自查腳本（README 說明依賴本機會話日誌，換機不一定能直接跑）：
test-client-render.mjs：用假的 React 樁渲染界面，無需啓動 DSH。verify-usage.py：讀本機會話日誌重算用量與花費，用於和麪板數字對賬。
適用場景與注意¶
適合：長期在 DSH Web 裏開發智能體、頻繁開多對話或子代理，希望在同一界面快速感知餘額、當日用量和高峯/空閒時段的用戶。
注意：
- 插件以當前 DSH 進程權限運行；安裝前建議瀏覽 GitHub 源碼 與 MIT 許可證，確認符合你的安全策略。
- 花費數字是依據插件內價目表的估算，不能替代官方賬單；調價後需自行更新
PRICES。 - SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，並非官方應用商店。
結尾¶
dsh-balance-widget 把餘額、今日用量估算、按對話拆分和計費時段提示固定在側邊欄底部，減少在 DSH 與賬戶頁之間來回切換。目錄頁：https://www.skillhub.cn/plugins/b9p79rgh6f-sudo/dsh-balance-widget；源碼與 README：https://github.com/b9p79rgh6f-sudo/dsh-balance-widget。
