钱包花费计 slj-123/dsh-cost-meter

dsh-cost-meter

一个 DeepSeek Harness 客户端插件，把你的真实账号钱包和当前会话按官方价目表估算的花费放进输入框下方的停靠区——外加进行中这一轮已花费的金额。

一个 DeepSeek Harness 插件：在输入框下方显示账号钱包真实余额、本次会话按官方价目表算出的花费，以及本轮花费。

¥94.25 · ¥5.10 ← 状态栏里的 pill（点一下展开） ┌──────────────────────────────┐ │ ⟲ 账号钱包 ¥94.25 │ │ ───────────────────────────── │ │ 充值余额 ¥94.25 │ │ 赠送额度 ¥0.00 │ │ 余额合计 ¥94.25 │ │ 本次会话 ≈¥5.10 │ │ 本轮花费 ≈¥0.033（进行中）│ │ ───────────────────────────── │ │ 显示项 勾选 pill 显示哪几项 │ └──────────────────────────────┘

它解决什么问题

Harness 自带的统计只告诉你「用了多少 token」，不告诉你「花了多少钱」。这个插件补上后者，并且不编数字：

- 钱包余额直接读账号服务（ctx.remote.account.getBalance），是真钱；
- 花费按 DeepSeek 官方价目表 算，含高峰/空闲时段（高峰 = 空闲 ×2）与中国法定节假日；
- 官方改价时，用钱包实际扣的钱反推一个修正系数，pill 自己跟上，不需要你改代码。

插件不接触任何凭据：余额调用走 Host 已持有的账号授权，客户端拿不到令牌。

安装

前提：DeepSeek Harness 桌面版（开发版本 0.2.0-rc.2）。

方式一（推荐）：侧边栏 → 插件管理 → 从本地目录路径安装 → 填本目录的绝对路径。安装结果应为 applied；若状态栏没出现，刷新页面。

方式二（命令行）：

dsh plugin --profile add

装完后 dsh.profile.bundles 会自动带上本包；改完代码刷新页面即可（本地目录是软链，不用重装）。

数字怎么来的

| 数字 | 来源 |
| 充值余额 / 赠送额度 / 余额合计 | ctx.remote.account.getBalance() —— 平台钱包，两位小数，小于一分显示 s.running) 的上升沿。页面刷新不会把一轮切成两半（挂载不算边界——这条是审计出问题后修的）。
- 模型：取自 modelSelection.lastUsed；成本按模型分别累计，会话中途换模型不会互相串味。

自我校准（改价了怎么办）

每个观测窗口都会产生一对样本：(官方表预测的钱, 钱包实际掉的钱, 窗口秒数)，最近 24 组做一次两项回归：

实际扣费 ≈ r × 窗口秒数 + k × 官方表预测 ↑ 时间项 ↑ 价格项

- 官方涨价 → 只动 k → pill 自动按 k 修正；
- 另一台设备在花同一个钱包 → 只动 r → k 保持 1.00，不会被误判成涨价。

闸门：样本不足、样本成本没有差异（斜率无法辨认）、残差过大时一律不修正；倍率钳制在 ×0.25–×4；AUTO_CALIBRATE = false 可完全关闭。更新 RATES 时记得同时改 RATES_VERSION，版本一变旧系数作废。

刷新策略

| 场景 | 频率 |
| 会话正在跑 | 5 秒 |
| 弹框打开着 | 5 秒（有人在看就不退避） |
| 空闲且一直没动静 | 每安静一分钟翻倍，40 秒封顶 |
| 余额变动 / 轮次起止 / 切回前台 / 窗口重新聚焦 | 立刻读一次 |
| 页面切到后台 | 暂停 |

本机会话的花费走推送（用量事件一到就读，亚秒级）；轮询只用于发现推送看不到的花钱（别的会话、别的设备）。平台没有余额推送接口，这是 API 层面的限制。

配置

都在 client.js 顶部：

const RATES = { ... } // 官方单价（人民币 / 百万 tokens） const RATES_VERSION = '2026-09-10' // 价目表修订日；改价后同时更新这两项 const HOLIDAYS = [ ... ] // 法定节假日（全天按空闲计价） const RUNNING_INTERVAL_MS = 5000 // 运行中轮询 const IDLE_INTERVAL_MS = 5000 // 空闲基准 const IDLE_MAX_INTERVAL_MS = 40000 // 空闲退避上限 const AUTO_CALIBRATE = true // 是否应用实测修正

状态栏显示项点开弹框底部有「显示项」一栏，默认收起、点标题展开（标题带箭头，展开状态在弹框开关之间保持）；里面决定 pill 显示哪几项：充值余额 / 赠送额度 / 余额合计 / 本次会话 / 本轮花费。

- 默认是「余额合计 + 本次会话」，与没有这个功能时完全一致；
- pill 里的排列顺序固定（余额合计打头，依次充值余额 / 赠送额度 / 本次会话 / 本轮花费），不随勾选先后变化；勾选项本身的列表按上面表格的行顺序排，和明细对得上；
- pill 上的花费数字直接写数额（¥0.861）：速览要干净，≈ 与实测系数只出现在弹框里，那里才是说明出处的地方；
- 暂时没有值的项不显示：模型未定价时不给估算，本轮还没花钱时不给本轮花费，都不会留占位符；
- 至少要留一项，取消最后一项是无效操作（pill 空了就没法再点开）；
- 第六个勾选「标注『进行中』」只管 pill：关掉后本轮花费只剩数值（¥0.008），弹框那一行始终带「进行中」；默认开启，旧记录（没有这个字段）也按开启处理；没勾「本轮花费」时这一行不显示（它只对那项生效）；
- 存在浏览器 localStorage 的 dsh-cost-meter/view/v1，换浏览器或清缓存后回到默认。弹框里的五行明细不受这个选择影响，始终完整。
- 第七个勾选「花费变红 + 扣血动效」默认关闭：打开后 pill 里的本轮花费写成负数并用负面色（--dsw-alias-state-error-primary），数值上涨时来一下「扣血」——数字下沉回弹 + 一层短暂的红色底光。三道闸门：增量不足 ¥0.0002 不触发、两次之间至少隔 600ms、系统开了「减少动态效果」时完全不播动画。它只作用于 pill，弹框那一行始终是 ≈¥0.008（进行中）。

已知限制

- 页面打开前的那段用量只能整笔按打开时刻的时段计价（跨峰谷时最多差 2×）。逐请求精确计价需要 Host 侧投影，尚未实现。
- 缓存写入没有官方独立价目，按「未命中输入」计价；本账号实测写入量为 0，该假设未生效。
- 钱包是账号级的：别的设备/会话的花费会影响校准样本（回归会把它分离到 r，但仍会引入噪声）。
- 修正系数存在 localStorage，换浏览器/清缓存后需要重新积累样本。
- 节假日表要手工跟进：国务院一般每年 11–12 月公布次年安排。在那之前跨年的空档期里，假期当天会被当成普通工作日按高峰计价（弹框会提示「表只到 XXXX」，但不改数字）。
- 只在 Harness 桌面版上验证过（依赖账号 Remote 与 conversation.composer.dock 插槽）。

语言

界面文案走 Harness 的 ctx.locale：本包注册 cost-meter 命名空间（zh 为键集基准，en 与之逐键对应），槽位声明 locale 后由框架注入 t，跟随 Harness 的语言设置实时切换。组合里没有 locale 服务时回退到中文内置字典，界面不会空白。

维护

升级 Harness 或官方改价时，改 client.js 顶部这几个常量：

| 常量 | 什么时候改 |
| RATES + RATES_VERSION | 官方价目表变了：两个一起改，RATES_VERSION 一变，旧记录下的实测校准系数自动作废 |
| CLIENT_VERSION | 跟随 Harness 桌面版版本号。只能手工跟：客户端半边拿不到 app 版本（启动图里只有模块 id 和路径，__DSH_BOOT__ 没有版本字段，客户端 Service 里也没有，桌面版也没设 user agent） |
| HOLIDAYS | 国办发文公布次年安排后（一般每年 11–12 月）把日期补进去，弹框里的过期提示会自动消失 |

开发与测试

零依赖，直接用 Node 跑：

node test/verify_cost_meter.mjs # 静态：清单、插槽注册、账本/校准/峰谷数学、轮询策略、弹框结构
node test/simulate_cost_meter.mjs # 端到端：迷你 React（真跑 effect）+ 假定时器 + 可控时钟
node test/cost-meter-turn-split.test.mjs # 回归：一轮进行中刷新页面，不得把本轮切断
node test/cost-meter-fixes.test.mjs # 回归：locale 接线（含两套字典的键/占位符一致性）与流的 accept()
node test/cost-meter-view.test.mjs # 回归：显示项的选择、持久化与两条不变量

五套都是离线自检，不需要 Harness、不联网。

许可

MIT，见 LICENSE。