Instruction file imported from OctaFuse/octafuse-gateway (
.cursor/rules/add-new-model.mdc). Copyright stays with the author.
引入新模型（Gateway）
1. 只信官网
先查厂商文档：上下文、最大输出、模态、刊例价、现价折扣、思考字段/枚举/默认值、能否关思考、官方协议入口、特殊参数。同族模型不能直接套（例如 FlashX 文本参数可同 GLM-5.3，模态不同）。数字不得编造。
2. 静态目录写刊例价
改 packages/admin/lib/model-presets/（LLM / 生图 / 音频分开），补 import-catalog-billing 测试。模型类型（llm / image / asr / tts / embedding）由模态与计费模式派生，写预设时对照 docs/developers/reference/model-kinds.md：ASR 输入含 audio、输出 text，计费 per_second / token；TTS 输入 text、输出 audio，计费 per_character；model-kind-presets.test.ts 会拦截矛盾预设。USD 与 CNY 分源（如 Z.AI vs BigModel），不要用汇率换算。折扣只记现状，preset 里写刊例价，不写限时活动价。
退役日期 retired（YYYY-MM-DD）：只依据厂商官方 deprecations / 下线公告填写厂商停止提供该模型的日期；未公布日期（含“not sooner than”之类的下限）一律不写。日期不晚于今天即视为退役，晚于今天在 Admin 显示“将于 X 退役”。加新模型与定期巡检都要对照官方下线页。该字段仅作元数据，不影响路由与计费。
3. 导入模板不是上线
preset 只供管理后台导入。还要：导入模型、配真实供应商 Key、用协议适配器挂路由。导入不会自动打标签。octafuse-website 模型目录跟发版同步，不必每次加模型都改网站。
4. 给出路由建议
写清客户端入口（Chat / Responses / Anthropic Messages / Gemini）与实际上游协议；特殊参数放路由默认值还是客户端 extras。Agent 始终带 tools，若某协议+tools+思考会 400（如部分 GPT-5.4+ Chat），建议必须写明。
