dsh-llm-balance：DeepSeek Harness 用量监控插件

在 DeepSeek Harness (DSH) 的使用过程中，频繁切换页面查看账号余额或配额会打断工作流。下面介绍 dsh-llm-balance，这是一个能将余额监控集成到界面右下角的插件。

插件简介¶

该插件是 DeepSeek Harness 的联网工具组件，由 L.H 维护（MIT 许可证）。它的核心价值在于解决多账号管理中“余额不足”和“配额耗尽”的突发问题，通过一张常驻卡片，让开发者无需离开当前界面即可掌握接入 AI 账号的剩余情况。

核心功能¶

插件支持 DeepSeek、Moonshot、Kimi For Coding 和 OpenCode Go 四种服务。它具备以下能力：

自动读取数据：自动查找并读取配置文件中已填写的 API Key 对应的剩余余额或订阅配额，无需额外配置凭据。
多维度展示：
- 充值账号（如 DeepSeek、Moonshot）：显示剩余金额。
- 订阅账号（如 Kimi For Coding、OpenCode Go）：显示已用百分比和重置时间。
状态可视化：
- 颜色预警：剩余不足 20% 变红，不足 40% 变黄，其余为蓝色。
- 当前状态：当前正在使用的提供商旁显示绿点。
交互功能：
- 支持拖动和磁吸贴边。
- 支持折叠显示（气泡模式）。
- 支持调整刷新频率（60秒/5分钟/30分钟/1小时）。
- 支持半透明模式。
- 记住视图、位置、折叠状态和刷新频率。

安装与启用¶

在终端中执行官方安装命令：

dsh plugin --profile web add dsh-llm-balance

安装完成后刷新网页即可生效。插件会自动查找已填写的 API Key，无需额外配置。

使用方法¶

切换视图：点击卡片标题右侧的图标，在“当前模型”、“整体汇总”、“全部来源”之间循环切换。
移动与磁吸：按住标题行拖动，靠近左右边缘会自动磁吸贴边；双击标题可复位到右下角。
折叠/展开：贴边后卡片角上会出现 ‹ 或 ›，点击气泡可折叠（显示首字母+关键数字）或恢复。
刷新频率：点击刷新频率芯片（如 60s）切换间隔。
透明度：点击半透明图标调整底色。

配置说明¶

插件默认配置即可使用，但支持深度定制。修改 cordis.patch.yml 中的 config 配置项并重启 dsh web 生效：

config:
  thresholds: { warn: 40, error: 20 }                    # 剩余低于 40% 黄、低于 20% 红
  balanceThresholds:
    'deepseek-balance:CNY': { warnBelow: 40, errorBelow: 20 }   # DeepSeek 余额阈值设置
  percentMode: used                                      # 显示已用%（改成 left 显示剩余%）
  refreshMs: 60000                                       # 默认 60 秒刷新一次

注意事项：
* 订阅窗口显示的是已用百分比，但颜色判断基于剩余百分比。
* 余额没有总量分母，不硬凑百分比，需在配置中设置金额阈值。
* 修改配置后必须重启服务。

隐私与安全¶

插件遵循隐私保护原则：
* 密钥隔离：API Key 仅保留在宿主进程，不会在浏览器端持久化。
* 接口限制：浏览器端仅收到金额、币种、窗口时长和错误码，接口为只读且不缓存数据。

适用场景¶

适合需要在 DSH 界面中实时监控多账号余额或配额使用情况的开发者。安装前请确认源码与许可证。