前言¶
在 DeepSeek Harness（DSH）裏用 Our Free Model（OFM）切換多家免費模型渠道時，額度往往分散在各渠道賬號裏，輸入框附近默認不會告訴你「當前渠道還剩多少」。要逐個打開 OFM 或各廠商頁面覈對，打斷對話節奏。社區維護者 zengxiangpeng123 提供的客戶端插件 dsh-our-free-model-balance-zxp，在 DSH 輸入框旁展示 OFM 各渠道的剩餘額度；點開可看全部已登錄渠道。它依賴已安裝的 dsh-our-free-model 插件及其登錄狀態，本身不替代 OFM，只做只讀展示與定時刷新。
這是什麼¶
dsh-our-free-model-balance-zxp 是 DSH 社區插件目錄中分類爲「客戶端」的擴展（當前 package.json 版本爲 1.1.1，MIT 許可）。定位是：在宿主已安裝 OFM 且至少登錄一個渠道的前提下，把各渠道餘額快照展示在輸入框旁，並支持面板總覽與懸浮詳情。未安裝或未登錄 OFM 時，界面會顯示「讀不到 Our Free Model」，不會出現具體數字。
核心功能¶
下面介紹插件在界面上呈現的內容與規則（均來自項目 README）。
圖標：顯示當前會話所用模型所屬渠道的餘額；切換模型後圖標隨渠道變化。
面板：列出所有已登錄渠道，每個渠道一行。
懸浮卡片：該行渠道的精確總額（兩位小數），下方逐賬號列出額度。
顯示規則摘要：
| 情況 | 表現 |
|---|---|
| 渠道有餘額 | 只顯示數字 |
| 餘額爲 0 | 紅底、紅邊、加粗「用盡」 |
| 當前渠道 | 左側一條該廠商品牌色脊線 |
| 未登錄的渠道 | 默認不出現（可在設置中打開顯示） |
| 數字超過一千 | 與 OFM 同款縮寫（如 15K、7.5K、8.0M）；懸浮卡片仍給精確值 |
前提與環境¶
- 已安裝 Our Free Model 插件（
dsh-our-free-model），並在其中登錄至少一個渠道。 - DSH ≥ 0.2.1（插件使用
connection.browserPeer與webServer的 prefix 路由；package.json中 engines 爲dsh >= 0.2.1-rc.1）。
安裝與啓用¶
在 desktop 配置下執行官方安裝命令：
dsh plugin --profile desktop add github:zengxiangpeng123/dsh-our-free-model-balance-zxp
安裝前建議自行查看 GitHub 倉庫源碼與 MIT 許可證；插件在 DSH 進程權限下運行，與目錄中其它社區插件一樣，需自行評估是否滿足環境要求。
設置¶
路徑：設置 → 渠道餘額。
可配置項包括：
- 自動刷新間隔：關閉 / 30 秒 / 1 分鐘 / 5 分鐘 / 自定義 15–3600 秒
- 立即刷新
- 顯示項：時間戳、單位、脊線、底部彙總、用盡標紅、圖標只顯示色點
- 逐渠道隱藏，以及是否顯示未登錄渠道
典型用法¶
- 先完成 OFM 安裝與各渠道登錄（見 OFM 插件文檔）。
- 安裝本插件後打開 DSH 客戶端，在輸入框旁查看當前渠道餘額圖標；需要總覽時點開面板。
- 將鼠標懸停在某一渠道行上，查看精確總額與各賬號明細。
- 若餘額長期不更新，可在「渠道餘額」設置裏點「立即刷新」，或調整自動刷新間隔。
宿主側通過內核 RPC（channel-pack）向 OFM 詢問已登錄渠道並查詢餘額，合成快照；瀏覽器端只讀 GET /api/our-free-model-balance-zxp/snapshot，並通過 POST /watch 心跳告知宿主仍在觀看。無人觀看約 150 秒後輪詢停止以省電；失敗時指數退避（上限 10 分鐘），整輪失敗時保留上次正確數字並標記可能已不準，而非清空。
本地 HTTP 接口包括：/snapshot（GET）、/watch（POST）、/refresh（POST）、/settings（GET/PUT）。宿主本地接口不做鑑權，僅監聽本機，與 DSH 其它插件一致。
適用場景與注意¶
適合：已在 DSH 中日常使用 OFM、需要在對話界面快速感知當前渠道與全渠道額度、避免額度用盡才發現的用戶。
已知限制（README 原文）：
- 內置渠道表共 10 個：
lobsterai、qoder、qodercn、trae、cline、loomy、raccoon、minimax、zcode、gemini。OFM 新增渠道後需更新本插件纔會識別；未識別渠道會被忽略，不會猜測數字。 - 各渠道單位不同（積分 / Token / USD / 配額等），不做跨渠道換算或彙總。
DSH 採用「一切皆插件」的擴展方式；社區目錄站點 SkillHub 插件頁 與 GitHub 倉庫由社區維護，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-our-free-model-balance-zxp 在 OFM 之上補一層輸入框旁的餘額視圖與可配置的刷新策略，適合把「還剩多少」留在對話界面裏。安裝命令與行爲以倉庫 README 爲準。
- 目錄頁：https://www.skillhub.cn/plugins/zengxiangpeng123/dsh-our-free-model-balance-zxp
- GitHub：https://github.com/zengxiangpeng123/dsh-our-free-model-balance-zxp
