更新

app/README.md

@@ -9,16 +9,16 @@
 Windows 直接在项目根目录双击：
 
 - `一键运行_医生工作站.bat`：优先启动现有成品；没有成品时自动使用 `uv` 准备源码环境并运行。
-- `一键打包_医生工作站.bat`：自动同步锁定的 Python/Node 依赖，构建并冒烟验证，最后生成 `dist/DoctorWorkstation-Windows-x64-<版本>.zip` 和 SHA-256 文件。
+- `一键打包_医生工作站.bat`：自动同步锁定的 Python/Node 依赖，检查冻结 QtWebEngine/QtMultimedia 文件，执行应用与媒体离屏冒烟验证，最后生成 `dist/DoctorWorkstation-Windows-x64-<版本>.zip` 和 SHA-256 文件。
 
 英文稳定别名分别是 `Run_DoctorWorkstation.bat` 和 `Build_DoctorWorkstation.bat`。分发 ZIP 解压后，可直接双击其中的 `Start_DoctorWorkstation.bat`。
 
 macOS 在 Finder 中双击：
 
 - `一键运行.command`：优先打开现有 `DoctorWorkstation.app`，否则自动准备源码环境并运行。
-- `一键打包.command`：构建、签名检查和冒烟验证后，生成 `.app`、可分发 ZIP 及 SHA-256 文件。
+- `一键打包.command`：构建、QtWebEngine/QtMultimedia 文件门禁、签名检查和两项冻结冒烟验证后，生成 `.app`、可分发 ZIP 及 SHA-256 文件。
 
-Windows 打包机需预先安装 `uv` 与 Node.js 20+；脚本会自动处理项目虚拟环境和锁定依赖。首次打包需要联网下载依赖，之后会复用本机缓存。如果 macOS 传输过程丢失了执行权限，可在项目目录执行一次 `chmod +x *.command scripts/*.sh`；若 Gatekeeper 拦截未签名内部测试版，请使用右键“打开”。
+Windows 打包机需预先安装 `uv` 与 Node.js 20+；脚本会自动处理项目虚拟环境和锁定依赖。首次打包需要联网下载依赖，之后会复用本机缓存。macOS 发布源码中的根 `.command` 与操作型 `scripts/*.sh` 必须以 Git mode `100755` 跟踪；源码压缩包在传输中丢失权限时，可在项目目录执行一次 `chmod +x *.command scripts/*.sh`。若 Gatekeeper 拦截未签名内部测试版，请使用右键“打开”。
 
 ## 已实现范围
 
@@ -52,6 +52,8 @@ uv run doctor-workstation
 
 `.env.example` 默认启用演示模式。演示账号：`doctor`，密码：`doctor123`。
 
+`.env.example` 仅作为源码开发/企业部署模板，不会复制进发布 ZIP 或 `.app`。生产环境请通过受控启动器、设备管理或进程环境注入配置；不要把密码、token、UserSig、TRTC SecretKey 等凭据放进 `.env` 或发布包。
+
 ## 连接现有后端
 
 将 `.env` 调整为：
@@ -100,12 +102,16 @@ uv run ruff check src tests
 .\scripts\build_windows.ps1
 ```
 
+`build_windows.ps1` 只生成并验证 onedir；正式一键发布请运行 `Build_DoctorWorkstation.bat`，它在所有冻结文件/媒体门禁通过后再生成版本 ZIP 与 SHA-256。
+
 macOS 必须在 macOS 机器上构建、签名和公证：
 
 ```bash
 ./scripts/build_macos.sh
 ```
 
+`build_macos.sh` 只生成并验证 `.app`；正式一键发布请双击 `一键打包.command`（或 `package_macos.command`），通过相同门禁后再归档并生成 SHA-256。
+
 Windows 与 macOS 的 Qt/媒体权限和签名产物不能交叉编译。首次生产发布前，应按 [research/tencent_rtc.md](research/tencent_rtc.md) 的准入清单完成摄像头、麦克风、设备插拔、休眠恢复和弱网实测。
 
 ## 工程结构