Files
yingqing/core/qa/visual-parity
seaislee1209andClaude Opus 4.8 c6e9c7e77b feat(video): 期3 视频趴 — 人物→角色 + 引用模特库/自动入库 + 分镜合规归类 + 资产库素材
后端:
- B 路:视频流程新生成角色立绘+三视图成套 → 自动入模特库(run_triview_task,幂等 additive)
- 合规闭合:三视图 person→tri_view、分镜图 scene→storyboard,两者均加 on_commit 送审(此前只有角色立绘送审,三视图/分镜图漏审 = 合规缺口)
- 资产库 _tab_q:成片 finals→素材 materials(所有视频排除最终成片;最终成片隐藏不列)
- 单测 TriviewAutoEnrollTests:自动入库 + 幂等 + 三视图落审核范围

前端:
- 视频项目资产趴「人物」→「角色」(KIND_LABEL,区块名/新增/空态/详情弹窗一处全改;向导人设 persona 不动)
- A 路:演员库收编模特库 —— 顶部「模特库」tab 取自模特库实体(含官方跨团队模特),选一个即用其形象图作角色参考
- 资产库 library:人物→角色、成片 tab→素材、分类标签补全(模特上身图/平台套图/自由创作/视频素材/最终成片)
- vite.config:端口与后端代理目标可用 VITE_PORT/VITE_API_TARGET 覆盖(默认不变),避免多实例撞车

验收:后端单测全绿(基线既有 7 失败零新增);tsc+build 全绿;无头 0 console error
(资产库角色/素材改名、最终成片隐藏;pipeline 资产趴显角色;演员库模特库 tab 含 5 模特)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-21 19:27:23 +08:00
..

Visual Parity QA

这个目录用于逐页校对 电商AI平台 设计稿代码和 core/frontend 实现页的像素差。

原则

  1. 每开发完一个页面,先截设计稿,再截实现页。
  2. 两张图使用同一浏览器、同一视口、同一 deviceScaleFactor。
  3. 输出 design.png、implementation.png、diff.png 和 report.json。
  4. diffPixels 必须逐轮下降; 页面验收目标是 0,如字体渲染造成非业务差异,必须在报告里单独记录。
  5. 视频生成真实测试不进入这个阶段,只校对页面和普通交互。

实现层

core/frontend/public/exact/ 是从 电商AI平台/ 同步到 core 内的精确镜像实现层,用于保证每个设计稿页面都能在当前前端服务中以真实 URL 打开并进行像素验收。

已 React 化并直接接入主 SPA 的页面:

  • 登录: /
  • 注册: /#register
  • 工作台: ?visual=dashboard / /#dashboard

其余页面先通过 /exact/*.html 达成 1:1 视觉还原,后续再按功能模块逐步替换为真实接口驱动的 React/Django 页面。替换时必须继续跑同名 visual parity 项,直到 diffPixels=0。

页面比对命令

先启动前端:

cd /Users/maidong/Desktop/zyc/qiyuan_gitea/AirShelf/core/frontend
npm run dev

再执行像素比对:

cd /Users/maidong/Desktop/zyc/qiyuan_gitea/AirShelf/core/qa/visual-parity
npm install
npm run compare:login
npm run compare:register
npm run compare:dashboard
npm run compare:all

输出目录:

core/qa/visual-parity/output/

页面复刻队列

优先级 页面 设计稿 关键子页面/交互 实现入口 状态
P0 登录 电商AI平台/login.html 密码可见、忘记密码 toast、SSO toast、注册入口 / 未登录态 1440x900 diffPixels=0
P0 注册 电商AI平台/register.html 团队注册、返回登录 /#register 未登录态 1440x900 diffPixels=0
P0 工作台 电商AI平台/index.html 侧栏、顶部余额/消息、快捷入口、最近项目 ?visual=dashboard / /#dashboard 1440x900 diffPixels=0
P0 商品库 电商AI平台/products.html 列表/卡片、新建商品 drawer、删除/筛选 /exact/products.html 1440x900 diffPixels=0
P0 商品详情 电商AI平台/product-detail.html 编辑、素材区、创建视频项目入口 /exact/product-detail.html 1440x900 diffPixels=0
P0 上传创建商品 电商AI平台/product-create-upload.html 跳转商品库并自动打开新建商品 drawer /exact/product-create-upload.html 1440x900 diffPixels=0
P0 视频项目 电商AI平台/projects.html 表格/卡片视图、删除确认 modal、进入 pipeline /exact/projects.html 1440x900 diffPixels=0
P0 新建视频项目 电商AI平台/projects-new.html 商品选择、模板选择、素材库 modal、创建确认 /exact/projects-new.html 1440x900 diffPixels=0
P0 生产管线 电商AI平台/pipeline.html Stage 1-5、资产详情、演员/场景库、额度预检、视频详情、导出 /exact/pipeline.html#stage-1..5 5/5 stages diffPixels=0,不测真实生视频
P1 资产库 电商AI平台/library.html 上传、筛选、预览/删除 /exact/library.html 1440x900 diffPixels=0
P1 账户/额度 电商AI平台/account.html 充值、交易流水、充值 modal /exact/account.html 1440x900 diffPixels=0
P1 团队 电商AI平台/team.html 成员、角色、月限额 modal /exact/team.html 1440x900 diffPixels=0
P1 消息中心 电商AI平台/messages.html 消息详情、日志展开、通知设置跳转 /exact/messages.html 1440x900 diffPixels=0
P1 图片工具入口 电商AI平台/asset-factory.html 三类工具入口、任务列表 /exact/asset-factory.html 1440x900 diffPixels=0
P1 图片创作 电商AI平台/image-optimize.html 参数面板、重复任务 modal、返回 /exact/image-optimize.html 1440x900 diffPixels=0
P1 模特上身图 电商AI平台/model-photo.html 模特选择、方案入口、生成参数 /exact/model-photo.html 1440x900 diffPixels=0
P1 模特方案 A 电商AI平台/model-photo-demo-a.html 方案预览/采用 /exact/model-photo-demo-a.html 1440x900 diffPixels=0
P1 模特方案 B 电商AI平台/model-photo-demo-b.html 方案预览/采用 /exact/model-photo-demo-b.html 1440x900 diffPixels=0
P1 平台套图 电商AI平台/platform-cover.html 平台规格、批量生成 /exact/platform-cover.html 1440x900 diffPixels=0
P1 设置 电商AI平台/settings.html 资料、安全、通知策略 #sec-notify /exact/settings.html#sec-profile/security/notify/pref/display 5/5 sections diffPixels=0

电商AI平台/design-system.html 作为 token/component 参考,不作为业务页面验收目标。电商AI平台/_archive 下旧稿默认不纳入复刻,除非后续明确要求恢复旧版本。