用途：把代码库从 OpenAI、Anthropic、本地 LLM 或其他云（Bedrock、Vertex）迁移到 Groq，或在 Groq 模型代际之间迁移，实现零停机切换。Groq 提供 OpenAI 兼容 API，迁移主要为更换 SDK 导入、模型 ID 和响应元数据，从而获得更快推理。
主要能力：提供最小迁移示例（将 openai 客户端换为 groq-sdk 客户端并改 model）；提供 OpenAI/Anthropic 到 Groq 的模型 ID 映射表（如 gpt-4o→llama-3.3-70b-versatile、gpt-4o-mini→llama-3.1-8b-instant），未知模型回退到默认；规划供应商抽象层、特性开关灰度切流（groq_migration_pct）、迁移扫描器、对比基准与回滚方案。
使用方式：需准备 Groq API key（GROQ_API_KEY，来自 console.groq.com）、安装 groq-sdk（npm install groq-sdk）、一个特性开关机制、保留原供应商 key 以便并行运行，使用性能基准时需 Node >=18。基本步骤为先替换导入与模型 ID，再用统一接口封装两家供应商，按小流量金丝雀逐步提升至 100%，并保留一键回滚。
适用场景：需要迁移到 Groq 或 Groq 模型升级、且要求零停机的项目。
限制：OpenAI 迁移复杂度低（API 形态相同），Anthropic 为中（消息格式与流式协议不同）；Groq 不提供 embeddings/images 功能，需保留原供应商；存在质量回归、速率限制与成本结构差异，需调优提示词、配置限流并分流简单任务。具体迁移代码与基准脚本位于参考资料文件中，未提供的细节以资料为准。