operating-room-monitor-server/clients/voice-confirmation/README.md

# 手术室耗材 — 语音确认（独立客户端）

**与监控 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) 访问。

## 启动

```bash
./start.sh              # 默认 0.0.0.0:8080
./start.sh 9000
./start.sh --single     # 打包单 HTML 后启动 dist/
```

Windows：`start.bat`（用法同上）。

浏览器将 **Base URL** 指向监控 API（例如 `http://192.168.1.100:38080`）。后端启动：

```bash
cd backend && docker compose up -d --build
```

详见 [`../../docs/Docker部署.md`](../../docs/Docker部署.md)。

## 单 HTML 分发

```bash
python3 scripts/bundle_single_html.py
# 或：./start.sh --single
```

生成 `dist/index.html`；该目录被 `.gitignore` 忽略。

## 与 Demo 客户端的关系

流程联调见 [`../demo-client/`](../demo-client/)（默认 `:38081`）。