测试通过

README.md

@@ -8,6 +8,12 @@
 
 当前形态更接近单机演示和研发验证环境，不是已经拆分完毕的生产化架构。
 
+当前运行约束：
+
+- 服务端按“单客户端接管”模式工作。新的浏览器页面连上后，会主动断开旧页面的音频、字幕、动画 WebSocket。
+- 浏览器刷新后，语音通道可能仍受浏览器媒体安全策略限制，需要一次页面点击或点“连接语音通道”来恢复麦克风与播放上下文。
+- 前端目前默认保留随机眨眼；更激进的 idle body motion 已回退，避免部分 VRM 模型进入 T pose。
+
 ## 当前架构
 
 语音链路：
@@ -90,6 +96,12 @@ python main.py
 
 或使用脚本：
 
+```bash
+bash scripts/start-test.sh auto
+```
+
+如果你明确要固定走当前 shell/虚拟环境里的 Python，也可以用：
+
 ```bash
 bash scripts/start-public.sh
 ```
@@ -107,6 +119,11 @@ python scripts/smoke_test.py --text "你好，请做一个简短自我介绍。"
 - `http://127.0.0.1:8080/`
 - `http://127.0.0.1:8080/health`
 
+如果 `.env` 里已经配置了 `WEBRTC_PORT=8018` 与 `SSL_CERTFILE` / `SSL_KEYFILE`，实际访问地址通常会变成：
+
+- `https://<server-ip>:8018/`
+- `https://<server-ip>:8018/health`
+
 如果浏览器与服务端跨机器访问，麦克风采集通常需要 HTTPS。可以先生成自签证书：
 
 ```bash
@@ -133,6 +150,8 @@ bash scripts/gen-self-signed-cert.sh
 - `WS /ws/animation`: 数字人控制流。
 - `GET /avatar/schema`: 当前控制协议 schema。
 
+说明：三个 WebSocket 通道当前都只保留一个活动客户端。新页面接入后，旧页面会收到 `1012 replaced` 并停止接收数据。
+
 ## 后续开发建议
 
 优先阅读 [docs/development-guide.md](docs/development-guide.md)。这个文档说明了：