自定义模型服务的费用估算与实际计费不一致，建议仅统计 Token

[cindy-issue]

提交人: zhufeng
客户端版本: 0.1.50

---

现象

接入自定义模型服务后，Cindy 仍展示人民币费用估算，但该金额与模型服务商针对同一任务、同一时段的实际计费明显不一致，容易让用户误判真实成本。

复现步骤

1. 在 Cindy 中接入自定义模型服务。
2. 选择该服务提供的模型并执行一个任务。
3. 查看 Cindy 显示的“本任务已用”和“最近一轮用户请求累计”费用。
4. 查看模型服务商后台中同一任务、同一时段的计费。
5. 对比两边的费用数据。

期望行为

对于用户自行接入的模型服务，Cindy 默认不估算货币费用，仅准确展示输入 Token、输出 Token 和总 Token 数，避免因服务商定价、路由或计费规则不同而产生误导。

实际行为

Cindy 展示了与服务商实际账单明显不一致的费用估算。

经用户同意公开的脱敏诊断摘要：

• 模型标识：google/gemini-3.7-flash[1m]
• 服务商后台：总费用约 $4.8821，其中输入约 $3.6764、输出约 $1.2058
• Cindy：本任务已用约 ¥115.97，最近一轮约 ¥5.78
• Cindy 显示 Token：共约 161.7k，输入约 158.9k、输出约 2.7k
• 缓存拆分：读取 0、写入 0
• 上述数据对应同一任务、同一时段

复现频率

每次使用该自定义模型服务时都会出现。

已尝试

尚未尝试其他处理方式。

OS: win32 x64 (10.0.26200)
界面语言: zh-CN

[dash-s-cindy]

判断：这个问题值得处理。当前主干仍可能把自定义供应商路径中的 SDK costUsd 当作“实际费用”展示和记账；对于聚合代理、自建网关或采用特殊路由/折扣规则的服务，这个数值未必是供应商最终结算金额，却会以精确费用的语义出现在任务、最近一轮和会话累计中，容易被理解为可与账单直接核对的事实。

进一步检查发现，Cindy 已经具备两项相关能力：

1. 非 Cindy AI 模型可以在设置中编辑“API 估价”，配置币种、输入、输出和缓存单价；
2. 无可用金额但有用量时，消息区域会回退显示 Token。

因此，当前更明确的缺口不是“完全没有 Token 展示能力”，而是费用来源的可信度分层不完整。是否把所有自定义服务默认改成仅 Token，会改变已存在的估价行为，应由产品确认；可以先修复无需等待产品决策的误导性语义。

行动：建议分两步推进。

1. 先修计费语义：对 source: user 的自定义 Provider，只有能够确认是上游实报结算值的金额才进入 actual-cost、session spend 和 daily spend。当前 SDK costUsd 若无法证明是服务商账单事实，应降级为带 reference-price 原因的估算，并与实际支出账本隔离。
2. 复用现有降级链：有用户配置的 API 估价时优先采用该配置；否则可采用匹配的公开参考价并明确标为估算；两者都不可用时，不显示货币金额，直接使用现有 Token fallback。产品再确认自定义 Provider 的默认策略是“展示明确标注的估价”还是“默认仅 Token、用户主动配置后才展示估价”。不建议在该决策前删除现有估价入口。

源码依据

当前快照 ac87ff39e16f746e7017630aa62518e694d08973 中：

• apps/desktop/src/main/usage/turnCostCalculator.ts

  • billingRouteForExplicitProvider() 会把普通自定义 API 来源归为 provider-api。
  • resolveTurnCost() 对绝大多数 provider-api 路径优先读取正数 sdkCostDelta，经 usdToLedgerCurrency() 投影后返回 source: 'sdk'。
  • 这笔钱由 usdMoney() 构造为 kind: 'actual-cost'、approximate: false；即使其本质只是 SDK 根据模型公开单价计算的估值，展示和账本也无法识别。
  • Provider 参考价或用户覆盖价通常只有在 SDK 未报告正数费用时才会生效；这些报价则会正确标为 value-estimate / reference-price，并由 resolveClaudeTurnCostSinks() 与实际费用分流。
  • DeepSeek 已有一个针对性例外：有 Token 明细和官方缓存价时，代码会舍弃可能失真的 SDK 金额，按 Token 分桶重算并保留估算标记。这证明当前架构已支持更安全的分流方式，但该保护尚未覆盖一般自定义 Provider。

• apps/desktop/src/main/usage/modelPriceOverrideStore.ts

  • 已按 (provider instance, runtime, model id) 保存用户的稀疏估价覆盖；生成的报价来源为 user-override、approximate: true。
  • 设置页文案也明确说明：“仅用于估算你自己的 API 或订阅通道用量，不会改变供应商的实际账单。”因此，把未经验证的 SDK 金额显示为精确 actual cost，与已有产品语义并不一致。

• apps/desktop/src/renderer/components/chat/MessageActionBar.tsx

  • 金额缺席且 turnUsageDetails.totalTokens > 0 时，已经回退显示 Token，并在 tooltip 展示输入、输出和缓存明细。无需为本问题另造一套 Token 展示机制。

对现象的解释

报告中的任务金额约为 ¥115.97。按当前代码固定的 USD→CNY 展示汇率 6.7 反推，约为 $17.31；这与服务商后台约 $4.8821 仍相差较大。由此看，人民币符号或换算并不是全部问题，主要差异发生在换算前的金额来源。

当前代码路径与该现象一致：自定义 Provider 的 SDK 金额可以先被当作精确 USD 成本，再投影到账本币种。仅凭 Issue 中的脱敏摘要还不能证明本次一定命中了哪一个 SDK 上报分支；若要完成根因闭环，仍建议补充该轮持久化的 source、kind、approximate、estimateReasons、原始 costUsdDelta 和 provider ID。无需收集 API Key、请求正文或其他敏感内容。

模型 ID 尾部的 [1m] 不是直接计费依据：当前代码会先规范化掉该后缀；长上下文价格由本轮实际输入 Token 命中的 inputTokenPriceBands 决定。因而不建议把修复限定为该模型名或 [1m] 后缀。

建议实现边界

• 在路由上下文中保留“当前 Provider 是否为用户自定义来源”的明确事实，避免仅凭 provider ID 或模型名前缀猜测。
• 对自定义 Provider 的 SDK 金额新增可信度策略：
  • 若协议确实提供服务商实报 billed amount，并能区分于本地估值，可保留 actual-cost；
  • 否则改为 value-estimate + reference-price，不得进入 actual session/daily spend；
  • 如果用户未配置估价且没有可匹配参考价，则金额为 null，让现有 Token fallback 接管。
• UI 中继续同时保留 Token 明细；若显示估价，应在任务金额、最近一轮、会话累计及 Mobile/device-link 投影中保持相同的“估算”标识。
• 不建议用“自定义 Provider 一律无金额”替代来源判断：这会同时移除用户已经主动配置并期待看到的估价能力。

验证建议

至少覆盖以下回归场景：

1. 自定义 Provider 上报正数 SDK costUsd、无用户估价：不得成为精确 actual spend；按最终产品决策显示估价或仅 Token。
2. 自定义 Provider 有用户估价：按输入/输出/cache Token 计算，标为估算，不进入实际支出账本。
3. 自定义 Provider 有公开参考价但无覆盖：行为同样明确标为估算。
4. Cindy AI Gateway 的服务端报价和可确认实报费用保持现有 actual-cost 行为。
5. 内置订阅来源继续只展示价值估算，不被改记为实际支出。
6. CN/USD 两种账本币种、[1m] 后缀、长上下文价格分段、Desktop 与 Mobile/device-link 的金额/Token fallback 均保持一致。
7. 用一个 mock 自定义聚合服务构造“SDK 估值与服务商账单不同”的端到端案例，确认界面不再把二者表述为同一口径。

相关记录

• feat(models): consume unified remote model catalog #1174：已合并统一模型目录、公开参考价和用户本地估价覆盖；明确要求 Provider 参考价只进入估值，不写入真实 daily/session spend。这是本问题最直接的既有产品与技术边界。
• feat(desktop,mobile): 算不出模型报价时消息底部回退显示本轮 token #1211：已合并“无金额时显示本轮 Token”的降级能力，可直接复用于自定义 Provider 无可信金额的情况。
• fix(desktop): 稳定账本币种并停止用量记账丢数据 #1302：已修复账本币种推断、币种抖动和长上下文落档，并要求推断币种显式标为估算；该修复不包含自定义 Provider SDK 金额可信度判断，因此当前主干仍需处理本问题。

[dash-s-cindy]

那么问题来了，用户会以为这个价格是不是官方价格，如果我用了官方的订阅，是不是就按这个价格消费了，会导致用户流失 Cindy

来自 Slack #cindy-issue · @A1aZ