dsh-balance-monitor

English | 中文

DSH（DeepSeek Harness）插件：在左侧任务栏实时显示 API 账户余额，支持多平台余额检测、峰谷计价、会话/每日消耗统计与可配置的消耗上限。同时适配 Web 端与桌面端（两者运行同一份代码）。

功能

• 侧边栏小组件（设置按钮上方）：实时显示账户余额（醒目）、今日消耗、上限进度、峰谷状态小点；展开时带手动刷新按钮。显示内容可逐项开关。
• Popover 详情面板：点击余额打开。
  • 平台下拉切换：DeepSeek 官方 / 智谱 GLM / OpenRouter / Tavily，各自余额明细（总余额/可用/赠送/充值等）
  • 今日消耗、累计消耗、各上限进度
  • 近 7 天消耗柱状图
  • 月度日历热力图（每格一天，颜色越深当日消耗越多，历史全部保留，可翻月）
  • 全部会话消耗列表（按最近排序）
• 峰谷计价：内置 DeepSeek 官方规则（北京时间高峰 9:00–12:00、14:00–18:00，谷时半价），价目由插件自动从 DeepSeek 官方文档页查证并每日同步（用户无需也不可手填），成本按每个请求的实际发生时间与模型精确计算。同步失败时回退到内置默认价目。
• 三类消耗上限：每日金额 / 累计金额 / LLM 请求次数，各自可设数值、超限行为（仅提醒 / 提醒并终止）、是否在侧边栏显示。选择「提醒并终止」时，服务端会拦截后续 LLM 请求并返回明确报错。
• Key 配置：在 DSH 设置 → 余额监控 中填写各平台 API Key（掩码、写入式，值不过客户端），DeepSeek 留空时自动复用 DSH 凭据 DEEPSEEK_API_KEY。
• 刷新频率：5s / 30s / 60s 可选。

已支持平台

平台	接口	说明
DeepSeek 官方	GET /user/balance	CNY / USD，含赠送与充值余额
智谱 GLM	GET /api/paas/v4/users/me/balance	CNY，含可用/代金券/现金
OpenRouter	GET /api/v1/credits	USD 额度（总额/已用/剩余）
Tavily	GET /usage	本月用量与限额（搜索/抽取等分类用量）

首版不包含：OpenAI（无官方余额接口）、小米 MiMo（无公开余额 API）——两者仅能在各自控制台查看。

安装

方式一：从 GitHub（推荐）

dsh plugin --profile web add github:ConTr0L0/dsh-balance-monitor

方式二：本地开发（link）

dsh plugin --profile web add link:C:/你的路径/dsh-balance-monitor

方式三：npm（发布后）

dsh plugin --profile web add dsh-balance-monitor

安装后完全退出并重启 DSH（桌面端从托盘 Quit；浏览器版刷新页面），设置页会多出「余额监控」一项。

dsh plugin add 会自动把插件追加进 profile 的 dsh.profile.bundles；若 bundle 未更新，补跑 dsh plugin --profile web install。

成本计算说明

• 数据来源：DSH 会话日志（$DSH_HOME/sessions/.../session.jsonl.zstd），按次增量解析。DSH 会把同一会话内容写入多个 session 文件（父/子会话副本），插件按 assistant/message 的唯一 message.id 去重后再计费。
• 每次 LLM 请求：未命中输入按 input 单价、缓存命中按 cacheHit 单价（0.1 元/百万）、输出按 output 单价（每百万 token）。该口径已与 DeepSeek 平台每日账单逐项对账验证（2026-08-22：flash 误差 0.3%，总量误差约 5%，残差来自失败/中断请求的不可见计费）。
• 请求发生在高峰窗口内按价目表原价，否则乘以「谷时折扣」（0.5）。现行官方规则（2026-08-23 起）：高峰时段为北京时间周一至周五 9:00–12:00、14:00–18:00，周末（周六、周日）全天按低谷价；规则随每日价目同步自动解析。
• 价目表由插件每日自动验证（lib/pricing.js，源：DeepSeek 官方文档页），未知模型走内置默认价（flash 价），无需手动配置。

开发

npm install --ignore-scripts   # 仅 esbuild 构建依赖
node build.mjs                 # 打包 src/client → lib/client.js

• 服务端（host 半）：lib/*.js，无构建步骤，改完即生效（重启 DSH）。
• 客户端：src/client/*（React + TSX），改完需 node build.mjs 重新打包再重启。

架构

• cordis.patch.yml：bundle 挂载声明（insert 插件行），由 dsh plugin add 自动同步。
• lib/index.js：服务端——会话日志折叠计费、多平台余额轮询、上限拦截（llm/stream waterfall）、RPC 通道 /dsh-balance-monitor。
• lib/client.js：客户端 bundle——sidebar.footer.action（侧边栏组件）与 settings.section（设置卡片）两个插槽注册。
• 数据存于 $DSH_HOME/storages/dsh-balance-monitor/state.json（原子写入）；偏好存于 DSH settings 命名空间 dsh-balance-monitor（密钥脱敏）。

License

MIT