docs: 记录播放器同源嵌入修复 (#54)

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: 3b3a0a211aa7ed8209799a09818b7901c290f750
-synchronized_at: 2026-08-13T07:01:47Z
+wiki_revision: 19729dc49683e0ea30b951ec369ce2409ba52b2b
+synchronized_at: 2026-08-13T07:24:36Z
 <!-- gitea-wiki-mirror:end -->
 
 # 54 修复实时监看按需拉流循环等待
@@ -25,6 +25,7 @@ MediaMTX 使用按需拉流时，必须先有播放器读取路径才会连接
 
 - 实时监看收到有效播放地址且状态为“等待拉流”或“可播放”时都加载播放器；“等待拉流”保留明确状态提示，同时触发 MediaMTX 按需连接。
 - 会话查询通过只读媒体端口刷新控制器状态，把等待状态安全收敛为可播放或需要处理，不重新应用路径配置。
+- 播放器包装接口覆盖全局嵌入策略为 `SAMEORIGIN`，并用 CSP `frame-ancestors 'self'` 限制为 Sense 同源页面；其他接口继续保持 `X-Frame-Options: DENY`。
 - 继续保持 `sourceOnDemand`，无人观看时不占用摄像机连接与转码资源。
 - 真实环境验证过程中发现已保存的 RTSP 凭据被摄像机拒绝（401）；已通过现有 Sense 接口使用本地已获授权配置修正运行数据，未把凭据写入仓库、工单、Wiki 或日志证据。
 
@@ -33,6 +34,7 @@ MediaMTX 使用按需拉流时，必须先有播放器读取路径才会连接
 - `Sense/server/app/sense/media/service.go`、`route_port.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`：允许并验证播放器包装页仅同源嵌入。
 - `Sense/server/app/sense/liveview/service_test.go`：验证等待状态收敛到可播放。
 - `Sense/ui/src/components/sense/liveview/StreamPlayer.vue`：等待拉流时即加载播放器。
 - Wiki 架构、业务规则与排错页面。
@@ -46,6 +48,7 @@ MediaMTX 使用按需拉流时，必须先有播放器读取路径才会连接
 | 实际媒体源可解码 | 通过，探测到 H.264 1920×1080 视频和 AAC 音频 |
 | 不重复应用路径配置 | 通过，单元测试验证刷新仅调用状态查询 |
 | 不泄露摄像机凭据和源地址 | 通过 |
+| 播放器可被 Sense 同源嵌入且其他页面仍禁止嵌入 | 通过，运行包接口响应头验证通过 |
 
 ## 测试
 
@@ -53,6 +56,7 @@ MediaMTX 使用按需拉流时，必须先有播放器读取路径才会连接
 - `corepack pnpm lint`：0 error，806 个既有格式 warning。
 - `corepack pnpm build`：通过，存在 3 个既有 webpack 体积 warning。
 - Go 1.26.5 Windows 打包：通过。
+- 运行包响应头：播放器接口为 `SAMEORIGIN` 且包含 `frame-ancestors 'self'`；首页仍为 `DENY`。
 - 真实媒体链路：MediaMTX `sourceReady=true`、`readers=1`、收到媒体字节且包含 2 个轨道；Sense 会话由 `waiting` 收敛为 `ready`。
 - **未验证部分**：最终浏览器中的可视画面需要用户在当前浏览器验收；自动化已验证媒体源、读取者与会话状态收敛。
 
@@ -64,3 +68,4 @@ MediaMTX 使用按需拉流时，必须先有播放器读取路径才会连接
 
 - `8d4e4c2` 修复实时监看按需拉流循环等待。
 - `b3dfd23` 更新按需拉流长期 Wiki 镜像。
+- `3696442` 允许播放器包装页仅被 Sense 同源嵌入。