API 费用计 maxwell234smith/dsh-cost-meter

dsh-cost-meter

实时统计你自己的 DeepSeek API 费用，并把结果显示在 DSH 界面输入框下方的状态区：

[闲时] 本次 ¥0.1234 · 今日 ¥8.6027 · 累计 ¥20.6143

- 只算你的：统计范围是本机这台 DSH 安装的全部模型调用。别人在别的机器/别的工具上用同一个 API key 产生的费用，本机看不到、也不会被算进来；本机多开几个窗口也只会算一次。
- 跨全部会话：不止当前对话——所有历史会话、子代理（subagent）、后台任务、会话标题生成、压缩（compaction）、联网搜索，以及插件直接调 ctx.llm.stream() 做实验的调用，都计入。
- 按闲时/忙时区分：忙时按标准价，闲时按官方五折，逐次调用按发生时刻判定，不是按总计折算。
- 实时：界面每 3 秒拉一次快照；Host 侧每完成一次模型调用就记账并落盘。

安装

从 GitHub 安装（推荐锁到 tag 或某个提交，见仓库 Releases）
dsh plugin --profile desktop add github:maxwell234smith/dsh-cost-meter#v0.1.0

本地开发：直接链接源码目录
dsh plugin --profile desktop add link:D:\path\to\dsh-cost-meter

也可以在 DSH 网页版 侧边栏 → 插件 → 安装 bundle 里填 github:maxwell234smith/dsh-cost-meter。
装完刷新一次页面即可生效（Host 半随 profile 热重载加载，浏览器半需要页面重新加载）。

零运行时依赖，无需构建步骤：lib/client.js 是手写的浏览器 bundle。

计费规则（与官方文档一致）

价格来源：（2026-09-29 核对）

| 模型 | 缓存命中输入 | 缓存未命中输入 | 输出 |
| deepseek-flash | ¥0.04 | ¥2.00 | ¥8.00 |
| deepseek-v4-pro | ¥0.30 | ¥9.00 | ¥27.00 |

单位：人民币元 / 百万 token，忙时价。

- 忙时：北京时间（UTC+8）周一至周五 09:00–12:00、14:00–18:00，且当天不是中国法定节假日。
- 闲时：其余全部时段——含周末、法定节假日全天、以及 12:00–14:00 午休——价格 = 忙时价 × 0.5。
- 旧模型 id（deepseek-v4-flash、deepseek-v4-flash-vision-exp）按官方说明归一到 deepseek-flash 计价。
- 未登记的模型 id 回退按 deepseek-flash 价计费（可在配置里自行补价目）。
- 节假日数据：内置 2025、2026 年国务院办公厅公布的法定节假日（src/holidays.js）。2027 年通知尚未发布，届时补录即可。

关于「调休上班日」

官方文档的表述是「周一至周五（不含中国法定节假日）」，按字面含义，调休上班的周末不算忙时（本插件默认口径）。若你认为调休日应视作工作日，把配置 makeupWorkdaysArePeak 设为 true 即可。两种口径每年只差 5–6 天、每天至多 6 小时。

界面

- [忙时]/[闲时]：当前时段，颜色区分；悬浮提示会给出下次切换的具体时刻。
- 本次：当前会话累计（会话 id 自动归一化，session- 前缀不影响匹配）。
- 今日：北京时间当天累计。
- 累计：本机历史总量（首次安装时会自动回填历史会话日志）。
- 悬浮到徽标上可看到：本次/今日/累计的忙时与闲时拆分、今日三桶 token、非会话实验调用、回填状态、统计口径。

徽标挂在插槽 conversation.composer.dock（与官方 token 统计同一条状态带）。想改成整屏常驻角标，把 lib/client.js 里的插槽名换成 shell.overlay 即可。

数据文件

$DSH_HOME/storages/cost-meter/ledger.json # 账本 $DSH_HOME/storages/cost-meter/diagnostics.json # 诊断（排障用）

（Windows 下 $DSH_HOME 默认为 %USERPROFILE%\.dsh）

- 原子写入（临时文件 + rename），变更后 1.5 秒去抖落盘，插件卸载时立即落盘。
- 想清零重来：停掉 DSH，删除 ledger.json，再启动即可（会自动重新回填历史）。
- 文件里金额以整数「微元」记账（1 元 = 1e6），避免浮点累加漂移。

浏览器怎么拿到数据

浏览器半优先走宿主自己的 HTTP 精确路由 GET /cost-meter/snapshot（以页面 origin 为根锚定，不受页面路由影响），失败时才退回框架 RPC 通道 /cost-meter → snapshot。

为什么不用 RPC 通道作主通道：DSH 里 ctx.connection.rpc.call() 用的是相对 URL，当页面地址带路径（例如 /session/xxx）时会解析到 /session/cost-meter/snapshot 而 404，表现为界面显示「读取失败」。HTTP 路由没有这个问题。

该路由由插件自己守门（宿主 webserver 本身不带认证）：

| 检查 | 行为 |
| 方法 | 只允许 GET/HEAD/POST，其余 405 |
| 跨站 | sec-fetch-site: cross-site → 403 |
| 同源 | Origin 与 Host 不一致 → 403 |
| Host | 默认只允许回环（127.0.0.1/localhost/[::1]），防 DNS rebinding；需要局域网访问时用 allowHosts 显式放行 |

POST 同一路径用于客户端上报排障信息（写入 diagnostics.json），不返回业务数据。

界面显示「读取失败」怎么查

1. 看 diagnostics.json：
- rpcRegistered / httpRegistered：两条通道是否注册成功；
- httpRequests / lastHttpAt：浏览器有没有真的打进来；
- lastHttpError：被守门拒绝的原因（cross_site/origin_mismatch/host_not_allowed）；
- lastClientReport：浏览器侧自己上报的失败原因（poll-failed 的 error 字段最有用）。
2. 悬浮到徽标上，提示里也会带上同样的错误文本。
3. 若 httpRegistered 为 false，多半是路由被别的插件占用（换 httpPath）或宿主没加载新代码（重启 DSH）。

配置

在 profile 的 cordis.patch.yml 里按 id 覆盖，例如：

- id: dsh-cost-meter
name: dsh-cost-meter
config:
覆盖/新增单价（人民币 / 百万 token，忙时价） prices: deepseek-flash: output: 8.0 my-proxy-model: cacheHitInput: 0.1 cacheMissInput: 3.0 output: 12.0 追加自定义放假日（公司假等），北京时间 YYYY-MM-DD extraHolidays:
- 2026-12-31
调休上班日是否按工作日计（默认 false） makeupWorkdaysArePeak: false 账本路径，相对 $DSH_HOME ledgerPath: storages/cost-meter/ledger.json 浏览器取数路由 httpPath: /cost-meter/snapshot 额外允许访问取数路由的 Host（默认只允许回环地址）
allowHosts: []
是否在挂载时回填历史会话（默认 true） backfill: true

其它可调项：saveDebounceMs、sessionKeepDays（默认 90）、sessionKeepMax（默认 60）、snapshotSessionLimit、liveBufferLimit。

安装 / 更新

在 profile 目录里把本包链接进来（ 换成你的 clone/checkout 路径）
node \node\bin\node.exe \pnpm\bin\pnpm.mjs add "link:"

再把包名加进 profiles//package.json 的 dsh.profile.bundles。

- 首次安装生效时机：Host 半会在 profile 热重载后立即加载（本机实测：装完账本文件随即生成并完成历史回填）。
- 改 lib/client.js 不需要刷新页面：客户端 bundle 有 500ms 的 mtime 轮询会自动替换（失败会在「设置 → 插件」里显示并可重试）。
- 改 Host 半（index.js/src/*.js）请重启 DSH：HMR 默认只热重载配置与 bundle 列表，模块根未开启（root: []）。本机观察到过一次宿主代码热重载，但不可依赖——以 diagnostics.json 里的 codeRevision 为准：它等于源码里的 CODE_REVISION 常量，才说明新代码已生效。
- 两条通道的注册情况也写在 diagnostics.json：httpRegistered 是主通道；rpcRegistered 是备用通道，在部分组合下注册不上（原因记在 rpcError），不影响使用。

精度与已知限制

- 会话 id 归一化：DSH 里主会话 id 是 session-、子代理会话是裸 ，界面侧给的是品牌化 id。账本统一去掉 session- 前缀存键（老账本会在启动时自动迁移并入），保证「本次会话」查得到。
- 重试：同一 step 内被重试掉的尝试会与最终那次分别计费（与官方 tokenUsage 口径一致），并用用量指纹去重，避免同一次调用被算两遍。
- 缓存写入（cacheWriteTokens）：DeepSeek 不单独计费，本插件按「缓存未命中输入」价并入输入桶。
- 图像 token：官方未明确其计费桶，本插件按「未命中输入」计（inputTokens 已含图像 token）。
- 时刻判定：用会话事件里的完成时刻（time）判定闲忙。官方未说明是按请求发起还是完成时刻，跨时段边界的长请求可能有极小偏差。
- 按会话明细只保留最近 90 天 / 60 个会话，但累计与按天数据不受影响（水位线也始终保留，因此回填永不会重复计费）。
- 2027 年节假日通知发布前，该年的工作日一律按「周一至周五」判定。
- 共用同一 key 的其他人无法被区分：DeepSeek 平台只提供账号级账单，不提供按人/按 key 的官方接口。要做到服务端可分账，只能每人一把独立 key。

结构

dsh-cost-meter/
├── index.js # Host 入口（转发到 src/plugin.js） ├── src/pricing.js # 价表、闲忙判定、单次计价、下次切换时刻 ├── src/holidays.js # 2025/2026 法定节假日与调休数据 ├── src/rates.js # 配置解析（内置价表 + 用户覆盖） ├── src/fold.js # 会话事件 → 已计价条目（含重试去重） ├── src/ledger.js # 账本累加（幂等水位线、闲忙分桶、微元记账） ├── src/plugin.js # cordis 插件：订阅、回填、持久化、RPC 快照 ├── lib/client.js # 浏览器半（手写 lazy-CJS bundle，无需构建） ├── cordis.patch.yml # bundle 注册 └── test/ # node --test：47 项单元 + 集成测试

开发

node --test # 全部测试
测试覆盖：闲忙边界（09:00/12:00/14:00/18:00/周末/节假日/调休）、官方价表自检、别名归一、未知模型回退、账本幂等与纯净性、回填与实时的一致性、重启后不重复计费、配置覆盖、以及端到端的「事件 → 快照 → 落盘 → 重启回填」流程。

许可证

MIT