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-media-asset-url",
    releaseDate: "2026-03-17",
    repoVersion: "902bd78+media-asset-url-fix",
    summary:
      "修复同步观看预览地址被重复拼接 `/media` 导致的 404，观看端可以继续打开 relay 缓存视频。",
    features: [
      "共享的 `getMediaAssetUrl()` 现在会保留已带 `/media/` 前缀的应用内路径，不再把 `/media/assets/...` 再次拼成 `/media/media/assets/...`",
      "当服务端直接返回完整 `https://...` 外链时，前端会原样使用该地址，避免对外部媒体地址做错误拼接",
      "其他仍是普通相对路径的媒体资源会继续自动补齐 `/media` 前缀，因此旧调用方无需改动",
      "同步观看点击“同步观看”后，请求的 preview 地址恢复为 `/media/assets/sessions/.../preview.webm`，不再因 `404 page not found` 导致无视频可播",
      "线上 smoke 已确认 `https://te.hao.work/` 已切换到包含本次修复的新构建，而不是继续提供部署前的旧资源 revision",
    ],
    tests: [
      "pnpm vitest run client/src/lib/media.test.ts",
      "pnpm check",
      "pnpm build",
      "playwright-skill 线上 smoke: 登录 `H1` 后访问 `https://te.hao.work/live-camera`，确认 viewer 实际请求 `https://te.hao.work/media/assets/sessions/.../preview.webm?...` 并返回 `200`，同时不存在 `/media/media/...` 双前缀请求",
      "线上 smoke: 已确认部署前公开站点还是旧 revision；部署后 `https://te.hao.work/` 已切换到包含本次修复的新构建",
    ],
  },
  {
    version: "2026.03.17-live-camera-pose-buffer-window",
    releaseDate: "2026-03-17",
    repoVersion: "f3f7e19+pose-buffer-window",
    summary:
      "修复实时分析启动时的 MediaPipe Pose 模块加载崩溃，并把多端同步缓存改为默认 2 分钟、可选 10 秒到 5 分钟。",
    features: [
      "live-camera 开始分析时不再直接解构 `import(\"@mediapipe/pose\")` 的返回值，而是兼容 `Pose`、`default.Pose` 和默认导出三种形态；模块缺失时会抛出明确错误，避免再次出现 `Cannot destructure property 'Pose' ... as it is undefined`",
      "同步观看的 relay 缓存时长改为按会话配置，范围 10 秒到 5 分钟，默认 2 分钟；viewer 文案、徽标和设置面板都会实时显示当前缓存窗口",
      "owner 端合成画布录制改为每 10 秒上传一次 relay 分片，同时继续维持每 60 秒一段的自动归档录像，因此观看端切到短缓存时不需要再等满 60 秒才出现平滑视频",
      "media 服务会按各自 relay 会话的缓存窗口裁剪预览分段，并在从磁盘恢复旧会话时自动归一化缓存秒数，避免旧数据继续按固定 60 秒窗口工作",
      "同步端渲染远端 recentSegments 时新增旧快照归一化，`keyFrames`、`issueSummary` 等数组字段缺失时也会自动补默认值，避免再出现 `Cannot read properties of undefined (reading 'length')`",
      "同步观看界面新增“已累积 / 还需多久才能看到首段回放 / 距离目标缓存还差多少”的提示，观看端不再只显示笼统的等待文案",
      "线上 smoke 已确认 `https://te.hao.work/` 已经提供本次新构建，而不是旧资源版本；首页、主样式和 `pose` 模块都已切到本次发布的最新资源 revision",
    ],
    tests: [
      "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/，并确认首页、主样式与 `pose` 模块资源均返回 `200` 和正确 MIME",
    ],
  },
  {
    version: "2026.03.17-live-camera-relay-buffer",
    releaseDate: "2026-03-17",
    repoVersion: "63dbfd2+relay-buffer",
    summary:
      "实时分析同步观看改为服务端滚动视频缓存，观看端不再轮询单帧图片；media 服务同时新增最近 60 秒缓冲和 30 分钟缓存清理。",
    features: [
      "live-camera owner 端的 60 秒合成录像分段现在会额外上传到 media relay 会话，观看端改为播放服务端生成的滚动 preview 视频，不再依赖 `live-frame.jpg` 单帧轮询",
      "relay 会话只保留最近 60 秒分段，worker 会在新分段到达后按最新窗口重建 `preview.webm`，避免观看端继续看到旧一分钟缓存",
      "超过 30 分钟无活动的 relay 会话、分段目录和公开缓存文件会自动清理，避免多端同步长期堆积无用缓存",
      "实时分析 viewer 文案和占位提示同步调整为“缓冲最近 60 秒视频 / 加载缓存回放”，更贴近现在的服务端缓存播放行为",
      "media preview 非归档阶段跳过 mp4 转码，Chrome 观看直接使用 webm，降低 worker 处理时延和 CPU 消耗",
    ],
    tests: [
      "cd media && go test ./...",
      "pnpm vitest run client/src/lib/liveCamera.test.ts",
      'pnpm exec playwright test tests/e2e/app.spec.ts --grep "live camera page exposes camera startup controls|live camera starts analysis and produces scores|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 check",
      "pnpm build",
      "线上 smoke: 部署后确认 `https://te.hao.work/` 已提供新构建而不是旧资源版本，`/live-camera` viewer 端进入“服务端缓存同步”路径并返回正确的 JS/CSS MIME",
    ],
  },
  {
    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: ["教程库、提醒、通知相关测试通过"],
  },
];