760 Commits

Author	SHA1	Message	Date
xiaoxia	4a6d84921d	fix(cover): add plan.config.cover_candidates fallback in cover generation endpoint (#1458) ... Co-authored-by: xiaoxia <dev@xiaoxiajianji.com> Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>	2026-08-22 21:51:01 +08:00
xiaoxia	98cd806d29	style: 封面预览框缩小至max-width 180px居中	2026-08-22 20:34:52 +08:00
xiaoxia	6a57431f68	fix: 配音素材时长/大小显示为0 — fallback读取metadata字段	2026-08-22 18:41:18 +08:00
xiaoxia	d19fa951ee	fix: 标题/不换行+字体映射表修复	2026-08-22 18:23:46 +08:00
xiaoxia	e928068efd	refactor: v3调度器——所有状态存入ref彻底消除RAF闭包陷阱+片段切换先播下一段再切可见性	2026-08-22 15:35:37 +08:00
xiaoxia	18371dc438	fix: 修复RAF循环穿透导致指数级增长+音频同步重置卡顿 ... useSegmentScheduler.ts: - 新增 tickRef 保存最新 tick 引用，所有 RAF 调度通过 () => tickRef.current() - 片段边界切换分支加 return，阻止旧闭包穿透到末尾重复调度 RAF （这是网页越来越卡的根因：每次片段切换 RAF 链数量翻倍） - play() 和重播分支的 RAF 同样改用 tickRef FrontendPreviewPlayer.tsx: - 片段切换音频同步 useEffect 移除 currentTime 依赖 原依赖每200ms变化导致 audio.currentTime 被反复重置，音频卡顿	2026-08-22 13:38:02 +08:00
xiaoxia	4e9c9a2eda	fix: 禁用useCanvasPlayer后台解码+恢复所有video预加载 ... - useCanvasPlayer 新增 enabled 参数，enabled=false 时 hasSupport=false 且 init useEffect 直接 return，彻底不执行 WebCodecs 初始化和后台解码 - FrontendPreviewPlayer 传入 enabled=(useWebCodecs && !forceVideoFallback)， useWebCodecs=false 时 useCanvasPlayer 完全不启动，消除网页卡顿元凶 - 恢复所有 video 元素 preload=auto + src，撤掉条件预加载逻辑 （之前条件预加载导致 switchToSegment 时频繁动态设 src，影响播放和进度）	2026-08-22 02:37:46 +08:00
xiaoxia	b8a349d5e0	refactor: 默认使用原生video播放，彻底解决主线程解码卡顿 ... FrontendPreviewPlayer.tsx: - useWebCodecs 默认 false，走浏览器原生硬件解码（独立线程） - 删除 Canvas ResizeObserver useEffect（默认路径不需要） - video 元素只预加载当前+下一片段，其余 preload=none+不设src，减少并发连接 - 片段指示器统一显示片段序号，不再显示Canvas/降级提示 - isWebCodecsSupported 不再导入，清理 TS6133 useSegmentScheduler.ts: - tick 进度更新 200ms 节流（5fps），避免 60fps setCurrentTime 触发整树 re-render - 重播/seek 时重置节流 ref - switchToSegment 兜底：若 video 无 src 则动态设置并 load()，兼容 seek 到未预加载片段 useCanvasPlayer.ts 不删，保留作为兜底	2026-08-22 01:53:43 +08:00
xiaoxia	9c02e69ede	fix: 第13轮 — 背压阈值20→64+移除idleTicks超时+等待10ms→5ms ... - 背压阈值从20提到64，给硬件解码器足够流水线深度 - 等待间隔10ms→5ms，减少轮询开销 - 删除idleTicks 3秒超时，帧队列容量(180)才是真正背压 - 保留帧输出等待(500ms)和完成日志	2026-08-22 01:09:59 +08:00
xiaoxia	ece1f25f71	fix: 第12轮 — 背压超时保护+帧输出等待+feedFrames阈值 ... - 背压等待加 idleTicks 计数，超3秒自动break防止死循环 - 解码完成后等待帧输出（最多500ms），确保队列有帧 - 加解码完成日志便于排查 - renderFrame 中 feedFrames 调用加 size<80 阈值保护	2026-08-22 00:57:38 +08:00
xiaoxia	2885ede533	fix: 第11轮 — 解码流水线批量提交+背压+移除每帧log ... - decodeSegmentBatch: 移除每帧 await+3s超时，改为批量提交 decode() - 添加 decodeQueueSize>20 背压，防止解码器内部队列积压 - 批量提交后 16ms 等待让解码器输出帧 - feedFrames 缓冲阈值 100→80，减少后台解码抢占渲染 - 删除 drawTitle 每帧 console.log（JSON.stringify 开销导致抖动）	2026-08-22 00:15:27 +08:00
xiaoxia	ac31c88c96	fix: 修复 TS2367 类型收窄错误 — decoder.state 显式断言为 string	2026-08-21 23:43:15 +08:00
xiaoxia	585a3b6887	fix: 第10轮方案A — 滑动窗口+持久解码器+二分查找 ... 架构级重构，从根本解决抖动/卡顿/黑屏/重播失效/关键帧错误： - FrameQueue 默认容量 200，getCurrentFrame 改二分查找 O(log n) - 每个片段持有持久化 VideoDecoder，连续喂 sample 不报关键帧错误 - segmentSampleCursorRef 记录游标，支持断点续解码 - feedFrames 后台补充：队列低于 100 帧自动续解，保持 ≥6s 缓冲 - init 只解前 2 个片段各 60 帧，播放中后台补充 - 重播/seek：关闭旧解码器→清空队列→重置游标→重新解码 - isFeedingRef 防重入	2026-08-21 23:31:44 +08:00
xiaoxia	412aa83b32	fix: 第9轮最终简化方案 — init全量解码+播放时只渲染 ... 根因：之前 init 只解 60 帧，播放中续解码导致关键帧错误、 重复帧、队列混乱、抖动。 新方案： - init 阶段一次性解码全部 894 帧（队列 1024 足够容纳） - 播放时只做 drawImage，不触发任何解码 - 重播直接复用已有帧，不重新解码 - seek 直接定位，不清帧队列 - 删除 decodeAroundPosition 动态解码函数	2026-08-21 22:16:22 +08:00
xiaoxia	c6eeca75fb	fix: 删除 decodeSegment 的 startFrame 参数，修复关键帧错误 ... WebCodecs 解码器要求第一个 chunk 必须是关键帧。续解码从 startFrame=60 开始时，samplesCollected[60] 不是关键帧 → 报错 "A key frame is required"。 修复： - 删除 startFrame 参数，sample 循环永远从 0 开始 - decodeAroundPosition 不再传 startFrame - totalDecoded 计算不再使用 startFrame 偏移	2026-08-21 21:25:19 +08:00
xiaoxia	df4de37f73	fix: MAX_INIT_FRAMES 500 → 60，减少 init 阶段解码帧数降低播放抖动 ... init 阶段解码 894 帧导致 getCurrentFrame 遍历过多帧，播放抖动。 改为每片段只解 60 帧（≈2s），播放时由 decodeAroundPosition 按需续解。	2026-08-21 21:11:08 +08:00
xiaoxia	88c07ef142	fix: 视频 fallback 路径片段切换卡顿 — 预加载策略升级 ... 根因：UseWebCodecs=false 时走原生 video fallback，preload 策略为 当前片段 auto / 下一片段 metadata / 其余 none，导致切换时下一片段 需现场从网络缓冲，卡顿约 10 秒。 修复： 1. 所有 video 元素 preload="auto"，让浏览器提前缓冲全部片段 2. tick 循环中距出点 ≤3s 时主动 seek 下一片段触发缓冲 3. switchToSegment 超时从 10s 降到 3s（预加载正常时无需久等）	2026-08-21 20:55:36 +08:00
xiaoxia	0996ba45ec	fix: 续解码架构 + 帧队列扩容 1024 + 重播/seek/destroy 同步帧计数	2026-08-21 20:30:45 +08:00
xiaoxia	a34639975c	fix: 增大 init 解码上限 + 重播不清帧队列 + sample 循环 generation 检查	2026-08-21 19:58:40 +08:00
xiaoxia	4b68c9be9c	fix: 给 decoder.decode() 加 3s 超时保护，防止解码卡死	2026-08-21 19:09:39 +08:00
xiaoxia	fbe0a6e826	fix: 视频播放结束后重播时重置 currentTime 到起点	2026-08-21 17:18:35 +08:00
xiaoxia	7f2861e98e	fix: 移除 decoder.flush() 调用，修复 Chromium 下 flush 永久挂起导致解码卡死	2026-08-21 16:57:20 +08:00
xiaoxia	b1aa866252	fix: 修复 flush 超时 catch 块类型错误导致 CI 构建失败	2026-08-21 16:53:53 +08:00
xiaoxia	ebe43f163b	chore: DIAG_v2 诊断日志 + flush 5s 超时保护	2026-08-21 16:30:59 +08:00
xiaoxia	3e38395f46	chore: 添加 [DIAG] 诊断日志定位 decode loop 卡死点	2026-08-21 15:43:16 +08:00
xiaoxia	9cb20c38ae	fix: Strict Mode 双执行导致 decode loop 提前退出 ... React 18 Strict Mode 下 effect 执行两次（run → cleanup → run）， destroy() 和 init() 都调用 decodeGenerationRef.current++ 导致 generation 被多增两次，decode loop 内 generation check 误判为 seek/destroy 事件而提前退出。 修复： - destroy() 移除 decodeGenerationRef.current++ - init() 移除 decodeGenerationRef.current++ - seek()/play() 保留 generation 递增不变 - decoder.state === 'closed' 时 return 而非 break，让第二轮 init 重新创建 decoder 正常解码	2026-08-21 15:27:42 +08:00
xiaoxia	d784af7f67	fix: 重置 isDestroyedRef 修复 effect 生命周期导致解码永久跳过 ... useEffect cleanup 调用 destroy() 将 isDestroyedRef 设为 true， 但新的 init 周期不重置它，导致 loadSegment/decodeSegment 立即 return， isReady 永远为 false → canPlay 为 false → '暂无可播放素材' 修复： - init 开始时重置 isDestroyedRef = false + 递增 decodeGeneration - 同步重置 hasDecodeError/errorMessage/isReady 状态 - decode 循环内每次迭代后增加 cancelled 检查 - 增加诊断日志（decode loop 前后 + cancelled 分支）	2026-08-21 15:01:17 +08:00
xiaoxia	1b6ecc39f0	fix: WebCodecs 解码失败时自动 fallback 到原生 video 播放 ... - useCanvasPlayer 新增 hasDecodeError/errorMessage 状态和 onError 回调 - decodeSegment catch 块不再静默失败，更新状态并通知上层 - VideoDecoder error 回调同步报告错误状态 - 连续 3 次解码失败时报告 hasDecodeError - FrontendPreviewPlayer 检测 hasDecodeError 后自动切换 video fallback - 解码失败时显示具体错误信息而非静默'暂无可播放素材' - 新增 normalizeCodecString 函数规范化 codec 字符串 - configure 调用增加 codec 字符码调试日志	2026-08-21 14:43:12 +08:00
xiaoxia	955613efd3	fix(e2e): update generation API URL pattern in core-generation test (#1455) ... Co-authored-by: xiaoxia <dev@xiaoxiajianji.com> Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>	2026-08-21 12:31:01 +08:00
xiaoxia	3441b3fece	fix: Canvas 播放黑屏二次修复 — FrameQueue 扩容到 600 + 按需解码限制 300 帧 ... 根因：按需解码 decodeAroundPosition 调用 decodeSegment 时未传 maxFrames， 导致一次解码整个片段（~300帧）全部 push 进 maxSize=60 的队列，前 240 帧被淘汰， 只剩末尾帧（pts≈8~10s），getCurrentFrame(0) 找不到帧 → 黑屏 3~4 秒。 修复： - FrameQueue maxSize: 60 → 600（覆盖约 20 秒 @30fps） - decodeAroundPosition 中 decodeSegment 传入 maxFrames=300， 限制单次按需解码帧数，避免远超队列容量的帧挤兑	2026-08-21 00:46:41 +08:00
xiaoxia	b7be479ae7	fix: staging test_asset.spec.ts 适配 POST /assets 返回 410 (#1453) ... Co-authored-by: xiaoxia <dev@xiaoxiajianji.com> Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>	2026-08-21 00:06:01 +08:00
xiaoxia	95c33f6604	fix: Canvas 内部分辨率不匹配导致画面变形 — 修复 ResizeObserver 未创建问题 ... 根因：ResizeObserver useEffect 依赖数组为空 []，组件挂载时 canPlay=false 导致 canvas 未渲染、canvasRef 为 null，effect 直接 return 后永远不会重新执行， canvas 内部分辨率停留在浏览器默认值 300×150（横屏 2:1），而 CSS 显示为竖屏容器。 修复： - useEffect 依赖改为 [useWebCodecs, canPlay]，canPlay=true 时 canvas 已渲染， effect 重新执行并正确创建 ResizeObserver - 创建 ResizeObserver 前立即通过 getBoundingClientRect 设置 canvas 初始像素分辨率， 避免首帧使用默认 300×150 导致变形 - computeDrawRect 已正确基于 videoDimRef 做 letterbox 居中绘制，无需修改	2026-08-20 23:49:57 +08:00
xiaoxia	8b30193f3e	fix: Canvas 预览黑屏修复 - 增大帧缓冲 + 限制初始化预解码 + play 同步清空帧队列 ... - FrameQueue maxSize 从 10 改为 60（约 2 秒 @30fps），给按需解码留出足够预缓冲空间 - 新增 MAX_INIT_FRAMES=60 常量，decodeSegment 支持 maxFrames 参数，初始化阶段只解码前 60 帧避免帧挤兑 - play() 重播时同步清空 frameQueue（之前只清 decodedSegments 标记没清帧缓冲） - play() 启动渲染循环后立即触发 decodeAroundPosition，不等 200ms 节流延迟	2026-08-20 19:21:32 +08:00
xiaoxia	665228a58f	refactor: 删除 uploadAsset，统一使用 uploadAssetDirect 直传 ... 前端： - 删除 uploadAsset 函数（upload.ts）和 export（index.ts） - 删除 UploadResult type export - CloneModal/useCloneSubmit 改用 uploadAssetDirect - DirectUploadCompleteResult 新增 url 字段 - 清理测试文件中 uploadAsset 引用 后端： - DirectUploadCompleteResponse 新增 url 字段 - complete_direct_upload 返回 OSS 文件 URL - 修复 FFmpeg 超时日志 300s → 900s	2026-08-20 16:22:56 +08:00
CI Bot	ab4a1b7262	style: auto-format with black + isort + prettier [skip ci-format-check]	2026-08-20 08:07:14 +00:00
xiaoxia	a39e5ea936	refactor: 清理前端 createAsset 死代码和未使用 import ... - 删除 test/api/assets.test.ts 中 createAsset 的 import 和测试块 - 删除 GeneratePage.test.tsx 和 VoiceMaterialLibrary.test.tsx 中 createAsset mock - 清理 voices/types.ts 和 voice-materials/types.ts 中 createAsset 注释 - 删除 useVoiceUpload.ts 中未使用的 IngestJob type import	2026-08-20 16:02:05 +08:00
CI Bot	2d0d8a2777	chore: 清理上传路径统一后的残留死代码 ... 后端: - create_asset 函数简化为仅返回 410，删除 46 行死代码 - 移除无用的依赖注入参数（asset_repository 等） 前端: - 删除 createAsset 函数定义（assets.ts） - 删除 createAsset 的 re-export（index.ts） 注: uploadAsset 函数保留（语音克隆 CloneModal 仍在使用）	2026-08-20 15:59:44 +08:00
CI Bot	d3469d9799	refactor: 统一所有素材上传为单一 ingest 路径 ... 前端修改: 1. useVoiceUpload.ts (voices): 删除 createAsset 调用，改为轮询 ingest_job_id 2. useVoiceUpload.ts (voice-materials): 同上，使用 result_asset_id 打标签 后端修改: 1. POST /assets 返回 410 Gone（已废弃，统一走 ingest-jobs） 2. 上传流程: uploadAssetDirect → completeDirectUpload → _submit_ingest_job → Worker 统一后的上传路径: - 前端上传 OSS（直传） - 调用 completeDirectUpload 创建 ingest job - Worker 根据类型处理（视频转码/图片音频元数据提取） - 创建 Asset 记录 → ready - 前端轮询 job 状态，完成后刷新	2026-08-20 15:54:01 +08:00
xiaoxia	231d5153bf	fix: CSS 残留 6 处 aspect-ratio 16/9 改为 9/16 ... 统一竖屏 9:16 比例，清理 generate.css 中所有残留的横屏比例： - .xx-preview-video (894) - .xx-smart-match-thumb (1519) - .xx-cover-frame-placeholder (2147) - .xx-cover-upload-area (2250) - .xx-cover-preview-box (2311) - .xx-preview-video-wrapper .xx-preview-video (2669)	2026-08-20 15:30:29 +08:00
xiaoxia	f4af6ec8b7	fix: 删除用 mp4box.js 维度数据设置 videoDimRef 的代码 ... - 删除 decoder configure 成功后的 videoDimRef 设置 - 删除 init 函数中的 videoDimRef 设置 - 唯一可靠的尺寸来源改为 VideoDecoder output 回调从 VideoFrame 获取的真实帧尺寸	2026-08-20 14:37:07 +08:00
xiaoxia	6a3f4e4127	fix: 统一竖屏 9:16 比例 ... - generate.css: 7 处 aspect-ratio 从 16/9 改为 9/16 - generate.css: .xx-preview-video max-height 400px→600px - generate.css: .xx-preview-video-wrapper max-width→max-height - PreviewVideoPanel.tsx: fallback 从 16:9→9:16 - UploadCoverPicker.tsx: 提示文字从 建议16:9→建议9:16	2026-08-20 14:29:05 +08:00
xiaoxia	cb903e3bd6	fix: 移除 rotation 元数据检测，从 VideoFrame 获取实际尺寸 ... - 删除 extractVideoRotation 函数 - 删除 demuxSegment 和 decodeSegment 中的旋转检测+宽高交换代码 - 删除 decoder.configure() 中的 codedWidth/codedHeight 参数 - 在 VideoDecoder output 回调中从第一帧获取实际帧尺寸 - 核心思路：不再依赖 mp4box.js 的 track_width/track_height 和 rotation 元数据， 改为从 VideoDecoder 实际输出的 VideoFrame 获取真实尺寸	2026-08-20 14:11:13 +08:00
xiaoxia	b447ad84ea	fix: vitest 全局超时从 5s 提到 15s，防止 CI 高负载偶发超时 (#1451) ... Co-authored-by: xiaoxia <dev@xiaoxiajianji.com> Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>	2026-08-20 14:06:00 +08:00
xiaoxia	2356f12f11	fix: 修复 VideoDecoder flush timeout 解码器超时卡死 ... - decoder.decode(chunk) 改为 await，捕获异步 rejection - 添加 decodeErrors 计数，连续 3 次解码失败跳过当前片段 - flush 之前检查 decoder.state，只在 configured 状态才执行 - 避免在 error/closed 状态调用 flush 导致卡死	2026-08-20 13:31:57 +08:00
xiaoxia	3c42541ff7	fix: 解析 MP4 rotation 元数据，修复竖屏视频显示为横屏 ... - 新增 extractVideoRotation 函数，从 tkhd box 解析旋转角度 - demuxSegment 中检测 90°/270° 旋转，交换宽高 - decodeSegment 中同样检测旋转，确保 configure 使用正确尺寸 - 修复 iPhone 竖屏视频在竖屏容器中显示为一小块横屏画面的问题	2026-08-20 13:08:24 +08:00
xiaoxia	634d05c010	fix: 修复 AI Code Review 阻塞级问题 v3（useCanvasPlayer 解码策略+资源泄漏+useStep6Cover 轮询超时） (#1450) ... Co-authored-by: xiaoxia <dev@xiaoxiajianji.com> Co-committed-by: xiaoxia <dev@xiaoxiajianji.com>	2026-08-20 12:01:01 +08:00
张宏杰	355431b867	feat: decodeSegment 增加解码进度日志和 flush 超时保护 ... - 记录实际 decode 的 sample 数量、跳过数量、decoder 状态 - flush 增加 10 秒超时保护，防止无限卡住 - configure 成功后立即清除 isBuffering 状态，让 UI 不再显示'准备中'	2026-08-19 23:58:23 +08:00
张宏杰	041cec8670	fix: findCodecConfig 重写，正确处理 stsd 和容器 box 递归 ... - 新增 MP4_CONTAINER_TYPES 常量，包含 trak/mdia/minf/stbl 等标准容器 - stsd 特殊处理：额外 8 字节头（version/flags + entry_count），从 offset+16 开始 - VisualSampleEntry 保持 offset+8+78（78 字节固定字段） - 删除 fallback 双重搜索逻辑，改为明确的容器类型判断	2026-08-19 23:24:00 +08:00
张宏杰	472f371d2f	fix: VisualSampleEntry 添加 fallback 搜索，兼容不同 MP4 结构 ... - 先尝试 offset+8+78（标准 VisualSampleEntry 结构） - 未找到则 fallback 到 offset+8（兼容非标准 MP4） - 添加调试日志追踪搜索过程	2026-08-19 22:51:25 +08:00
张宏杰	709d65ce52	fix: VisualSampleEntry 跳过78字节固定字段，修复 hvcC 提取位置 ... - findCodecConfigRecursive 区分 VisualSampleEntry 和普通容器 box - avc1/avc3/hvc1/hev1 前 78 字节是固定字段（ISO 14496-12），子 box 从 offset+8+78 开始 - 普通容器 box（moov/trak/mdia/minf/stbl）仍从 offset+8 开始递归 - 修复 HEVC description 提取失败导致的黑屏问题	2026-08-19 22:38:01 +08:00