前言¶
在 DeepSeek Harness（DSH）裏跑智能體或長對話時，token 用量會在 composer 下方以統計項形式展示，但賬戶裏還剩多少 API 餘額通常要另開頁面或控制台去查。頻繁切換上下文容易在餘額不足時才察覺，影響調試和日常使用。下面介紹社區插件 display-api-balance：它把 DeepSeek API 餘額嵌進 composer 統計行，與 turns、steps、tok/s 等同排顯示，並支持本地低餘額提醒。
這是什麼¶
display-api-balance 由維護者 river291 發佈，分類爲客戶端插件，當前在 GitHub 上爲 1 star。插件定位是：在 DSH 桌面版（及兼容的 web 構建）中，以 ambient stat 形式展示 DeepSeek API 餘額，默認每 60 秒刷新；點擊餘額可設置本地低餘額閾值，達到或低於閾值時金額變紅加粗。密鑰只留在宿主進程，瀏覽器側通過相對路徑請求宿主路由，不把 API Key 交給前端。
核心功能¶
經 README 覈實，插件具備以下能力：
- 展示位置與樣式：渲染在 composer 輸入框下方的 stat 行，排在自帶的 turns · steps · tok/s 與 token 佔用統計之後，共用字號、顏色與圖標風格，不單獨浮層。
- 刷新策略：每 60 秒自動刷新；窗口或標籤重新獲得焦點時立即刷新。
- 低餘額提醒：點擊餘額打開小面板，可設置低餘額閾值（默認 ¥20）；等於或低於閾值時金額變紅並加粗；留空則關閉提醒。閾值保存在瀏覽器
localStorage（鍵名display-api-balance:threshold），不上傳、不隨網絡發送。 - 異常狀態：未配置
DEEPSEEK_API_KEY、請求失敗或未登錄賬號時，有明確狀態展示，不顯示錯誤數字。 - 主題：顏色使用 DSH 的
--dsw-alias-*語義 token，隨主題變化。
宿主側（index.js）註冊 GET /api/balance：每次請求重新解析 DEEPSEEK_API_KEY（輪換密鑰無需重啓），以 Bearer 調用 https://api.deepseek.com/user/balance，15 秒超時，返回上游 JSON。客戶端（client.js）在 conversation.composer.dock 插槽註冊統計項（order: 2），通過 fetch('/api/balance') 訪問上述路由。純 HTTP 的 web 部署下，與其他宿主路由一樣，/api/balance 應僅綁定 loopback。
與舊版 web 做法的區別：舊方案用 webServer.tapIndex 向 index.html 注入腳本；桌面 Electron 窗口加載打包前端，不執行宿主 renderIndex，注入腳本無效。本插件改用 client slot + React，桌面與 web 均可工作。
安裝與啓用¶
插件隨 DSH profile 安裝，可從桌面 Plugins 頁或 CLI 操作。當前無 npm 發佈，須用 GitHub 源（無需構建、無需 allowBuilds）：
dsh plugin --profile <profile> add github:river291/display-api-balance
安裝後在 Plugins 頁確認 display-api-balance 已啓用。若日後發佈到 npm，README 說明也可使用 dsh plugin add display-api-balance（以屆時文檔爲準）。
卸載：
dsh plugin --profile <profile> remove display-api-balance
典型用法¶
- 前置條件：宿主憑證服務能解析
DEEPSEEK_API_KEY——在 DSH Settings → Models 填寫 DeepSeek API Key，或在啓動 DSH 的環境中導出該變量。 - 版本：在 DSH
0.2.1-rc.5（desktop）上開發與驗證；宿主僅用webServer、credentials，客戶端僅用slots、locale。 - 日常使用：啓用插件後，在 composer 下方即可看到餘額；需要提醒時點擊餘額，設置閾值（例如默認 ¥20）；不需要提醒時將閾值字段留空。
- 密鑰輪換：更換 Settings 或環境中的 Key 後，下次請求會自動用新憑證，無需重啓 DSH。
適用場景與注意¶
適合：長期在 DSH 桌面版開發、調試智能體，希望餘額與對話統計同屏可見、並做本地低餘額預警的開發者。
注意：
- 插件以當前 DSH 進程權限運行，安裝前建議閱讀 GitHub 倉庫 源碼與 MIT 許可證，確認行爲符合你的安全策略。
- 社區插件目錄（如 SkillHub）爲獨立生態站點，與 DeepSeek / 幻方無官方從屬關係；DSH 理念是「一切皆插件」，選用社區包需自行評估維護者與更新頻率。
- package.json 版本爲
1.0.0；星標與目錄信息以各站點當時展示爲準。
結尾¶
display-api-balance 把 DeepSeek API 餘額收進 composer 統計行，定時刷新並支持僅本地的低餘額閾值，密鑰留在宿主、前端只讀餘額接口。需要安裝說明與實現細節時，可查閱社區目錄頁與上游 README：
- 目錄頁：https://www.skillhub.cn/plugins/river291/display-api-balance
- GitHub：https://github.com/river291/display-api-balance
