Quimos-M/dsh-turn-cost

dsh-turn-cost

本项目目的是制作一个简单的计价显示，使用与DSH本体用量、用时显示一致的外观，显示单轮对话及整个会话按 DeepSeek 官方 API 价格计算的花费。 本项目代码及文档由 WSL 环境 DSH 中调用 deepseek-v4-flash-vision-exp 路由的 deepseek-v4.1-flash 开发或生成，人类只进行了需求、审查和文档微调。

会话累计	每轮花费

左图：输入框下方与「轮/步 · 速度」「总 token · 缓存命中率」同排的会话花费，点开是整段会话的累计明细。 右图：每轮回答尾部动作行里的花费 pill（标签末尾的 含子代理 N 表示该轮有 N 个子代理计入），点开是本轮明细。 截图为早期开发版本内容，仅用于粗略展示功能，实际UI请以使用实测为准。

界面截图中 DSH / DeepSeek 商标归其所有者。

插件功能

• 每轮花费：读取该轮实际发生的每次模型请求，按请求时刻的官方单价计价后求和；弹窗给出本轮用的模型、缓存命中率，以及缓存命中输入 / 缓存未命中输入 / 输出三项各自的 token 数与对应金额、合计。该轮调用的子代理也会计入本轮（见下条）。
• 会话累计：把各轮花费逐轮累加，每一轮用的是当次请求的模型与价格；翻页、滚动、上下文压缩、分叉都不会让数字变化。
• 弹窗可以翻页看总计与每个代理的明细：点开任意一个花费弹窗，明细区下方就是一条极简翻页控件 ‹ 2/4 ›。有子代理时第 1 页是总计（三桶与合计，末尾一行 由 N 个代理构成 : 主 Agent x CNY + 子代理 y CNY 说明钱花在谁身上）、第 2 页是主 Agent（会话 pill 是"本会话自身"，每轮 pill 是"本轮自身"）、第 3 页起每个子代理一页（名称 / 模型 / 三桶 / 合计 / 归属轮次）。没有子代理时弹窗就是单页（与分页前逐条一致），不出现任何翻页控件。
• 翻页怎么操作：点 ‹ / ›，或按 ← / → 前后翻（到两端就停住）；按 Enter 循环翻到下一页（最后一页回到第 1 页），连按即可把每页过一遍；Esc 关闭弹窗（Esc 是原生弹窗本来就有的行为）。子代理个数变化导致页数变少时，当前页会自动夹到最后一页，不会看到空白页。
• 子代理（subagent）：子代理是独立会话，花费记在它自己的日志里。插件按官方会话列表把全部后代子会话（含孙代）的花费聚合进来：会话 pill 的金额 = 本会话自身 + 各子代理自身，弹窗按上面的页序逐页查看总计与各代理明细，并在标签上标 含子代理 N；每轮 pill 分页里的子代理页只包含该轮调用的子代理。归属规则是"按子代理那一轮的开始时刻落进本会话的对应轮次"，取不到时刻时退回它被创建的轮次并在弹窗里标注 按创建轮归属。
• 两个弹窗底部都有一行脚注说明计价依据，例如 DeepSeek 官方 API 价格 · 空闲时段 · 2026-09-10；每一页都保留这行脚注，翻到哪一页都知道数字是按什么价算的。

实现方式

插件不改动DSH官方源码，不覆盖任何原生UI：

1. host 侧注册一个 session「投影单元」——DSH 原生的投影接缝（与官方 tokenUsage / sessionStats 同一种机制）。订阅、水位、变更推送、持久缓存全由框架负责，插件只贡献一个纯折叠函数；这正是数字不受分页 / 压缩影响的原因。
2. client 侧只向两个 list 槽位（输入框下的会话统计行、每轮的动作行）追加条目，并只移动自己的节点去对齐到原生「用量」pill 旁边；不替换、包裹或隐藏任何原生元素。
3. 卸载即净：移出插件后两个 pill 与投影一起消失，无残留。插件内任何一环失败（找不到锚点、注册冲突、渲染异常）都只会降级为"自己不显示"或"退回原位"，在设计上不会影响 DSH 本身。

如何计价

• 区分消耗token类型：缓存命中输入（prompt_cache_hit_tokens）、缓存未命中输入（prompt_tokens − 命中）、输出（completion_tokens；思维链已含在输出内，不重复计费）。
• 单价：DeepSeek官方API价格，以人民币计价，按「模型家族 + 生效时间」版本化，并按请求时刻自动区分高峰 / 空闲（峰价 = 谷价 × 2；高峰为北京时间周一至周五 09:00–12:00、14:00–18:00）。例如 flash 系列当前空闲价为 ¥0.02 / ¥1 / ¥4（每百万 token 的命中 / 未命中 / 输出），deepseek-v4-pro 按其自身价。历史会话用当时的价格（8/17 峰谷启用、8/23 起周末全天谷价、9/10 flash 降价，均已收录）。
• 精度：金额以微元整数累加（round(tokens × 元/百万)），无浮点漂移；显示为 花费 1.1451 CNY，不足 0.0001 元显示 <0.0001 CNY。
• 与原生口径逐条对齐：同一 (turn, step) 的流式样本会被最终样本替换；失败重试的每一次请求都真实累加（llm/retry-started 之后不清零）。
• 未收录模型按同类价估算并在弹窗标注；非官方 provider 的路由（例如经 DSH 官方 llm-pi-ai 适配器接入的第三方模型）默认不计价（其他被计价的请求照常累计），可用插件配置 pricedProviders 放开（配置写在 profile 的 cordis.patch.yml insert 行 config 里；'*' = 全部放开）。官方 provider id 显式列举在 src/providers.ts（唯一维护点）：目前收录 deepseek-official（DSH 0.1.5-rc.1 及更早）与 deepseek-account（DSH 0.2.0-rc.2 起账号登录 / 桌面端）。
• 未计价会显式标出（不会静默显示 0）：只要有请求因 provider 未收录而没计价，pill 标签就写 · 未计价 provider <id>；若整个会话/这一轮完全没有可计价的金额，则写 花费 未计价（<id>） 而不是 0 CNY，弹窗脚注也说明金额不含这些 provider。这样"钱花了但没算进来"一眼可见——DSH 0.2.0-rc.2 把官方 provider 改名时，旧版正是静默失效的。
• 口径边界（重要）：以上数字是「官方公开价目表 × provider 上报 token」推算出的估算值，不等于 DeepSeek 开放平台的最终账单，以开放平台为准。会话花费与每轮花费已包含子代理会话（按官方会话列表聚合全部后代子会话，见上条）；仍不包含标题生成、联网搜索（web/deepseek-search-llm-request）这类同会话内但不走计价请求的旁路调用——平台会为这些请求扣费，但本插件的「会话花费」看不到。