docs: 记录 Sense Supervisor 托管方式 (#106)

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
 <!-- gitea-wiki-mirror:end -->
 
 # 本地开发与验证
@@ -313,3 +313,29 @@ corepack pnpm@9.15.1 build:prod
 
 浏览器 smoke 至少覆盖：鼠标添加和拖动顶点；键盘 Enter 添加、方向键移动、Delete 删除；错误文字可见并具有 aria-live/alert 语义；刷新后版本、启停和重新校准状态仍可追溯。真实摄像机校准只使用明确授权设备，不记录地址、URI、凭据或视频内容。Brain、Bell 不启动时必须能独立保存、读取和预览。
 <!-- sense-area:end -->
+
+<!-- sense-supervisor:start -->
+## 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 均更新。
+<!-- sense-supervisor:end -->