会话费用胶囊 vegerot/deepseek-harness-session-cost-pill

💸 会话费用胶囊 — DeepSeek Harness

实时会话花费，就在输入框停靠栏里。

DeepSeek Harness 输入框停靠栏里的会话费用胶囊

DeepSeek 会告诉你烧掉了多少 token，但不会告诉你花了多少钱。
这个插件会告诉你——实时、按会话，而且不用改一行 harness 源码。

你能得到什么

输入框停靠栏本来就在跟踪轮次、速度、token 和上下文。费用胶囊加入这一行：

| 胶囊 | 显示 |
| ⏱ 活动 | 轮次 · 步数 · 解码速度 |
| 💾 用量 | 总 token · 缓存命中率 |
| 💸 费用 | 本次会话的预估花费 |
| 🪫 上下文 | 上下文窗口压力 |

图标会随会话总额往上爬，所以扫一眼这一行，还没看到数字就知道大概了：

| 💸 | 💵 | 💰 | 🔥 | 🚨 |
| 低于 $1 | 低于 $5 | 低于 $20 | 低于 $100 | $100 及以上 |

点一下就展开明细：未缓存输入、缓存读取、输出，各自单独计价，另外还有总额里有多少按高峰价计费、覆盖了多少步。按 Escape、点外面、再点一下都能关掉——用的是浏览器自带的 popover 行为，所以插件自己不带任何对话框状态、监听器或定位代码。

胶囊运行中的完整窗口

安装

dsh plugin --profile web add ~/code/github.com/vegerot/deepseek-harness-session-cost-pill
dsh plugin --profile desktop add ~/code/github.com/vegerot/deepseek-harness-session-cost-pill

安装就这些。不用构建，不用打包器，没有依赖。重启配置档再刷新即可。

为什么这个数字是对的

大多数费用跟踪器拿会话的 token 乘一个固定单价。对 DeepSeek 来说，这错了两处。

1. DeepSeek 有高峰定价

高峰时段价格翻倍，所以每个模型只用一个单价，算不出会话的费用。

| 模型 | 档位 | 缓存命中输入 | 缓存未命中输入 | 输出 |
| deepseek-flash | 非高峰 | 0.003 | 0.15 | 0.60 |
| deepseek-flash | 高峰 | 0.006 | 0.30 | 1.20 |
| deepseek-v4-pro | 非高峰 | 0.022 | 0.66 | 1.98 |
| deepseek-v4-pro | 高峰 | 0.044 | 1.32 | 3.96 |

单位：USD / 1M tokens，摘自 Models & Pricing。

高峰时段为 UTC 周一至周五 01:00–04:00 与 06:00–10:00。其余时间——包括整个周末——都是非高峰。

所以这个插件按每个助手步骤自身时间戳对应的费率来计价。跨过高峰边界的会话，得到的是正确混合后的总额，而不是估算。

2. 缓存命中占大头，而且便宜约 50 倍

缓存命中的花费只是缓存未命中零头。把所有提示词 token 都塞进一个桶里的统计工具，在长智能体会话上会严重失准——而长会话恰恰就是那种缓存命中率读到 96% 的。

对照真实账单验证过

DeepSeek 没有公开定价 API，但它的 Platform 控制台会给出权威费用。拿这个插件的表，对照某个真实账号 10 月的 deepseek-flash 用量：

tokens: hit 140.56512M miss 2.828971M out 0.758458M
published all-off-peak total = $1.301116
platform's own billed total = $0.453778 + ¥6.0056894
= $1.301116 at FX 7.0877 CNY/USD

吻合度 0.11%。表是对的，那个月的用量实际上全在非高峰——要是按高峰算，估算值会翻倍。

工作原理

它是一个普通的 Cordis 客户端插件。harness 里没有任何东西被补丁、fork 或 monkey-patch 过。

ctx.slots.inject('conversation.composer.dock', () => ctx.slots.register({
name: 'conversation.composer.dock',
id: 'cost-pill',
order: 2, // joins the activity (0) and usage (1) pills
}, CostPill));

这个 pill 通过会话标准套件读取聊天快照，然后归并：

- useChat → 每个已结算的助手步骤，各自带着自己的 time 和服务商 usage
- useProjection('modelSelection') → 会话所用的模型

total = Σ over steps costOfUsage(step.usage, model, isPeak(step.time))

isPeak 根据 UTC 星期几和小时判断单次请求，所以计价是按请求而不是按会话。

已知限制

都是实话，不是脚注：

- 中国法定节假日全程算非高峰，这一点没有建模。 那需要一份中国节假日日历，所以落在节假日周内的工作日时段会按高峰计价——这些天会略微高估。
- 模型是按会话级别计价的。 聊天助手节点带着 time 和 usage，但不带模型，所以中途换过模型的会话，每一步都按最近使用的模型费率计价。
- 不显示账号级支出。 DeepSeek 的 Platform 控制台确实通过私有端点暴露真实账单费用，这些端点用 x-dsh-auth-token 认证（不是 Authorization: Bearer），而 DSH 已经通过 getPlatformSession() 持有该授权。这里之所以延迟处理，是因为 Remote 的浏览器端需要生成的 zod 编解码器。

开发

pnpm test # tsc --noEmit && node --test test.ts
pnpm typecheck # 只做类型检查

无需构建步骤的类型。 client.js 有意以纯 JavaScript 形式发布：harness 把插件包作为经典脚本（，没有 type="module"）注入页面，所以文件原样送达 JS 引擎。浏览器端没有构建步骤，也没有运行时类型剥离。

因此类型写在 JSDoc 注解里，由 tsc --checkJs 校验。真正的、CI 可见的检查，不需要任何工具链。test.ts 不一样——Node 原生剥离它的类型。

测试套件锁定了关键行为：

- 高峰时段窗口、两个边界、午间空档，以及周末
- 两个模型在非高峰和高峰时段的公布费率
- 单个会话里一个非高峰步骤加一个高峰步骤，断言各步骤费率之和——这个场景，按会话汇总的总量可证明无法得出
- 未定价的模型不渲染任何标签，而不是渲染一个错误的数字

许可证

MIT——见 LICENSE。