44 lines
1.9 KiB
Markdown
44 lines
1.9 KiB
Markdown
|
# 手术室耗材 — 语音确认（独立客户端）
|
|||
|
|
|
|||
|
|
**与监控 API 分宿**的浏览器静态页（`index.html` + `voice_app.js`，Tailwind 使用 CDN）。复制本目录或 `dist/` 即可独立分发。
|
|||
|
|
|
|||
|
|
- 功能：播放 TTS、并行录音、`POST .../resolve` 上传 WAV；WebSocket 收 `voice_assignment` / `voice_pending` 等。协议见 [`../../docs/客户端手术通信接口说明.md`](../../docs/客户端手术通信接口说明.md)。
|
|||
|
|
- 界面：默认 **术间模式**；接口地址与调试信息在 **「高级设置」** 内。
|
|||
|
|
- **禁止使用 `file://` 打开**；须通过 HTTP(S) 访问。
|
|||
|
|
|
|||
|
|
## 启动
|
|||
|
|
|
|||
|
|
仅需 **Python 3**：
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
./start.sh # 默认 0.0.0.0:8080
|
|||
|
|
./start.sh 9000 # 指定端口
|
|||
|
|
./start.sh --single # 打包单 HTML 后启动 dist/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Windows：`start.bat`（用法同上）。
|
|||
|
|
|
|||
|
|
也可直接使用本目录内的 `start_http.sh` / `start_http.bat`。
|
|||
|
|
|
|||
|
|
环境变量 **`VOCH_HTTP_BIND`**：默认 `0.0.0.0`（局域网终端访问）；仅本机调试可设 `127.0.0.1`。
|
|||
|
|
|
|||
|
|
浏览器将 **Base URL** 指向监控 API，例如 `http://192.168.1.100:38080`（后端由仓库根目录 `docker compose up -d --build` 启动，详见 [`../../docs/Docker部署.md`](../../docs/Docker部署.md)）。
|
|||
|
|
|
|||
|
|
## 单 HTML 分发（`dist/`）
|
|||
|
|
|
|||
|
|
```bash
|
|||
|
|
python3 scripts/bundle_single_html.py
|
|||
|
|
# 或：./start.sh --single
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
生成 `dist/index.html`（内联脚本）及 `dist/start_http.*`。对外只发包 **`dist/`** 即可；该目录被 `.gitignore` 忽略。
|
|||
|
|
|
|||
|
|
## 生产部署
|
|||
|
|
|
|||
|
|
- 本目录整体或 **`dist/`** 可交给 Nginx / Caddy / CDN；非 localhost 通常需 **HTTPS** 才能稳定使用麦克风。
|
|||
|
|
- **CORS**：后端需 `DEMO_CORS_ENABLED=true`；生产建议收窄 `DEMO_CORS_ORIGINS`。
|
|||
|
|
|
|||
|
|
## 与 Demo 客户端的关系
|
|||
|
|
|
|||
|
|
流程联调见 [`../demo-client/`](../demo-client/)（默认 `:38081`）。语音闭环仅在本目录或 `dist/` 完成。
|