在 DeepSeek Harness（DSH）中構建智能體時，開發者通常需要精確掌握 API 調用的成本。yyfather/dsh-balance 插件解決了這一需求，它將 DeepSeek / MiMo 的賬戶餘額與逐請求計費信息直接展示在對話底部的狀態欄（composer dock）中。
功能¶
- 實時餘額查詢：實時查詢 DeepSeek 賬戶餘額。密鑰僅存儲在 Host 側，僅本機可訪問。噹噹前會話爲 MiMo 等外部模型時，DeepSeek 餘額不顯示。
- 逐請求精確計價：支持按每個請求的時間戳選擇高峯/空閒檔價，按模型選價，並使用官方投影替換規則去重。支持四種計費維度：
- 本會話：當前會話從創建至今的全部花費。
- 本次活躍：自本次插件啓用以來新產生的花費。
- 最近一次：當前會話最新一步請求的花費。
- 上次對話：當前會話之前的上一會話花費（MiMo 會話按小米美元價 × 匯率折算）。
- 多模型價目：內置 DeepSeek V4 系列（Flash/Vision Exp/Pro 等）與小米 MiMo V2.5 系列的價目。支持峯谷定價，可在面板中按模型+時段編輯。美元模型按可配置匯率換算。
- 花費超線提醒：當本次活躍花費 ≥ 提醒線（默認 ¥1）或 DeepSeek 餘額 < 提醒線（默認 ¥10）時，狀態欄變爲橙色徽標。點擊狀態欄面板可修改這兩條提醒線。
- 自動刷新：每次對話結束後自動刷新余額 + 每 5 分鐘自動刷新（可在面板中開關）。
安裝¶
方式一：插件市場（推薦）¶
在 DSH 的設置 → 插件市場中找到本插件，在可安裝頁點擊卡片即可完成安裝。
方式二：手動安裝¶
- 克隆倉庫到 DSH 的 profile 依賴目錄：
git clone https://github.com/YYfather/dsh-balance.git "$USERPROFILE\.dsh\profiles\node_modules\@yyfather\dsh-balance"
- 在 profile 的
cordis.patch.yml末尾追加：
- insert:
- id: dsh-balance
name: '@yyfather/dsh-balance'
- 重啓 DSH Desktop。
配置與使用¶
- 密鑰配置：在 DSH 的設置 → 模型中保存 DeepSeek 密鑰，插件默認引用
DEEPSEEK_API_KEY。 - Host 側覆蓋：在
cordis.patch.yml中可覆蓋以下配置項：
apiKeyRef: DEEPSEEK_API_KEY # 餘額查詢憑據引用
baseUrl: https://api.deepseek.com # API 根地址
timeoutMs: 20000 # 上游查詢超時
allowRemote: false # 安全默認，不允許非本機訪問
- 運行時設置：點擊狀態欄面板，可編輯價格檔位與提醒線，修改在進程內生效。
依賴與安全¶
- 依賴：需安裝 Node >= 20 以支持 Host 原生 fetch。依賴 Host 側的
webServer、credentials、sessions、sessionQuery和timer服務，以及 Client 側的slots和react。 - 安全：密鑰僅在 Host 側解析，瀏覽器端只能訪問本地路由（
dsh-balance/api/*）。默認配置不允許非本機訪問插件路由（allowRemote: false），路由響應不含任何上游原文或密鑰。
總結¶
該插件通過狀態欄集成，爲開發者提供了直觀的餘額監控和逐請求計費能力。對於需要精細化控制 DeepSeek 調用成本的用戶，這是一個實用的工具。
