前言¶
使用 DeepSeek Harness Web 跑會話時，常見的需求是把幾類信息放在一起看：當前 DeepSeek 賬戶還有多少餘額、本次會話大約花了多少、近期累計花了多少、不同模型消耗了多少 token。這些信息分散在 DeepSeek 平臺、Harness 本地日誌和手動統計中，不方便直接查看。
下面介紹 dsh-balance-stats。它是 DeepSeek Harness Web 的一個社區插件，由 pangzi499 維護，採用 MIT 許可證。它會在 Harness Web 中提供餘額、當前會話成本估算、用量明細，以及可選的發票摘要導入。
這是什麼¶
dsh-balance-stats 的定位是：DeepSeek Harness Web 的餘額和用量統計插件。
它解決的核心問題是：在 Harness Web 界面裏集中查看 DeepSeek 餘額、當前會話成本、歷史花費、模型消耗和 token 用量，並支持通過導入發票信息計算更貼近賬本口徑的總花費。
需要注意：這是社區插件，不是官方 @deepseek-ai 插件。
核心功能¶
餘額展示¶
插件會讀取官方 DeepSeek balance API，並展示可用餘額、充值餘額和贈送餘額。
當前會話成本估算¶
插件會通過 balanceStatsSessionCost 投影，即時估算當前活躍會話的成本。這裏的 scope 綁定在 composer 上。
總花費展示¶
導入發票後，插件會使用基於賬本的百分比展示總花費。沒有導入發票時，會回退到 Harness 本地估算。
明細卡片¶
點擊狀態欄可以打開明細卡片。卡片中會展示：
- 今日花費
- 最近 7 天 / 30 天花費
- 按模型劃分的花費
- token 用量
- 更新時間
- 發票導入入口
發票導入¶
插件支持兩種發票導入方式：
- 自動導入：在明細卡片中保存平臺
userToken後，插件會按計劃重新獲取發票。 - 一次性 JSON 導入：手動粘貼
get_all_invoice響應 JSON，作爲回退方式。
自動導入支持憑據持久化，也支持一鍵清除。
容錯與刷新¶
當請求失敗時，插件會保留最近一次成功獲取的餘額或發票信息。插件也支持按可配置間隔刷新數據。
安裝與啓用¶
安裝前，先確認 Node.js 和 pnpm 可用：
node -v
pnpm --version
要求 Node.js >=22.19.0，並且 pnpm 在 PATH 中可用。
確認環境後，執行下面的命令安裝插件：
npx @deepseek-ai/dsh plugin --profile web add https://github.com/pangzi499/dsh-balance-stats.git
安裝完成後，啓動或重啓 Harness Web：
npx @deepseek-ai/dsh web
啓動後，在瀏覽器中做一次硬刷新，再查看 Harness Web 中的插件入口。
如果要更新插件，執行：
npx @deepseek-ai/dsh plugin --profile web update dsh-balance-stats
典型用法¶
打開明細卡片¶
安裝並刷新頁面後，點擊插件提供的狀態欄，即可打開明細卡片。
卡片中可以看到餘額構成、賬單摘要、按模型花費、token 用量，以及發票導入相關配置。
使用自動發票導入¶
如果使用自動導入，按下面步驟操作：
- 打開明細卡片。
- 粘貼平臺
userToken。 - 點擊 Save。
保存後，插件會按計劃重新獲取發票。憑據會寫入本地 Harness credentials 文件：
~/.dsh/.credentials.yaml
寫入權限爲 0600。
在明細卡片中也可以一鍵清除已保存的憑據。
使用手動 JSON 導入¶
如果不想保存 userToken，可以使用一次性 JSON 導入：
- 在明細卡片中展開 Advanced。
- 粘貼完整的
get_all_invoiceJSON 響應。 - 執行導入。
手動粘貼的 JSON 只在內存中解析。瀏覽器端 localStorage 回退摘要只保存聚合信息，不保存訂單明細。
通過憑據配置 token¶
除了手動粘貼，也可以通過 Harness 憑據或配置項提供 token：
DEEPSEEK_PLATFORM_TOKEN
也可以在：
cordis.patch.yml
中配置：
platformToken
或者使用同名環境變量。
適用場景與注意¶
適合誰¶
如果你已經在用 DeepSeek Harness Web，並且希望在同一個界面裏查看：
- DeepSeek 餘額
- 當前會話成本估算
- 最近 7 天 / 30 天花費
- 按模型花費
- token 用量
- 發票導入後的總花費
那麼 dsh-balance-stats 比較適合。
注意事項¶
- 這是社區插件，不是官方
@deepseek-ai插件。 - 插件要求 Node.js
>=22.19.0，並且pnpm在PATH中可用。 - 該插件在 DeepSeek Harness
0.1.0-rc.6到0.1.1-rc.1範圍內測試過。 - DeepSeek Harness 目前處於 developer preview，插件使用的 client API 或掛載點可能在後續版本中變化。
- 默認情況下，插件不會請求
get_all_invoice，也不會保存 DeepSeek Platform 憑據。 - 只有顯式保存
userToken後，插件纔會寫入本地憑據文件：
~/.dsh/.credentials.yaml
文件權限爲 0600。
- 插件不接受或保存 DeepSeek Platform cookies。token 只會發送到：
platform.deepseek.com
get_all_invoice是私有、需認證的 DeepSeek Platform 接口，響應格式可能變化。- 只有
payment_order_status爲SUCCESS的充值訂單會被計入；有效贈送訂單會單獨累計。 - DSH 插件會隨當前
dsh進程運行，安裝前應先檢查源碼與許可證。該插件爲 MIT 許可證。
小結¶
dsh-balance-stats 把 DeepSeek 餘額、當前會話成本、模型用量和發票導入集中到 DeepSeek Harness Web 中，適合希望在 Harness 界面裏做日常成本查看的人使用。
GitHub 倉庫：
https://github.com/pangzi499/dsh-balance-stats
