前言¶
在 DeepSeek Harness（DSH）里用 Composer 对话时，界面通常会显示 token 统计，但不会直接告诉你「这一整棵对话树大概花了多少钱」，也不会标明当前是峰时还是谷时。若要在控制台按天对账，还要自己换算模型价目、缓存命中/未命中与输出 token，并记住 DeepSeek 公布的 UTC 峰谷窗口和中国法定节假日规则。
下面介绍社区插件 nickkupriyanov/dsh-plugin-composer-cost：它挂在 Composer 下方与 token 统计同一行，用人民币（或美元）展示当前会话树累计费用，并用圆点颜色标出实时峰谷状态；点击可展开明细。插件归类为联网工具，维护者为 nickkupriyanov，源码与说明见 GitHub 仓库，社区目录页为 SkillHub 条目。
这是什么¶
dsh-plugin-composer-cost 是 DeepSeek Harness 的 Web UI 插件（当前 package 版本 1.0.1，MIT 许可证）。它向 conversation.composer.dock 插槽渲染一颗「费用胶囊」：显示会话成本（默认 CNY）以及当前是 Peak 还是 Off-peak；交互方式与相邻的统计胶囊一致，点击打开锚定面板，点外部或按 Escape 关闭。
插件不引入 Harness Client 包，锚定、外部点击关闭与图标均在 client.js 内基于 --dsw-* 设计 token 实现；无构建步骤、无运行时依赖，client.js 即浏览器端产物。
费用统计范围¶
- 整棵对话树：子智能体以独立 Session 运行并计入同一账号用量，胶囊会把绑定 Session 与其派生的所有子智能体 Session 加总；面板会拆分「本对话」与「子智能体」，使合计可解释。
- 仅模型轮次：只统计提供商回报 usage 的请求；不包含的部分见下文「统计不到的项」。
金额保留两位小数，各部分先四舍五入再相加，保证「本对话 + 子智能体」与显示总额一致；若四舍五入后为 0，则显示 <¥0.01（或对应货币符号），而不显示为免费。
峰谷时段与价目¶
峰谷规则按 DeepSeek 公开价目文档核对（README 注明 2026-10-14 对照 pricing）：
| 窗口（UTC） | 费率 |
|---|---|
| 周一至周五 01:00–04:00 | 峰时 |
| 周一至周五 06:00–10:00 | 峰时 |
| 其余时刻（含整个周末） | 谷时，为峰时价格的 50% |
中国法定节假日全天按谷时计价；插件内置 2026 年国务院办公清单（国办发明电〔2025〕7号）。README 提醒：2027 年放假通知预计在 2026 年 11 月初发布，需手动把新日期写入 CN_HOLIDAYS，否则 2027 年 1 月会按普通工作日历计价。DeepSeek 定价不按「调休上班日」处理：调休后的周六仍视为周末，按谷时计。
峰时单价（每 1,000,000 tokens，摘自公开价目表；CNY 与 USD 分别四舍五入，互不换算）：
| 货币 | 模型 | Cache hit | Cache miss | Output |
|---|---|---|---|---|
| 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，可改为 USD 选择展示的价目卡。DeepSeek 不单独对 cache 写入计费，因此 cacheWriteTokens 会列出但不计入费用。未知或旧版 model id 回退到 deepseek-flash 行。
界面上的时段圆点：峰时为琥珀色，谷时为绿色。
精度与对账差异¶
持久化的 tokenUsage 投影只有整段会话的 token 合计，没有每次请求的时间戳，因此费用按渲染时刻生效的费率计价。若一次会话跨越峰谷边界，显示金额会落在纯峰时与纯谷时之间；若从未跨边界，则与按该费率手算一致。
与 platform.deepseek.com/usage 控制台对比时，README 归纳了两类结构差异：
- 范围：胶囊是单棵对话树的生命周期累计，不是「自然日」汇总；跨午夜对话仍保留全程总额。
- 控制台按北京日历日：日从北京时间 00:00 起算，即前一日 16:00 UTC；因此同一时刻在北京「今天」与 UTC「今天」的汇总窗口不同。
README 在 2026-10-14 12:34 UTC 的一次实测中，用单机全部 session 日志按谷时 CNY 价目折叠后：UTC 日合计约 CNY 2.0752，北京日窗口约 CNY 2.2944，控制台报告 CNY 2.3300；北京日窗口与控制台相差约 1.5% 以内，残差主要来自无法本地计价的辅助调用。
统计不到的项¶
- 会话标题与网页搜索：日志中有
session/title-llm-request与web/deepseek-search-llm-request等记录，但只有请求、无 usage，本地无法计价。 - 同账号其他客户端：控制台是账号级；胶囊仅对当前聊天树。
安装与启用¶
需要带 Web GUI 的 DeepSeek Harness 构建；插件渲染到 conversation.composer.dock。
从插件页安装：侧栏 → Plugins → Add plugin，粘贴仓库地址后安装，再刷新页面：
https://github.com/nickkupriyanov/dsh-plugin-composer-cost
从 CLI 安装（在 profile 目录下转发给 pnpm）：
dsh plugin --profile <profile> add https://github.com/nickkupriyanov/dsh-plugin-composer-cost
侧载本地目录（不用 pnpm）：将检出内容放到 profile 下，并增加一条 loader 配置，然后完全重启 Harness（仅刷新页面不会更新宿主缓存的客户端 bundle）：
~/.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
安装前建议阅读仓库源码与 MIT 许可证；插件随当前 DSH 进程与用户 profile 加载，与使用其他社区插件一样，应自行确认来源可信。
配置¶
无运行时配置界面；在 client.js 顶部有四个常量：
| 常量 | 默认值 | 含义 |
|---|---|---|
DISPLAY_CURRENCY |
'CNY' |
'CNY' 或 'USD'，选择价目卡 |
RATE_ZONE |
'Europe/Moscow' |
界面展示的墙钟时区 |
RATE_CARDS |
见 README 表 | 各货币价目 |
CN_HOLIDAYS |
2026 列表 | 法定节假日 YYYY-MM-DD |
修改后需按侧载说明完全重启 Harness，以便客户端 bundle 生效。
典型用法¶
- 安装并 reload（或重启）后，打开任意对话，在 Composer 下方 token 统计旁查看费用胶囊与峰/谷标签。
- 点击胶囊：面板展示模型、费率、token 分桶，以及本对话与子智能体拆分。
- 若主要用美元价目或需调整节假日列表，编辑
client.js中上述常量后重启 Harness。
适用场景与注意¶
适合在 DSH Web UI 里长时间跑 Composer、带子智能体分支，且希望就地看到 CNY/USD 估算费用与当前峰谷状态的用户。它不替代官方账单，也不覆盖标题生成、搜索等无 usage 的调用。
DeepSeek Harness 生态强调「一切皆插件」；SkillHub 等目录由社区维护，与 DeepSeek / 幻方无官方从属关系。本插件 GitHub 星标为 0（以目录线索为准），功能与限制以仓库 README 为准。
结尾¶
dsh-plugin-composer-cost 把会话树 token 用量与公开价目、峰谷规则合成 Composer 旁的一行可见信息，减少手算与查文档切换。目录页：https://www.skillhub.cn/plugins/nickkupriyanov/dsh-plugin-composer-cost；源码与安装说明：https://github.com/nickkupriyanov/dsh-plugin-composer-cost。
