story/deploy/local-rtc

Windows 本地真实 RTC 联调

该覆盖层只用于本机联调，不访问阿里云服务器。它把 API 的 RTC Token 签发器和 Worker 的语音供应商切换到火山引擎，同时保留数据库、Redis、MinIO、Keycloak和告警模拟器在本地 Docker 中运行。

1. 生成本地凭据

在项目根目录运行：

.\deploy\local-rtc\configure.ps1

脚本会以隐藏输入方式依次读取：

• RTC AppKey；
• 火山引擎 AccessKey ID / Secret AccessKey；
• 豆包端到端语音 APP ID / Access Token；
• 豆包音色 ID。

密钥文件只生成到deploy/local-rtc/runtime，该目录不会提交到 Git。当前首轮联调使用豆包 S2S-O 纯端到端模式（OutputMode=0），平台本地路由仍沿用s2s_hybrid模板槽位；这是为了只依赖豆包端到端语音凭据，先验证真实双向音频。后续接入火山方舟 Endpoint 后再切换真正的混合编排模式。

2. 启动本地后端

.\deploy\local-rtc\start.ps1

首次构建需要下载 Docker 基础镜像。脚本会等待http://localhost:58080/health/ready可用。

3. 启动模拟器

双击device-simulator-windows/release/voice-device-simulator-0.1.0-windows-x64.exe，然后：

1. 保持默认本地平台地址、设备 ID 和本地测试设备密钥；
2. 点击“检测平台和音频设备”；
3. 选择麦克风和扬声器；
4. 点击“开始语音聊天”；
5. 看到“豆包语音任务已激活”后直接说话；
6. 点击“结束通话”验证StopVoiceChat和RTC离房。

RTC AppKey、火山 AK/SK 和豆包 Access Token 均不进入模拟器安装包，也不会通过渲染页面读取。