前言¶
DeepSeek Harness（dsh）是 DeepSeek 開源的智能體運行時，官方倉庫把它概括成一句話：Everything is a Plugin（一切皆插件）。模型、工具、會話、UI 都由 Cordis 插件拼出來，開發者不用改核心源碼，就能在配置層掛上自己的能力。當前仍是 developer preview，官方明確寫了會有破壞性變更。
日常用 Web UI 跑智能體時，另一個很具體的問題是：DeepSeek API 還剩多少錢、今天已經燒掉多少。官方提供了 GET /user/balance 接口，但默認界面不會把這筆賬釘在側邊欄。社區插件 dsh-balance-monitor 做的就是這件事：把餘額、剩餘比例條和今日花費，放在側邊欄底部、設置按鈕上方。
需要先說明來源。本文介紹的是維護者 jelly-000 的倉庫，目錄頁在社區站點 DeepSeek Harness 插件庫。該站點是獨立運營的社區目錄，與 DeepSeek / 幻方沒有從屬或背書關係；同名或相近的餘額插件還有好幾份，安裝時請認準 github:jelly-000/dsh-balance-monitor，不要只按包名搜索。
這是什麼¶
dsh-balance-monitor 是一款 界面增強 插件，許可證 MIT，主要語言 JavaScript。package.json 中的版本爲 0.1.2，並聲明 dsh.client.platform 爲 web，也就是說卡片只會出現在 Web UI，不會出現在純終端會話裏。
目錄頁的定位很短：DeepSeek 餘額、剩餘比例條與今日花費，顯示在側邊欄底部。倉庫 README 寫得更具體：樣式只用官方設計令牌，掛在官方槽位 sidebar.footer.action，不改核心、也不做 DOM hack。社區目錄收錄時標註 7 星；本文寫作時 GitHub 倉庫爲 8 星，倉庫創建於 2026-08-13，最近一次推送爲 2026-08-14。
它解決的問題很單一：不用打開平臺控制檯，也能在對話界面裏看見賬戶餘額是否還夠用。
核心功能¶
對照目錄頁、README 和倉庫源碼（lib/index.js、lib/client.js），當前能力可以分成下面幾塊。
1、即時餘額。服務端讀取 DEEPSEEK_API_KEY（環境變量優先，否則讀 $DSH_HOME/.credentials.yaml，默認目錄是 ~/.dsh），調用官方接口 GET https://api.deepseek.com/user/balance。返回的 balance_infos 裏優先取人民幣（CNY），沒有再退回第一條；界面上人民幣顯示爲 ¥，美元顯示爲 $。卡片文案帶中英兩套字典，會跟 dsh 的 locale 走。
2、今日花費。按本機日曆日計算。當天第一次成功查詢的餘額記爲基線，並寫到 $DSH_HOME/storages/balance-monitor.json，刷新頁面或重啓進程後還能接着用。源碼裏的花費是「只累加餘額下降」：充值不會把今日花費變成負數，也不會把已經記下來的花費沖掉；如果餘額因充值高於當日基線，基線會跟着抬高，比例條重新鋪滿。跨天或貨幣切換時，基線和花費都會重置。README 裏寫的 花費 = max(0, 基線 − 當前) 是同一思路的簡化表述。
3、剩餘比例條。比例是「當前餘額 ÷ 當日基線」，限制在 0 到 1。顏色按剩餘比例分三檔：大約還剩 20% 及以上爲藍，10%–20% 爲琥珀，低於 10% 爲紅。顏色變量用的是 --dsw-static-deepseek-500、--dsw-static-amber-500、--dsw-static-red-500 這類官方 token。
4、位置與摺疊態。展開側邊欄時，卡片在底部、設置按鈕上方；收起後變成 36px 圓標，顯示壓縮後的金額，完整數字放在 tooltip 裏。壓縮顯示會向下取整，避免把餘額說高。
5、輪詢與失敗兜底。瀏覽器每 60 秒請求一次；切回標籤頁時立刻再刷。上游失敗時，若本地還有上次快照，界面繼續顯示舊數字並變淡（stale），而不是閃一條錯誤。
實現上是「一行插件、兩半代碼」：cordis.patch.yml 插入 id: balance-monitor 這一行；服務端 lib/index.js 在 ctx.connection 上註冊 /balance RPC（authority: 'loopback'）；瀏覽器 lib/client.js 是手寫的 classic script，無構建步驟、無單獨 CSS。API key 只留在服務端，瀏覽器只能看到餘額數字。README 還寫了：無遙測，出站請求只有官方餘額接口。
安裝與啓用¶
目錄頁給出的安裝命令如下，在 DeepSeek Harness 終端裏運行即可：
dsh plugin add github:jelly-000/dsh-balance-monitor
這是界面增強插件，卡片只在 Web UI 出現。倉庫 README 建議顯式裝到 web profile，並在安裝後重啓 Web UI：
dsh plugin --profile web add github:jelly-000/dsh-balance-monitor#main
dsh --profile web
目錄頁同時提醒：如需可復現安裝，把 #main 換成具體 commit 哈希，例如：
dsh plugin add github:jelly-000/dsh-balance-monitor#<commit>
README 裏還有一條 dsh plugin --profile web add dsh-balance-monitor，並註明是「發佈後」才從 npm 安裝。本文寫作時仍以 GitHub 源爲準，不要改用裸包名，以免裝到同名的其他項目。
啓用前需要已經配置 DeepSeek API Key。插件按下面順序找密鑰：
- 環境變量
DEEPSEEK_API_KEY $DSH_HOME/.credentials.yaml裏形如DEEPSEEK_API_KEY: sk-...的一行
找不到密鑰時，服務端會返回 unauthorized，界面上餘額不可用。密鑰解析是對 YAML 做正則匹配，不是完整 YAML 解析器；如果憑據文件格式很特殊，需要先確認這一行能被匹配到。
用起來是什麼樣¶
安裝並重啓 Web UI 之後，打開側邊欄底部即可。展開態大致是三行：
- 左側「餘額」，右側當前金額，例如
¥99.50 - 中間一條細比例條
- 底部「今日花費」加金額
收起側邊欄後，只剩圓形金額；鼠標懸停可以看到完整數字。源碼裏沒有單獨的「刷新」按鈕，刷新靠 60 秒輪詢和切回標籤頁。
狀態文件是一個本地 JSON，路徑爲 $DSH_HOME/storages/balance-monitor.json。倉庫 README 給出的示例是：
{
"date": "2026-08-14",
"dayStart": 100.0,
"lastTotal": 99.5,
"lastCurrency": "CNY",
"updatedAt": 1755200000000
}
當前 lib/index.js 寫入時還會帶上 spent 字段，用來跨重啓記住當天已經累加的花費。這個文件只服務本機展示，不是賬單導出。
適用場景與注意事項¶
適合已經在用 dsh web、並且 DeepSeek 官方 API Key 配在 dsh 憑據裏的人。如果你只是偶爾查一次餘額，打開平臺控制檯就夠了；這個插件的價值是把數字一直放在側邊欄，跑任務時不用切走。
使用前有幾條邊界需要看清楚。
1、權限與許可證。目錄頁寫得很明確：插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前請檢查源代碼倉庫和許可證。本插件是 MIT，源碼集中在 lib/index.js 和 lib/client.js，可以先讀再裝。
2、今日花費不是官方賬單。數字來自餘額接口的差額，不是 token 明細，也不是平臺賬單頁。它看不到贈額、充值額的拆分（服務端雖然讀了 granted_balance / topped_up_balance，回給界面的快照只有總額和花費），也統計不到別的供應商。換機器或刪掉狀態文件，當天基線會按下一次成功查詢重新起算。
3、只覆蓋 Web UI。package.json 聲明瞭 platform: "web"。終端 TUI 或其它 profile 裏不會出現這張卡片。
4、dsh 仍在快速迭代。官方 README 寫了會有兼容性破壞。槽位名、憑據文件格式或 RPC 通道如果變了，插件可能需要跟着改。
5、安全模型。API key 不進瀏覽器；RPC 使用 loopback 信任策略。即便如此，插件仍運行在 dsh 進程裏，能讀本地憑據、能訪問網絡。不要從不明 fork 安裝。
小結¶
dsh-balance-monitor 把 DeepSeek 官方餘額接口接到 dsh 側邊欄底部：看剩餘額度、看當日消耗、用一條細比例條提示餘額還剩多少。它不改核心、不用構建、密鑰留在服務端，目標就是少切一次頁面。
目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-balance-monitor/
GitHub：https://github.com/jelly-000/dsh-balance-monitor
