前言¶
在 DeepSeek Harness（DSH）里長時間跑會話或編排任務時，賬戶餘額會隨模型調用持續消耗。界面其他位置的用量統計與錢包金額未必同步，要到平臺側單獨查看既打斷工作流，也容易在餘額偏低時毫無察覺。下面介紹的插件把餘額固定在 Web GUI 底部狀態欄，並可在低於閾值時給出提醒，適合已用 DeepSeek 賬號登錄 DSH 的桌面用戶。
這是什麼¶
dsh-balance-monitor 由維護者 kousenlee 發佈，分類爲聯網工具，在 SkillHub 目錄 與 GitHub 均可找到。插件面向 DeepSeek Harness Web GUI：通過 DSH 自帶的賬戶能力讀取平臺錢包金額，在界面底部展示實時餘額，並支持低餘額閾值與可選的系統通知。許可證爲 MIT，當前 package 版本爲 1.0.0。
核心功能¶
常駐餘額條¶
DSH 各視圖底部有一條細長狀態欄，默認約每 60 秒刷新一次，窗口重新獲得焦點或頁面變爲可見時也會再次拉取。顯示形如 ● Balance ¥x.xx：綠點表示讀取成功；琥珀色表示最近一次失敗，仍顯示上一次成功值；紅點並帶 Low 徽章表示可用總額已低於你設定的閾值。
詳情面板與手動刷新¶
點擊狀態欄可打開面板：上方展示充值餘額、贈送額度、可用總額及最後更新時間，並提供 Refresh now；下方是提醒相關設置（閾值、自動刷新間隔、提醒開關等）。
低餘額提醒¶
默認閾值爲 ¥5.00。當可用總額低於閾值時，狀態欄變紅並顯示 Low；應用內會出現類似 Low balance: ¥4.19 left, below the ¥5.00 threshold. 的提示；若瀏覽器已授予通知權限，還可選擇發送操作系統級通知。
設置與持久化¶
閾值、自動刷新間隔（30 秒 / 1 / 5 / 10 分鐘）、應用內提醒與系統通知開關，既可在狀態欄面板中修改，也可在 Settings → Balance reminder 中配置。偏好保存在當前瀏覽器的 localStorage，刷新頁面或重啓應用後仍保留。界面語言隨 DSH 中英文設置切換。
數據與展示規則¶
餘額經 ctx.remote.account.getBalance(...) 由 DSH Host 向 DeepSeek 平臺查詢，插件不接觸、不存儲、不傳輸登錄令牌。可用總額 = 充值餘額 + 贈送額度（同幣種）；贈送額度先扣，再扣充值錢包。多幣種時不做換算，面板可按數據切換 CNY / USD。讀取失敗不會顯示爲零，而是保留上次成功值並標明陳舊。
環境與前提¶
- DeepSeek Harness 桌面 0.2.2-rc.1 或兼容版本。
- 須使用 DeepSeek 賬號 登錄；僅 API Key、無賬戶登錄的安裝無法讀取賬戶餘額，狀態欄會顯示爲未登錄狀態。
安裝與啓用¶
插件以當前 DSH 進程權限運行，安裝前建議閱讀倉庫源碼與 MIT 許可證。以下命令均出自項目 README。
方式 A：在 DSH 會話中由 Agent 安裝（推薦，無需重啓）¶
在任意 DSH 會話中請 Agent 安裝該插件，或直接調用工具：
plugin_manager install_bundle target = github:kousenlee/dsh-balance-monitor
返回結果中 application: applied 表示插件已在運行中的 GUI 立即生效。
方式 B：CLI 安裝後重啓應用¶
# 桌面版 CLI 通常位於：
# <DSH install>\resources\runtime\cli\bin\dsh.cmd
dsh plugin --profile desktop add github:kousenlee/dsh-balance-monitor
隨後在 <DSH_HOME>/profiles/<profile>/package.json（默認 %USERPROFILE%\.dsh）的 dsh.profile.bundles 中加入 "dsh-balance-monitor"，並重啓 DeepSeek Harness。倉庫提供的 install.ps1 可自動化該流程。
方式 C：本地開發（Windows PowerShell）¶
維護者在 README 中說明了從克隆倉庫執行 install.ps1 的方式；在 macOS 或 Linux 上宜採用方式 A 或方式 B，插件本身爲跨平臺。
典型用法¶
- 安裝並登錄 DeepSeek 賬號後，在各頁面底部觀察
● Balance ¥x.xx及圓點顏色含義。 - 點擊狀態欄打開面板，查看充值/贈送/總額與最後更新時間，需要時點 Refresh now。
- 在面板或 Settings → Balance reminder 中修改閾值並按 Enter 確認；若當前餘額已低於新閾值，會提醒一次，同一低餘額週期內後續提醒至少間隔 30 分鐘。
- 按需開啓應用內提醒與系統通知，並選擇自動刷新間隔。
適用場景與限制¶
適合：已在 DSH 桌面版用 DeepSeek 賬號登錄、希望在 GUI 內持續感知錢包餘額並在偏低時收到提醒的開發者或日常用戶。
不適合或需注意：
- 僅 API Key 場景無賬戶餘額可讀。
- 提醒依賴 GUI 頁面處於打開狀態，應用完全關閉時不會告警。
- 輪詢最快 30 秒，平臺側無客戶端緩存；餘額與 DSH 其他位置的用量統計可能略有差異。
- LiveShare 等非所有者共享視圖無
account遠程權限，不會掛載餘額條。 - 設置按瀏覽器配置文件保存，不跨設備同步。
卸載可在 DSH Agent 中執行：
plugin_manager remove_bundle target = dsh-balance-monitor
或使用 uninstall.ps1 並重啓應用。
結尾¶
dsh-balance-monitor 把 DeepSeek 賬戶餘額接到 DSH Web GUI 底部，用可配置的閾值與刷新策略降低「餘額耗盡才發現」的風險，同時明確不持有登錄令牌、僅通過 Host 查詢錢包金額。更多說明與截圖見倉庫 README；安裝可從 SkillHub 目錄頁跳轉，或直接使用上述 github:kousenlee/dsh-balance-monitor 規格。
- 目錄頁：https://www.skillhub.cn/plugins/kousenlee/dsh-balance-monitor
- GitHub：https://github.com/kousenlee/dsh-balance-monitor
