From d71ef1cefd8a580ebb1dcaa880e7ab6d8e8bfd00 Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Thu, 13 Aug 2026 22:05:42 +0800
Subject: [PATCH] docs: update task #54 path recovery evidence

---
 ...¿®å¤�实时监看按需拉æµ�循环等待.md | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/docs/task/54-修�实时监看按需拉�循环等待.md b/docs/task/54-修�实时监看按需拉�循环等待.md
index b882303..6805ec7 100644
--- a/docs/task/54-修�实时监看按需拉�循环等待.md
+++ b/docs/task/54-修�实时监看按需拉�循环等待.md
@@ -2,8 +2,8 @@
 generated: true (请先修改 Gitea Wiki，�止直接编辑本文件)
 wiki_page: Task-54-修�实时监看按需拉�循环等待
 wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Task-54-%E4%BF%AE%E5%A4%8D%E5%AE%9E%E6%97%B6%E7%9B%91%E7%9C%8B%E6%8C%89%E9%9C%80%E6%8B%89%E6%B5%81%E5%BE%AA%E7%8E%AF%E7%AD%89%E5%BE%85.-
-wiki_revision: bdeca60040f62df75a8138491cb30939172b6b73
-synchronized_at: 2026-08-13T13:32:00Z
+wiki_revision: ff79f9dbc718ae570b01dace25304379124a99b4
+synchronized_at: 2026-08-13T14:05:00Z
 <!-- gitea-wiki-mirror:end -->
 
 # 54 修�实时监看按需拉�循环等待
@@ -27,12 +27,16 @@ MediaMTX 使用按需拉�时，必须先有播放器读�路径�会连接
 - 会�查询通过�读媒体端�刷新控制器状�，把等待状�安全收敛为�播放或需�处�，��新应用路径�置。
 - 播放器包装接�覆盖全局嵌入策略为 `SAMEORIGIN`，并用 CSP `frame-ancestors 'self'` �制为 Sense ��页�；其他接�继续�� `X-Frame-Options: DENY`。
 - iframe 导航无法附加 API 客户端的 `X-Product` 头，因此播放器路由改用窄导航认�：有效 Sense 会� Cookie�媒体读����`Sec-Fetch-Site: same-origin`�`Sec-Fetch-Mode: navigate` 和 `Sec-Fetch-Dest: iframe` 必须�时满足。普通 API 的产�头�求����。
+- MediaMTX 路径首次�置使用 add，已存在时使用 replace；控制 API 刚�动尚未监�时�时等待。
+- Sense 完�数�库�移�自动��所有 `desired=running` 路径；路径�存在显�标记为�置失败，��误报 waiting。
 - 继续�� `sourceOnDemand`，无人观看时��用摄�机连接与转�资�。
 - 真实环境验�过程中�现已�存的 RTSP 凭�被摄�机拒�（401）；已通过现有 Sense 接�使用本地已获授��置修正�行数�，未把凭�写入仓库�工��Wiki 或日志��。
 
 ## 修改文件
 
-- `Sense/server/app/sense/media/service.go`�`route_port.go`：增加�读状�刷新能力。
+- `Sense/server/app/sense/media/service.go`�`route_port.go`：增加�读状�刷新�缺失状�和�动��能力。
+- `Sense/server/app/sense/adapters/mediamtx/client.go`�`client_test.go`：实现 add/replace 幂等语义并等待控制 API 就绪。
+- `Sense/server/cmd/sense/{modules_media.go,root.go}`�`internal/platform/app.go`：在�移完��执行媒体路径��。
 - `Sense/server/app/sense/media/service_test.go`：验�刷新状�且����置路径。
 - `Sense/server/app/sense/liveview/service.go`：查询会�时刷新媒体状�。
 - `Sense/server/app/sense/liveview/http.go`�`http_test.go`：�许并验�播放器包装页仅��嵌入。
@@ -52,6 +56,8 @@ MediaMTX 使用按需拉�时，必须先有播放器读�路径�会连接
 | �泄露摄�机凭�和�地� | 通过 |
 | 播放器�被 Sense ��嵌入且其他页���止嵌入 | 通过，�行包接��应头验�通过 |
 | iframe �带 `X-Product` 时�能安全认� | 通过，�� iframe + 有效 Cookie 返回 200；跨站返回 401；普通 API 缺少产�头返回 401 |
+| MediaMTX 冷�动��� Sense 路径 | 通过，�置列表自动出现 2 � `sourceOnDemand` 路径，无需手工对账 |
+| 两�摄�机路径�实际解� | 通过，主�� H.264 1920×1080 + AAC，��� H.264，�收到媒体字节 |
 
 ## 测试
 
@@ -61,7 +67,9 @@ MediaMTX 使用按需拉�时，必须先有播放器读�路径�会连接
 - Go 1.26.5 Windows 打包：通过。
 - �行包�应头：播放器接�为 `SAMEORIGIN` 且包� `frame-ancestors 'self'`；首页�为 `DENY`。
 - �行包�览器�认�：�带 `X-Product`�带有效 Cookie 和�� iframe Fetch Metadata 的播放器请求返回 200；跨站播放器与缺少产�头的普通 API �返回 401。
-- 真实媒体链路：MediaMTX `sourceReady=true`�`readers=1`�收到媒体字节且包� 2 个轨�；Sense 会�由 `waiting` 收敛为 `ready`。
+- 冷�动��：MediaMTX �置列表自动包�两� Sense `sourceOnDemand` 路径；�行�列表也存在两�路径。
+- 真实媒体链路：主�� H.264 1920×1080 + AAC，��� H.264；两�路径分别通过本机 RTSP 读�并收到媒体字节。
+- �元测试覆盖路径首次 add�已有 replace�控制 API �动等待��动���缺失路径�误报 waiting。
 - **未验�部分**：最终�览器中的�视画�需�用户在当��览器验收；自动化已验�媒体��读�者与会�状�收敛。
 
 ## �留问题
@@ -74,4 +82,5 @@ MediaMTX 使用按需拉�时，必须先有播放器读�路径�会连接
 - `b3dfd23` 更新按需拉�长期 Wiki 镜�。
 - `3696442` �许播放器包装页仅被 Sense ��嵌入。
 - `8bf9a6d` 支���播放器导航认�并��普通 API 产�边界。
+- `d7cd3a5` �� MediaMTX 按需路径并处��动竞�。