ai-chatbot/docs/video-canvas-task-repairs-2026-09-17.md

视频画布任务与交互修复 · 2026-09-17

承接 23f86dfc 的全面扫描。用户补充“浏览器刷新一下就好了”，本轮重点修复任务结果与页面状态脱节，同时处理 F02–F07 中已确认的入口问题。本记录是分支修复与本地验收，未部署 48 服务器，也没有把原 231 项清单改成全部通过。

前半部分保留 0d17638a 阶段记录；本轮新增修复和验证见文末“后续修复”。

修复范围

扫描项	本轮改动	验证及边界
F01 任务恢复	新增统一生成任务接口、数据库受理记录、请求 ID 去重、原子领取、心跳与结果保存；客户端提交前保存待核对请求，刷新/重开/online/focus/visibilitychange 时查询；去掉虚假进度；旧版无任务 ID 的 pending 明确提示无法恢复	主图像/视频生成、配置工具的图像/视频/分析、脚本再生成、批量分镜/视频接入。局部编辑按已有 taskId 恢复查询。真实数据库与浏览器验收见下文。专用图像后期、角度编辑、脚本弹窗资产生成/逐镜提示词仍有同步请求，未宣称全部入口具备同等恢复能力
F02 取消	排队任务通过数据库 CAS 取消；已提交供应商的任务返回明确说明，继续保存结果；删除已完成结果写入任务隐藏记录	数据库并发及浏览器排队取消通过；没有冒充支持上游中止
F03 模板	待执行模板设为 idle；参考样例标记示例；空脚本不再显示硬编码成稿	代码检查；未逐个模板做生产生成
F04 脚本	脚本入口统一 story-script；空响应/无有效镜头返回失败并保留旧稿	结果契约回归通过；脚本资产生成与单镜提示词处理不是此次持久队列接入范围
F05 批量	批量分镜和视频实际入队；按有无首帧选择兼容模式，采用模型声明的离散时长/比例/分辨率；完成任务不重复提交，失败/空节点可继续执行	模型参数和任务契约通过；没有新增真实付费批量请求
F06 素材弹窗	去掉假分页和无效图标，增加搜索、纵向滚动、自适应列、素材名称与明确数量单位	实际组件注入 100 个素材，第 100 项能选中、确认回传，搜索返回 1 项；使用当前 Tailwind 编译产物验收
F07 次级控件	文本及音频生视频提示词翻译接真实接口并预览后应用；旧脚本编辑聚焦；资源替换接上传；通知显示真实任务；模板筛选使用配置数据；退出接现有登出流程；未实现按钮明确禁用	代码与类型检查。未实际退出生产账户，未声称所有停用高级能力已实现

任务表复用既有 0091_add_canvas_capability_tasks.sql，没有新增数据库迁移。上线前须核对该既有迁移已应用。

任务一致性

• 同一请求 ID 重试不会重复执行；同一节点已有活动任务时复用现有任务。
• 同画布任务串行领取，多执行者通过 PostgreSQL 事务锁与状态更新竞争。
• 刷新前画布尚未保存的已受理节点，可从任务快照补回；不会从旧任务复活已保存删除的节点。
• 多图结果使用任务 ID 与序号组成稳定结果节点 ID，轮询不重复追加，重新生成不误用上次附图。
• 旧请求不能覆盖新请求；画布保存落后于新任务时，根据任务时间和保存版本恢复最新结果。
• 连线仅首次恢复时补齐，后续轮询不反复恢复用户已经删除的连线。
• 执行进程心跳超过 120 秒未更新，任务标记待核实；不自动重新提交付费请求。若原执行稍后确实返回，仍允许保存真实结果。
• 浏览器离开与服务端执行进程重启是不同情况：本轮解决前者的主要入口；进程中断后尚未实现供应商任务 ID 的自动续查。

验证记录

1. 真实本地 PostgreSQL：scripts/qa/video-canvas-task-db.cjs 建立隔离测试库，加载实际任务表迁移和实际 store。10 次并发相同提交只创建 1 条记录；10 次并发领取仅 1 次成功；跨用户隔离、排队取消、执行中不可取消、串行队列、结果保存、结果隐藏、过期不重投、晚到结果保存全部通过。这是并发数据库调用测试，不是 10 个操作系统进程实测。
2. 真实浏览器任务恢复：验收页使用实际 React Hook、实际任务 route/worker/store 与本地 PostgreSQL；鉴权使用固定测试用户，NextResponse/after 使用本地适配器，模型返回使用 12 秒测试桩。提交图片后立即刷新，最终出现 2 个结果且只 1 条任务；视频执行时关闭页面，再打开能恢复结果；后续分析排队任务成功取消；移除附图后刷新不复活。画布快照保存使用本地验收服务器，不是生产画布接口。
3. 实际素材组件：100 项列表可定位选择最后一项，确认回传 测试素材 100；搜索同名只剩 1 项且保留选中状态；已有第 100 项再连续点选第 1–10 项，最终只选中 10 项，第 10 项（第 11 次选择）被正确拦截。验收期间先发现旧测试样式缓存，重新编译当前源码样式后验证通过。
4. 自动化：最终 helpers/route 回归 437 项通过，无跳过，包含本次新增 13 项任务/批量参数测试和既有真实 FFmpeg 检查。不是 437 个生产端到端测试。
5. 静态检查：TypeScript 无错误；git diff --check 通过。新增服务端模块与旧接口共享执行逻辑，图像计费仍走原有计费模块。

没有进行新的付费模型测试，没有重新宣称参考站像素级一致，没有覆盖操作系统休眠、真实断网、多标签冲突、生产 Next.js 进程重启或生产部署后的回归。原扫描中 79 项缺失/停用能力依然需要单独实现与验证，详见原验证矩阵。

复现

# FFmpeg / ffprobe 必须在 PATH 中，避免媒体测试跳过
pnpm exec playwright test --config=playwright.helpers.config.ts
pnpm exec tsc --noEmit --incremental false
# 隔离数据库测试依赖仅装入忽略的 .qa 目录，不改项目依赖
npm install --prefix .qa/video-task-db --no-save embedded-postgres
node scripts/qa/video-canvas-task-db.cjs

浏览器验收脚手架位于忽略目录 .qa/video-durable 和 .qa/video-repair；上述记录保留测试方法和模拟边界，不能代替后续部署验收。

后续修复：图片后期与脚本子任务（承接 0d17638a）

本轮把角度编辑（自定义参数及预设）、高清、扩图、抠图、宫格批量放大，以及脚本弹窗的资产生成、单镜/全部提示词合成接入已有持久队列。结果节点在提交时创建，完成后由任务查询更新；脚本任务另外按资产 ID、镜头 ID 回填对应字段。生成期间的修改或删除会保留，新结果继续留在独立节点，并显示冲突说明。脚本弹窗重新打开后显示服务器任务的处理中/失败状态。

高清接口的 AOS 分支可能先返回 HTTP 202 和 taskId。之前视频画布同步调用只寻找 original_url，导致将“已受理”误当失败。本轮先保存上游 taskId，再调用原有 GET 查询；查询中断或达到等待上限时标为“待核实”，保留上游标识，不重新 POST。当前仍不自动恢复服务端进程重启后的上游查询，需后续补全；浏览器刷新不影响在运行的服务端查询。

四个原 API 的执行实现抽取到 lib/canvas/operations/，原 URL 的入口继续通过 auth 验证身份；队列使用已校验的任务所有者调用共享执行函数。逐文件比较确认模型、存储、计费执行逻辑与抽取前保持一致。另修正上轮清理共享生图模块时遗漏的 getCanvasImageTaskForUser 导入，本轮完整类型检查通过。

本轮验证：

• helpers/route 回归 447 项通过，无跳过，其中任务专项 23 项；新增后期参数校验、202 续查只提交一次、断网/502/等待上限待核实、角度响应、空结果拒绝、脚本稳定 ID 回填与修改冲突保护。
• 真实隔离 PostgreSQL：原并发/权限/取消检查通过；新增上游任务标识写入、待核实时保留标识、不自动重投检查通过。
• 本地浏览器：实际 Hook/API/worker/store + PostgreSQL；鉴权、模型和后期服务使用测试桩。高清提交后刷新恢复；脚本资产提交后刷新自动回填；提示词提交后刷新自动回填 imagePrompt/motionPrompt，原对白保留；生成中修改资产的冲突保护单独检查。画布保存仍使用本地验收接口，不是生产画布 API。
• TypeScript 与 diff 空白检查通过；没有新增付费模型调用，没有部署 48 服务器。

仍需继续的项目：视频解析故事入口尚有同步请求，后台进程中断后的上游续查、多标签同时编辑、生产部署回归，以及原矩阵中的高级功能缺口。本轮不据此宣称 231 项全部完成。