前言¶
在 DeepSeek Harness（DSH）中，如果希望在當前會話旁邊直接看到渠道餘額或用量，可以安裝一個側邊欄插件。dsh-balance-monitor 是一個極簡的 DSH 插件，把當前會話渠道的餘額/用量顯示在側邊欄底部（設置上方）。下面介紹它的功能、安裝方式、憑證配置與注意事項。
這是什麼¶
alanzhao0128/dsh-balance-monitor 是一個 DeepSeek Harness (dsh) 插件，用於在側邊欄底部顯示當前會話渠道的餘額/用量。許可證爲 MIT。
核心功能¶
- 在 dsh 側邊欄底部（設置上方）顯示當前會話渠道的餘額/用量。
- DeepSeek 官方渠道顯示餘額與今日/7日/30日花費窗口。
- 無平臺 token 或官方接口失敗時，今日花費回退爲餘額差值賬本，7日/30日顯示
—。 - 火山方舟渠道顯示 Agent Plan 5小時/周/月套餐額度進度條。
- Command Code 渠道顯示 5h/周/月用量窗口。
- 渠道感知自動顯隱：其他渠道顯示「暫不支持」佔位，無會話不顯示。
- 摺疊態變爲
36px圓形，顯示緊湊餘額 +tooltip。 60s輪詢，切回標籤頁時刷新；上游失敗時保留上次數據並標記stale。- 通過設置面板編輯卡片行爲參數，保存後寫入
~/.dsh/settings.yaml的dsh-balance-monitor段。 - 憑證通過官方
ctx.credentials服務讀取，環境變量優先。
安裝與啓用¶
瀏覽器端 bundle 是手寫的 classic script，無構建步驟。安裝命令：
dsh plugin --profile web add "github:alanzhao0128/dsh-balance-monitor#main"
也可以從 npm 安裝：
dsh plugin --profile web add @alanzhao/dsh-balance-monitor
安裝後重啓 Web UI：
dsh --profile web
重啓後，卡片出現在展開的側邊欄底部、設置按鈕上方。
典型用法¶
DeepSeek 官方渠道¶
餘額查詢需要配置：
DEEPSEEK_API_KEY
官方今日/7日/30日花費還需要配置：
DEEPSEEK_PLATFORM_TOKEN
獲取 DEEPSEEK_PLATFORM_TOKEN：
- 登錄
platform.deepseek.com。 - 打開 DevTools Console。
- 執行：
JSON.parse(localStorage.getItem('userToken')).value
- 把輸出寫入憑證。
注意：DEEPSEEK_PLATFORM_TOKEN 是網頁會話 token，會過期。過期時卡片顯示紅色提示，今日花費回退爲餘額差值估算，7日/30日顯示 —。
火山方舟渠道¶
顯示 Agent Plan 額度需要配置：
ARK_ACCESS_KEY_ID
ARK_SECRET_ACCESS_KEY
配置後顯示 5小時/周/月套餐額度進度條。
Command Code 渠道¶
顯示用量窗口需要配置：
COMMANDCODE_API_KEY
配置後顯示 5h/周/月用量窗口。
設置與狀態¶
打開 dsh 設置：
餘額監控 / Balance Monitor
可編輯卡片行爲參數。保存後寫入：
~/.dsh/settings.yaml
的 dsh-balance-monitor 段。
保存後即時生效，個別參數重啓後生效。
狀態文件位於：
$DSH_HOME/storages/balance-monitor.json
用於餘額差值賬本等狀態。
憑證通過官方 ctx.credentials 服務讀取，環境變量優先。可寫憑證保存走官方 ctx.credentials.set() 寫入：
$DSH_HOME/.credentials.yaml
的 refs 段，插件自身不寫文件。
安全與注意¶
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
- API key 與平臺 token 永不離開服務端；瀏覽器半隻能通過 RPC 通道看到餘額/花費數字，接觸不到憑證。
- 通道走
loopback信任策略。 - 無遙測。
DEEPSEEK_PLATFORM_TOKEN會過期，過期後會影響官方花費窗口，並觸發餘額差值估算回退。- 火山方舟
AK/SK是 IAM 賬號級憑證，能操作所有資源，請妥善保管。 - 社區目錄
skillhub.cn是獨立站點，與 DeepSeek / 幻方無官方從屬關係。
資源¶
目錄頁：
https://www.skillhub.cn/plugins/alanzhao0128/dsh-balance-monitor
GitHub：
https://github.com/alanzhao0128/dsh-balance-monitor
