feat: align frontend runtime and Edge TTS

README.md

@@ -24,7 +24,7 @@ cp .env.example .env.local
 pnpm dev
 ```
 
-开发服务器默认监听所有网络接口。打开终端中 Vite 输出的地址即可访问工作台。
+开发服务器默认地址为 <http://127.0.0.1:5173>。
 
 Agent 服务默认地址为 `http://127.0.0.1:8787`。需要完整对话能力时，请同时启动对应的 Agent 后端。
 
@@ -40,10 +40,11 @@ Agent 服务默认地址为 `http://127.0.0.1:8787`。需要完整对话能力
 | `TJWATER_AGENT_API_BASE_URL` | `http://127.0.0.1:8787` | 浏览器访问的 Agent API 地址 |
 | `TJWATER_ENABLE_DEV_PANEL` | `false` | 是否显示开发面板 |
 | `TJWATER_ENABLE_MSW` | `false` | 是否启用浏览器端 Mock Service Worker |
-| `AGENT_API_INTERNAL_BASE_URL` | `http://127.0.0.1:8787` | Vite 开发代理访问的 Agent 服务地址，仅开发环境使用 |
 
 `.env.local` 已被 Git 忽略，请勿提交令牌或生产环境配置。
 
+Agent 请求由浏览器直接访问 `TJWATER_AGENT_API_BASE_URL`，部署环境需要为前端来源配置 CORS。语音播放始终请求同源 `/api/tts/edge`；开发和预览由 Vite 中间件处理，生产镜像会启动仅监听容器回环地址的 Edge TTS 适配器。无需配置 TTS 服务 URL，可选的服务端变量 `EDGE_TTS_VOICE` 用于覆盖默认中文语音。
+
 ## 常用命令
 
 ```bash
@@ -60,7 +61,7 @@ pnpm test:browser # 运行 Playwright 浏览器测试
 
 ## Docker
 
-生产镜像使用 Node.js 构建静态文件，并通过 Caddy 提供服务。容器启动时会根据环境变量生成 `/runtime-config.js`。
+生产镜像使用 Node.js 构建静态文件，并通过 Caddy 提供服务。容器启动时会根据环境变量生成 `/runtime-config.js`，同时启动 Edge TTS 适配器。
 
 ```bash
 docker build -t next-tjwater .