前言¶

在 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。