dsh-session-cost

DeepSeek Harness (DSH) 的实时会话费用估算插件（人民币计价），适配 DSH Desktop 0.2.x。

• 实时读数：输入框下方显示整个会话族的累计费用（本会话 + 子代理会话），例如 会话费用 ¥0.27 · 60 次调用 · 子代理 2；
• 点击展开树状明细：读数是一颗按钮，点击展开小面板，逐行展示本会话与每个子代理会话的费用、调用次数、token；
• 日志权威：费用由会话日志的 assistant/message 用量事件逐条累加（缓存命中/未命中拆分），重试与回放不会重复计数；
• 按调用时间计价：价格表带生效日期（ERAS），每条调用按发生时点取当时单价，调价不会改写历史调用的金额；
• 峰谷与调价前后拆分：悬停读数可看到高峰/空闲费用，以及各价格区间（如 2026-10-17、pre-2026-10-17）分别花了多少；
• 只计价 DeepSeek 官方渠道：仅 deepseek-official / deepseek-account 两个渠道有单价；其他渠道只累计 token、不计金额，并在读数上标注"未计价"；
• 零客户端计算：宿主侧 sessionCost projection 折叠出结果并推送到页面，客户端只负责渲染。

估算工具：单价来自 DeepSeek 官方定价页， 不含法定节假日判断（按工作日时段计），不是官方计费凭证。

安装（DSH Desktop）

在 Desktop 里：设置 → 插件 → 添加，选择本目录（本机文件夹）或填入包名安装。 Harness 的插件管理器会把它装进当前 profile（desktop），并自动插入 cordis.patch.yml 中的插件行：

- insert:
    - id: session-cost
      name: dsh-session-cost

安装后无需重启即可生效（宿主行经 HMR 激活，页面刷新后出现读数）。

价格历史（元/百万 tokens）

每条调用按发生时刻（日志事件的 time）选取当时生效的价格，因此调价只影响之后的调用。

2026-10-17 起（峰谷分时：空闲价为高峰价一半；高峰 = 北京时间周一至周五 9:00–12:00、14:00–18:00）

模型	输入(缓存命中)	输入(缓存未命中)	输出
deepseek-flash（空闲/高峰）	0.02 / 0.04	1 / 2	4 / 8
deepseek-v4-pro（空闲/高峰）	0.15 / 0.30	4.5 / 9.0	13.5 / 27.0

2026-10-17 之前（当时为单一价，无峰谷）

模型	输入(缓存命中)	输入(缓存未命中)	输出
deepseek-v4-flash	0.02	1	2
deepseek-v4-pro	0.025	3	6
deepseek-chat	0.5	2	8
deepseek-reasoner	1	4	16

未列出的模型按 deepseek-flash 计（保守估算）。 计费公式：费用 = 未缓存输入×未命中价 + 缓存读×命中价 + 缓存写×未命中价 + 输出×输出价。 新增调价时在 index.js 的 ERAS 里插入一条（含 since 生效日期与 models 单价）即可，历史金额不受影响。

结构

index.js          宿主侧：sessionCost projection（折叠用量 → 费用，wire.view 推给客户端）
client.js         客户端侧：composer 下方读数（useProjection 读取，locale 文案）
cordis.patch.yml  插入宿主插件行
locale/*.json     插件卡片的标题/描述（en、zh）
icon.svg          插件图标

• 宿主侧通过 ctx.sessionProjections.register() 注册投影单元，状态是纯 JSON，随投影缓存持久化；
• 客户端通过标准 props 的 useProjection('sessionCost') 读取框架推送的整值，不做任何事件折叠；
• 文本走 ctx.locale，样式只用 --dsw-alias-* 主题 token。

兼容性

• 针对 DSH Desktop 0.2.1-rc.x 编写（投影 wire.view、useProjection、slot 注册契约）。
• 不依赖任何 npm 包：bundle 自带宿主与客户端代码，安装时无需构建。

已知限制

• 已结束的子会话依赖投影缓存：树结构来自父日志（持久），子会话金额来自它自己的投影状态。进程内使用"最后已知值"快照（标记"已结束"），所以合计不会在子代理结束时掉下来；重启后会先从 DSH 的投影缓存（session_projcache，零 I/O）预热已存子会话的金额。缓存行版本不匹配（插件升级改过 stateVersion）时，会回退为读取该子会话的日志重算一次（启动时最多 200 个，避免启动变慢），并写回新行。只有两条路都失败（例如日志已删除、读取报错）时，该子会话才显示"未加载"、不计入合计。
• 只计价 DeepSeek 官方渠道：deepseek-official / deepseek-account 之外的渠道（自定义 baseURL、第三方网关等）只累计 token，不计金额，读数会标注"未计价"。
• 法定节假日按工作日时段计价（无法从日志推导）。
• 合计值在父会话有新事件时刷新；子代理运行期间读数可能略有滞后，子代理结束后立即补上。

以上问题的分析与候选方案见 docs/RFC-0001-billing-edge-cases.md。

License

MIT