operating-room-monitor-server/docs/部署版使用指南.md

# 部署版使用说明（地址与填写项）

## 一、浏览器里要打开哪个地址

在浏览器地址栏里，只打开**信息科或厂商给你的「语音确认」网页地址**。

常见写法类似（**把里面的服务器和端口换成你们自己的**）：

- `http://语音网页所在服务器:8080`
- 局域网内常见为 `http://192.168.1.100:8080`
- 若对方给的是带文件名的，按其提供的完整地址打开即可。

**不要**用「从文件夹里双击打开网页」的方式（那种一般打不开麦克风）。

监控后端由部署机上的 Docker Compose 栈提供，默认地址是 `http://<部署机局域网IP>:38080`。语音确认网页可以部署在同一台机器，也可以部署在局域网内另一台机器，只要能访问这个后端地址即可。

---

## 二、页面里「高级设置」各框填什么

在语音确认页上，点开 **「高级设置（运维 / 调试）」**，按下面填写。


| 页面上的名称                  | 填什么                                                                                                         |
| ----------------------- | ----------------------------------------------------------------------------------------------------------- |
| **服务端 Base URL**        | 填**监控服务**的根地址（不是本语音网页的地址）。信息科会单独提供，局域网常见形如：`http://监控服务器局域网IP:38080` 或 `https://监控服务器域名`。**不要**把本页的端口（例如 8080）填进这里。 |
| **本机语音终端 ID**           | 填**这台电脑/平板在配置表里对应的终端编号**（与医院给术间分配的一致）。                                                                      |
| **启用服务端自动指派…**（复选框）     | **保持勾选**（平时不要取消）。取消后本机收不到手术室自动派来的任务。                                                                        |
| **手动手术号（6 位，未开录或未指派时）** | **一般留空。**只有信息科让你做调试时，才填 6 位数字手术号，并仅在对方指导下点「开始监控（手动）」。                                                       |
| **提示音结束后继续录音秒数**        | **一般不改**，用默认 **5** 即可。                                                                                      |
| **调试：只录音，不上传**（复选框）     | **不要勾选**（勾选后不会真正把确认结果交给系统）。                                                                                 |


改完 **服务端 Base URL**、**本机语音终端 ID** 或勾选项后，若页面没有自动连上，可**刷新一次网页**再试。

如果语音网页地址与监控服务在同一台机器，页面通常会自动把 Base URL 推导成同一局域网 IP 的 `38080` 端口；如果现场网络分开部署，请按信息科提供的监控服务地址手动填写。

---

## 三、数值示例（仅作格式参考）

下面数字是假的，仅说明「长什么样」；**以医院给你们的为准**。


| 项目            | 示例格式                         |
| ------------- | ---------------------------- |
| 语音网页地址        | `http://192.168.1.100:8080`  |
| 服务端 Base URL  | `http://192.168.1.100:38080` |
| 本机语音终端 ID     | 如 `or-voice-01`（实际字符串以配置为准）  |
| 手动手术号（若被要求填写） | 恰好 6 位数字，如 `123456`          |


---

以上内容对应 `clients/voice-confirmation/` 语音确认页面。手术室主程序、摄像头等由别家软件或信息科配置，不在此页填写。