@javierni/balance-show：DeepSeek Harness 餘額與用量監控

在使用 DeepSeek Harness（DSH）開發智能體時，實時掌握賬戶餘額和對話成本是必要的。@javierni/balance-show 插件針對 DSH 的 Web GUI 開發，解決了這一需求，提供了一個集成的儀表盤來顯示餘額狀態和詳細的 Token 用量數據。

插件定位¶

這是一個由 JavierNier 維護的客戶端插件。它讀取當前 Harness 配置的 DEEPSEEK_API_KEY 來查詢餘額，而非 DeepSeek 官方插件，與平臺無隸屬關係。插件完全在本地運行，不內置 API Key，僅查詢安裝者自己的賬戶。

核心功能¶

1. 餘額卡片：右下角浮窗顯示餘額，字體按檔位着色（≥¥50 綠、¥10–50 橙、<¥10 紅），支持手動刷新和收起/展開。
2. 位置記憶與避讓：卡片位置按對話獨立記憶，窗口縮放時跟隨並限制在容器內；側邊欄等面板打開時，會自動貼到面板外側避免遮擋。
3. 當前對話統計：實時顯示當前對話的 Tokens、緩存命中率與費用。費用按高峯/低谷分桶計價，懸浮可查看明細。
4. 技術特性：零依賴、無構建步驟、自動檢查更新、友好錯誤提示。

安裝與啓用¶

通過官方命令安裝：

dsh plugin --profile web add @javierni/balance-show

安裝完成後，重啓 dsh web 並刷新瀏覽器頁面即可看到卡片。

配置要求¶

安裝後必須確認 profile 的 pnpm-workspace.yaml 包含以下兩項，否則插件無法正確掛載，或更新功能無法生效：

# 1. 讓 bundle 的 ESM 依賴能從 flat 目錄解析
nodeLinker: hoisted

# 2. 排除 release-age 門禁，允許安裝最新版本
minimumReleaseAgeExclude:
  - '@javierni/*'

典型用法¶

安裝重啓後，卡片默認顯示在右下角。你可以通過以下方式驗證和更新：

1. 驗證餘額：使用以下命令檢查接口返回的餘額數據。

curl http://127.0.0.1:3080/balance

2. 更新插件：卡片底部常駐顯示版本信息。當顯示“線上版本 vX.Y.Z”爲橙色且可點擊時，點擊即可通過本機 pnpm 執行更新。

注意事項¶

1. 本插件不是 DeepSeek 官方插件，與平臺無隸屬關係。
2. 插件讀取當前 Harness 配置的 DEEPSEEK_API_KEY，不內置 Key。
3. 價目表策展自官方公告，如官方調整價格，需手動同步更新 lib/pricing.js。
4. 計費爲本地估算，非平臺權威賬單。
5. 更新需要本機可調用 pnpm 或 corepack（Windows 上 Node 自帶 corepack）。
6. 插件不內置 API Key，讀取當前 harness 配置的 DEEPSEEK_API_KEY 所對應賬戶的餘額。

更多細節與源碼請查看：GitHub 倉庫