用途：指导升级 ElevenLabs SDK 并在不同模型代际之间迁移，覆盖 JS 包更名（社区版 elevenlabs → 官方 @elevenlabs/elevenlabs-js）、跨代模型 ID 变更、语音设置演进与 API 端点稳定性。
主要能力：提供七步、分支隔离的迁移流程——检查当前版本、JS 包迁移、模型迁移、语音设置核对、端点检查、Python SDK 升级、验证。模型迁移表例：eleven_monolingual_v1 → eleven_multilingual_v2；eleven_turbo_v2 → eleven_flash_v2_5；eleven_multilingual_v2 → eleven_v3（表达力最强、70+ 语言，但不支持 WebSocket）。可产出 config/models.ts 选择辅助函数，在需要 WebSocket 时从 eleven_v3 回退。
使用方式：认证统一用 xi-api-key 请求头，密钥存于 ELEVENLABS_API_KEY 环境变量，勿内联源码；Node 读取 process.env.ELEVENLABS_API_KEY，Python 用 api_key=...。前置条件包括已安装 Node 或 Python SDK、已导出密钥、Git、可用测试套件与预发环境。关键命令示例：npm uninstall elevenlabs && npm install @elevenlabs/elevenlabs-js；git checkout -b upgrade/elevenlabs-sdk。完整命令与逐步代码见 references/migration-guide.md，三个端到端示例见 references/examples.md。
验证与限制：需跑测试、TTS 冒烟测试（返回 200）与非空语音列表检查；失败时回滚到固定旧版本或 git revert。eleven_v3 不支持 WebSocket，模型切换后流式失败可改用 eleven_flash_v2_5 或 eleven_multilingual_v2；语音设置被忽略时核对 stability、similarity_boost、style、speed 参数名。具体价格、性能数值与平台支持等资料未提供，暂未说明。