feat: improve ota packaging and people-flow runtime

README.md

@@ -82,6 +82,41 @@ docker compose --env-file managed-portal.env up -d --build
 http://<服务器IP>:13000/
 ```
 
+## OTA 发布包
+
+OTA 安装脚本默认从发布目录下载一个主 ZIP，再用 `deploy/docker-compose.ota-release.yml` 启动服务。主 ZIP 现在只需要包含安装端真正依赖的内容：
+
+- `deploy/docker-compose.ota-release.yml`
+- `deploy/Dockerfile.runtime-overlay`
+- `deploy/managed-portal.release.env`
+- `release-manifest.env`
+- `managed/store_dwell_alert/config/`
+- `managed/people_flow_project/config/`
+
+仓库提供了一个最小打包脚本：`deploy/package-managed-portal-ota.sh`。
+
+示例：
+
+```bash
+RELEASE_VERSION=20260518-7b32b21-11 \
+RELEASE_MANIFEST_SOURCE=/path/to/release-manifest.env \
+RELEASE_ENV_SOURCE=deploy/managed-portal.10.8.0.12.env \
+sh deploy/package-managed-portal-ota.sh
+```
+
+默认情况下，主 ZIP 不包含 `managed/people_flow_project/weights/`。OTA installer 会优先复用主机上的共享权重目录，避免每次只改安装脚本或配置时都重复打包、上传大体积权重。
+
+只有两种场景才建议把权重重新打进 ZIP：
+
+- 首次在一台没有预置权重的新主机上安装
+- `people_flow_project` 的权重文件本身发生变更
+
+这两种场景可以临时打开：
+
+```bash
+INCLUDE_WEIGHTS=1 sh deploy/package-managed-portal-ota.sh
+```
+
 ## 模型权重
 
 子服务镜像构建前需要以下权重文件：