鲸鱼电表Shiye-10Pages/dsh-whale-meter

🐳 鲸鱼电表 whale-meter

给你的鲸鱼装个电表 —— DeepSeek Harness 用量与费用面板

一行安装 · 零配置 · 消耗量段位 · 人民币账单 · 涨价前后对比 · 可晒的战绩卡片

English · 安装 · 配置 · FAQ

你这个月在 DeepSeek Harness 上烧了多少 token？到什么段位了？

鲸鱼电表把它算清楚：本月消耗量、🐟→🐳 五档段位、估算超过多少用户，外加一句有画面感的换算——「≈ 592 遍《三体》全集」。一键生成战绩卡片，直接发出去。

顺带也把钱算明白：8-17 DeepSeek 涨价了（v4-flash 未命中输入 ¥1 → ¥3，输出 ¥2 → ¥9），同一份用量按新旧两套价目分别算给你看，缓存帮你挡下多少、哪个模型在烧钱，一目了然。

真实运行录制：会话头部的花费徽章 → 完整账单 → 一键生成账单卡片。画面里每个数字都是真跑出来的，没有摆拍。

30 秒装上

dsh plugin --profile  add dsh-whale-meter

重启 dsh web，会话页顶部出现 🐳 花费徽章，点开就是完整账单。

从源码装：dsh plugin --profile  add github:Shiye-10Pages/dsh-whale-meter（首次需按提示在 profile 的 pnpm-workspace.yaml 里授权构建，建议锁定 commit）。

它能告诉你什么

- 🐳 消耗量段位：本月烧了多少 token → 🐟小鱼苗 / 🐠热带鱼 / 🐬海豚 / 🐋座头鲸 / 🐳蓝鲸，附估算分位与「≈ 多少遍《三体》」的量级换算。全部本地计算，零上报——分布曲线内置在仓库里（tier.data.ts 写明了推导依据，欢迎用真实数据提 PR 改进），分位如实标注为估算，不谎称「全球排名」
- 今日 / 昨日 / 本月 / 累计花费：按 DeepSeek 官方价目实时估算，¥ 为主（可切 $）
- 📈 涨价对比：同一份用量，新价 vs 旧价分别多少、多花了多少，直接标在面板上。8-17 之前是预演（「按新价今天要花 ¥X」），之后是回溯（「按旧价只要 ¥X」）
- ⚡ 峰谷计价：8-17 起分高峰/空闲两档（空闲是高峰的一半）。电表按每笔请求各自发生的时刻套价，处于空闲档时徽章亮 ⚡½——注意这不等于比涨价前便宜，空闲价依然高于旧平价
- 跨调价日正确：价目表按「生效区间」组织，8-16 的账按旧价、8-17 的账按新价，历史账单不会被一刀切算错
- 缓存账本：命中率 + 「缓存帮你省下 ¥X」——涨价后缓存比以前更值钱（命中与未命中的差价被同步放大）
- 多厂商精准计价：DeepSeek / Anthropic / OpenAI / Google / 智谱 GLM / 月之暗面 Kimi 共 46 个模型，逐项核对官方定价页。支持国内厂商的分档计价（如 GLM-5.1 输入  想要的模型不在表里？用上面的 prices 自己补，或者提个 issue 告诉我。未知模型不会被瞎算，面板会如实标为「未定价」。

工作原理 & 数据隐私

- 监听 dsh 会话日志中的用量记录（assistant/chunk usage 权威、assistant/message.usage 兜底，按官方口径去重），逐行追加到本机 ~/.dsh/whale-meter/usage-YYYY-MM.jsonl
- 只存原始 tokens，不固化金额——价目表更新后历史账单自动按新表重算
- 所有数据都在你本机。除了你主动配置 key 后的余额查询（直连 DeepSeek 官方接口），不发出任何网络请求，不上报任何遥测
- 电表坏了不能弄沉船：采集器全程防御式编程，任何异常只降级不打扰 agent 运行

FAQ

Q：金额和平台账单会完全一致吗？
按官方价目和逐笔时刻估算，通常非常接近；以 DeepSeek 平台账单 为准。价目表内置版本号（当前 2026-08-16，已收录 8-17 新价），官方调价后只需改 src/pricing.data.ts 一个文件——里面是按「生效区间」组织的价格时代，追加一组即可，历史账单自动各按各价重算。

Q：8-17 到底涨了多少？

| v4-flash（每百万 tokens） | 命中 | 未命中 | 输出 |
|---|---|---|---|
| 8-17 前 | ¥0.02 | ¥1 | ¥2 |
| 8-17 起・高峰 | ¥0.10 | ¥3 | ¥9 |
| 8-17 起・空闲 | ¥0.05 | ¥1.5 | ¥4.5 |

v4-pro 同步调整（高峰 ¥0.30 / ¥9 / ¥27，空闲减半）。高峰时段为北京时间 9:00-12:00、14:00-18:00。
换句话说：即使全跑在空闲时段，也比 8-17 之前贵。电表能做的是让你看清这件事，以及把重活挪到空闲档少挨一刀。

Q：用了第三方模型（非 DeepSeek）怎么办？
tokens 照常统计；未知模型不会编造价格，标记为「未定价」，可在 prices 里自行补价目。

Q：支持 TUI / headless 吗？
数据采集在 host 侧，Web 面板是展示层。TUI 场景可直接 curl http://127.0.0.1:3080/whale-meter/api/summary。独立 TUI 视图在路线图上。

路线图

- [x] 历史会话回填（安装前的账单）
- [x] 多厂商价目内置（6 家 46 个模型，含国内分档计价）
- [ ] v0.2 项目账本：按天 / 周 / 月 / 项目维度看消耗，配可晒的战绩卡片
- [ ] 月度账单报告导出（CSV / Markdown）
- [ ] 错峰调度建议（把重活自动留给空闲时段）
- [ ] 独立 TUI 视图

声明

社区插件，与 DeepSeek 官方无关。dsh 处于 developer preview，接口变动时本插件会尽快跟进适配（欢迎 issue 催更）。

觉得有用的话，给个 ⭐ —— 这是对一个深夜写插件的独立开发者最大的鼓励。

License

MIT © 2026 十页 (shiye)