298 行
17 KiB
TypeScript
298 行
17 KiB
TypeScript
export type ChangeLogEntry = {
|
||
version: string;
|
||
releaseDate: string;
|
||
repoVersion: string;
|
||
summary: string;
|
||
features: string[];
|
||
tests: string[];
|
||
};
|
||
|
||
export const CHANGE_LOG_ENTRIES: ChangeLogEntry[] = [
|
||
{
|
||
version: "2026.03.17-live-camera-preview-recovery",
|
||
releaseDate: "2026-03-17",
|
||
repoVersion: "06b9701",
|
||
summary: "修复实时分析页标题乱码、同步观看残留状态导致的黑屏，以及切回本机摄像头后预览无法恢复的问题。",
|
||
features: [
|
||
"runtime 标题恢复逻辑新增更严格的乱码筛除与二次 UTF-8 解码兜底，`æœ...`、带替换字符的脏标题现在会优先恢复为正常中文，无法恢复时会安全回退到稳定默认标题",
|
||
"同步观看退出时会完整重置 viewer 轮询、连接标记和帧版本，不再把旧 viewer 状态残留到 owner 或空闲态，避免页面继续停留在黑屏或“等待同步画面”",
|
||
"本地摄像头预览新增独立重绑流程和多次 watchdog 重试，即使浏览器在首帧时没有及时绑定 `srcObject` 或 `play()` 被短暂打断，也会自动恢复预览",
|
||
"视频区域是否显示画面改为按当前 runtime 角色分别判断，避免 viewer 的旧连接状态误导 owner 模式，导致本地没有预览时仍隐藏占位提示",
|
||
],
|
||
tests: [
|
||
"pnpm check",
|
||
"pnpm vitest run client/src/lib/liveCamera.test.ts",
|
||
"pnpm exec playwright test tests/e2e/app.spec.ts --grep \"live camera\"",
|
||
"pnpm build",
|
||
"线上 smoke: `curl -I https://te.hao.work/`，并检查页面源码中的 `/assets/index-*.js`、`/assets/index-*.css`、`/assets/pose-*.js` 已切换到新构建且返回正确 MIME",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.16-live-camera-runtime-refresh",
|
||
releaseDate: "2026-03-16",
|
||
repoVersion: "8e9e491",
|
||
summary: "修复实时分析页偶发残留在同步观看状态、标题乱码，以及摄像头预览绑定波动导致的启动失败。",
|
||
features: [
|
||
"live-camera 在打开拍摄引导、启用摄像头、开始分析前，都会先向服务端强制刷新 runtime 状态，避免旧的 viewer 锁残留导致本机明明已释放却仍无法启动",
|
||
"同步观看标题新增乱码恢复逻辑，可自动把 UTF-8 被误按 Latin-1 显示的标题恢复成正常中文，避免出现 `æœ...` 一类异常标题",
|
||
"摄像头启动链路改为以 `getUserMedia` 成功为准；即使本地预览 `<video>` 的 `srcObject` 或 `play()` 在当前浏览器里短暂失败，也不会直接把整次启动判死",
|
||
"e2e mock 的媒体流补齐为带假视频轨道的流对象，并把 viewer 回归改为校验“服务端 relay、无 viewer-signal”行为，减少和旧 P2P 逻辑混淆",
|
||
],
|
||
tests: [
|
||
"pnpm exec playwright test tests/e2e/app.spec.ts --grep \"live camera page exposes camera startup controls|live camera switches into viewer mode when another device already owns analysis|live camera recovers mojibake viewer titles before rendering|live camera no longer opens viewer peer retries when server relay is active\"",
|
||
"pnpm build",
|
||
"部署后线上 smoke: `https://te.hao.work/live-camera` 登录 H1 后可见空闲态“启动摄像头”入口，确认不再被残留 viewer 锁卡住；公开站点前端资源为 `assets/index-33wVjC4p.js` 与 `assets/index-tNGuStgv.css`",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.16-live-viewer-server-relay",
|
||
releaseDate: "2026-03-16",
|
||
repoVersion: "bb46d26",
|
||
summary: "实时分析同步观看改为由 media 服务中转帧图，不再依赖浏览器之间的 P2P 视频连接。",
|
||
features: [
|
||
"owner 端现在会把带骨架、关键点和虚拟形象叠层的合成画布压缩成 JPEG 并持续上传到 media 服务",
|
||
"viewer 端改为直接拉取 media 服务中的最新同步帧图，不再建立 WebRTC viewer peer 连接，因此跨网络和多端观看更稳定",
|
||
"同步观看模式文案改为明确提示“通过 media 服务中转”，等待同步时也会自动轮询最新画面",
|
||
"media 服务新增 live-frame 上传与静态分发能力，并记录最近同步帧的更新时间，方便后续扩展成更高频的服务端中转流",
|
||
],
|
||
tests: [
|
||
"cd media && go test ./...",
|
||
"pnpm build",
|
||
"playwright-skill 线上 smoke: 先用 media 服务创建 relay session、上传 live-frame，并把 H1 的 `live_analysis_runtime` 注入为 active viewer 场景；随后访问 `https://te.hao.work/live-camera`，确认页面进入“同步观看模式”、同步帧来自 `/media/assets/sessions/.../live-frame.jpg`，且 `viewer-signal` 请求数为 0",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.16-camera-startup-fallbacks",
|
||
releaseDate: "2026-03-16",
|
||
repoVersion: "a211562",
|
||
summary: "修复部分设备上摄像头因后置镜头约束、分辨率约束或麦克风不可用而直接启动失败的问题。",
|
||
features: [
|
||
"live-camera 与 recorder 改为共用分级降级的摄像头请求流程，会在当前画质失败时自动降分辨率、降约束并回退到兼容镜头",
|
||
"当设备不支持默认后置摄像头或当前镜头不可用时，页面会自动切换到实际可用的镜头方向，避免直接报错后卡死在未启动状态",
|
||
"recorder 预览启动不再被麦克风权限或麦克风设备异常整体拖死；麦克风不可用时会自动回退到仅视频模式",
|
||
"兼容模式命中时前端会给出明确提示，方便区分“已自动降级成功”与“仍然无法访问摄像头”的场景",
|
||
],
|
||
tests: [
|
||
"pnpm build",
|
||
"部署后线上 smoke: `https://te.hao.work/` 已提供 `assets/index-CRxtWK07.js` 与 `assets/index-tNGuStgv.css`；通过注入 `getUserMedia` 回归验证 `/live-camera` 首轮高约束失败后会自动切到兼容摄像头模式，`/recorder` 在麦克风不可用时会自动回退到仅视频模式并继续启动预览",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.16-live-analysis-viewer-full-sync",
|
||
releaseDate: "2026-03-16",
|
||
repoVersion: "922a9fb",
|
||
summary: "多端同步观看改为按持有端快照完整渲染，另一设备可同步看到视频状态、模式、画质、虚拟形象和保存阶段信息。",
|
||
features: [
|
||
"viewer 端现在同步显示持有端的会话标题、训练模式、设备端、拍摄视角、画质模式、虚拟形象状态和最近同步时间",
|
||
"同步观看时的分析阶段、保存阶段、已完成状态也会跟随主端刷新，不再只显示本地默认状态",
|
||
"viewer 页面会自动关闭拍摄校准弹窗，避免同步观看时被“启用摄像头”流程遮挡",
|
||
"新增 viewer 同步信息卡，明确允许 1 秒级延迟，并持续显示最近心跳时间",
|
||
],
|
||
tests: [
|
||
"pnpm exec playwright test tests/e2e/app.spec.ts --grep \"live camera switches into viewer mode|viewer stream|recorder blocks\"",
|
||
"pnpm build",
|
||
"部署后线上 smoke: `https://te.hao.work/` 已提供 `assets/index-HRdM3fxq.js` 与 `assets/index-tNGuStgv.css`；同账号 H1 双端登录后，移动端 owner 可开始实时分析，桌面端 `/live-camera` 自动进入同步观看并显示主端信息、同步视频流，owner 点击结束分析后 viewer 会同步进入保存阶段",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.16-live-analysis-lock-hardening",
|
||
releaseDate: "2026-03-16",
|
||
repoVersion: "f9db6ef",
|
||
summary: "修复同账号多端实时分析在旧登录态下仍可重复占用摄像头的问题，补强同步观看重试、录制页占用锁，并修复部署后启动阶段长时间 502。",
|
||
features: [
|
||
"旧用户名登录 token 即使缺少 `sid`，现在也会按 token 本身派生唯一会话标识，不再把不同设备错误识别成同一持有端",
|
||
"同步观看模式新增 viewer 自动重试：当持有端刚启动推流、viewer 首次连接返回 `viewer stream not ready` 时，会自动重连而不是一直黑屏",
|
||
"在线录制页接入实时分析占用锁；当其他设备正在 `/live-camera` 分析时，本页会禁止再次启动摄像头和录制",
|
||
"应用启动改为先监听 HTTP 端口、再后台串行执行教程图同步和标准库预热，修复新容器上线时公网长时间返回 502 的问题",
|
||
"线上 smoke 已确认 `https://te.hao.work/live-camera` 与 `/recorder` 都已切换到本次新构建，公开站点不再返回 502",
|
||
],
|
||
tests: [
|
||
"curl -I https://te.hao.work/",
|
||
"pnpm check",
|
||
"pnpm exec vitest run server/_core/sdk.test.ts server/features.test.ts",
|
||
"pnpm exec playwright test tests/e2e/app.spec.ts --grep \"viewer mode|viewer stream|recorder blocks\"",
|
||
"pnpm build",
|
||
"线上 smoke: H1 手机端开启实时分析后，PC 端 `/live-camera` 自动进入同步观看并显示同步画面，`/recorder` 禁止启动摄像头；结束分析后会话可正常释放",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.16-live-analysis-runtime-migration",
|
||
releaseDate: "2026-03-16",
|
||
repoVersion: "2b72ef9",
|
||
summary: "修复实时分析因缺失 `live_analysis_runtime` 表导致的启动失败，并补齐迁移记录避免后续部署再次漏表。",
|
||
features: [
|
||
"生产库补建 `live_analysis_runtime` 表，并补写 `__drizzle_migrations` 中缺失的 `0011_live_analysis_runtime` 记录",
|
||
"仓库内 Drizzle migration journal 补齐 `0011_live_analysis_runtime` 条目，后续 `docker compose` 部署可正确感知该迁移",
|
||
"实时分析启动链路恢复，`/live-camera` 再次可以读取 runtime 锁并正常进入分析准备流程",
|
||
"线上 smoke 已确认 `https://te.hao.work/` 正在提供本次新构建，当前前端资源为 `assets/index-B3BN5hY-.js` 与 `assets/index-BL6GQzUF.css`",
|
||
],
|
||
tests: [
|
||
"pnpm check",
|
||
"pnpm exec vitest run server/features.test.ts",
|
||
"pnpm build",
|
||
"docker compose exec -T db mysql ... SHOW TABLES LIKE 'live_analysis_runtime'",
|
||
"curl -I https://te.hao.work/live-camera",
|
||
"Playwright smoke: 登录 `H1` 后访问 `/live-camera`，`analysis.runtimeGet` / `analysis.runtimeAcquire` / `analysis.runtimeRelease` 全部返回 200",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.16-live-camera-multidevice-viewer",
|
||
releaseDate: "2026-03-16",
|
||
repoVersion: "4e4122d",
|
||
summary: "实时分析新增同账号多端互斥和同步观看模式，分析持有端独占摄像头，其它端只能查看同步画面与核心识别结果。",
|
||
features: [
|
||
"同一账号在 `/live-camera` 进入实时分析后，会写入按用户维度的 runtime 锁，其他设备不能重复启动摄像头或分析",
|
||
"其他设备会自动进入“同步观看模式”，可订阅持有端的实时画面，并同步看到动作、评分、反馈、最近片段和归档段数",
|
||
"同步观看复用 media 服务的 WebRTC viewer 通道，传输的是带骨架、关键点和虚拟形象覆盖后的合成画面",
|
||
"runtime 锁按 session sid 区分持有端，兼容缺少 sid 的旧 token，超过 15 秒无心跳会自动判定为陈旧并释放",
|
||
"线上 smoke 已确认 `https://te.hao.work/live-camera` 已切换到本次新构建，公开站点正在提供这次发布的最新前端资源",
|
||
],
|
||
tests: [
|
||
"pnpm check",
|
||
"pnpm exec vitest run server/features.test.ts",
|
||
"go test ./... && go build ./... (media)",
|
||
"pnpm build",
|
||
"pnpm exec playwright test tests/e2e/app.spec.ts --grep \"live camera\"",
|
||
"pnpm exec playwright test tests/e2e/app.spec.ts --grep \"recorder flow archives a session and exposes it in videos\"",
|
||
"curl -I https://te.hao.work/live-camera",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.16-live-analysis-overlay-archive",
|
||
releaseDate: "2026-03-16",
|
||
repoVersion: "4fb2d09",
|
||
summary: "实时分析新增 60 秒自动归档录像，录制内容会保留骨架、关键点和虚拟形象叠层，并同步进入视频库。",
|
||
features: [
|
||
"实时分析开始后会自动录制合成画布，每 60 秒自动切段归档",
|
||
"归档录像会保留原视频、骨架线、关键点和当前虚拟形象覆盖效果",
|
||
"归档片段会自动写入视频库，标签显示为“实时分析”",
|
||
"删除视频库中的实时分析录像时，不会删除已写入的实时分析数据和训练记录",
|
||
"线上 smoke 已确认 `https://te.hao.work/` 已切换到本次新构建，`/live-camera`、`/videos`、`/changelog` 页面均可正常访问",
|
||
],
|
||
tests: [
|
||
"pnpm check",
|
||
"pnpm test",
|
||
"pnpm build",
|
||
"pnpm test:e2e",
|
||
"Playwright smoke: 真实站点登录 H1，完成 /live-camera 引导、开始/结束分析，并确认 /videos 可见实时分析条目",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.15-live-analysis-leave-hint",
|
||
releaseDate: "2026-03-15",
|
||
repoVersion: "5c2dcf2",
|
||
summary: "实时分析结束后增加离开提示，明确何时必须停留、何时可以安全关闭或切页。",
|
||
features: [
|
||
"分析进行中显示“不要关闭或切走页面”提示",
|
||
"结束分析后保存阶段显示“请暂时停留当前页面”提示",
|
||
"保存成功后明确提示“现在可以关闭浏览器或切换到其他页面”",
|
||
"分析中和保存中挂接 beforeunload 提醒，减少误关页面导致的数据丢失",
|
||
],
|
||
tests: [
|
||
"pnpm check",
|
||
"pnpm build",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.15-training-generator-collapse",
|
||
releaseDate: "2026-03-15",
|
||
repoVersion: "1ce94f6",
|
||
summary: "训练计划生成面板在桌面端默认折叠到右侧，按需展开查看和重新生成。",
|
||
features: [
|
||
"训练页右侧生成器在桌面端默认折叠为窄栏",
|
||
"点击右侧折叠栏可展开“重新生成计划”完整面板",
|
||
"移动端继续直接展示完整生成器，避免隐藏关键操作",
|
||
"未生成计划时点击“前往生成训练计划”会自动展开并滚动到生成面板",
|
||
],
|
||
tests: [
|
||
"pnpm check",
|
||
"pnpm build",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.15-progress-time-actions",
|
||
releaseDate: "2026-03-15",
|
||
repoVersion: "71caf0d",
|
||
summary: "最近训练记录默认显示具体上海时间，并直接展示录制动作数据摘要。",
|
||
features: [
|
||
"最近训练记录摘要行默认显示到秒的 Asia/Shanghai 时间",
|
||
"录制记录列表直接展示主动作和前 3 个动作统计，无需先展开",
|
||
"展开态动作明细统一用中文动作标签展示",
|
||
"提醒页通知时间统一切换为 Asia/Shanghai",
|
||
],
|
||
tests: [
|
||
"pnpm check",
|
||
"pnpm build",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.15-session-changelog",
|
||
releaseDate: "2026-03-15",
|
||
repoVersion: "a9ea94f",
|
||
summary: "多端 session、更新日志页面、录制动作摘要与上海时区显示同步收口。",
|
||
features: [
|
||
"用户名登录生成独立 sid，同一账号多端登录保持并行有效",
|
||
"新增 /changelog 页面和侧边栏入口，展示版本、仓库版本和验证记录",
|
||
"训练进度页可展开查看最近训练记录的具体时间、动作统计和录制有效性",
|
||
"录制页增加动作抽样摘要、无效录制标记与 media 预归档状态",
|
||
"Dashboard、任务中心、管理台、评分、日志、视觉测试、视频库等页面统一使用 Asia/Shanghai 时间显示",
|
||
],
|
||
tests: [
|
||
"pnpm check",
|
||
"pnpm test",
|
||
"pnpm test:go",
|
||
"pnpm build",
|
||
"Playwright smoke: https://te.hao.work/ 双上下文登录 H1 后 dashboard 均保持有效；线上 /changelog 仍显示旧构建，待部署后复测",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.15-recorder-zoom",
|
||
releaseDate: "2026-03-15",
|
||
repoVersion: "c4ec397",
|
||
summary: "补齐录制页与实时分析页的节省流量模式、镜头缩放和移动端控制。",
|
||
features: [
|
||
"在线录制默认切换为节省流量模式",
|
||
"在线录制支持镜头焦距放大缩小",
|
||
"实时分析支持镜头焦距放大缩小",
|
||
"页面内增加拍摄与流量设置说明",
|
||
],
|
||
tests: [
|
||
"pnpm check",
|
||
"pnpm exec vitest run client/src/lib/media.test.ts client/src/lib/camera.test.ts",
|
||
"Playwright 真实站点检查 /live-camera 与 /recorder 新控件可见",
|
||
],
|
||
},
|
||
{
|
||
version: "2026.03.15-videos-crud",
|
||
releaseDate: "2026-03-15",
|
||
repoVersion: "bd89981",
|
||
summary: "视频库支持新增、编辑、删除训练视频记录。",
|
||
features: [
|
||
"视频库新增外部视频登记",
|
||
"视频库支持编辑标题和动作类型",
|
||
"视频库支持删除视频及关联分析引用",
|
||
"视频详情读取按当前用户权限收敛",
|
||
],
|
||
tests: [
|
||
"pnpm check",
|
||
"pnpm exec vitest run server/features.test.ts -t \"video\\\\.\"",
|
||
"Playwright 真实站点完成 /videos 新增-编辑-删除全链路",
|
||
],
|
||
},
|
||
{
|
||
version: "v3.0.0",
|
||
releaseDate: "2026-03-14",
|
||
repoVersion: "历史版本",
|
||
summary: "教程库、提醒、通知等学习能力上线。",
|
||
features: [
|
||
"训练视频教程库",
|
||
"教程自评与学习进度",
|
||
"训练提醒通知",
|
||
"通知历史管理",
|
||
],
|
||
tests: [
|
||
"教程库、提醒、通知相关测试通过",
|
||
],
|
||
},
|
||
];
|