对话费用计 nickkupriyanov/dsh-plugin-composer-cost

dsh-plugin-composer-cost

一个 DeepSeek Harness Web UI 插件，显示一次对话花了多少钱，以及当前处于哪个 DeepSeek 费率时段。它显示在输入框下方那一行，也就是 token 统计信息原本所在的位置。

输入框下方的费用胶囊：~¥2.71，Off-peak

点击胶囊查看明细：

明细面板：模型、费率、token 分项、本次对话与子代理对比

圆点在高峰时段为琥珀色，非高峰时段为绿色。面板与相邻统计胶囊打开的是同一种锚定触发元素的对话框，点击外部或按 Escape 即可关闭。

金额覆盖范围

- 整棵对话树。 子代理作为独立会话运行，有自己的持久化用量，但计费到同一账户，所以胶囊汇总的是绑定的会话加上它派生的每个子代理。面板把两者拆开，让总额始终可解释。
- 仅模型轮次 —— 服务商上报了用量的那些请求。参见无法包含的内容。

高峰时段表

2026-10-14 对照 <https://api-docs.deepseek.com/quick_start/pricing> 核实。

| 时段（UTC） | 费率 |
| 周一至周五 01:00–04:00 | 高峰 |
| 周一至周五 06:00–10:00 | 高峰 |
| 其余所有时刻，包括整个周末 | 非高峰，正好是高峰的 50 % |

中国法定节假日全天按非高峰计费。已内置 2026 年官方列表（国务院通知 国办发明电〔2025〕7号）。2027 年的通知将在 2026 年 11 月初发布 —— 把那些日期加进 CN_HOLIDAYS，否则 2027 年 1 月会按普通周计费。

DeepSeek 不考虑调休：调休上班的周六仍算周末，因此按非高峰计费。

费率

高峰费率，每 1,000,000 token，逐字取自公布的费率卡。DeepSeek 对人民币和美元分别取整，所以两者互不推导：

| 币种 | 模型 | 缓存命中 | 缓存未命中 | 输出 |
| CNY | deepseek-flash | 0.04 | 2 | 8 |
| CNY | deepseek-v4-pro | 0.30 | 9 | 27 |
| USD | deepseek-flash | 0.006 | 0.30 | 1.20 |
| USD | deepseek-v4-pro | 0.044 | 1.32 | 3.96 |

非高峰是每个数字的一半。DISPLAY_CURRENCY 选择显示哪张费率卡，默认 CNY。DeepSeek 不单独收缓存写入费，所以 cacheWriteTokens 会列出但从不计费。未知和旧版模型 id 回退到 deepseek-flash 那一行。

安装

需要带 Web GUI 的 DeepSeek Harness 构建；插件渲染到 conversation.composer.dock 插槽。

从 Plugins 页面安装。 侧边栏 → Plugins → Add plugin，粘贴 https://github.com/nickkupriyanov/dsh-plugin-composer-cost，安装，然后刷新页面。
从命令行安装 —— 在配置档目录里转发给 pnpm：

dsh plugin --profile <profile> add https://github.com/nickkupriyanov/dsh-plugin-composer-cost

旁加载本地检出，不用 pnpm：把检出复制进配置档，再加一行 loader。

~/.dsh/profiles/<profile>/plugins/dsh-plugin-composer-cost/

~/.dsh/profiles/<profile>/cordis.patch.yml
- insert:
- id: composer-cost
name: ./plugins/dsh-plugin-composer-cost/index.js

然后完整重启 harness。宿主会缓存客户端 bundle 的字节，直到重启才失效，而浏览器模块 id 是这份缓存键的一部分；只刷新页面不会加载改动后的 bundle。

配置

没有运行时选项 —— client.js 顶部的四个常量就是全部可调项。

| 常量 | 默认值 | 含义 |
| DISPLAY_CURRENCY | 'CNY' | 'CNY' 或 'USD'，决定用哪张价目表 |
| RATE_ZONE | 'Europe/Moscow' | 所有显示的墙钟时间都按这个时区表达 |
| RATE_CARDS | 见上文 | 已公布的价目表，每种货币一张 |
| CN_HOLIDAYS | 2026 年列表 | 中国法定节假日，格式 YYYY-MM-DD |

准确性

持久化的 tokenUsage 投影只带整个会话的汇总，没有逐请求时间戳，所以费用按渲染时刻生效的资费计算。跨过峰谷边界的会话，结果落在峰时与谷时两个数字之间；没跨过边界的会话，结果是精确的。

金额打印两位小数，各部分先各自取整再求和，所以 This chat + Subagents 始终等于打印出的总计。本该取整为零的金额打印为 <¥0.01，不会说成免费。

无法计入的部分

- 会话标题和联网搜索。 两者都是计费的服务商调用，会话日志把它们记作 session/title-llm-request 和 web/deepseek-search-llm-request —— 只有请求，没带用量，本地怎么算都定不出价。
- 同一账号下的其他客户端。 platform.deepseek.com/usage 是全账号口径；这个胶囊只统计单个会话。

与计费控制台对比

两边总计不同，有两个结构性原因。

1. 范围。 胶囊统计的是一棵会话树从开始到现在的全部，不是某一天。跨过午夜的会话，整笔都算在里面。
2. 控制台的一天按北京时间算。 它的一天从北京时间 00:00 开始，也就是前一天 16:00 UTC，所以北京时间 00:01 跑的会话属于「今天」，而按 UTC 日统计的总计不含它。

2026-10-14 12:34 UTC 实测：把一台机器上所有会话日志折叠起来，按谷时 CNY 价目表计价：

| 窗口 | 总计 |
| UTC 日，2026-10-14 00:00Z 至今 | CNY 2.0752 |
| 北京日，2026-10-13 16:00Z 至今 | CNY 2.2944 |
| 控制台报告 | CNY 2.3300 |

北京日窗口与控制台的差距在 1.5 % 以内；剩下的差额就是上面那些辅助调用。

文件

| 文件 | 作用 |
| package.json | bundle 清单：dsh.bundle.patch、dsh.client 网页部分、展示元数据 |
| cordis.patch.yml | 插入 composer-cost 加载器行 |
| index.js | 宿主侧——有意留空 |
| client.js | 胶囊、面板、样式、字典与插槽注册 |
| locale/.json | 插件管理器卡片标题与描述 |
| icon.svg | 插件管理器图标 |

不导入任何 Harness Client 包：锚定、点击外部关闭、Escape 处理与硬币图标都实现在 client.js 里，只依赖 --dsw- 设计 token。

开发

没有构建步骤，也没有依赖：client.js 就是浏览器产物，采用加载器懒工厂形式，作为源码提交。由于 Harness 把它实体化之前没有任何类型检查，改由 scripts/check.cjs 强制校验包契约——每个导出的入口点都存在、bundle 补丁点名了本包、工厂 id 等于包名、且没有导入任何 Harness Client 包。

npm run check

每次 push 和 pull request，CI 都会在 Node 20 和 22 上跑同样的检查。

更新日志

发布说明见 CHANGELOG.md。

许可证

MIT