前言¶

在 DSH 中調用 DeepSeek API 時，餘額和 token 用量通常要另開接口查詢，或者去翻會話日誌。dsh-balance-plugin 把這兩類信息放進 dsh web 側邊欄底部，提供 Today / All-time 切換，並且只統計 deepseek-official，避免把其他廠商的調用混入同一組數據。

這是什麼¶

dsh-balance-plugin 是 DeepSeek Harness (DSH) 的 web 插件。它的主要作用是：在 web 側邊欄底部顯示 DeepSeek API 餘額和 token 用量，支持今日/全部切換，僅統計 deepseek-official。

公開倉庫地址：

https://github.com/stevenx65/dsh-balance-plugin

許可證：MIT。

核心功能¶

顯示 DeepSeek API 餘額¶

• 調用 DeepSeek 官方接口 GET /user/balance。
• 複用 dsh 的 credentials：~/.dsh/.credentials.yaml。
• 無需手動輸入 API key。

顯示 token 用量¶

• 讀取 dsh session logs：~/.dsh/sessions/<scope>/<session-id>/session.jsonl.zstd。
• 按 provider 聚合：
• uncached input
• cache read
• output
• model call count
• 僅統計 provider=deepseek-official，忽略其他廠商。

切換與展示¶

• 支持 Today / All-time 切換。
• Today 範圍使用北京時間。
• All-time 範圍爲全部歷史。
• 自動適配淺色/深色主題。
• 注入 web 側邊欄底部按鈕和浮動面板，掛載位置爲 sidebar.footer.action。

安裝與啓用¶

1、從插件目錄安裝

dsh plugin --profile web add dsh-balance-plugin

2、安裝後重啓 dsh web，然後刷新頁面。

側邊欄底部會出現 balance 按鈕。

手動安裝¶

需要把以下文件複製到：

~/.dsh/profiles/web/node_modules/dsh-balance-plugin

文件包括：

index.js
client.js
cordis.patch.yml
package.json

然後在 ~/.dsh/profiles/web/cordis.patch.yml 中添加 id 爲 dsh-balance、name 爲 dsh-balance-plugin 的 insert 條目，例如：

- insert:
    - id: dsh-balance
      name: dsh-balance-plugin

保存後重啓 dsh web，再刷新瀏覽器頁面。

典型用法¶

安裝並啓用後，打開側邊欄底部的 balance 按鈕，可以查看 DeepSeek API 餘額和 token 用量，並切換：

Today
All-time

數據接口爲：

/dsh-balance/data?scope=today|all

其中 scope 可取 today 或 all。

適用場景與注意¶

適合經常在 dsh web 中使用 DeepSeek 官方 API，並希望快速查看餘額、今日用量或全部歷史用量的開發者。

使用前注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 該插件僅聚合 provider=deepseek-official，其他廠商不計入。
• Today 範圍使用北京時間。
• Node 端需要 zstd CLI，用於解壓 session logs。
• 瀏覽器端 peer dependency 爲 @deepseek-ai/dsh-client-ui-primitives 0.1.0-rc.6。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/stevenx65/dsh-balance-plugin
• GitHub：https://github.com/stevenx65/dsh-balance-plugin