mouse33333/dsh-quota-monitor

dsh-quota-monitor

DeepSeek Harness (DSH) Web 插件：界面左下角的额度监控窗口，实时展示
OpenCode Go 套餐（5小时/周/月额度）、DeepSeek API（余额/用量）与
MiniMax Token Plan（5小时/本周额度），以及当前任务的 token 消耗与预估费用。

v0.6.0 起：P0 自建计量（llm/stream 瀑布记账，不再依赖 session_projcache.json）
+ P1 供应商抽象（balance/windows 两类模型 + 预设 + 可配置解析器）+ bundle 打包（免手动 loader 行）。

截图

折叠态（左下角小卡片）

折叠态

展开态（点击卡片打开，Tab 切换）

| 任务详情 | OpenCode | DeepSeek | MiniMax |
|---|---|---|---|
| 任务详情 | OpenCode | DeepSeek | MiniMax |

功能

- 收起态：可拖拽的状态条卡片，宽度跟随侧边栏。显示当前模型与套餐标签、
当前套餐额度/余额（余额金色大字；Go 5h 已用% + 进度条 + 重置倒计时）、
任务四指标（缓存命中率 · 输入 · 输出 · 预估费用）。
- 展开态：384px 监控面板（点击空白 / Esc 关闭），展示全部套餐明细：
当前模型（名称 / 套餐 / 推理 / 路由）、任务指标网格（轮数 / 步数 / 时长 /
缓存 / 输入 / 输出 / 费用，明细在 tooltip）、OpenCode Go 三窗口
（5小时 / 本周 / 本月）、DeepSeek 余额与累计用量。
- 实时同步：与聊天框模型选择同步，切换 DeepSeek ↔ OpenCode Go 的瞬间
卡片即切换对应套餐视图。
- 费用预估：按 API 单价 × 用量折算（USD→CNY）；价格与汇率每日自动刷新
（litellm → openrouter → 内置兜底），DeepSeek 调价次日自动生效。
- P0 自建计量（v0.6.0）：所有"本地用量"来自插件自有的
$DSH_HOME/storages/dsh-opencode-quota-usage.jsonl 账本（llm/stream 瀑布
逐次记账，90 天留存）；会话统计（轮数/步骤/时长）仍优先取 DSH 投影缓存，
缺失时自动回落到自有账本口径，格式变化不报错。
- P1 供应商抽象（v0.6.0）：每个被监控目标 = 一条供应商配置（kind:
balance|windows），内置预设 deepseek-official / opencode-go / new-api /
sub2api；解析器支持内置 / 粘贴 JS / 脚本文件三种形态；/quota-providers
暴露全部已配置供应商快照（供未来设置页使用）。
- 60 秒自动轮询 + 聚焦刷新 + 手动刷新；密钥只留在宿主机，不进浏览器。

安装（v0.6.0 起为 bundle 型，一条命令）

前置：已用 opencode auth login 登录；DSH 凭据配置了 DEEPSEEK_API_KEY。

本地目录（开发模式）
dsh plugin --profile web add D:\OneDrive\DeepSeek\dsh-quota-monitor
或：npm 安装
dsh plugin --profile web add dsh-quota-monitor
或：GitHub 源码安装
dsh plugin --profile web add github:mouse33333/dsh-quota-monitor

重启 GUI 应用使宿主端生效（浏览器端 UI 变更可 HMR 热替换，宿主端路由/价格服务需重启）。

v0.6.0 起包内自带 cordis.patch.yml 补丁层（dsh.bundle.patch），loader 行
由 bundle 机制自动合并，不再需要手动编辑 profile 的 cordis.patch.yml。

更新

npm view dsh-quota-monitor version                    # 查看最新版本
dsh plugin --profile web update dsh-quota-monitor     # 升级
生效：UI 刷新页面即可；宿主端变更重启应用

配置（v0.6.0 新增）

除界面下拉预设外，可通过包条目的 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、opencode-go-usage、new-api-self、
sub2api-usage、generic-balance；parse.source 支持粘贴 JS 函数，
parse.file 支持脚本文件（默认导出一个 (raw) => 快照片段 的函数）。
- OpenCode 令牌：~/.local/share/opencode/auth.json（OPENCODE_QUOTA_AUTH 可覆盖），
或环境变量 OPENCODE_API_KEY。
- DeepSeek 密钥：DSH 凭据中的 DEEPSEEK_API_KEY 或环境变量。
- 价格/汇率：每日刷新一次并缓存 24h；离线回落内置价格表（面板标注"内置价格"）。
- 轮询间隔：60 秒（lib/client.js 中 POLL_INTERVAL_MS）。

安全说明

- 所有 API 密钥只存在于宿主机（credentials 服务 / 环境变量 / opencode auth.json），
仅作为 Authorization 头发往配置的供应商 URL；错误信息令牌脱敏；
- opencode zen usage 接口无官方文档（逆向接口），上游变更需跟进；
- 用量账本只记录 token 数与会话元数据，不含任何密钥或消息内容。

开发与发布

- 源码：lib/index.js（宿主端，零依赖 Node ESM）+ lib/client.js（浏览器端 bundle）。
- 开发记录：docs/DEVELOPMENT.md · 变更历史：CHANGELOG.md
- 冒烟测试：.research/test-refactor-smoke.mjs（mock ctx + 桩上游，验证全部路由契约与账本）
- npm:  · GitHub: