refactor(billing): 长上下文阶梯计价改为价格目录数据驱动 - #6353

⚠️ 合并依赖

请先合并 Wei-Shaw/model-price-repo#20 再合并本 PR。

本 PR 删除了代码侧的全部长上下文阶梯兜底，阶梯完全依赖价格目录数据（*_above_XXXk_tokens 字段）。#19 是配套的目录数据修正；若本 PR 先合并，依赖那批修正条目的部署会在间隙期按基础价计费（少收）。

之前错了什么

1. 阶梯规则写死在代码里，与数据源长期脱节

• 目录数据（LiteLLM → model-price-repo）自 v0.1.133 起就携带标准 input/output_cost_per_token_above_272k_tokens 等绝对价字段，但代码从未解析过它们（全仓 rg above_272k 零命中）
• 代码实际依赖的是 v0.1.92 与硬编码同 commit 引入的自定义 long_context_input_token_threshold / *_cost_multiplier 三字段——这套约定在远程目录数据里出现 0 次，唯一载体是 resources fallback 文件里 gpt-5.6 三个条目（运行时被同步数据遮蔽，等于死配置）
• 结果是每适配一个新模型都要改一次代码（gpt-5.4 → 5.5 → 5.5-pro → 5.6 系共四次扩展），且 applyModelSpecificPricingPolicy 对 GPT 系强补 272K，目录数据无法关闭它

2. Gemini 旧规则与 Google 官方定价存在三处偏差

• 边际计价（仅超出部分 ×2）≠ 官方整单换档
• 只对 input/cache_read 加倍，漏了官方的 output ×1.5 档
• 规则套在全部 gemini 模型上（Flash 系被误加价），且仅 /v1beta 入口生效

3. Grok 阶梯从未生效：目录条目（无阶梯字段）优先遮蔽了带阶梯的 Go 兜底价卡——数据侧已在 #19 修复，本 PR 合并后自然生效，无需再改代码。

改成了什么

• 解析层通用折算：deriveLongContextFromAboveTierFields 把目录的 above_XXXk 绝对价折算成阈值+倍率——阈值取自字段名，倍率 = above 价 ÷ 基础价，cache 侧跟随输入倍率；_flex/_priority 变体与 above_1hr（缓存时长）不参与。语义与 LiteLLM 官方 cost calculator 同构：整单换档、严格 >、唯 xAI 用 ≥
• 显式 long_context_* 字段按"字段存在"优先：写 threshold: 0 或 multiplier: 1 即可在数据层显式关闭某模型的阶梯
• 删除全部模型专属硬编码：272K 常量、policy 强补分支、usesOpenAILegacyLongContextPricing、六个 fallback 价卡的 LongContext 字段、Gemini 旧边际链路（CalculateCostWithLongContext / RecordUsageWithLongContext / 阶梯表 marginal 基准）。保留 fastRatio 与 GPT-5.6 cache_write 1.25x 两个分支——它们防御的目录数据缺陷（LiteLLM 把 5.5 priority 错标 2x、5.6 缺 cache_write 价）至今存在
• 两道防御：长上下文倍率 ≤0 在应用点按 1 计（防显式字段残缺把分项乘 0 免费）；目录重载时对比新旧数据，原有阶梯丢失即打 WARN 哨兵（数据驱动后字段误删的 fail 方向是静默少收）
• 渠道配置了定价区间时仍完全以渠道区间为准，不叠加目录阶梯

新增：pricing.override_file 本地覆盖补丁

阶梯改由数据驱动后，"显式 threshold: 0 关某个模型的阶梯"、"修正个别条目价格"这类操作只剩改目录数据一条路——但自托管部署不控制 model-price-repo：fallback_file 只补目录缺失的模型（无法覆盖已有条目），直接改 data/model_pricing.json 又会被哈希同步覆盖。数据驱动缺了一个部署方自控的持久覆盖入口，本 PR 一并补上：

• 新配置 pricing.override_file（默认空 = 关闭，零行为变化）：稀疏补丁 JSON，条目按字段浅合并覆盖目录/回退数据，最高优先级；字段值 null 删除该字段；目录、回退、灾备三条解析路径同语义
• 目录/回退都没有的模型作为独立条目并入（复用主解析路径，须自带价格字段通过有效性过滤）；刻意不在主解析时抢先建条目——否则纯补丁会遮蔽回退文件中的同名完整条目，其余分项价静默变 0
• 最终未生效的条目（模型名拼错、纯补丁落在不存在的模型上）打 WARN 哨兵；文件缺失/损坏仅跳过合并，不影响目录加载；生效时机 = 重启或下次目录下载，与 fallback_file 一致
• 与 fallback_file 分工明确、语义互不影响：fallback 补缺失（灾备快照 + 自定义新模型），override 覆盖已有（最高优先级稀疏补丁）
• 也是目录数据回归时部署侧的止血通道，与上面的 WARN 哨兵配套：哨兵发现阶梯丢失 → override 本地恢复，无需等数据仓修复

示例——某部署想让 gpt-5.5 按 272K 标准价、不启用阶梯：

{
  "gpt-5.5": { "long_context_input_token_threshold": 0 },
  "gpt-5.5-2026-04-23": { "long_context_input_token_threshold": 0 }
}

影响了什么

测试

• make test-unit 54 个包全绿
• 阶梯场景表改用真实解析路径（含 above 折算）构造目录 stub，探针对账测试覆盖每个档界 ±1 与随机点
• 新增：above 折算派生（多阈值/变体排除/无附加费/显式优先）、显式字段残缺的乘 0 保护、渠道区间优先于目录阶梯、Claude sonnet 阶梯行为声明、xAI ≥ 语义
• override_file 8 个用例：字段级合并保留其余字段、null 删字段、加载管线分层顺序（纯补丁不得遮蔽回退完整条目）、新模型并入、未生效 WARN 断言、坏文件/缺文件容错、真实出厂快照端到端（关 gpt-5.5 阶梯且 gpt-5.4 不受影响）

Related: #6440