diff --git a/docs/04-local-development-and-verification.md b/docs/04-local-development-and-verification.md index 372052d..6f19378 100644 --- a/docs/04-local-development-and-verification.md +++ b/docs/04-local-development-and-verification.md @@ -2,8 +2,8 @@ generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件) wiki_page: Local-Development-and-Verification wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Local-Development-and-Verification.- -wiki_revision: 84a086640dc3618e43f834c488080f1e0cb5b063 -synchronized_at: 2026-08-17T02:54:49Z +wiki_revision: 925a16a72bd5840697b5c61489a97018134b3930 +synchronized_at: 2026-08-27T08:07:04Z # 本地开发与验证 @@ -313,3 +313,29 @@ corepack pnpm@9.15.1 build:prod 浏览器 smoke 至少覆盖:鼠标添加和拖动顶点;键盘 Enter 添加、方向键移动、Delete 删除;错误文字可见并具有 aria-live/alert 语义;刷新后版本、启停和重新校准状态仍可追溯。真实摄像机校准只使用明确授权设备,不记录地址、URI、凭据或视频内容。Brain、Bell 不启动时必须能独立保存、读取和预览。 + + +## Sense 本机 Supervisor 托管 + +本机开发/演示环境可由 `D:\supervisor` 托管已经构建的 Sense Windows 交付包。实例配置位于仓库外的 `D:\supervisor\programs\yovision.conf`,实例名为 `yovision-sense`;工作目录固定为 `D:\OPC\yovision\Sense\dist\sense-windows-amd64`。 + +Supervisor 配置只调用包内 `scripts\runtime\start-sense.ps1`,运行参数继续从包内 `config\sense.env` 读取。不得把数据库连接、JWT 密钥、摄像头凭据或其他秘密复制到 Supervisor 配置或工单。 + +常用命令: + +```powershell +D:\supervisor\supervisord.exe ctl /c D:\supervisor\supervisord.conf status yovision-sense +D:\supervisor\supervisord.exe ctl /c D:\supervisor\supervisord.conf restart yovision-sense +D:\supervisor\supervisord.exe ctl /c D:\supervisor\supervisord.conf stop yovision-sense +D:\supervisor\supervisord.exe ctl /c D:\supervisor\supervisord.conf start yovision-sense +Get-Content D:\supervisor\logs\yovision-sense.log -Tail 100 +``` + +新增或修改 `programs/*.conf` 后执行: + +```powershell +D:\supervisor\supervisord.exe ctl /c D:\supervisor\supervisord.conf reload +``` + +当前 Go Supervisor 的 `reload` 会重新读取独立配置;实际受影响实例必须以命令输出和 reload 前后 PID 为准。切换托管前先停止占用 Sense 端口的非 Supervisor 实例,防止自动启动进入 Backoff。验证至少包含 Supervisor 状态为 Running、`http://127.0.0.1:18080/health` 与首页返回 200,以及受控重启后 Sense 和受管 MediaMTX PID 均更新。 +