chore: checkpoint 第一版

device-simulator-windows/远程测试包说明.txt

@@ -1,21 +1,24 @@
-云端语音测试设备使用说明
+云端硬件对话智能体测试程序使用说明
 
-1. 将整个 ZIP 解压到普通文件夹，不要只从压缩包内直接运行。
-2. 双击“启动云端测试设备.cmd”，不要直接双击 EXE。
-3. 首次运行时允许 Windows 麦克风访问。
-4. 点击“检测平台和音频设备”，检测通过后即可开始语音聊天。
+1. 将 ZIP 完整解压到普通文件夹，不要直接在压缩包内运行。
+2. 双击“启动云端测试设备.cmd”，或运行 hardware-agent-tester-0.3.2-windows-x64.exe。
+3. 首次运行允许 Windows 麦克风访问。
+4. 填写平台设备信息和 Hardware ID；火山 Instance ID、Product Key、Device Name 由平台自动下发。
+5. Product Secret 只配置在平台密钥服务中，测试程序不会要求输入；平台代设备注册后只下发本设备的一机一密。
+6. 根据火山控制台中的 Bot 类型选择“通用 LLM”或“豆包端到端语音”。选错会导致 session.update 校验失败。
+7. 点击“检测、鉴权并准备设备”，13项验收区开始记录证据。
+8. 检测通过后点击“开始硬件智能体通话”。只有收到火山 session.updated 且平台确认 ACTIVE 后才会开放麦克风。
+9. 完成双方对话后点击结束；也可以从平台停止通话，程序会在 session_updated 回执中收到 stop_session 并自动结束。
+10. 点击“导出测试报告”，将 JSON 报告交给开发人员验收。
 
-云端后台：https://121.41.46.238
-测试设备：10000000-0000-0000-0000-000000000511
+平台维护中心必须把本设备设置为 volc_hardware_agent + low_load，并绑定与火山产品关联的真实 Bot ID。公网平台尚未部署 v3 路由时会返回 404，此时不能进行真实测试。
 
-网络需要允许 HTTPS 443、WSS 以及火山 RTC 所需的出站网络连接。
+网络需要允许 HTTPS 443 和 WSS 到：
+- 平台服务器
+- ai-gateway.vei.volces.com
 
-如果检测平台时提示 RTC 网络检测失败，或入房超过 15 秒：
-- 关闭 VPN、系统代理和网络加速器；
-- 在 Windows 防火墙/杀毒软件中允许本程序联网；
-- 优先改用手机热点复测，以排除公司、校园或酒店网络限制；
-- 需要放行 TCP 443 到火山 RTC Web SDK 4.69.0 使用的 *.rtc.volcvideo.com 和 *.volcvideos.com。
+`iot-cn-shanghai.iot.volces.com`只需要平台服务器访问，设备无需访问动态注册地址。
 
-如果手机热点、关闭VPN/代理后仍然无法入房，请在失败后点击页面底部“导出 RTC 日志”，把 Windows“下载”目录中最新生成的 RTC 日志文件交给开发人员分析。
+安全提示：Product Secret 永不到达设备。平台下发的一机一密会使用当前 Windows 用户的 Safe Storage 加密保存，导出的测试报告不包含任何密钥。
 
-安全提示：本测试包包含服务器测试设备凭据，仅限受控测试使用，请勿公开上传或转发。测试完成后请删除其他电脑上的解压目录和 ZIP 文件。
+当前测试 EXE 未配置商业代码签名证书，Windows 可能提示“未知发布者”。请先用随包 SHA-256 文件核对完整性；正式外发版本应使用甲方或发布主体的代码签名证书签名。