docs: 更新工单 #54 验收修复

2026-08-13 15:24:06 +08:00
parent e526f43f9f
commit 948a80e951
1 changed files with 5 additions and 0 deletions
@@ -17,6 +17,7 @@ MediaMTX 使用按需拉流时，必须先有播放器读取路径才会连接

 - 实时监看收到有效播放地址且状态为“等待拉流”或“可播放”时都加载播放器；“等待拉流”保留明确状态提示，同时触发 MediaMTX 按需连接。
 - 会话查询通过只读媒体端口刷新控制器状态，把等待状态安全收敛为可播放或需要处理，不重新应用路径配置。
+- 播放器包装接口覆盖全局嵌入策略为 `SAMEORIGIN`，并用 CSP `frame-ancestors 'self'` 限制为 Sense 同源页面；其他接口继续保持 `X-Frame-Options: DENY`。
 - 继续保持 `sourceOnDemand`，无人观看时不占用摄像机连接与转码资源。
 - 真实环境验证过程中发现已保存的 RTSP 凭据被摄像机拒绝（401）；已通过现有 Sense 接口使用本地已获授权配置修正运行数据，未把凭据写入仓库、工单、Wiki 或日志证据。

@@ -25,6 +26,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 架构、业务规则与排错页面。
@@ -38,6 +40,7 @@ MediaMTX 使用按需拉流时，必须先有播放器读取路径才会连接
 | 实际媒体源可解码 | 通过，探测到 H.264 1920×1080 视频和 AAC 音频 |
 | 不重复应用路径配置 | 通过，单元测试验证刷新仅调用状态查询 |
 | 不泄露摄像机凭据和源地址 | 通过 |
+| 播放器可被 Sense 同源嵌入且其他页面仍禁止嵌入 | 通过，运行包接口响应头验证通过 |

 ## 测试

@@ -45,6 +48,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`。
 - **未验证部分**：最终浏览器中的可视画面需要用户在当前浏览器验收；自动化已验证媒体源、读取者与会话状态收敛。

@@ -56,3 +60,4 @@ MediaMTX 使用按需拉流时，必须先有播放器读取路径才会连接

 - `8d4e4c2` 修复实时监看按需拉流循环等待。
 - `b3dfd23` 更新按需拉流长期 Wiki 镜像。
+- `3696442` 允许播放器包装页仅被 Sense 同源嵌入。