前言¶
DeepSeek Harness (DSH) 采用了插件化架构，允许开发者根据需求灵活扩展功能。在本地调试或部署智能体时，实时掌握 DeepSeek API 的真实 token 消耗并控制成本是一个关键需求。lstalu/dsh-quota-meter-plus 是一个 DSH 会话额度监控增强版插件，旨在解决缺乏直观计费反馈和预算控制的问题。
核心功能¶
该插件主要提供以下能力：
- 真实 token 计费：按模型 × 可配置价目表记账，支持缓存命中、未命中及输出分档计费。
- 实时进度条：输入框上方显示消耗进度条，请求发起时左侧有脉动效果，扣费瞬间弹出金额徽标。
- 额度耗尽拦截：达到预算上限时自动拦截新的模型调用。
- 峰谷定价：支持按时间段（高峰/空闲）调整价格，支持自定义时区。
- 周末优惠：支持周六/周日全天按空闲价计费。
- 会话独立记账：记账按会话独立，子代理消耗自动并入父会话额度，额度条显示真实总花费。
- 余额校准胶囊：右上角悬浮窗，显示官方余额、实测消耗及本会话已花/剩余。
安装与启用¶
任意装有 DSH 的机器均可通过以下命令安装。Client 端（进度条/弹层 UI）刷新浏览器即生效，Host 端（记账/拦截）需重启 dsh web 进程。
dsh plugin --profile web add github:Lstalu/dsh-quota-meter-plus
使用与配置¶
安装后，插件会在输入框上方显示消耗进度条，并在右上角显示余额校准胶囊。点击胶囊内的刷新按钮可手动更新数据。API Key 也通过胶囊保存，落盘至 ~/.dsh/storages/quota-meter/config.（仅本机）。
注意事项¶
- 升级注意：默认价目表随版本更新，但本机
prices.json（如已存在）会覆盖默认值。升级到含新价格的版本后，需在价格弹层点「重置」或删除配置文件以更新默认价。 - 同源防护：带 Origin 的请求要求其 host 与请求 Host 头完全一致，跨源一律 403。
- 计价基准：官方 2026-08-21 页面为美元价，此处按当日人民币兑美元中间价 6.78 折算。
