重组为 backend/clients/docs 三层结构,并清理 git 污染。

将后端迁入 backend/,完善根目录 .gitignore,删除误提交的 .mypy_cache 缓存文件。

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Kevin
2026-05-21 16:02:25 +08:00
parent 6bc6801df9
commit 1af442481e
142 changed files with 175 additions and 212 deletions

View File

@@ -3,41 +3,35 @@
**与监控 API 分宿**的浏览器静态页(`index.html` + `voice_app.js`Tailwind 使用 CDN。复制本目录或 `dist/` 即可独立分发。
- 功能:播放 TTS、并行录音、`POST .../resolve` 上传 WAVWebSocket 收 `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`)。