add-model-price

添加模型价格

使用此技能修改 worker/ 中的模型定价，以及更新 packages/shared/ 中共享的 LLM 类型。

适用情形

• 编辑 worker/src/constants/default-model-prices.json
• 编辑 packages/shared/src/server/llm/types.ts
• 添加新的定价模型
• 更新提供商价格、缓存定价或层级条件
• 扩展 Bedrock、Vertex、Azure 或带提供商前缀的模型名称的正则表达式覆盖范围
• 审查默认模型价格，查找过时、缺失或未匹配的提供商定价
• 审查提供商官方文档，查找应设置默认价格的新发布主力模型，并在适当情况下为其添加可选模型支持
• 从可选模型列表中移除已退役或已停服的模型

如何阅读此技能

• 将此 SKILL.md 用作高级工作流和辅助索引。
• 只打开与任务对应的特定参考文件。

快速入门清单

添加新模型

• 从提供商文档中收集官方定价。
• 为模型条目生成一个小写 UUID。
• 创建一个覆盖受支持提供商格式的 matchPattern。
• 至少添加一个默认定价层级。
• 将每个单 Token 价格写为 <USD per MTok>e-6（0.1e-6，而不是 1e-7）。
• 将每个受支持的语义用量类别映射到 Langfuse 可能持久化的提供商别名。
• 将定价条目插入 worker/src/constants/default-model-prices.json。
• 如果该模型应可在 playground 或评估流程中选择，请更新 packages/shared/src/server/llm/types.ts。
• 编辑后验证 JSON。

退役可选模型

• 在提供商的官方生命周期页面上确认停服或退役信息。
• 从 packages/shared/src/server/llm/types.ts 中的可选数组移除该模型，以便模型选择器不再提供它。
• 在 default-model-prices.json 中保留其条目，以便历史成本查询。
• 不要重新排列数组；如果第一个（默认）条目退役，下一个条目将成为默认项。

更新现有模型

• 更新相关价格、键、层级或正则表达式。
• 将 updatedAt 更新为今天的 ISO-8601 时间戳。
• 编辑后验证 JSON。

参考索引

主题	阅读时机	文件
Schema 和层级规则	需要了解条目结构或定价层级约束时	references/schema-and-tiers.md
提供商来源和价格键	需要官方定价 URL、每个 token 的换算方式或提供商专属用量键时	references/provider-sources-and-price-keys.md
提供商用量键矩阵	添加或修改 OpenAI、Gemini、Anthropic 或 Bedrock 用量键时	references/provider-usage-key-matrix.md
匹配模式	编辑 matchPattern 正则表达式或提供商覆盖范围时	references/match-patterns.md
工作流和验证	执行端到端编辑流程或检查常见错误时	references/workflow-and-validation.md
自动化审计模式	运行定时／默认价格审计并需要符合 CI 要求的编辑规则时	references/automated-audit.md
审计记忆	需要保留来自有用的先前自动化审计的可选模型上下文时	references/model-audit-memory.md

确定性辅助工具

• 定价文件验证器： node .agents/skills/add-model-price/scripts/validate-pricing-file.mjs
• 匹配模式测试器： node .agents/skills/add-model-price/scripts/test-match-pattern.mjs --model <modelName> --accept <sample...> --reject <sample...>
• 直接正则表达式测试器： node .agents/skills/add-model-price/scripts/test-match-pattern.mjs --pattern '(?i)^(openai/)?(gpt-4o)$' --accept gpt-4o openai/gpt-4o --reject gpt-4o-mini