重组为 backend/clients/docs 三层结构,并清理 git 污染。
将后端迁入 backend/,完善根目录 .gitignore,删除误提交的 .mypy_cache 缓存文件。 Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -3,41 +3,35 @@
|
||||
**与监控 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 9000
|
||||
./start.sh --single # 打包单 HTML 后启动 dist/
|
||||
```
|
||||
|
||||
Windows:`start.bat`(用法同上)。
|
||||
|
||||
也可直接使用本目录内的 `start_http.sh` / `start_http.bat`。
|
||||
浏览器将 **Base URL** 指向监控 API(例如 `http://192.168.1.100:38080`)。后端启动:
|
||||
|
||||
环境变量 **`VOCH_HTTP_BIND`**:默认 `0.0.0.0`(局域网终端访问);仅本机调试可设 `127.0.0.1`。
|
||||
```bash
|
||||
cd backend && docker compose up -d --build
|
||||
```
|
||||
|
||||
浏览器将 **Base URL** 指向监控 API,例如 `http://192.168.1.100:38080`(后端由仓库根目录 `docker compose up -d --build` 启动,详见 [`../../docs/Docker部署.md`](../../docs/Docker部署.md))。
|
||||
详见 [`../../docs/Docker部署.md`](../../docs/Docker部署.md)。
|
||||
|
||||
## 单 HTML 分发(`dist/`)
|
||||
## 单 HTML 分发
|
||||
|
||||
```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`。
|
||||
生成 `dist/index.html`;该目录被 `.gitignore` 忽略。
|
||||
|
||||
## 与 Demo 客户端的关系
|
||||
|
||||
流程联调见 [`../demo-client/`](../demo-client/)(默认 `:38081`)。语音闭环仅在本目录或 `dist/` 完成。
|
||||
流程联调见 [`../demo-client/`](../demo-client/)(默认 `:38081`)。
|
||||
|
||||
Reference in New Issue
Block a user