前言¶
在 DeepSeek Harness（DSH）中使用 DeepSeek API 時，賬戶餘額與到服務商的網絡延遲是兩個關鍵指標。現有 UI 並未在側邊欄底部提供常駐顯示，需要切換到瀏覽器開發者工具或外部監控工具才能查看，在長時間運行會話中頻繁查看會打斷工作流。下面介紹一個 DSH 插件，在側邊欄底部常駐一個小掛件，同時顯示賬戶可用餘額和到模型服務商的實時網絡延遲。
這是什麼¶
xuezhining/dsh-deepseek-balance 是 DeepSeek Harness 的一個客戶端插件，由維護者 xuezhining 開發。它通過 Host 進程提供兩條同源路由，Client 半註冊到 sidebar.footer.action，在側邊欄底部展示餘額與延遲，無需額外配置即可使用。
核心功能¶
Host 半路由¶
Host 半負責數據獲取，兩條同源路由都保留在 Host 進程中：
| 路由 | 內容 | 緩存 |
|---|---|---|
GET /deepseek-balance |
DEEPSEEK_API_KEY 賬戶餘額（api.deepseek.com/user/balance） |
10s |
GET /deepseek-balance/ping |
對各服務商 origin 的 HEAD 往返耗時 | 2s |
兩條路由都接受 ?refresh=1 參數繞過緩存。
延遲探測目標¶
延遲探測的目標自動從當前 provider 配置發現，優先級爲：
llm-deepseek的baseURLllm-pi-ai的providers.*.baseURL- 默認
https://api.deepseek.com
也可通過環境變量覆蓋：
DSH_BALANCE_PING_URLS=https://a.example,https://b.example
Client 半行爲¶
Client 半註冊到 sidebar.footer.action，負責前端展示與輪詢：
- 餘額每 30 秒輪詢一次，延遲每 5 秒輪詢一次
- 頁面重新可見時立即刷新
- 點擊掛件可強制刷新余額與延遲
- 延遲顏色：
≤400ms爲常規，>400ms爲警告，>900ms或不可達爲紅色報錯 - 懸停可見：總餘額 / 充值 / 贈金 / 各目標 host 的延遲 / 更新時間
- 若延遲路由尚未就緒（例如 Host 未重啓），掛件自動只顯示餘額，不顯示紅槓
顯示規則¶
| 情況 | 掛件顯示 |
|---|---|
| 正常 | ● ¥19.21 · 178ms |
| 餘額讀取中 | ● ··· · 178ms（黃點） |
| 缺少 API Key | ● 未配置 DEEPSEEK_API_KEY · 178ms（紅點） |
| 餘額失敗 / Key 無效 | ● — · 178ms（紅點） |
| 服務商不可達 | ● ¥19.21 · —（延遲變紅） |
| 側邊欄收起 | 只顯示 ¥19.21（56px 窄欄放不下延遲） |
配置¶
無需額外配置項。餘額讀取使用環境變量 DEEPSEEK_API_KEY，該變量在 ~/.ds-harness-desktop/dsh-home/.credentials.yaml 的 refs 下維護。每次查詢都會重新解析，更換 API Key 無需重啓 DSH。
安裝與啓用¶
使用官方安裝命令：
plugin_manager install_bundle target=<本目錄絕對路徑>
安裝後插件行 id 爲 deepseek-balance，可在「設置 → 插件」中啓用或停用。
典型用法¶
安裝後無需配置，在 DSH Web UI 中打開任意對話或設置頁面，側邊欄底部會自動出現掛件，顯示當前賬戶餘額和到服務商的延遲。點擊掛件可立即刷新，懸停可查看更詳細的餘額構成與各目標 host 的延遲信息。
適用場景與注意¶
適合需要長時間運行會話、關注 API 賬戶餘額與網絡延遲的開發者。插件以當前 DSH 進程權限運行，安裝前建議查看源碼與許可證。該插件由社區維護，與 DeepSeek 或幻方無官方從屬關係。
短結尾¶
該插件通過兩條同源路由與輪詢機制，在 DSH 側邊欄底部提供餘額與延遲的常駐顯示，減少切換工具查看指標的操作。更多細節可訪問插件目錄頁與 GitHub 倉庫。
- 插件目錄：https://www.skillhub.cn/plugins/xuezhining/dsh-deepseek-balance
- GitHub：https://github.com/xuezhining/dsh-deepseek-balance
