用途：为 ElevenLabs TTS 项目搭建 CI/CD 测试流水线，避免每次 PR 都消耗字符配额。采用两层策略：每次推送运行模拟单元测试（无需 API Key、零配额），仅在 main 分支或手动触发时运行真实 API 集成测试，并加配额守卫。
主要能力：提供 GitHub Actions 工作流配置，包含 unit-tests 与 integration-tests 两个 job；集成测试前先调用 GET /v1/user 检查剩余字符，低于 5000 则跳过；支持将 API Key 与 webhook 密钥存入仓库 secret；提供模拟 SDK 的单元测试骨架与受环境变量门控的集成冒烟测试。
使用方式：创建 .github/workflows/elevenlabs-tests.yml；用 gh secret set ELEVENLABS_API_KEY --body "sk_your_test_key_here" 配置密钥；单元测试通过 vi.mock 模拟 @elevenlabs/elevenlabs-js；集成测试用 describe.skipIf 在未设置 ELEVENLABS_INTEGRATION 时跳过；本地可运行 npm test -- --coverage，手动触发用 gh workflow run elevenlabs-tests.yml，本地集成测试用 ELEVENLABS_INTEGRATION=1 npm run test:integration。
适用场景：需要为 TTS 项目建立自动化测试、控制 API 配额消耗的 GitHub 仓库。
限制：需 GitHub Actions、ElevenLabs 测试用 API Key、已配置 vitest 的 npm/pnpm 项目；集成测试建议使用 Flash 模型与短文本以降低成本；SDK 升级后需同步更新模拟代码。完整工作流 YAML 与测试代码见 references/implementation.md 和 references/examples.md。