前言¶
用 DSH（DeepSeek Harness）跑智能體任務時，API 餘額和花費通常要另開官方控制檯才能看到：切頁面、登錄、翻賬單，一趟下來手頭的工作就斷了。如果想順手掌握「還剩多少錢、最近每天花多少」，就需要一個常駐在客戶端裏的監視器。
下面介紹的 dsh-deepseek-balance 就是解決這個問題的 DSH 插件：它在窗口右下角放一個懸浮徽章，即時顯示賬戶餘額，並附帶 7 天 / 30 天的用量費用圖表。
這是什麼¶
dsh-deepseek-balance 是由 lin-cheng-lab 維護的 DSH 插件，當前版本 0.1.0，許可證爲 MIT。定位一句話可以說清：DeepSeek API 餘額監視器——DSH 右下角懸浮徽章 + 7 天/30 天用量費用圖表。
DSH 的理念是「一切皆插件」，這個插件把「查餘額」這件事做成了客戶端 UI 的一部分。數據來源分兩路：餘額來自官方接口 GET https://api.deepseek.com/user/balance；用量則統計本機 DSH 會話日誌裏的真實 token 數，再按官方價格換算成費用。
核心功能¶
按 README 的說明，插件提供這些能力：
- 右下角常駐懸浮徽章：狀態色圓點 + 即時餘額，任何頁面/會話下可見；
- 用量費用圖表：7 天 / 30 天柱狀圖，懸停查看每日金額；
- 每 60 秒自動刷新，也可手動刷新；
- 自動適配深淺色主題（使用 DSH 主題變量）；
- 自動讀取已配置的
DEEPSEEK_API_KEY憑證，無需手動填寫； - Key 安全：通過環境變量傳給 curl，命令行/日誌不出現明文。
安裝與啓用¶
先安裝插件，命令爲 README 原文，<你的用戶名> 部分按實際倉庫路徑替換：
dsh plugin --profile web add "github:<你的用戶名>/dsh-deepseek-balance#main"
再配置憑證。在 ~/.dsh/.credentials.yaml 中寫入：
DEEPSEEK_API_KEY: sk-xxxxxxxxxxxxxxxxxxxxxxxx
經過上面的步驟，重啓 dsh --profile web，右下角即可看到餘額徽章。插件會自動讀取這份憑證，不需要在界面裏手動填 Key。
注意：插件的 Client 平臺是 web，必須以 dsh --profile web 方式運行。
工作原理¶
插件分 Host（Node 進程）和 Browser UI 兩半。Browser UI 部分掛載在 shell.overlay 上，負責懸浮徽章和圖表；查詢時通過 connection.rpc.call 調用 /deepseek-balance，由 Host 完成三件事：
credentials.resolve解析憑證；- 通過 shell 調用 curl 請求餘額接口，Key 經環境變量傳遞，不出現在命令行和日誌；
sessionQuery統計本機會話日誌的 token 用量並換算費用。
README 中的結構圖如下：
┌──────────────┐ connection.rpc.call ┌──────────────────────────┐
│ Browser UI │ ──────────────────────▶ │ Host (Node) │
│ shell.overlay│ /deepseek-balance │ ├─ credentials.resolve │
│ 懸浮徽章+圖表 │ ◀────────────────────── │ ├─ shell curl 餘額 API │
└──────────────┘ RpcResult │ └─ sessionQuery 用量統計 │
└──────────────────────────┘
需要說明的是，用量圖表基於本機 DSH 會話日誌的 token 統計，本地沒有記錄的更早歷史會以灰色示意柱展示。
本地開發與構建¶
如果想自己改代碼或從源碼構建，要求 Node >= 22.19.0（package.json 的 engines 字段）。先拉取依賴，再執行構建：
pnpm install
pnpm build # tsc 編譯 Host + tsdown 打包 Client
構建產物爲 lib/index.js（Host 半，RPC handler：餘額/用量查詢）與 lib/client.js（Client 半，懸浮徽章 UI）。
適用場景與注意事項¶
適合的場景：
- 長時間在 DSH 裏使用 DeepSeek API，想隨時掌握餘額；
- 關心每日花費趨勢，想用 7 天 / 30 天圖表覆盤用量；
- 不想把 API Key 交給第三方面板，希望 Key 只留在本機憑證文件裏。
幾點注意：
- 插件以當前 dsh 進程的權限運行，可以讀取本機憑證和會話日誌，安裝前建議先檢查源碼與許可證（本項目爲 MIT）；
- 必須以
dsh --profile web啓動，否則 Client 不生效； - 餘額查詢依賴 Host 通過 curl 調用官方接口，Key 經環境變量傳遞，不會出現在命令行或日誌中。
結尾¶
回顧一下：dsh-deepseek-balance 把 DeepSeek 的餘額與用量信息搬進了 DSH 客戶端右下角，餘額來自官方接口，用量來自本機會話日誌的真實統計，Key 全程留在本機。對每天和 DeepSeek API 打交道的開發者來說，這是一個小而實用的補充。
項目地址：
- GitHub：https://github.com/lin-cheng-lab/dsh-deepseek-balance
- 社區目錄頁：https://www.skillhub.cn/plugins/lin-cheng-lab/dsh-deepseek-balance
（目錄爲社區獨立站點，與 DeepSeek / 幻方無官方從屬關係。）
