前言¶
在 DSH 的 Web UI 裏做會話或智能體調試時，花費、餘額、緩存命中和 Token 用量通常分散在不同位置。dsh-cost-balance 把這類統計放在輸入框下方：默認是一條居中的小黑條，點擊後展開半透明多行面板。DSH 插件體系強調“一切皆插件”，該插件可作爲 web profile 的統計入口接入。
下面介紹它的定位、功能、安裝方式和注意事項。
這是什麼¶
dsh-cost-balance 是一個 DeepSeek Harness（DSH）Web UI 插件，維護者爲 zoumutou，許可證爲 MIT。
它註冊在 conversation.composer.dock 槽位，接管 shipped 的 stats 單元格，在輸入框下方展示統計。
插件分爲客戶端與 Host 兩部分：客戶端負責摺疊/展開 UI，並通過同源接口讀取數據；Host 負責註冊路由、計算花費、獲取餘額。
核心功能¶
展示內容¶
默認摺疊爲一條居中的小黑條，類似 iOS 底部橫條。點擊後可展開毛玻璃面板，查看：
- 輪次 / 步數
- LLM 耗時 / 工具調用
- 首 token 平均 / 吞吐
- 緩存命中
- Token 輸入 / 輸出
- 會話花費
- 賬戶餘額
餘額顯示爲 DeepSeek 賬戶即時餘額，60s 自動刷新。
數據來源與刷新¶
客戶端通過同源 GET /api/cost-balance 讀取數據，每 60 秒自動刷新；當 token 用量變化時即時重算。
Host 半經 webServer 註冊 /api/cost-balance 路由。花費按會話累計 token 乘以模型單價計算。餘額經 credentials 服務解析 DEEPSEEK_API_KEY 後調用 DeepSeek 官方 GET /user/balance，有 60s 緩存，失敗後有 30s 抑制。
餘額取自用戶自己的 API Key 賬戶，無需額外配置；未配置或抓取失敗時面板顯示：
餘額 --
內置 DeepSeek 官方定價，覆蓋 deepseek-v4-flash 與 deepseek-v4-pro 的緩存命中、緩存未命中、輸出價格。
README 提到 DeepSeek 自 2026-08-16 16:00 UTC 起切換峯谷計費，off-peak 爲 peak 的一半。
安裝與啓用¶
npm 發佈版¶
先執行安裝命令，把插件加入 web profile：
dsh plugin --profile web add dsh-cost-balance
該命令從 npm registry 拉取已發佈的 dsh-cost-balance（dsh.bundle），並加入 profile 的 bundle 層。
然後重啓（或刷新）DSH Web UI。經過上面的步驟，輸入框下方會出現默認摺疊的小黑條，點擊可展開統計面板。
卸載命令如下：
dsh plugin --profile web remove dsh-cost-balance
源碼安裝¶
如果是開發或本地調試，先克隆倉庫，再進入目錄，最後把當前目錄作爲插件加入 web profile：
git clone https://github.com/zoumutou/dsh-cost-balance.git
cd dsh-cost-balance
dsh plugin --profile web add .
倉庫 package.json 中當前 version 爲 0.1.0。
發佈新版本時，先修改 package.json 的 version，再執行 npm publish；賬號需要 2FA 繞過 token，見 npm 文檔。
定價覆蓋¶
當 DeepSeek 計費調整時，可以在 profile 的 cordis.patch.yml 中覆蓋 prices 配置，而不必等待插件更新。
覆蓋項需要保留插件 ID，並在 config.prices 下配置目標模型的價格字段：
- id: cost-balance
config:
prices:
deepseek-v4-flash:
# 按需填寫 cacheHit / cacheMiss / output
deepseek-v4-pro:
# 按需填寫 cacheHit / cacheMiss / output
覆蓋是整行替換，務必保留 id: cost-balance。
適用場景與注意¶
適合在 DSH Web UI 中快速查看會話花費、賬戶餘額、緩存命中與 Token 用量的使用者。
使用前注意：
- 插件以當前 dsh 進程權限運行，Host 半會註冊路由並調用接口，安裝前應檢查源碼與 MIT 許可證。
- 餘額依賴
DEEPSEEK_API_KEY；未配置或抓取失敗時顯示餘額 --。 - 定價覆蓋爲整行替換，修改配置時務必保留
id: cost-balance。
相關鏈接¶
該插件把花費、餘額、緩存命中與 Token 用量集中到輸入框下方，適合作爲 DSH web profile 的輕量統計入口。
GitHub：
- https://github.com/zoumutou/dsh-cost-balance
目錄頁線索：
- https://www.skillhub.cn/plugins/zoumutou/dsh-cost-balance
目錄頁爲獨立站點線索，不代表 DeepSeek 或幻方官方應用商店。
