前言¶

在 DeepSeek Harness (DSH) 的對話界面中，用戶往往無法直觀地看到賬戶餘額的實時變化或當前任務的單輪成本。這導致在長時間運行的任務中，一旦餘額耗盡或花費超標，往往只能等到任務中斷後才能得知。dsh-budget-watcher 針對這一場景，提供了一個懸浮窗口，實時展示賬戶狀態與消耗情況。

插件簡介¶

dsh-budget-watcher 是一個 DeepSeek Harness 插件，由 NeutronStar714 維護，歸類於 admin-security。它通過懸浮窗口顯示賬戶總餘額、當前輪次及會話的消耗，並提供實時燃燒速率監控。

核心功能¶

該插件專注於成本監控與控制，具體功能包括：

1. 餘額顯示：顯示賬戶總餘額（含充值與贈送額度）。
2. 消耗統計：顯示當前輪次、會話及子代理的消耗。
3. 燃燒速率監控：
   • 實時監控燃燒速率（默認 15 秒窗口）。
   • 計算平均燃燒速率（凍結於任務結束）。
4. 自動中斷：支持超閾值自動中斷運行中的輪次。
5. 交互與佈局：
   • 支持拖拽佈局，位置跨重載記憶。
   • 支持摺疊爲膠囊狀態。
6. 可視化：提供實時圖表可視化。
7. 性能：不消耗額外的 Token 和請求。

安裝與啓用¶

目前未提供官方提供的安裝命令。插件需要手動配置或部署。根據 package.json 配置，該插件依賴 @deepseek-ai/schemastery (版本 ~3.18.4)，且需要 Node.js 版本 >= 20。

典型用法¶

1. 佈局調整：拖拽懸浮面板到對話界面的任意位置。
2. 狀態摺疊：點擊或雙擊面板頭部，將其摺疊爲膠囊狀態，僅保留狀態點與金額。
3. 數據觀察：在運行任務時，觀察燃燒速率圖表與實時數值，對比不同任務的消耗情況。
4. 閾值配置：通過設置調整警告閾值和中斷閾值。

適用場景與注意¶

• 適用場景：需要長時間運行智能體任務，且對 API 賬戶成本敏感的開發者。
• 注意：
  • 插件默認關閉自動中斷功能（terminateAbovePerHour 爲 0）。
  • Turn targeting 存在精度限制（已知侷限性）。
  • 僅統計當前輪次及其直接/間接產生的子代理消耗。
  • 顯示的餘額爲 DeepSeek 的 total_balance。
  • 不發起額外的 API 調用。
  • 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證（MIT）。

總結¶

該插件通過實時數據可視化和閾值控制，幫助開發者在任務運行過程中精準掌握成本，避免意外耗盡餘額。更多詳情請訪問 GitHub。