dsh-cost-manager

dsh-cost-meter

给 DeepSeek Harness（DSH）装上一只电表：底部读数行多一格「已用人民币 X」，按官方峰谷定价算，每个会话各记各的账。

A real cost meter for DeepSeek Harness: one more cell in the composer readout — "已用人民币 X" — priced with DeepSeek's peak/off-peak tariff, accounted per session.

底部读数行末尾多一格 已用人民币 10.27（悬停时出现浅灰圆角底，与原生那几粒一致）。

点它，上方弹出明细面板：

面板里能一眼看出这个数字的口径：三类 token 分开、计费调用次数（含回溯多少条）、 高峰/空闲各花了多少、当前时段与切换倒计时、价目版本、用的哪个模型。

---

它解决什么 / Why

DSH 的底部那行会告诉你用了多少 token，但不会告诉你花了多少钱。而 DeepSeek 的价格是分时段的、也分缓存命中与否 —— 你自己拿计算器算，算出来的数字通常和账单差得很远。

这个插件把那笔账实时算给你看，只算官方通道：

• 底部多一格 已用人民币 6.95，字体、颜色、内边距与旁边原生那两粒逐字对齐（不是"看着差不多"）；
• 鼠标悬停只是变灰底，不弹任何浮层；点一下，上方弹出一张左对齐的明细卡；
• 换到第三方中转渠道时，那一行一个字符都不变 —— 插件不猜、不编、不显示别人的账。

DeepSeek's own readout tells you how many tokens went by; it does not tell you what they cost. Prices vary by time of day and by whether the prompt hit the cache, so hand-arithmetic tends to land far from the invoice. This plugin prices it live, for the official channel only, and leaves the row untouched for third-party providers.

功能一览 / What you get

安装 / Install

插件是一个真正的 profile bundle，所以它会出现在「设置 → 插件」的列表里，可以启用 / 停用 / 卸载。

dsh plugin --profile <你的 profile> add dsh-cost-meter
dsh plugin --profile <你的 profile> add <git-url-or-path>   # 或从仓库/本地目录

装完重启一次 DSH（它是宿主组合里的一行，不是纯运行时热加载）。

Restart the profile afterwards: the plugin is a row in the host composition.

卸载 / Uninstall：dsh plugin --profile <profile> remove dsh-cost-meter

从源码目录装（开发用）

dsh plugin --profile desktop add link:/path/to/dsh-cost-meter

用 link: 装的话，改完文件不需要重新安装：只改浏览器半 （client.js）存盘即生效（HMR 自动换版本）；改宿主半 （dsh-cost-meter.mjs）要重启 DSH。

DSH 版本要求 / DSH version requirement

本插件要求 DSH ≥ 0.2.0-rc.2，并已在 DSH 0.2.0-rc.2（Windows 桌面端）上验证。

engines.dsh 只是声明：npm 只校验它认识的引擎名（node / npm），自定义引擎名不参与检查，所以装错版本不会有安装期告警，表现是运行时报错。

快速上手 / Quick start

装上、重启，然后随便聊几句。底部那一行末尾就会出现：

1 轮 · 3 步 · 12 tok/s   48.2K tok · 缓存命中 93%   已用人民币 0.42   26%

点它，上方弹出明细卡：

本会话花费                                    ¥0.42
─────────────────────────────────────────────────
缓存命中                                        93%
未缓存输入                                   3,412
缓存读取                                    48,900
输出                                         1,204
单价（元 / 1M tok）                    0.02 / 1 / 4
计费调用                          计价 7 次，含回溯 2 次
当前时段                            空闲档，2 小时 15 分钟后切换
价目版本                                 2026-09-10
模型                                 deepseek-flash

计费口径 / Billing rules

只认 provider 路由名，不认模型名 / Route name, not model name

这是整个插件最重要的一条。判断"这通调用该不该计费"看的是 provider 路由名：

deepseek-official · deepseek-account · deepseek · deepseek-api-key
另有兜底：任何以 deepseek- 开头的自有路由

所以：

• ✅ 官方账号登录 → 算
• ✅ 自己的官方 API Key → 算
• ✅ 别人的官方 Key（走同一个 provider）→ 算
• ❌ 第三方中转站（llm-pi-ai 里的 yuni 之类）→ 不算，一个字符都不显示

为什么不用模型名判断：中转站里大量模型就叫 ［phythm］Deepseek-v4-flash。按名字判断会把这些第三方渠道的花销算进"官方花费"里，数字立刻变成假的。想额外把某个路由认成官方，写进 cost-config.json 的 providers 就行。

峰谷定价 / Peak and off-peak

按官方口径，北京时间（Asia/Shanghai）：

明细卡里会写「当前时段」以及还有多久切换（空闲档，2 小时 15 分钟后切换），所以你能决定"要不要等一会儿再跑这活"。

三类 token 分别计价 / Three token buckets

官方对 prompt 侧和输出侧定价不同，且命中/未命中缓存也不同价。DSH 的 TokenUsage 里 inputTokens 就是未命中数（官方定义 prompt_tokens = prompt_cache_hit_tokens + prompt_cache_miss_tokens），所以三类分开算：

花费 = (命中 × 命中价 + 未命中 × 未命中价 + 输出 × 输出价) / 1e6

缓存命中率也按同一口径算：命中 / (命中 + 未命中)。刻意和计费同源 —— 否则会出现"命中率 99% 但金额对不上"这种没法和账单对照的数字。

价目表 / The tariff table

来源 https://api-docs.deepseek.com/zh-cn/quick_start/pricing（元 / 1M tokens）：

价目表带版本：每条有 from（生效时刻）和 id。历史区间按 effectiveFrom 分段 —— 旧调用永远按当时的价算，不会被新价追溯。官方明文说仍可调用、按 Flash 计价的旧名（deepseek-v4-flash、deepseek-v4-flash-vision-exp）已做映射。

不认识的模型：官方通道上遇到价目表里没有的模型，会记一笔「未计价」并在明细里说明，绝不编一个数字。

它是怎么记的 / How the accounting works

一个会话一本账 / One ledger per session

${DSH_HOME}/dsh-cost/ledger.json

v2 schema，每个 session 一条：金额、峰谷各自的小计、按模型的桶、调用次数、价目指纹。子代理有独立的会话 id，花销记在各自的账本里 —— 所以底部那一格显示的永远是当前会话的钱，不会把子代理的开销糊进来。

插件的 llm/stream 钩子观测到 usage chunk 就记一笔。适配器一次调用可能吐多个 usage，只记最后一个，且只记一次。

增量 vs 重算 / Incremental, never recompute

平时永远只做加法。 每次调用往上加一笔，从不回放整个会话。

唯一的例外是价目指纹变了（见下）—— 那时候才精确重放一次，而且按记录的三类 token 与历史峰谷调用次数分摊，不是粗暴地乘一个系数。

回溯补齐 / Backfill

中途才装插件的话，只算"从装载那刻起"显然不对。所以每个会话第一次被记账时，插件会去读它的会话日志：

${DSH_HOME}/sessions/<slugified-cwd>/<sessionId>/*.jsonl.zstd

每个 append 是独立的 zstd 帧，所以按魔数 28 B5 2F FD 切片逐帧解压；每条 assistant/message 带着 time 和 data.usage，按各自发生时刻的峰谷档补进账本。防重复的判据是账本里的 firstAt，实时记账与回溯区间严格不重叠。

明细卡里会写「含回溯 N 次」，所以你能看出这个数字的覆盖面。补不到的（比如日志已被清理）会退回显示「从装载那刻起计」。

定价政策变了怎么办 / When the tariff changes

账本里存着一个定价指纹（价目表 + 峰谷规则 + 节假日表 + 时区 + schema 版本的摘要）。发现某会话的指纹与当前不一致时：

1. 用当前价目把该会话的历史累计 token 精确重算一次，写回新指纹；
2. 之后继续走增量。

重算带下限保护：只会认得更贵，不会让已显示的金额缩水（避免"数字变小了"这种事发生在已经给你看过的金额上）。

要改价或加新档位：编辑 TARIFFS 新增一条 from 更晚的记录 —— 不要改旧档位的数字，那会让历史被新价追溯。

界面 / The UI

底部那一格不是自己开一行，而是注册进原生读数行所在的槽位 （conversation.composer.dock，原生 session-stats 就在那儿），order: 10 排在它后面。

排版是逐条抄原生实现的，不是估的：

悬停只变灰底（与原生那两粒完全一致），不弹任何浮层；明细只在点击时以面板形式给出（点外部或 Esc 关闭）。无障碍名称带一行摘要，键盘 / 屏幕阅读器用户不缺信息。

试过两版悬停提示都被否决了，原因都记在 UI-NOTES.md 里：官方 Tooltip 原语的气泡底色令牌在浅色主题下也是深灰近乎黑（dsw-static-neutral-bluish-850），放在这行浅色读数旁边就是一块黑方块；自绘浅色版则是"根本不需要悬停出东西"。底部那行是"安静读数"的地方。

配置 / Configuration

可选，不建也能跑：

${DSH_HOME}/dsh-cost/cost-config.json

{
  "holidays": ["2027-01-01", "2027-02-06"],
  "providers": ["my-official-gateway"],
  "currency": "CNY",
  "showPeakBadge": true
}

2026 年节假日表是按近年规律预排的，不是官方原文。影响面很小：某天被误判成高峰，只会让当天那几次调用按高峰价计（正好贵一倍），平时判定不受影响。

只读接口 / Read-only API

GET /dsh-cost/api（借用 harness 自己的信任闸 connection.requestRejection，要用浏览器会话凭据读；裸 curl 会拿到 401，那是对的 —— 404 才说明没挂载）。

测试 / Tests

108 项断言，0 失败，不需要开浏览器：

node verify/check-client-bundle.mjs        # 66 项：浏览器半契约 + 界面口径
node --experimental-vm-modules verify/dsh-cost-selftest.mjs   # 42 项：宿主半记账

覆盖的是那些**容易"看着对、其实错"**的地方：

• 金额格式：4.505978 → 4.51、0.5 → 0.50、0.0042 不许显示成 0.00（花了钱就得看见）
• 缓存命中率与计费同源：3M/(3M+1M) = 75%
• 三类 token 分开、回溯次数写进计费行、峰谷小计分开
• 字号 / 颜色 / 内边距 / 圆角逐字匹配 StatsPills 的声明
• 没有悬停浮层（防止以后自己又给加回来）
• 面板在上方（side: top）、悬停无浮层、apply 在缺少官方原语时不抛错、无 sessionId 时返回 null
• 合成日志精确对账：手算峰谷金额与账本分毫不差
• 真实会话日志端到端：回溯补齐后金额与逐条重算一致

已知限制 / Limitations

• 是估算，不是账单。 官方没有价格查询接口，这里是按公示价目表算的。要跟账单对，看的是量级和相对关系。
• 单次调用跨峰谷切换点时，按调用完成时刻归档，不按时长摊分。
• 子代理不并进当前会话那一格（各自的会话、各自的账本，这是设计）。
• 2026 节假日表是按惯例预排，非官方原文；公布后用 cost-config.json 覆盖。
• 第三方渠道不显示任何东西 —— 这是设计约束，不是缺陷。
• 价目表要跟着官方更新：官方改价后需要新增一条 TARIFFS 记录（改完重启）。

文件结构 / Layout

dsh-cost-meter/
├── dsh-cost-meter.mjs     # 宿主半：价目表、账本、llm/stream 计量、回溯、只读路由
├── client.js              # 浏览器半：底部那一格 + 点击面板（官方 dsh.client 惰性工厂）
├── cordis.patch.yml       # bundle 补丁：本包被装成依赖时插哪一行
├── locale/zh.json         # 插件列表里显示的中文名与说明
├── package.json           # dsh.bundle.patch（让它进插件列表）+ dsh.client（提供浏览器半）
├── examples/cost-config.json  # 可选配置示例（节假日表、额外官方 provider）
├── assets/                # README 图与离线复刻页
├── INSTALL.md             # 安装与故障排查
├── UI-NOTES.md            # 界面口径：抄了官方哪些声明、为什么，以及踩过的坑
├── CHANGELOG.md
└── LICENSE

License

MIT —— 见 LICENSE。