Fix live camera pose loading and relay buffer

docs/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Tennis Training Hub - 变更日志
 
+## 2026.03.17-live-camera-pose-buffer-window (2026-03-17)
+
+### 功能更新
+
+- 修复 `/live-camera` 开始分析时报错 `Cannot destructure property 'Pose' ... as it is undefined` 的问题；MediaPipe Pose 动态加载现在兼容 `Pose`、`default.Pose` 和默认导出三种模块形态
+- 多端同步观看的 relay 缓存窗口改为按会话配置，默认 `2` 分钟，可选最短 `10` 秒、最长 `5` 分钟；viewer 页面、徽标和设置卡都会同步显示当前缓存时长
+- owner 端分析录制在继续保持“每 `60` 秒自动归档”之外，会额外每 `10` 秒上传一次 relay 分片，因此短缓存模式下其他端不需要等待整整 `60` 秒才看到平滑同步视频
+- media 服务会按各自 relay 会话的缓存秒数裁剪 preview 分段；从磁盘恢复旧 relay 会话时也会自动归一化到合法范围，避免旧会话继续沿用固定 `60` 秒窗口
+- 线上 smoke 已确认 `https://te.hao.work/` 正在提供本次新构建，而不是旧资源版本；当前公开站点资源 revision 为 `assets/index-2-BhvFom.js`、`assets/index-BHHHsAWc.css`、`assets/pose-BPcIm7Xa.js`
+
+### 测试
+
+- `cd media && go test ./...`
+- `pnpm vitest run client/src/lib/liveCamera.test.ts`
+- `pnpm check`
+- `pnpm build`
+- `pnpm exec playwright test tests/e2e/app.spec.ts`
+- `playwright-skill` 线上 smoke：登录 `H1` 后访问 `https://te.hao.work/live-camera`，完成校准、启用假摄像头并点击“开始分析”，确认页面进入分析中状态、默认显示“缓存 2 分钟”，且无控制台与页面级错误
+- `curl -I https://te.hao.work/`
+- `curl -I https://te.hao.work/assets/index-2-BhvFom.js`
+- `curl -I https://te.hao.work/assets/index-BHHHsAWc.css`
+- `curl -I https://te.hao.work/assets/pose-BPcIm7Xa.js`
+
+### 线上 smoke
+
+- `https://te.hao.work/` 已切换到本次新构建，而不是旧资源版本
+- 当前公开站点前端资源 revision：`assets/index-2-BhvFom.js`、`assets/index-BHHHsAWc.css`、`assets/pose-BPcIm7Xa.js`
+- 已确认首页、主 JS、主 CSS 与 `pose` 模块均返回 `200`，且 MIME 分别为 `text/html`、`application/javascript`、`text/css`、`application/javascript`
+- 真实浏览器验证已通过：登录 `H1` 后进入 `/live-camera`，能够完成校准、启用摄像头并点击“开始分析”；页面会进入“分析进行中”状态，默认显示“缓存 2 分钟”，且未再出现 `Pose` 模块解构异常
+
+### 仓库版本
+
+- `f3f7e19+pose-buffer-window`
+
 ## 2026.03.17-live-camera-relay-buffer (2026-03-17)
 
 ### 功能更新