前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在将各类功能模块化。在智能体开发或日常使用中，需要同时管理 OpenCode Go 套餐、DeepSeek API 余额以及 MiniMax Token Plan。dsh-quota-monitor 插件针对这一场景，在界面左下角提供了一个可拖拽的额度监控窗口，实时展示各项资源的使用情况与预估费用。
简介¶
这是一个 Web 插件，用于在 DeepSeek Harness Web 界面中监控多个供应商的额度与用量。它解决了多模型环境下无法统一查看余额和成本的问题。
核心功能¶
- 实时展示：界面左下角的卡片实时展示 OpenCode Go 套餐（5小时/周/月）、DeepSeek API 余额/用量以及 MiniMax Token Plan（5小时/本周）。
- 任务指标：卡片展开后显示当前任务的四项指标：缓存命中率、输入 Token、输出 Token 和预估费用。
- P0 自建计量（v0.6.0）：基于
llm/stream瀑布记账，不再依赖session_projcache.json。账本存储在$DSH_HOME/storages/dsh-opencode-quota-usage.jsonl，会话统计在缓存缺失时会自动回落到自有账本口径。 - P1 供应商抽象：支持
balance和windows两类模型。内置deepseek-official、opencode-go、new-api、sub2api等预设，并提供可配置的解析器。 - 费用预估：支持 USD 转 CNY，价格与汇率每日自动刷新。
- 界面交互：状态条卡片可拖拽，宽度跟随侧边栏。与聊天框模型选择同步，切换模型时卡片视图自动切换。
安装与启用¶
安装前需完成 opencode auth login 并配置 DEEPSEEK_API_KEY。
dsh plugin --profile web add github:mouse33333/dsh-quota-monitor
安装后需重启 GUI 应用。浏览器端 UI 变更支持 HMR 热替换，但宿主端的路由与价格服务变更需要重启应用才能生效。
配置¶
通过插件的 config 字段，可以覆盖默认阈值或新增自定义供应商。
- id: dsh-quota-monitor
name: dsh-quota-monitor
config:
cacheTtlMs: 5000
timeoutMs: 15000
lowBalanceThreshold: 20
providers:
# 覆盖内置预设：给 opencode-go 设独立低阈值
opencode-go:
lowBalanceThreshold: 10
# 新增自定义网关（复用通用余额解析器）
my-gateway:
label: 自建网关
kind: balance
url: https://gw.example.com/v1/balance
apiKeyEnv: MY_GW_KEY
parse: { builtin: generic-balance }
currency: USD
配置项说明：
* 供应商字段：kind（balance|windows）、url、apiKeyEnv、headers、auth（bearer/raw）、currency、parse（builtin/source/file）、lowBalanceThreshold。
* 解析器：支持内置解析器（如 deepseek-balance）以及通过 parse.source 粘贴 JS 函数或 parse.file 引用脚本文件。
* 凭证：OpenCode 令牌读取 ~/.local/share/opencode/auth.json 或环境变量 OPENCODE_API_KEY；DeepSeek 密钥读取 DEEPSEEK_API_KEY 或环境变量。
* 价格与汇率：每日刷新一次并缓存 24 小时，离线时回落至内置价格表。
安全与注意事项¶
- 密钥安全：所有 API 密钥仅作为 Authorization 头发往配置的供应商 URL，不进浏览器。
- 数据隐私：用量账本仅记录 token 数与会话元数据，不含任何密钥或消息内容。
- 接口依赖：OpenCode zen usage 接口无官方文档，属于逆向接口，上游变更需自行跟进。
- 版本变更：v0.6.0 起为 bundle 型，不再需要手动编辑 profile 的
cordis.patch.yml。
总结¶
该插件通过自建计量方案和供应商抽象层，为 DeepSeek Harness Web 提供了稳定、实时的额度监控能力。它将多模型的余额与用量管理集中化，并确保了密钥的安全存储。
