前言¶

用 DeepSeek Harness（dsh）做智能體開發時，API 賬戶餘額通常要單獨打開控制檯或查賬單頁面。開發過程中頻繁切換窗口，既打斷節奏，也難直觀判斷「今天已經花了多少」。dsh-balance-monitor 是一個面向 Web 客戶端的 dsh 插件：把 DeepSeek 賬戶餘額、剩餘比例條和當日花費，直接放在側邊欄底部、設置按鈕上方。下面介紹它的定位、能力與安裝方式。

這是什麼¶

dsh-balance-monitor 由社區維護者 jelly-000 發佈，歸類爲客戶端插件。它在 dsh 側邊欄底部註冊一個極簡卡片，即時展示 DeepSeek API 賬戶餘額、一條細的餘額剩餘比例條，以及當天已花費金額。樣式使用官方設計令牌，展開與摺疊兩種形態均與 dsh 界面一致。

插件當前版本爲 0.1.2，採用 MIT 許可證。GitHub 倉庫：jelly-000/dsh-balance-monitor；社區目錄頁：SkillHub 條目。

核心功能¶

README 中列出的能力如下，均經服務端與瀏覽器兩半協同實現。

安裝與啓用¶

瀏覽器端 bundle 爲手寫 classic script，無構建步驟，git 安裝無需 prepare 腳本。

從 GitHub 安裝：

dsh plugin --profile web add "github:jelly-000/dsh-balance-monitor#main"

或從 npm（發佈後）：

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

安裝完成後重啓 Web UI：

dsh --profile web

卡片會出現在展開的側邊欄底部、設置按鈕上方。

典型用法¶

安裝並重啓 Web UI 後，無需額外配置即可使用——前提是 $DSH_HOME/.credentials.yaml 中已配置有效的 DEEPSEEK_API_KEY（或對應環境變量已設置）。

日常使用流程：

1. 啓動 dsh --profile web，展開側邊欄，在底部查看當前餘額與今日花費。
2. 側邊欄摺疊時，卡片變爲 36px 圓形，懸停可查看 tooltip。
3. 插件每 60 秒自動輪詢；從其他標籤頁切回 dsh 時會立即刷新。

狀態文件示例（$DSH_HOME/storages/balance-monitor.json）：

{
  "date": "2026-08-14",
  "dayStart": 100.0,
  "lastTotal": 99.5,
  "lastCurrency": "CNY",
  "updatedAt": 1755200000000
}

工作原理與安全¶

一個插件行同時承擔兩種角色（dsh.bundle patch + dsh.client 瀏覽器註冊表聲明）：

• 服務端半（lib/index.js）—— 在 ctx.connection 上註冊 /balance RPC 通道（loopback 信任圍欄）。每次調用讀取 API key、查詢餘額 API、折算當日基線，返回 { ok, value }。
• 瀏覽器半（lib/client.js）—— 零依賴 classic-script bundle，註冊 sidebar.footer.action 條目，負責卡片渲染與輪詢。

安全方面：API key 不離開服務端，瀏覽器半隻能通過 RPC 通道看到餘額數字；通道走 loopback 信任策略；無遙測，網絡請求僅指向官方餘額接口。

適用場景與注意¶

適合長期在 dsh Web UI 中開發、調試智能體的用戶，希望在同一界面內掌握賬戶餘額與當日消耗，減少切換賬單頁面的次數。

使用前請注意：

• 插件以當前 dsh 進程權限運行，安裝前應自行檢查源碼與 MIT 許可證。
• 今日花費以當天首次成功查詢的餘額爲基線計算，跨日後基線會重置。
• 上游 API 暫時不可用時，界面保留上次數據並標記 stale，而非彈出錯誤。
• SkillHub 爲獨立社區目錄，與 DeepSeek / 幻方無官方從屬關係；插件亦非常方出品。

結尾¶

dsh-balance-monitor 把 DeepSeek 餘額、剩餘比例條與今日花費收進 dsh 側邊欄底部，改動小、集成方式符合官方槽位約定。若你正在用 dsh Web 客戶端做日常開發，可以按上文命令安裝試用。

• 社區目錄：https://www.skillhub.cn/plugins/jelly-000/dsh-balance-monitor
• GitHub：https://github.com/jelly-000/dsh-balance-monitor