用途:维护 OpenUsage 的定价补充文件 Sources/OpenUsage/Resources/pricing_supplement.json。该文件为公开目录未收录的模型(如 Cursor 原生 auto、composer-*、github_bugbot)提供价格,提供 fast 变体倍率,并把供应商日志或 CSV 中的 slug 映射到规范定价键。合并到 main 后,工作流 .github/workflows/pricing-supplement.yml 会校验并发布到 GitHub Pages,已安装应用约一小时内获取更新,无需发新版本。普通 API 模型(新 Claude、GPT、Gemini、Grok)由每日 LiteLLM 与 models.dev 抓取自动定价,除非需要别名规则或目录有误,否则不要加入补充文件。
主要流程:1)拉取 https://cursor.com/docs/models-and-pricing.md 全文作为权威来源,关注 Cursor 原生模型价格(输入、缓存写入、缓存读取、输出,均为每百万 token 的美元价)、fast 变体及其定价、长上下文档位(如 Sonnet 1M 按超过 200k 费率计费整个请求)、Cursor 使用的模型名与 slug。2)与现有补充文件比对:价格变化、缺失的新模型、被删除或改名模型(历史用量可能引用的条目不要删除,只有完全错误才移除)、fast_multipliers(仅当目录本身无 -fast 键时需要)、alias_rules(锚定正则、转义点号、可选 effort/thinking 分组;-fast 规则须排在基础规则之前,先匹配者优先)。若模型已在 LiteLLM 或 models.dev 中,优先用别名指向其规范键,而非在补充文件中重复价格。3)编辑文件:更新 updated_at 为当天 YYYY-MM-DD,保持两空格缩进、纯数字费率,非显而易见条目加 $comment。4)校验:运行资料中给出的 python3 检查脚本与 swift test --filter "ModelPricing|PricingBundledResource";若新增别名规则覆盖真实用量中的 slug,需在 Tests/OpenUsageTests/ModelPricingTests.swift 增加解析测试用例。5)提交 PR:从 main 分支,按仓库 PR 结构写描述,引用 Cursor 文档来源并逐条列出价格或别名变更,切勿直接推送定价改动到 main。6)合并后验证发布:用 gh run list --workflow=pricing-supplement.yml --limit 1 与 curl 检查线上 JSON 的 updated_at 是否与合并文件一致;发布经两步(补充文件工作流推送到 gh-pages 分支,再由 deploy-pages.yml 部署),十分钟后仍过期可检查 gh run list --workflow=deploy-pages.yml 并重跑 gh workflow run deploy-pages.yml --ref main。可选:内置快照(pricing_*_snapshot.json)由 ./script/update_pricing_snapshots.sh 刷新,通常发布前执行,单独提交。限制:费率必须逐字取自 Cursor 页面不得推断;不得删除历史用量可能引用的条目;必须更新 updated_at 并走 PR;具体收费与平台细节以官方文档为准。