问题：画布和首页推荐词是固定数组，旁边刷新按钮没有绑定事件；推荐词如果过长或换行，会把底部输入区撑高。

改动：web/canvas-app/src/views/Canvas.vue 和 Home.vue 改为 4 个一组的短推荐词池，点击刷新按钮时切换到下一组；推荐栏固定单行高度，chip 设置最大宽度和截断，按钮加 title / aria-label。

影响：用户可连续点刷新切换推荐词，推荐区不会因为文案长度换行或顶起 composer。

问题：为了降低 Seedance 人脸/肖像风控，不能把“虚构 AI 角色、非真人”无条件加到所有润色结果里；无人画面如果出现 character、avatar 等词，反而可能诱导模型新增人物。

改动：api/main.py 新增人物意图检测：原始输入含人像、模特、角色、数字人、脸、portrait、model、character 等语义时，润色才补“fully fictional synthetic AI character / virtual avatar / not based on any real person”；原始输入没有人物语义或明确写无人时，润色改为补“保持 object-only / scene-only / product-only composition，不新增 people、faces、bodies、hands、avatars、characters、crowds”。

影响：无人物产品图、场景图、食物图、街景图不会因为合规词被润成有人画面；有人物需求仍会尽量声明为虚构 AI 角色，减少被上游误判为真实肖像的概率。参考图里已有清晰人脸时，最终仍由上游图片安全检测决定，失败后继续显示可读的人脸风控提示。

问题：画布 AI 润色 之前复用 /creative/copy，该接口本来是 SKG 营销短视频文案生成器，会默认加入 SKG、健康科技、按摩产品、TikTok/Reels 广告语境，导致普通图片或视频提示词也被带偏。

改动：api/main.py 新增中性 POST /prompt/polish；web/canvas-app/src/hooks/useApi.js 改为调用该接口并传入 system_prompt、mode 和 target_language。根画布和文本节点显式用 mode=image 输出英文生成提示词；LLM 节点和自动执行意图分析用 mode=chat 保持输入语言。

影响：AI 润色只优化用户原本写的主体、风格、镜头、光线、构图和细节，不再主动添加用户没提到的品牌、产品或营销话术；/creative/copy 继续保留给明确的 SKG 营销文案生成场景。

问题：Seedance / Doubao 视频上游返回 InputImageSensitiveContentDetected.PrivacyInformation、HTTP 400、429、timeout 等机器错误时，画布错误框原样展示会让员工误以为账号、模型或网关坏了，需要人工解释。

改动：api/main.py 新增视频错误归一化逻辑，提交失败、轮询失败和后台任务异常都会先转换成可读中文，再写入 GeneratedVideo.error。例如含疑似真实人脸的参考图会提示“参考图里有清晰人物或疑似真实人脸，视频模型出于肖像/隐私风控拒绝生成”，并给出换无脸首帧、裁掉或模糊人物脸的下一步。

影响：前端现有视频失败卡、画布轮询错误框和详情里的 video.error 会自动显示中文解释；原始上游错误只写入 API 日志，方便管理员排查，不再要求用户把英文错误码发给开发者翻译。

问题：飞书接入后继续保留共享密码入口，后续成员容易误用旧密码账号，导致新内容继续落到 password:skg，和飞书个人身份沉淀混在一起。

改动：api/main.py 新增 PASSWORD_AUTH_ENABLED 总开关；生产设为 false 后，/auth/config 返回 password_enabled=false，登录页不再展示账号密码表单，/auth/login 不再可用，旧密码 Cookie 会在校验时失效。WEB_AUTH_SESSION_SECRET 仍保留用于飞书会话签名，旧备用账号配置只作为应急恢复材料，不作为当前入口。

验证：生产 /api/auth/config 返回 password_enabled=false、feishu_enabled=true；GET /api/auth/feishu/start?next=/ 返回 302 到飞书授权页；POST /api/auth/login 返回 503 账号密码登录未配置。

影响：新成员只能通过飞书登录，后续新建任务和画布都会绑定真实飞书 owner。旧 password:skg 数据不会自动归属到任何飞书用户，后续应通过公司可见/认领/管理员迁移处理。

问题：密码登录停用后，旧共享账号 password:skg 下的视频和画布不会自动出现在飞书账号里，用户会误以为之前生成的视频丢失。

改动：在生产服务器先备份 Postgres 和 data/jobs，再把 password:skg 的 22 个 job、3 个画布项目和对应生成资产索引迁到飞书用户 万康（feishu:ou_78276b4fd9dd818d8f70bc00d03ddbdf）。job 的 state.json 也同步改写 owner 字段，并重启 API 让内存态重新加载。

影响：万康飞书登录后应能看到旧密码账号下的历史视频和画布；无 owner 的 4 个更早旧 job 保持不动，避免把来源不明确的内容误归属。

问题：画布项目只存在浏览器 localStorage 时，换电脑、清缓存或多人长期使用都难以形成公司内部资产沉淀；任务和资源虽然已有文件持久化，但缺少结构化索引和审计。

改动：新增 api/db.py 和 Postgres schema：app_users、canvas_projects、job_index、generated_assets、prompt_library_index、asset_library_index、agent_run_index、audit_events。api/main.py 启动时建表并索引已有 job / AgentRun / 提示词 / 素材；新增 /canvas-projects CRUD 和 import 接口；登录、创建任务、资源库操作、画布保存都会写用户索引或审计。web/canvas-app/src/stores/projects.js 改为服务端项目优先，localStorage 只做缓存和旧项目导入。

部署：docker-compose.prod.yml 和 docker-compose.standalone.yml 增加 postgres:16-alpine；生产环境在 deploy/.env.production 写入 DATABASE_URL 和 Postgres 密码，数据目录为服务器 ./data/postgres。deploy-prod-safe.sh 会在容器存在时导出 pg_dump，verify-prod-docker.sh 要求 database.connected=true。

影响：画布项目开始具备跨浏览器、跨设备恢复的服务端主存储；默认仍按 owner 私有隔离，后续可在同一表上扩展 team/company 可见性。完整 job state 和媒体文件仍保留在原有文件目录，避免把大文件一次性搬进数据库。

问题：恢复上游画布后，前端仍可能显示 Nano Banana、Seedream、Kling、Veo 等上游或旧缓存模型，但这些并不是当前 SKG 后端已经验证可用的生成通道，用户一旦选择就会失败或误解模型能力。

改动：web/canvas-app/src/config/models.js 将图片模型收口为 auto、gpt-image-2、gemini-3-pro-image-preview，视频模型收口为 seedance / Seedance 2.0 Fast；图片尺寸、视频画幅和视频时长对齐后端真实能力。useModelConfig.js 和 Pinia 模型 store 会忽略浏览器本地自定义图片/视频模型，并把旧 localStorage 选中值回退到默认可用模型。

后端：api/main.py 的 video_model_options() 按真实模型去重：当前 kling、veo 等别名如果都指向 doubao-seedance-2-0-fast-260128，/health 只返回一个 Seedance 选项，不再假装有多个不同视频模型。

影响：员工在画布里只能选到当前可直接生成的图片/视频模型；后续新增 Kling、Veo 或其他图片模型时，必须先在后端完成真实模型配置和探针验证，再更新前端白名单。

部署：84d9de6 已部署到生产；外部根域名和 /p/test 登录保护复验通过，容器内 /health 确认图片模型为 auto,gpt-image-2,gemini-3-pro-image-preview，视频模型只返回 Seedance 2.0 Fast，生产静态 bundle 未命中旧上游模型名。

问题：三模式精简版把成熟画布削弱过多，用户明确要求 api 没关系，其他上游画布能力直接恢复，不再把早先的 SKG 简化想法强行融入当前成熟版面。

改动：从 chatfire-AI/huobao-canvas 恢复 ApiSettings.vue、模型/渠道/工作流配置、useWorkflowOrchestrator、首页、画布和图片/视频/文本/LLM 节点。保留 SKG logo-only 品牌、根路径 /、内部路由 /p/:id? 和 useApi.js 的 SKG 后端适配；API 设置弹窗去掉上游注册链接和外部品牌文案。

影响：画布重新具备推荐词、AI 润色、自动执行、工作流模板、首帧/尾帧/参考图节点、多角度分镜、故事板、绘本和批量下载等成熟能力；生成请求仍使用当前登录会话调用本项目 /api，员工不需要个人 API Key。

部署：cce9779 已部署到生产；外部根域名、旧 /canvas/ 跳转和 /p/test 登录保护均复验通过，容器静态 bundle 已命中恢复能力并未命中上游注册链接或火宝欢迎文案。

问题：用户已经确定用成熟画布版快速上架，不希望员工先进入单对话框首页再点 /canvas/，也不希望我们继续大幅重写成熟画布结构。

改动：web/canvas-app 的 Vite base 和 Vue Router base 改为根路径；web/package.json 生产构建改为先构建画布、再 Next 静态导出、最后用 web/scripts/sync-canvas-root.mjs 把画布产物覆盖到 web/out 根目录。deploy/nginx.conf 将 /canvas/ 改成 308 兼容跳转到根域名。

影响：https://marketing.skg.com 登录后直接进入个人生成画布；旧 /canvas/ 链接不会失效，但不再是主入口。后续优先围绕模式文案、API 接入、队列和结果显示做小改，不反复拆成熟画布。

问题：首帧生视频 和 首尾帧生视频 是模型提交细节，不应该作为用户主入口；和成熟生成产品里的“文生图、文生视频、图生视频”概念相比显得混乱。

改动：web/app/page.tsx 和 web/canvas-app/src/views/Canvas.vue 的模式按钮统一收敛为文生图、文生视频、图生视频。图生视频只显示“上传图片”，内部仍用 first_image 提交视频；画布视频节点状态也从首帧/尾帧细节收敛为图片状态。

影响：终端用户不再需要理解首帧、尾帧等实现概念；生成能力保留文生图、文生视频和单图参考的视频生成。

问题：画布底部输入框下方常驻“推荐”提示词 chips，占据底部视线和操作空间，用户已经在写提示词时会被这些内容阻挡。

改动：web/canvas-app/src/views/Canvas.vue 删除底部推荐提示词区域；web/canvas-app/src/views/Home.vue 同步删除入口页输入框下方推荐 chips，只保留输入框、必要模式/上传控件和发送按钮。

影响：生成能力不变，仍由用户手写提示词；画布底部更干净，避免推荐项遮挡主要操作。

问题：生图生视频、SKG 生成画布 和过长中文系统名放在主界面上都显得别扭，削弱“打开就会用”的简单感。

改动：终端可见品牌位改为 logo-only：主页顶部、登录框左上角、画布首页都只展示 SKG logo；网页 title 和画布 title 缩为 SKG；首页进入画布的按钮文案缩短为“画布”。

影响：产品语义仍是公司内部营销内容生产平台，功能路径不变；只是把品牌表达从文字命名改成 SKG 字标，减少页面认知负担。

问题：SKG 生图生视频 过窄，只覆盖图片和视频生成，不利于承接详情页图文方案、提示词沉淀和后续内容资产整理。

改动：当时将可见系统名统一改为 SKG 营销内容生产平台；画布入口和画布首页改为 内容生产画布。同步更新网页标题、登录页品牌、首页入口按钮、画布首页标题、项目元数据、规则和源码解析当前章节。

影响：功能路径不变，仍是首页单对话框生成、/canvas/ 进入个人画布、/detail/?job= 查看任务详情。随后已被上方 logo-only 方案覆盖。

问题：“营销内容工作台”像后台管理系统，“SKG 无限画布”也看不出具体用途，内部同事第一次打开无法立即判断这里是生图、生视频和整理生成结果的地方。

改动：当前可见系统名统一改为 SKG 生图生视频；画布入口和画布首页统一改为 生成画布。同步更新网页标题、登录页品牌、首页入口按钮、画布首页标题、项目元数据、规则和源码解析当前章节。

影响：功能路径不变，仍是首页单对话框生成、/canvas/ 进入个人生成画布、/detail/?job= 查看任务详情。

问题：默认首页适合“一次生成一个结果”，但内部多人使用时，用户还需要把多次生成的图片、视频、提示词和参考图放在一个自由空间里整理，避免结果都挤在同一条对话或详情页里。

改动：新增 web/canvas-app/，将 huobao-canvas 的 Vue Flow 画布交互改造为 SKG 内部版：可见品牌、GitHub 入口、API Key 设置和外部服务商配置都已移除，保留项目列表、生成画布、节点连接、四模式 prompt composer 和生成结果节点。构建链路新增 pnpm build:canvas 和 web/scripts/sync-canvas-dist.mjs，生产 Nginx 新增受登录保护的 /canvas/ fallback 路由；首页顶部增加“生成画布”入口。

影响：当时画布项目先保存在浏览器 localStorage，不是团队共享，也不做跨设备同步；2026-05-26 已升级为服务端 Postgres 持久化。生成图片和视频仍调用本项目 /api，按当前登录用户写入个人 job。第三方来源说明只保存在 THIRD_PARTY_NOTICES.md，不进入终端用户 UI。

问题：多人使用时，如果视频提交后直接开后台线程，单个用户连续提交多个视频可能占满生成通道，其他人也看不清自己的任务是在排队还是已经生成。

改动：api/main.py 新增进程内视频队列：全局默认同时 2 个视频生成、单用户同时 1 个视频生成；GeneratedVideo 增加 queue_position、queue_size、queue_message，排队、启动、完成、失败和删除都会回写状态。web/app/page.tsx 把首页视频结果卡的英文状态改成“排队中 / 前方 N 个任务 / 你的上一个视频生成中 / 生成中 N% / 可播放”。

影响：当前只做个人队列反馈，不做团队共享或管理员总览。队列是单 API 容器内存队列，不依赖 Redis；容器重启后未完成视频会标记为失败并提示重新生成。

问题：生产最近视频任务已经完成并写入 mp4，但首页结果卡里的视频缩略图没有原生播放控件，用户点击完成视频时看起来没有任何反馈，只能依赖 hover 自动预览。

改动：MediaAssetTile 新增 videoControls 参数；web/app/page.tsx 在首页最新视频状态为 completed 时启用 controls，并在失败状态显示失败空态和错误详情。

影响：首页生成视频完成后可直接在结果卡里播放；详情页和旧分镜候选仍按原有缩略图 / hover 预览 / 下载按钮语义工作。

改动：生产服务器 /opt/skg-marketing-studio/deploy/.env.production 已补齐飞书 OAuth 应用配置，保留 WEB_AUTH_SESSION_SECRET 和 AUTH_DATA_ISOLATION_ENABLED=true，并仅重建 skg-marketing-api 使环境变量生效；敏感 App Secret 不进入仓库。

验证：/api/auth/config 返回 feishu_enabled=true、password_enabled=true、data_isolation_enabled=true；GET /api/auth/feishu/start?next=/ 返回 302 跳转到飞书授权页；容器内 /health 返回 auth_modes.feishu=True。

影响：飞书登录链路正式可用，飞书用户新建任务时 owner_id 会按飞书身份写入，后端列表、详情和素材接口继续按 owner 校验；备用账号密码登录仍保留。

问题：当前后端已经有飞书 OAuth 的 start / callback / user info / 会话 Cookie 链路，但登录页仍要求用户点一次“飞书免登录”。用户希望在飞书里打开应用时自动免登录。

改动：web/app/login/page.tsx 读取 /api/auth/config 后，如果 feishu_enabled=true 且 UA 命中飞书 / Lark 客户端，会用 sessionStorage 防循环后自动跳转 /api/auth/feishu/start?next=...；普通浏览器继续显示飞书按钮和备用账号。deploy/nginx.conf 的未登录跳转改为 /login/?next=$request_uri，飞书或备用账号登录成功后回到原页面。

影响：该能力仍依赖生产服务器配置 FEISHU_APP_ID、FEISHU_APP_SECRET、FEISHU_REDIRECT_URI 和 WEB_AUTH_SESSION_SECRET，并要求飞书开放平台登记回调 https://marketing.skg.com/api/auth/feishu/callback。未配置时 feishu_enabled=false，页面不会自动跳转。

问题：文生图或文生视频没有上传首帧时，前端仍用空 FormData 调 createCreativeImageJob；部分浏览器 / 代理链路会把它变成缺 boundary 的 multipart/form-data，FastAPI 在进入 /creative/jobs/image 业务函数前直接返回 400 There was an error parsing the body。

改动：web/lib/api.ts 在无文件时改发 JSON 空对象；有文件时才发 multipart。api/main.py 的 /creative/jobs/image 不再通过 File(...) 强制预解析请求体，改为按 Content-Type 手动兼容 JSON / 无 body / 正常 multipart，并对空 multipart 容错为创建空白底图任务。

影响：首页四模式里文生图、文生视频这类无首帧路径都能稳定先创建轻量 job；首帧 / 首尾帧模式仍正常上传图片，坏图片继续返回 400。

问题：首页视频时长写死显示 20 秒和 30 秒，但后端当前 Ark / Doubao 视频提交会把时长截到最高 15 秒，Poe / 自定义视频通道最高只发 12 秒；文生图也没有尺寸选择，前端无法把竖图、方图或横图需求传给图片模型。

改动：api/main.py 的 /health 新增 image_size_options、video_size_options、video_duration_options 和 video_max_duration_seconds；GenerateReq 新增 size，文生图和图生图都会把尺寸传给 /images/generations 或 /images/edits。web/app/page.tsx 改为按后端能力渲染图片尺寸、视频画幅和视频时长，视频不再显示无法单条提交的 30 秒。

影响：当前 Doubao / Seedance 生产配置下，首页视频时长只应显示 5、8、10、12、15 秒；如果业务要 30 秒视频，应新增“分段生成 15 + 15 秒并合成”的工作流，而不是把单次生成时长直接改成 30。

问题：即梦式版本仍有侧栏、模式附属按钮和结果浮层，用户希望再简单一点：只保留对话框，让使用者自己写提示词，再选择对应生成方式。

改动：web/app/page.tsx 改为单中央对话框，默认只露出文生视频、文生图、首帧生视频、首尾帧生视频四个按钮、提示词输入框、必要上传位、时长和生成按钮。首尾帧模式复用 uploadReferenceFrame 上传尾帧，并把 last_image 传给 generateStoryboardVideo。

影响：默认首页不再展示营销图文、灵感、最近任务、侧栏或自动设置；默认使用方式是“选模式 → 上传必要帧 → 写提示词 → 生成”。详情页仍保留任务沉淀和继续生成能力。

问题：平台准备给团队直接使用时，用户需要自己选择模型；前端虽然可以传视频 model，但首页没有模型选择，生图接口也忽略了前端传入的 model。

改动：api/main.py 的 /health 新增 image_options 和 video_options；/frames/{idx}/generate 按 model 字段选择 auto / gpt-image-2 / gemini-3-pro-image-preview。web/app/page.tsx 读取模型选项并在单对话框底部显示模型下拉，生图和生视频提交时都带上用户选择。

验证：本地后端真实探针已确认 gpt-image-2 文生图成功；同一 job 提交 seedance 5 秒视频后拿到上游 provider id，并最终回填 mp4。

问题：上一版多人创作首页仍把入口、参考图、任务和结果全部展开，首次进入时信息密度偏高，不像用户指定的即梦登录后生成页那样“一眼知道往输入框里写”。

改动：web/app/page.tsx 改为窄导航栏 + 会话侧栏 + 中央 prompt composer。文生图、图生图、文生视频、图生视频不再作为大入口卡平铺，而是合并成视频 / 图片 / 图文模式；参考图上传放到输入框左侧倾斜卡片；产品、人群、平台、时长和语气折叠进“自动”；结果改为右下角浮层，完整沉淀继续进入 /detail/?job=<id>。

影响：默认产品使用方式改为“直接写需求或上传参考图 → 选视频/图片/图文 → 发送 → 右下角看当前结果或进详情页”。源码解析页和 RULES.md 已同步新默认心智。

问题：生视频链路已经会把中文要求转成英文再提交外部视频 API，但首页直接生图仍可能把中文混合 prompt 直接传给图片 API；物体六视图也只对俯视/仰视加了正投影约束，前后左右仍有“正面/背面/左侧/右侧”的口语化表述。

改动：/jobs/{job_id}/frames/{idx}/generate 在调用图片 API 前统一对完整 prompt 执行 _ensure_english()，和生视频 _enqueue_storyboard_videos 的英文提交规则保持一致。物体主体套图的默认六面视图改为 正投影主视图 / 正投影后视图 / 正投影左视图 / 正投影右视图 / 正投影俯视图 / 正投影仰视图，并对前后左右也加入 orthographic elevation、no perspective、no tilt、no 3/4 angle、no isometric view 约束。

影响：用户仍可以用中文描述生图或生视频需求；后端实际提交给图片/视频模型的提示词会优先归一为英文。以后“专利六视图”应明确理解为六面正投影视图，不等同于摄影角度图；真人/短视频主体参考包仍保留口播、45 度、肩颈近景等非专利视角。

问题：原先主体/产品套图里把 top 和 bottom 简写为“顶部/底部”或“俯视/仰视”，模型容易理解成斜上方、斜下方或 3/4 透视镜头，不符合外观专利六面正投影视图的要求。

改动：api/main.py 的 SUBJECT_VIEW_LABELS、默认物体 6 视图和主体生图 prompt 已改为“正投影俯视图 / 正投影仰视图”，并在生成单图时加入 orthographic top/bottom view、no perspective、no tilt、no 3/4 angle 约束。web/components/lightbox.tsx、web/components/ad-recreation-board.tsx 和 web/components/storyboard-editor.tsx 同步更新显示文案和后续分镜提示词。

影响：以后描述专利六面图需求时应说“正投影俯视图 / 正投影仰视图”，不要只说“俯视角度 / 仰视角度”；这些视图是垂直投影，不是带角度的摄影机视角。

问题：前一版已经从复刻管线降到直接创作台，但仍是三模式表单，缺少团队成员各自工作、四类主入口和任务详情沉淀。用户确认这次要完全推倒旧复刻优先设计，平台先服务多人快速生图、生视频和图文创作。

改动：重写 web/app/page.tsx 为多人创作首页：左侧四入口（文生图、图生图、文生视频、图生视频）、参考图和我的任务，中间创作台，右侧当前任务图片/视频/图文结果。新增 web/app/detail/page.tsx，静态路由 /detail/?job=<id> 按 job 展示参考图、全量生成图、视频候选、营销图文方案和历史提示词，并支持继续生成、删除和复制。进入重设计前创建本地数据备份 .backups/pre-redesign-20260524-012047、源码快照包、dirty patch，并把 Git 标签 backup/pre-redesign-20260524-012047 推到 Gitea。

影响：默认产品使用方式改为“选择入口 → 填写要求 → 生成 → 详情页沉淀”；旧 AdRecreationBoard 和 /agent/ 只作为高级复刻能力保留。.project.json 与 RULES.md 已同步多人创作平台定位。

问题：平台后续会给公司内多人使用，单一共享账号会让任务、素材和一键出片记录混在一起；项目定位也已经从 TK 二创验证转为长期使用的 SKG 营销内容工作台。

改动：项目名统一改为 SKG 营销内容工作台。后端新增飞书 OAuth：/auth/config 暴露登录方式，/auth/feishu/start 跳转飞书授权，/auth/feishu/callback 换取 user_access_token 并读取用户信息，再签发 HttpOnly 会话 Cookie；账号密码登录保留为备用。Job 和 AgentRun 新增 owner_id、owner_name、owner_email、owner_provider、tenant_key 字段，新建任务绑定当前登录用户；中间件统一拦截 /jobs/{id}、复制到 job 和 /agent-runs/{id} 路径，非 owner 返回 404。列表接口只返回本人数据。

影响：飞书用户之间数据互不可见；历史无 owner 的旧任务作为旧版本数据保留，仅备用账号可见。生产需要在飞书开放平台登记回调 https://marketing.skg.com/api/auth/feishu/callback，并把 FEISHU_APP_ID、FEISHU_APP_SECRET 和 WEB_AUTH_SESSION_SECRET 放入服务器 deploy/.env.production。

问题：原首页围绕 TK 复刻、抽帧、转换层、主体 6 视图和分镜工作台展开，功能完整但对普通团队成员太重。真实需求更接近“能直接生图、生视频、自动写文案，或给一张图加一句描述快速出图/出片”。

改动：进入新设计前先把当前数据复制到 .backups/pre-redesign-20260523-235959，并创建本地 tag pre-redesign-20260523 指向旧版代码 0d5c326。默认 web/app/page.tsx 改成 SKG 营销内容工作台 三模式首页：生视频、生图、写文案；图片和视频缩略图继续复用 MediaAssetTile。api/main.py 新增 POST /creative/jobs/image 创建参考图/空白图创作任务，新增 POST /creative/copy 生成短视频文案和可直接投喂模型的 image/video prompt；web/lib/api.ts 同步新增类型和 client。

影响：旧信息流复刻工作台和 Agent Cut 代码不删除，作为最后版本和后续可复用能力保留；默认产品使用方式已经变成“输入一句要求，必要时加一张图，直接生成图片/视频/文案”。后续需求应优先描述首页三模式创作体验，不要默认回到旧转换层或 09 步管线。

问题：音频解析默认把 ASR_LANGUAGE 固定为 en，本地容器兜底也使用 faster-whisper tiny.en 并强制 language="en"；中文或其他语言视频容易被压成英文识别路径，且质量校验按英文字符集计算重复率，会误伤中文字幕。

改动：api/main.py 将 ASR_LANGUAGE 默认改为空值/auto，远端和 faster-whisper 都只在显式配置语种时才传语言提示；本地 faster-whisper 默认模型改为多语言 base，Gemini 音频兜底也要求保留原语种而不是翻译成英文。ASR 质量校验改为 Unicode 文本 key，翻译 prompt 改为“原语言字幕 → 简体中文”，中文原文会作为中文镜像保留。

影响：后续音频解析默认支持中文、英文和其他多语言原文识别，分镜时间轴的 en 字段实际承载“原语言文案”，zh 字段承载中文镜像。若某个素材明确固定语种，可通过 ASR_LANGUAGE=zh、en 等 ISO-639-1 代码强制识别。

问题：分镜工作台右侧视频候选卡把普通点击绑定为“选用该视频”，用户只是想打开查看候选片段时会被误判成选择操作。

改动：StoryboardVideoSlots / StoryboardVideoPreview 取消候选卡的默认选择点击，完成态视频卡点击只打开视频预览；候选提交后立即写入当前任务，完成后自动回填 mp4，候选轨显示“自动保存”。卡片右上角常显下载按钮，并保留重生、删除和清空候选。旧 VideoCandidate 也同步改为缩略图点击预览，并在操作区提供“下载”。MediaAssetTile 增加 actionsAlwaysVisible，用于这类必须直接可见的媒体操作。

影响：分镜候选视频默认是“自动保存 / 看一下 / 下载”，不是“点一下就选中”或“生成后还要保存”。后续若要做整片合成的候选选用，应提供单独明确的“选用”控件，不再抢占视频缩略图点击。

背景：用户希望默认不再进入多段人工链路，而是只提交 TikTok 链接和产品图，后台像 Codex 接管一样解决下载、规划、生成和合成问题，最终直接看成片。

改动：新增 web/app/agent/page.tsx 快速出片页和 api/main.py 的 AgentRun 状态机。后台固定 12 段约 1 分钟策略，执行下载、产品素材、主体参考、抽帧、镜头规划、视频生成、失败重跑、审片接触图和最终 mp4 合成；前端只显示实时终端和成片播放器。

影响：旧信息流复刻工作台仍保留给高级编辑；新页是“只看成品”的默认候选入口。后续描述该路径时应引用“一键出片终端 / AgentRun / agent-runs 接口”，不要再要求用户逐步处理关键帧、分镜和候选视频。

问题：玻璃工作台顶栏仍使用英文 Marketing Production Console 和“信息流广告复刻工作台”标题，和当前中文品牌表达不一致。

改动：AdRecreationBoard 顶栏三行文案改为 未来健康 · 营销内容工作台、营销内容工作台 和 信息流广告复刻生产。

影响：只改变顶栏显示文案，不改变素材、音频解析、分镜、资源库、主题切换或任何接口数据。

问题：侧栏按整高工具条处理后不像原版参考图，资源库和明暗按钮被压到底部；顶部指标卡也偏全灰，缺少原版紫、黄绿、琥珀、青绿色光斑的玻璃层次。

改动：WorkbenchRail 改成贴近工作台全高的胶囊侧栏，鼠标移入或键盘聚焦时自动展开素材输入抽屉，点击素材任务可固定展开；资源库和明暗切换移到侧栏上方图标组。Metric 新增多色 variant，顶部五个指标分别使用紫、黄绿、琥珀、青绿和绿色光斑。

影响：侧栏不再作为短中段导航存在；后续应按“全高悬停抽屉 + 顶部真实动作图标”描述。配色增强只影响视觉层，不改变素材任务、资源库、主题切换或指标数据。

问题：玻璃工作台暗色模式整体灰雾偏重；明亮模式仍有黑色 stat 卡、黑底按钮和偏白音频波形残留，导致同一版面里明暗语义混在一起。

改动：web/app/globals.css 重新分离暗色和明亮模式的 shell、panel、glass、stat、action 与音频波形 token；暗色压低背景和卡片底色，明亮模式改为暖白面板、浅色指标卡和绿黄主按钮。AudioWaveform 改用 skg-audio-waveform 主题类，不再把黑底、白色包络和播放线写死在组件里。

影响：这是纯视觉修正，不改变素材任务、字幕时间轴、波形点击跳转、胶片抽帧、模型调用或任何接口数据；后续调色应优先调整主题 token，不要在组件里新增孤立的黑白 Tailwind 色值。

问题：原版视频下方的竖向逐句时间轴只有 270px，高度偏短，一屏可见字幕段落太少。

改动：SOURCE_TRANSCRIPT_MAX_HEIGHT 从 270 调整为 360，让时间轴向下多展示几行；列表仍保留内部滚动，英文和中文仍最多两行。

影响：只影响源视频工作区左侧字幕审片面板的可见高度，不改变字幕数据、点击跳转、当前句高亮或音频波形联动。

问题：侧栏图标条里的流程状态图标容易被理解成可导航入口，但多数没有独立操作；素材输入也不应该常驻挤占主画布，而应该由真实入口唤出。

改动：WorkbenchRail 默认收起为 65px 中段胶囊工具条，只保留素材任务、资源库和主题切换三个真实动作；鼠标移入、键盘聚焦或点击素材任务后，skg-board-rail 增加 is-open 并从左侧展开 320px MaterialColumn 抽屉。旧的源视频、音频、参考帧、主体套图和视频候选状态图标不再放在侧栏里冒充按钮，状态继续由顶部指标和主工作区各自展示。

影响：后续描述布局时应说“左侧中段胶囊工具条悬停滑出素材输入面板，右侧主画布视频拆解工作区”；素材任务状态、开始分析、上传和任务切换接口不受影响。

依据：通过本地 figma-desktop MCP 读取 Dashboard Glassmorphism (Community)：主 frame 2:3 为 1366x768，普通指标卡约 288x160、rgba(255,255,255,.1)、backdrop-blur(5px)、20px 圆角，左侧栏为 #383838、宽 65px、右侧 70px 圆角。

改动：web/app/globals.css 新增黑灰玻璃工作台 token 和 skg-board-shell、skg-board-rail、skg-glass-card 等类；AdRecreationBoard 新增 WorkbenchRail，把资源库和主题切换收进左侧胶囊栏，顶部改为轻量生产控制条，素材列、视频拆解面板、源视频工作区、转换层和主体结果栏统一套深色玻璃面。

影响：这是纯前端视觉壳改造，不改变后端接口、模型路由、任务状态、转换层确认逻辑或媒体缩略图交互；后续描述 UI 需求时可说“按 2026-05-21 玻璃工作台外壳继续扩展”，不要再回到旧的顶部大 brand strip。

问题：外层 1800x1000 固定画布和整页 zoom 虽然能让不同显示器看到相同框架，但会压缩真实排版、让文字发虚，并让页面在实际浏览器里显得比例失衡。

改动：AdRecreationBoard 删除 BOARD_FRAME_WIDTH / BOARD_FRAME_HEIGHT、缩放档位、ResizeObserver 和内层 zoom 画布；外层改为 min-height: 100vh、width: 100%、max-width: 1920px 的正常桌面流式容器，并保留 min-width: 1280px 作为最低操作宽度。

影响：浏览器宽度变化时页面不再按固定画布整体缩放，文字由原生字号渲染，视觉大小和真实空间更接近浏览器本身；窄窗口会横向滚动兜底，而不是把整套复杂工作台继续缩小。

问题：转换层固定 640px 和 160px 输入框让页面显得过长，主体元素被推远，整体观感变重。

改动：把 SOURCE_CONVERSION_HEIGHT 改为 SOURCE_CONVERSION_MAX_HEIGHT，转换层不再写死 height，而是按内容自然高度显示，最多到 560px 后内部滚动；生成要求输入框从 160px 收回到 128px。

影响：对话式生成入口保留“发送消息 / 确认生成”闭环，但界面不再为了固定长款占满垂直空间，主体元素栏会更早露出。

问题：生成要求区已经是对话式输入，但提示词生成后仍跳出确认弹窗，用户还要理解额外确认层。

改动：生成要求输入框先提升到 160px，随后为视觉观感收敛到 128px；subject-agent/message 返回出图提示词后不再自动弹窗，标题右侧只显示“提示词就绪”，底部主按钮直接从“发送消息”切换成“确认生成 N 张”。用户在输入框里输入“确认生成 / 出图 / 开始生成”这类短句时也走同一个生成动作。

影响：转换层的生成闭环收敛到同一个对话框：继续输入就是改需求，直接点确认生成就是提交套图；数量控件、保留元素和主体元素输出逻辑不变。

问题：生成要求 composer 放大后，560px 的转换层在已有参考图、识别结果和待确认入口同时存在时仍显得偏短。

改动：把 SOURCE_CONVERSION_MAX_HEIGHT 取消固定高并收敛为 560px 最大高度；参考帧池滚动高度同步使用该值，转换层内部仍保持自身滚动。

影响：参考输入、识别结果和生成要求之间有更多垂直呼吸空间，发送区不再贴得太紧；主体元素结果栏仍放在转换层下方。

问题：“当前要求”、保留元素副本和对话记录计数重复表达了识别结果和确认弹窗里的信息，增加了转换层噪音。

改动：删除生成要求区内的摘要卡、保留元素副本和“对话记录已收起”提示；该区域只保留文本输入、张数控件和发送按钮；文本输入高度提升到 112px，张数步进和发送按钮提升到 40px，出图提示词就绪后，底部主按钮直接切换为“确认生成 N 张”。

影响：转换层更像对话式生图输入区，输入框和底部操作区更适合直接书写生成要求，保留元素只在识别结果 chip 中管理，确认出图流程不变。

问题：转换层内部的模型选择、参考输入、识别结果和生成要求在 500px 高度内会互相挤压，和左侧参考帧池视觉高度也不完全一致。

改动：把转换层和参考帧池共用高度从 500px 拉到 560px，并在生成要求区域放大后继续扩到 640px；转换层内部改为 gap 堆叠，并让主要板块 shrink-0，内容超出时由转换层自身滚动承接。

影响：转换层与参考帧池在同一水平区域内更接近同长，内部板块不再因为 flex-1 被压缩重叠。

问题：转换层里同时展示完整待确认 prompt、大号“确认并生成”按钮和固定确认弹窗，职责重复，并挤压生成要求输入区。

改动：删除转换层内嵌的“待确认提示词”卡和黑色确认按钮；subject-agent/message 返回 prompt 后仍自动打开固定确认弹窗，用户关闭后可通过“生成要求”标题右侧的小型“待确认 · N 张”入口重新打开。

影响：确认出图的安全步骤不变，但转换层高度更稳定，当前要求区不再重复显示完整英文 prompt。

问题：临时滑杆和浏览器本地参数让工作区比例不稳定，容易把转换层、主体元素和逐句时间轴调乱。

改动：删除 SourceWorkspaceLayoutPanel、“布局调节”按钮和 localStorage["skg-source-workspace-layout:v1"] 读写；源视频工作区改回代码固定比例：左侧原视频列 380px、9:16 视频高 500px、逐句时间轴最大高 360px、参考帧池 140px、转换层自然高度、最大 560px 内部滚动、主体空态 78px。

影响：用户不再需要在线调比例，不同浏览器也不会继续受旧本地参数影响；任务数据、模型调用和素材生成接口不受影响。

问题：左侧 9:16 原版视频和逐句时间轴实际信息密度偏低，但固定列宽难以一次判断准确；转换层高度又会影响主体元素位置。

改动：AudioIntakePanel 新增“布局调节”面板，临时开放左列宽、视频高度、逐句时间轴高度、参考帧池宽度、转换层高度和主体空态高度 6 个滑杆，写入当前浏览器 localStorage["skg-source-workspace-layout:v1"]。转换层高度改为受控区域，内容过多时内部滚动。

影响：用户可以先在线调整到合适比例，后续再把确认后的参数固化为默认值；任务数据、模型调用和素材生成接口不受影响。

问题：主体元素是转换层的生成结果，却长期占据右侧整列；空态时浪费 500px 高度，也把对话式转换层挤得过窄。

改动：SourceSubjectPipeline 改为上方两列：左侧紧凑参考帧池，右侧宽幅转换层；主体元素移动到下方结果栏，空态压缩为 80px，已生成时横向展示当前套图并在右侧切换套图包。

影响：转换层获得主要操作宽度；主体套图仍保留文件夹分组、单张重生、删除和 MediaAssetTile 顶层 hover 预览。

问题：常见尺寸档位让宽度稳定了，但 1440x900、1728x1117、2560x1440 这类窗口里，缩放后的 1800x1000 工作台高度小于视口却仍贴顶，底部会出现明显空白，视觉上像整体尺寸调错。

改动：AdRecreationBoard 记录工作台视口宽高，在缩放后画布可完整放入视口高度时上下居中；当缩放后高度等于或超过视口时仍保持顶部对齐和滚动。

影响：不同显示器继续使用同一套框架和缩放档位，但短窗口不再贴顶留黑边，高窗口会保留更均衡的上下呼吸感。

问题：连续按宽度铺满虽然消除了左右空白，但 2048px 等窗口会被放得过大，界面失去最初的比例和呼吸感。

改动：AdRecreationBoard 新增 BOARD_SCALE_PRESETS，按可见宽度选择最接近且能放下的人工档位：0.72/0.76/0.8/0.86/0.92/1/1.06/1.16/1.24/1.34/1.48/1.6，继续用 CSS zoom 渲染。

影响：1440、1728、1920/2048、2200、2560 这类常见尺寸会更稳定，保留适度侧边留白；拖动浏览器不会每个像素都改变比例，视觉更接近人工设计稿。

问题：工作台按宽度铺满后仍使用 transform: scale() 缩放整个 1800x1000 画布，小数比例下浏览器会把文字、边线和图标一起作为缩放层处理，用户看到文字有发虚感。

改动：AdRecreationBoard 保留同一套 boardScale、外层占位尺寸和宽度优先策略，但内层画布改用 CSS zoom 承接缩放，减少整屏 transform 位图化带来的文字模糊。

影响：不同显示器仍看到同一套框架；左右空白和纵向滚动策略不变，但文字、按钮和小号状态标签应比 transform 缩放更清晰。

问题：工作台之前直接跟随浏览器视口宽高，并在 xl/2xl 断点下改变列宽、视频高度、主体管线和分镜网格；用户换显示器或缩放浏览器时，看到的框架会变。

改动：AdRecreationBoard 外层改为可缩放视口，内部保留 1800x1000 基准画布；移除工作台内会影响核心框架的响应式断点，统一使用同一套桌面列宽和高度，再按可见宽度计算 0.72-1.6 倍的等比缩放，优先消除左右空白，必要时允许纵向滚动。背景网格和氛围层改为固定层，滚动画布时视觉不被裁切；逐句时间轴的当前句同步滚动只作用于字幕列表内部，避免小窗口打开时把整个工作台顶端自动滚掉。

影响：不同显示器和浏览器宽度下，素材输入列、源视频工作区、参考帧池、转换层、主体元素和分镜行保持同一框架；大屏会自动放大并尽量铺满宽度，小窗口会等比缩小，高度不足时用纵向滚动承接，不再为了完整高度留下大块左右空白。

问题：手动 rsync --delete 如果没有排除服务器 data/jobs 和真实 deploy/.env.production，会把生产案例、资源库或登录配置删掉。

改动：新增 scripts/deploy-prod-safe.sh 作为生产部署唯一入口。脚本部署前会在服务器创建 /opt/skg-marketing-studio-backups/skg-marketing-preserve-*.tgz，备份真实 env、案例、资源库和 secrets；同步时用 rsync --filter='P ...' 和 exclude 双重保护 data/、jobs/、secrets/、api/jobs、deploy/.env.production 和本地开发文件。

影响：后续发布不再手写裸 rsync --delete；脚本会自动 Docker 重建并调用 verify-prod-docker.sh。若误操作，先从最新 skg-marketing-preserve-*.tgz 恢复。

补充：转换层排版改为“参考输入区在上、消息对话区在下”的对话式生图 composer。参考输入区可接收左侧参考帧拖拽、胶片拖拽和本地图片拖拽上传；本地图片通过 POST /jobs/{id}/frames/upload 写入 job.frames 后加入当前转换层参考图。

影响：“生成提示词”按钮语义收敛为底部“发送消息”，用户先围绕参考图发需求，系统再返回待确认英文 prompt；右侧主体元素套图输出、轮询、文件夹分组、单张重生和删除不变。

补充：可见快捷需求 chip 不再显示，输入框也不再枚举固定示例句，改成中性的“补充调整要求”；默认让识别结果 chip 承担元素保留，用户需要换人物、卡通化、放大人物或删除某元素时直接在对话里补充。生成数量改成发送区旁边的张数控件，默认 6 张，当前上限 10 张。参考输入空态和已选参考图缩略图压小，依靠 MediaAssetTile hover 放大预览查看细节。

补充：识别结果里的特征 chip 改为纯本地“保留元素”选择，点亮表示会随下一条消息提交给模型，再点同一 chip 取消，右侧“清空”一次性取消全部；点击 chip 本身不再触发 /subject-agent/message，避免每点一次都等待模型造成卡顿。

补充：转换层不再把最近 5 条 user/assistant 消息作为聊天泡逐条显示；“我们将不再强制……”这类模型确认句默认收起，界面只保留识别结果里的保留元素 chip 和生成要求 composer，最终英文 prompt 不再自动弹窗，界面只显示“提示词就绪”并把底部主按钮切换为确认生成。

问题：用户希望转换层只做清晰的“上传图/选图 → 分析图 → 对话确认需求 → 生成出图提示词 → 底部出现确认生成按钮 → 点击生成多角度统一套图”闭环，不能拖入参考后自动开跑，也不能继续保留旧四投放区。

改动：SourceSubjectPipeline 恢复轻量对话式转换层：参考帧池缩略图新增 + 操作送入转换层；转换层内可选 GPT/Gemini 套件、分析 1-3 张参考图、查看特征 chips、通过对话生成英文 prompt。subject-agent/message 返回后不再自动弹窗，生成要求区底部主按钮切换为“确认生成 N 张”；用户点该按钮才调用 generateSubjectAssets。

影响：右侧主体元素输出、套图文件夹、逐张回填、单张重生和删除逻辑不变。生成数量、方向和风格继续由对话解析，最终英文 prompt 由对话生成并进入就绪状态，用户从同一输入区直接确认生成。

问题：现有转换层界面和智能体交互方向被判定为错误，继续在该板块上补控件会扩大错误设计。

改动：SourceSubjectPipeline 的中间转换层渲染清空为待重构占位，移除模型选择、参考图、分析按钮、对话记录、输入框、生成按钮和拖拽接收。

影响：右侧主体元素区的已有图片输出、套图文件夹、轮询、单张重生和删除逻辑不变；后端 subject-agent 和主体生成函数暂时保留在代码里，但当前主界面不再通过转换层触发。

问题：转换层已经是生图智能体，但界面仍保留四个方向卡片、卡通风格下拉和数量按钮，用户需要在“对话”和“控件”之间来回确认，违背“模糊需求通过对话收口”的目标。

改动：SourceSubjectPipeline 删除方向卡片和独立数量控件，只显示当前识别出的方向与张数摘要；用户在对话里写“形象锁定 / 卡通重构 / 创意复刻 / 自主描述”和“生成几张”，后端 subject-agent/message 会解析并更新 selected_mode、quantity、中文需求和英文生成 prompt。

影响：数量、方向和风格以后都通过转换层对话完成；点击“生成 N 张”时使用对话状态，不再要求用户点卡片或另选数量。卡通风格若在对话里说明，会进入英文 prompt，不再被前端默认 3D 风格硬覆盖。

问题：旧多方向卡片加 textarea 的转换层不适合“参考图先分析、再边聊边确定生图需求”的模糊决策流程；同时 GPT/Gemini 切换必须成套影响分析对话模型和生图模型，不能只切图片模型。

改动：Job 新增 subject_agent 状态，保存当前项目的模型套件、参考帧、AI 分析、对话消息、选中方向、特征 chip、数量和英文生成 prompt。后端新增 POST /jobs/{job_id}/subject-agent/analyze 与 POST /jobs/{job_id}/subject-agent/message；SourceSubjectPipeline 的转换层改成“GPT 套件 / Gemini 套件 + 参考图 + 开始分析 + 生图对话 + 数量 + 生成”结构。选 GPT 时分析/对话走 GPT、图片走 gpt-image-2；选 Gemini 时分析/对话走 Gemini、图片走 gemini-3-pro-image-preview。

影响：转换层不再把生图模型偏好写入浏览器全局或 job-scoped localStorage 作为主状态；当前项目的生图记忆跟随 state.json。用户可以在对话里改“生成几张、保留什么、删除什么、人物放大、服装统一、形象锁定/创意复刻/卡通/自主描述”，确认后仍复用 generateSubjectAssets 逐张生成并进入右侧主体元素套图文件夹。

问题：转换层提示词记忆和生图模型选择用全局 localStorage key，切换不同项目时会带入上一项目的偏好；同时 reconstruction_mode=similar 虽然提交了参考帧，但最终走纯文字 /images/generations，导致不同项目容易生成同一套泛化人物。

改动：SourceSubjectPipeline 把主体提示词记忆和生图模型偏好改为按 job.id 存储；自主描述为空且已拖入参考帧时，前端切到 reconstruction_mode=same 并提交源形象锁定 prompt。generateSubjectAssets 对有参考帧的 similar 路径先生成 source brief，再把参考帧作为 /images/edits 的 image refs 一起提交；same 路径使用源形象 pack bible，锁定参考帧中的可见主体、体态、发型、服装和配色。

影响：不同项目之间不会再共享转换层提示词 chip 或模型选择；真人/卡通/元素重构仍是参考创新，但参考帧会真正进入生图请求；自主描述不写字时表示按拖入参考帧复刻同一主体，而不是随机生成新人。

问题：Gemini 显式生图时，6 个视角是 6 次独立 /images/generations 请求，容易每张自行脑补服装；模型也可能输出“小人 + 大白边”，即使最终文件是 2048 高也显得主体很小。

改动：generateSubjectAssets 在每套主体图中注入同一份 pack bible，固定同一新主体、发型、肤色、体态、服装、鞋、配饰和禁止换装项；全身视图 prompt 明确要求主体占画布高度 88-94%。_normalize_asset_image(fill_subject=true) 裁出白底主体后改为可放大 resize 到目标画布上限，不再只用 thumbnail() 导致小人保持原比例。

影响：显式 Gemini 仍然是逐视角独立生成，但每次调用收到同一份具体主体/服装约束；保存后的主体资产会尽量贴近画布高度，减少大白边。

问题：用户已经知道某个生图模型不可用时，需要能在转换层直接切换；同时主体 6 视图容易出现不同衣服、不同人设，提示词每次也要重复输入。

改动：SourceSubjectPipeline 新增自动 / GPT / Gemini 三档生图模型选择，当时偏好写入全局 localStorage["skg:subject-image-model:v1"]，后续已改为当前 job 作用域；提示词输入当时保存到全局 localStorage["skg:subject-prompt-memory:v1"]，后续也已改为当前 job 作用域。后端 _image_model_candidates 支持显式模型偏好，auto 保留 gpt-image-2 主模型、Gemini 兜底和短时熔断，显式 GPT / Gemini 只走所选模型。

影响：主体重构默认继承参考图里的性别、人种/肤色、年龄体态和角色气质这些广义特征，但生成同一个全新主体；六视图 prompt 强制统一脸部设定、发型、体态、服装类型、配色、材质、剪裁和配饰，避免一套图里每张衣服都不同。

问题：gpt-image-2 当前上层通道会读超时，但完全禁用兜底会导致主体套图和补图无法继续；同时不能把主模型直接改成 Gemini。

改动：api/main.py 保持 gpt-image-2 为主模型，新增 IMAGE_FALLBACK_MODEL=gemini-3-pro-image-preview、IMAGE_FALLBACK_ENABLED、IMAGE_CIRCUIT_FAILURE_THRESHOLD 和 IMAGE_CIRCUIT_COOLDOWN_SECONDS。只有主模型超时、429、5xx 或网络错误时才兜底；400/401/403/404 和参数错误不兜底。连续 2 次主模型上游类失败后，600 秒内直接走 Gemini；主模型成功后自动清空失败计数。主体同一套图内一旦触发 Gemini，后续视图沿用 Gemini。

影响：/health 返回 image_fallbacks 和 image_circuit；ModelTrace 显示 gpt-image-2 / gemini-3-pro-image-preview 和熔断规则。该变更是故障兜底，不是默认改模型。

问题：gpt-image-2 上游图片网关无响应时，文字生图仍通过 SDK 默认等待，编辑生图也按 120 秒重复尝试；主体 6 视图第一张卡住后，用户侧长时间看不到逐张失败或后续进度。

改动：api/main.py 新增 IMAGE_REQUEST_TIMEOUT_SECONDS，默认 60 秒；_image_text_call 统一改为直接调用 /images/generations，_image_edit_call 和旧分镜生图也复用同一超时。超时、DNS、连接失败这类传输错误不再盲目重试三轮，会把当前视图标失败并继续处理后续视图。/health 回传当前图片超时配置。

影响：当时不改模型，所有图片入口仍固定只使用 gpt-image-2；后续已增加 Gemini 故障兜底和短时熔断，但错误仍会明确指向当前 IMAGE_BASE_URL 上的主模型通道超时或不可用。

问题：主体 6 视图生成一次性等待太久，且多次生成后所有图片平铺会迅速挤满主体元素区。

改动：SubjectAsset 新增 status/progress/error 和 pack_id/pack_label/pack_mode/pack_created_at；generateSubjectAssets 先写 queued 占位卡并后台按视角逐张生成。web/app/page.tsx 轮询主体资产运行态，SourceSubjectPipeline 按 pack 显示套图文件夹，点击文件夹在最上层展开该套，其他套图进入下方可滚动列表。

影响：用户可以连续生成多套真人/卡通/元素/自主描述主体图，不会被平铺图片淹没；生成过程会逐张出现，单张失败不阻塞其他视角。

问题：拖入第一张参考帧就立即开始生成，会打断用户继续补第二、第三张参考帧和填写方向文字。

改动：SourceSubjectPipeline 的 addConversionFrame 只更新对应重构入口的参考队列和提示，不再调用 generateSubjectPack；旧版本曾保留独立生成按钮，用户放好参考后再手动提交。

影响：当前正确操作是“拖入 1-3 张参考帧 → 可写方向文字/选卡通风格 → 点击生成 6 视图”。

问题：旧转换层暴露“透明骨架 / 真人、完整 10 / 常用 4”等生成参数，和当前“参考创新生产套图、避免侵权”的目标不一致；用户更需要把少量参考帧拖到明确方向上，右侧马上看到生成结果。

改动：SourceSubjectPipeline 的转换层曾改成多方向入口；文字描述会参与 prompt，卡通重构可选择风格。主体元素区按重构类型分组展示结果。web/lib/api.ts 和 api/main.py 扩展 subject_style=cartoon_subject，后端对卡通主体额外加入原创卡通/插画约束。

影响：后续描述这块应说“把参考帧拖到某个重构方向，生成全新主体 6 视图”，不要再说“抠图”“模仿”“透明骨架/真人开关”或“10 张/4 张选择”。

问题：胶片只能拖入参考帧池，不能双击快速加入；回到同一素材时胶片会重新扫视频；音频解析失败后如果留下半成品 transcript 或 transcribing 状态，开始队列和解析按钮可能不再真正触发重试。

改动：TimelineFilmstrip 支持双击调用 addManualFrame，已加入的胶片显示“已添加”；胶片预览按 job、视频、密度和时长做内存缓存，未切换低/中/高时复用已有截图。web/app/page.tsx 用音频失败状态排除半成品结果，api/main.py 的 trigger_transcribe 只按实际 worker 和 audio_script.status=rewriting 判定忙碌，失败后可重新提交。

影响：用户可以双击胶片快速选参考帧；返回素材或切回同密度时不重复扫视频；音频失败后可直接点击解析音频或开始分析重试。

问题：参考帧池默认 hover 大图向右弹出，遮挡转换层；竖版缩略图用完整 contain 显示后仍然偏大；转换层拖入多张参考帧后也可能挤占生成控制区。

改动：MediaAssetTile 新增 previewPlacement 和 previewMaxWidth；SourceSubjectPipeline 的参考帧池改为左侧紧凑 hover 预览，参考帧池和转换层缩略图固定为约 72-80px 宽，同时保持 aspect-[9/16] 和 object-contain，转换层参考列表增加滚动上限。

影响：参考帧仍可点击多选、拖入转换层和删除；多张参考会在转换层内滚动，不会把下方生成按钮挤走。

问题：旧下方“相似主体 / 主体模板库”过重，用户实际只想从少量关键帧里挑 1-2 张作为参考，直接生成新的主体套图。

改动：AudioIntakePanel 右侧新增 SourceSubjectPipeline，把主体流程改为三栏：竖向参考帧池、转换层和主体元素。参考帧池可从胶片正式加帧，也可拖关键帧到转换层；转换层拖入后自动调用 generateSubjectAssets 参考创新生成套图，保留透明骨架/真人、完整 10 / 常用 4、统一方向和手动重生；主体元素区展示生成结果并支持单张重生、删除和 hover 放大。

影响：旧 SourceReferenceBuildPanel 不再主路径渲染，主体模板库入口从首屏移除；后续描述这里时，应按“参考帧池 → 转换层 → 主体元素”来提需求。

问题：逐句时间轴放在右侧会和波形、胶片、参考帧池抢空间，且单行截断导致文案内容看不全。

改动：AudioIntakePanel 把左侧原版视频列调整为 430-460px，并把逐句时间轴放到原版视频下方；时间轴抽成 TranscriptTimelinePanel，英文和中文字段由单行 truncate 改为最多两行 line-clamp-2，时间列收窄为 68px。

影响：视频、字幕、波形播放线仍联动；右侧下方只保留参考帧池。后续描述源视频工作区时，应把“逐句时间轴”理解为原版视频下方的字幕审片面板。

问题：用户通常只需要 1-2 张关键帧，但只靠自动抽帧或当前播放点补帧，浏览大量候选画面不够快，直接抽很多帧又会污染正式关键帧池。

改动：AudioIntakePanel 在 AudioWaveform 下方同框新增无标题 TimelineFilmstrip，前端从源视频临时截取低/中/高密度胶片缩略图，并按 frame.time / duration 的百分比定位到和波形一致的横向时间点；低/中/高密度按钮上移到波形上方，波形和胶片之间不再显示分隔横线，缩略图增加轻微上下错落。hover 时关闭额外弹出预览，改为在原胶片坐标生成固定顶层克隆，使用同一张胶片卡放大到约 4.8 倍；当前单击只跳转视频时间点，双击或拖进参考帧池才调用现有手动抽帧入口。

影响：临时胶片不会写入 job.frames，只有拖入后才成为正式关键帧；胶片轨道和波形共用同一个无标题框架，基线更贴近波形，并显示同一条当前播放线；胶片 hover 克隆挂到 document.body，避免被工作区、滚动容器或相邻面板裁切。后续如果要调摆放密度、倾斜角度、上下错落或放大倍率，改 FILMSTRIP_DENSITIES、FILMSTRIP_TILT_CLASSES、FILMSTRIP_VERTICAL_OFFSET_CLASSES 和 FILMSTRIP_HOVER_SCALE。

问题：宽屏下逐句时间轴占满右侧剩余空间，表格过宽、阅读距离过长，也挤压源视频拆解区的密度。

改动：AudioIntakePanel 给逐句时间轴容器增加桌面最大宽度，约束在 620-680px 范围内；参考帧池、波形、字幕点击跳转和当前句滚动逻辑不变。

影响：时间轴视觉宽度约减半，后续若要再调整只改该容器的 max-width。

问题：源视频工作区顶部的“音频解析结果”折叠条和讲话人/节奏/背景音三张摘要卡仍占据首屏，和用户当前要看的原视频、波形、参考帧和逐句时间轴重复抢空间。

改动：AudioIntakePanel 移除“音频解析结果”details 和三张 ProfileTile 摘要卡。AudioScript 里的讲话人、节奏和背景音数据仍由后端生成并保留，主界面不再默认展示这组诊断信息。

影响：源视频工作区打开后直接进入原视频、波形、参考帧池和逐句时间轴；需要排查模型分析时再从数据或后续专门详情入口查看。

问题：源视频工作区顶部同时展示 01-09 流程条、素材/视频/音频/文案/参考帧 chips、文案依据下拉和 03-06 四个状态卡，占用过多首屏空间，用户需要的是直接进入视频、音频文案、抽帧和分镜操作。

改动：AdRecreationBoard 不再渲染 WorkflowOrderBar，并移除右侧源视频区顶部的需求 chips、文案依据 details 和四个 PipelineLane 状态卡。后台状态计算、步骤编号和后续分镜/生成逻辑保持不变。

影响：这些状态仍可作为代码里的判定依据，但默认不在此工作区显现；首屏高度让给真实操作内容。

问题：多条音频分镜会映射到同一张参考帧，旧视频候选只按 frame_idx 过滤，导致第一行生成的视频也出现在后面共用参考帧的分镜行里。

改动：StoryboardScene、GeneratedVideo 和 /storyboard/video 请求增加 storyboard_row_idx；前端显示候选和读取已保存分镜时优先按该行号隔离，旧无行号候选只归到同参考帧的第一条兼容行。

影响：点击某一行生成视频后，只会在该音频分镜行右侧出现候选；整片生成也改为逐行提交，避免候选跨行串位。

问题：三字段和视频候选上下堆叠时，每条分镜一展开就占用大量纵向空间；4-grid 候选区也让长分镜列表很难连续操作。

改动：AudioStoryboardPlanPanel 改为每条分镜左侧编辑三字段、右侧直接显示视频候选横向轨。候选生成数量可按单行选择，整片生成也可选择每行数量并按行排队。中文镜像字段失焦后会调用 AI 改写链路优化对应英文主值，失败时退回翻译。

影响：用户可以按行扫文案、按行横向看所有候选，生成新候选会持续向右追加，不再撑高分镜行；英文仍是视频 prompt 主值，中文作为团队编辑入口和镜像。

问题：本地音频解析成功时实际链路是远端失败后落到 mlx_whisper，而生产强制 ASR_BASE_URL=https://ai.skg.com/azure/v1 + ASR_MODEL=gpt-4o-transcribe 且关闭本地兜底。生产探测官方 Azure OpenAI 音频路径 /openai/v1/audio/transcriptions?api-version=preview 和 /openai/deployments/{deployment}/audio/transcriptions?api-version=... 仍不可用，当前部署名返回 DeploymentNotFound。

改动：当时远端 ASR 请求新增 ASR_LANGUAGE 并固定英文素材优先；翻译请求也套用 ASR_TIMEOUT_SECONDS。生产配置临时改成 ASR_REMOTE_ENABLED=false、ASR_LOCAL_FALLBACK_ENABLED=true、ASR_AUDIO_FALLBACK_ENABLED=false，云端用容器内 faster-whisper 复制本地“真实本机转写”路径。2026-05-22 后该路径已改为默认 auto 语种和多语言模型。

影响：音频解析不再卡在不存在的 Azure deployment；当前云端 CPU 实测同一失败 job 的 audio.wav 可在约 13.6 秒转出 17 段。等 SKG 网关提供真实 Azure ASR deployment 后，再把 ASR_REMOTE_ENABLED=true 并恢复对应部署名。

问题：用户在参考帧池删除自动抽出来的帧时，后端 DELETE /jobs/{job_id}/frames/{idx} 返回的 job message 写成“删除分镜”，让人误以为删掉了逐句分镜。

改动：delete_frame 的状态消息改为“已删除参考帧 N”。前端按钮本来就是“删除关键帧”，删除逻辑仍只移除 job.frames 里的抽帧参考帧和对应文件。

影响：删除抽帧不会被误报成删除分镜；分镜行和参考帧池在用户提示和文档里继续保持清晰边界。

问题：旧文案里的“抽卡”容易被理解成图片、抽帧或只生成缩略图，不够明确。

改动：前端按钮、候选区标题、Toast、空状态和后端 job message 统一改为“生成 4 条视频 / 4 个视频候选”。接口逻辑不变：count=4 表示一次创建 4 个独立 GeneratedVideo 视频任务。

影响：用户看到的是“生成候选视频”，不是“抽图片”；后续不再用“张”描述视频候选数量。

问题：线上 Web 不是开发态 Next 服务，而是 Docker 内 Nginx 承载的 next export 静态产物。只在本地跑 npm run build 或 dev server，无法覆盖 Nginx 登录跳转、/api 反代、静态资源路径、生产构建参数和镜像内环境污染。

改动：新增 scripts/verify-prod-docker.sh，直接在 VPS 的 skg-marketing-web / skg-marketing-api 容器内检查路由状态、静态包是否残留本地 API 地址、API health、/app/.env 是否泄漏，以及 yt-dlp cookies 参数是否被开发环境污染。RULES.md 明确 Web 改动部署后必须跑该脚本。

影响：后续前端上线验收以生产 Docker 形态为准；本地 dev 只用于开发预览，不能作为生产适配结论。

问题：生产 API 镜像把本地开发 api/.env 复制进 /app/.env，其中 YTDLP_COOKIES_FROM_BROWSER=chrome 被 load_dotenv() 读入。容器没有 Chrome cookies 数据库，导致公开视频也在下载阶段失败，错误为 could not find chrome cookies database。

改动：.dockerignore 明确排除 api/.env、api/.env.local、api/.env.production，生产 env 显式保持 YTDLP_COOKIES_FILE=、YTDLP_COOKIES_FROM_BROWSER= 为空。需要登录态时只允许配置服务器 cookies 文件，不允许在生产容器使用 YTDLP_COOKIES_FROM_BROWSER=chrome。

影响：公开视频下载恢复为无 cookies 直连；受限视频仍可通过服务器私有 cookies 文件处理。后续 rsync / Docker build 必须排除本地 api/.env，否则开发代理、cookies 或 API 配置会污染生产镜像。

问题：三字段候选生成改造后，候选区默认直接铺开 4-grid，占用每条分镜的大量纵向空间；产品素材池、批量控制、三字段和候选区也缺少统一折叠入口，长列表操作时很难快速扫分镜。

改动：AudioStoryboardPlanPanel 新增板块折叠状态：产品素材池、批量控制 / 作者想法、每行三字段、每行视频候选和高级抽屉都可独立收起。视频候选默认不展开；无候选且未展开时不渲染大区域，有候选时只显示横向迷你缩略条和已选 / 生成中状态，点“候选”或候选标题后才展开 4-grid 大预览。

影响：默认工作台从“每条都展示候选面板”改为“行头控制 + 按需展开”。客户仍可一键生成 4 个视频候选、追加生成、选中、删除或清空候选，但长分镜列表不会被空候选槽撑高；高级用户展开高级区时继续看到完整视频候选和首尾帧细节。

问题：原分镜行把新口播、画面规划、人物描述、首帧、尾帧、产品出现方式和视频槽全部摊开，客户要先理解 6 字段和首尾帧闸门才能生成视频，单条也只能按旧候选逻辑慢慢提交。

改动：默认行改为三字段：文案、场景一句话、人物+产品+动作；每行提供 AI 改写、生成 4 条视频和高级抽屉。高级抽屉保留原 6 字段、首尾帧 prompt 和首尾帧资产槽。候选区改为 4-grid，支持生成中状态、hover 视频预览、选中、追加生成、单条重生、删除和清空。顶部新增整片一键生成候选，默认每条 4 个候选并后台提交。

影响：StoryboardScene 新增 skg_copy_*、scene_one_line_*、action_one_line_* 和 selected_video_id。后端新增 quick-plan、refine、batch-generate-all，并让 /storyboard/video 支持 count/seed。默认 prompt 仍以英文主值提交，中文只作为镜像显示。

问题：主体、产品、首尾帧、视频候选和常用 prompt 都散落在单个 job 里，跨任务复用时容易重新上传、重新生成或误把旧 job 文件当公共引用，后续也缺少删除保护和使用次数记录。

改动：后端新增和 jobs/ 平级的 asset_library/ 与 prompt_library/，服务启动扫描目录重建索引；提示词提供 CRUD、复制计数和 5 类分类；素材提供主体/产品/场景/视频四类 CRUD、引用检查、强删移入 _trash/ 和 copy-to-job。前端新增 LibraryDrawer 浮窗，顶部“资源库”按钮打开；浮窗记忆尺寸、位置和 Tab，提示词按“常用 + 月份”分列，素材按月份分列，节点不能拖动；提示词支持一键复制英文/中文/双语，素材应用到当前 job 时只走复制模式。生产 compose 同步挂载 /data/asset_library、/data/prompt_library 和 /data/_trash，避免容器重建后库文件丢失。

影响：后续保存产品图、首尾帧、主体模板和分镜 prompt 时优先进入资源中心。库素材永远不要直接写成 job 引用，必须通过 POST /asset-library/{kind}/{id}/copy-to-job/{job_id} 复制成普通 job asset；删除库素材前必须查 /refs 并让用户确认。

问题：登录页已经形成 SKG 卡通角色、暖橘光晕、金色聚焦色、米白主按钮和“未来健康 · 营销内容工作台”的品牌承诺，但进入信息流工作台后仍是纯黑高密度界面，主 CTA 和选中态混用 cyan、emerald、rose、violet 等颜色，视觉上像两个产品。

改动：web/app/globals.css 把登录页的金色、米白、暖光、8px 圆角、按钮阴影和明暗模式中性色抽成 skg-board-theme token，并新增 skg-board-brand、skg-stat-card、skg-primary-action、skg-secondary-action、skg-empty-state 等复用类。AdRecreationBoard 顶部改为 SKG brand strip，右侧统计改成米白 stat 卡片，开始分析、生成主体、整片改写、保存规划等主动作统一为登录页同源按钮；主体模板选中、处理中状态和重点输入焦点收敛到品牌金色，空状态复用 AnimatedLoginCharacters。

影响：后续描述工作台视觉时应按“登录页同源 SKG 营销内容工作台”理解，不再把它当成独立黑色工具页；新增图片/视频/表格板块时，主动作优先用 skg-primary-action，次动作用 skg-secondary-action，选中和聚焦用 SKG 金色，功能色只留给明确成功、等待、失败、信息语义。

问题：最终产物是英文 TikTok 二创广告，但前端默认分镜规划、首尾帧 prompt 和用户可编辑规划字段里混入中文，导致 gpt-image-2、脚本改写和后续视频模型收到中英混杂指令。

改动：AudioStoryboardRow.role 改为 hook/pain/proof/solution/cta/bridge 英文枚举，UI 仍显示中文角色标签。buildAudioStoryboardRows、buildVisualPlan、buildFirstFramePlan、buildLastFramePlan、buildSubjectDescription、buildEndpointFramePrompt 和 buildStoryboardSceneFromAudioRow 的模型主字段改为英文，并新增 *Zh 镜像用于团队阅读。首尾帧提交前前端会对含中文 prompt 调 translateText 兜底，后端新增 _ensure_english 并挂到 generate_scene_asset、generate_subject_assets、脚本改写和音频分析入口。

影响：发给 LLM / 生图 / 视频模型的主 prompt 默认全英文；中文只作为团队审稿镜像、UI 标签和 toast。AudioScript 新增 rewritten_text_zh，KeyElement 新增 subject_consensus_brief_zh，SubjectTemplateItem 新增 prompt_brief_zh。POST /jobs/{id}/script/rewrite 返回 text 英文主值和 text_zh 中文镜像。

问题：首尾帧旧链路把 5 张主体图和 6 张产品图拼成 contact sheet 再做 image-edit，主体姿态和景别被参考图锁死，模型还容易把拼图布局误认为输出布局。

改动：KeyElement 新增 subject_consensus_brief；主体视图生成后由 Vision LLM 从 10 张图或模板 prompt_brief 写入统一主体 brief。generateEndpointFrameForRow 生成首尾帧时只传 subject_brief 和最多 1-2 张产品图，不再传 subject_images；generate_scene_asset 在首/尾帧里只对产品图走 image-edit，没有产品图时走纯文字生图。前端状态栏改成“依据：主体 brief · N 张产品参考”，首尾帧 slot 的 info 图标可查看 brief 全文。

影响：主体可以在首尾帧里演新动作、新景别和新场景，但仍保持同一人设；产品结构继续由少量硬参考图锁住左右非对称、按键、触点、厚度和真实佩戴比例。

问题：“生成主体视图”只有自由文本方向，用户想控制男女老少、着装、地域人种、肤色等人设时必须手写，而且随机生成容易在多张视图里漂移。

改动：SourceReferenceBuildPanel 新增“主体设定”控件：默认随机组合，也可手动指定性别表现、年龄段、着装风格、地域人种、肤色、体型比例、发型和气质场景。点击生成时前端把随机项解析成一套固定 profile，传入 generateSubjectAssets 的 subject_profile；后端 GenerateSubjectAssetsReq 新增 SubjectProfilePreference，并把这套设定写入 gpt-image-2 prompt，要求整包视图统一使用同一人设。

影响：用户可以快速得到有差异但稳定的人物设定；随机模式仍省操作，手动模式可精确控制 casting，后续生成首尾帧时也更容易从主体库里挑到明确类型的人物。

问题：相似主体默认一次生成 10 张，旧后端只在整包全部成功后才写入 subject_assets；只要其中某个视角失败，前面已生成的图也不会显示。前端默认“不用模板”时仍渲染整块模板网格，也会把生成按钮和结果区域压到可视区域下方。

改动：generate_subject_assets 改为逐视角容错：单张失败时继续生成下一张，并把已成功的主体图写回 state，返回“部分生成完成”；只有一张都没成功才返回错误。SourceReferenceBuildPanel 在“不用模板”模式收起模板网格，已有主体缩略图优先显示在生成区顶部，并在生成中显示锁定的素材 ID，明确切换其他模块不会改变本次请求。

影响：用户不再因为一个视角失败而看到空结果；默认源视频创新路径下，生成按钮和主体缩略图更容易在当前屏幕内看到。

问题：前端模型弹窗和状态文档对音频、产品、相似主体、脚本改写和视频入口的描述过于简化，容易误解为所有模型调用都会成功、都会上传参考图或会直接提交视频。

改动：ModelTrace 文案改成真实链路：ASR 是远端 whisper、本机 mlx_whisper、Gemini 多模态三级；翻译失败会保留原文时间轴；音频画像使用 audio.wav + 转写时间轴并有本地估算兜底；产品识别批量失败会单图重试再写本地默认视角；相似主体先用 GPT 视觉 brief，有参考帧时再带参考图走 /images/edits；脚本改写全部模型失败后用本地模板；视频入口当前主工作台暂停直接提交。

影响：web/components/ad-recreation-board.tsx、web/components/dashboard.tsx、api/README.md、.project.json、.memory/status.md 和本页同步按实际后端行为描述，后续排查模型问题时优先看弹窗里的“兜底/失败行为”。

问题：旧个人语音通道虽然已不再作为活动路径，但仓库里仍有健康检查字段、前端类型、环境注释和文档历史文字残留，容易被误认为可用模型方案。

改动：/health 不再返回旧语音通道相关字段；web/lib/api.ts 删除对应类型；api/.env.example、deploy/.env.production.example、RULES.md、.memory/status.md 和本页移除相关名称和配置引用。语音只保留 Azure OpenAI TTS。

影响：后续模型分工里只描述 Azure OpenAI TTS；不要再把个人语音通道作为候选、fallback 或环境变量方案。

问题：语音生成测试失败时无法区分是 Azure OpenAI TTS 路径配置不对，还是整条语音服务不可用；同时 TTS 分支仍可能被环境变量或前端文案误导。

改动：后端固定 VOICE_PROVIDER=azure_openai，删除旧 TTS 活动配置和 fallback；_azure_openai_tts_sync 改为按 AZURE_TTS_PATHS 依次尝试多个 OpenAI-compatible 语音路径，失败时返回每个 URL 的 HTTP 状态或连接错误。/health 新增 models.voice_tts_paths。

影响：后续排查语音时先看失败信息里的路径和状态码：如果所有路径 404/405，优先调 AZURE_TTS_PATHS；如果连接/鉴权/上游错误，则按 Azure 语音服务可用性或 Key 排查。前端和状态文档不再展示旧语音方案。

问题：关键帧画面理解和分镜/口播改写仍可能被旧环境变量覆盖到 Gemini，不符合后端模型分工。

改动：api/main.py 新增 GPT_TEXT_MODEL / gpt_model_env，默认 VISION_MODEL、REWRITE_MODEL 和 AUDIO_REWRITE_MODEL 为 gpt-4o；旧 gemini-* 覆盖值会自动归一化回 GPT。

影响：/health 会向前端模型标注暴露 GPT 模型名；Gemini 仅保留在 ASR fallback / 翻译链路。

问题：相似主体生成把最多 10 张源视频帧或模板图作为 image[] 上传给 /images/edits，参考图视觉权重过强，结果容易变成源视频人物或内置模板的复刻品。

改动：generate_subject_assets 当时在 reconstruction_mode=similar 时先用 VISION_MODEL 把关键帧、内置形象或数据库模板转成非身份化文字 brief，再调用 gpt-image-2 的文字生图路径；后续当前转换层已有参考帧时会改走 /images/edits 图像参考路径。same 模式保留 image-edit 源形象锁定路径。SubjectTemplateItem 和内置形象 manifest 新增 prompt_brief，保存模板时会从生成视图反推 brief。前端 SourceReferenceBuildPanel 改成“用模板 / 不用模板”模式开关、120px 竖排模板卡、底部一行保存表单，以及独立的“生成主体视图”区域，支持全部 10 / 常用 4 / 自定义视图。

影响：后续说“相似主体”应理解为文字 brief 驱动的创新生图，不是把关键帧或模板图送去 image edit 复制。需要精确复刻时必须显式走 reconstruction_mode=same。

问题：工作台已对齐登录页暗色质感，但长时间编辑分镜、产品图和首尾帧时，需要一个更亮的检查环境，方便看表格、缩略图和文案密度。

改动：AdRecreationBoard 顶部增加“明亮/暗色”切换按钮，使用 localStorage["skg-board-theme"] 记住用户选择；globals.css 增加 skg-board-theme--light，把暗场玻璃面板映射为暖白底、浅绿金色光感、深色文本和浅色边框，保留登录页同源的材质感。

影响：只改变工作台视觉模式，不改变素材下载、音频解析、抽帧、主体模板、产品素材池、首尾帧或模型链路；web/app/page.tsx 同步移除旧全局浮动主题按钮，避免右下角出现第二套不相关的主题入口。后续新增图片/视频板块仍应复用同一套媒体悬停放大和删除逻辑。

问题：生产验收要求音频解析走微软 Azure OpenAI，而不是远端失败后静默落到容器内 faster-whisper 或 Gemini 多模态兜底。

改动：api/main.py 增加 ASR_LOCAL_FALLBACK_ENABLED 和 ASR_AUDIO_FALLBACK_ENABLED 两个运行期开关；GET /health 回传这两个值。生产示例把 ASR_BASE_URL 固定为 https://ai.skg.com/azure/v1，ASR_MODEL 固定为 gpt-4o-transcribe，并关闭本地 / 多模态兜底。

影响：微软 ASR 未部署或部署名不匹配时，音频步骤会直接暴露 Azure 的错误，例如 DeploymentNotFound；不会再用其它通道生成看似成功的逐句时间轴。

问题：生产只配置 LLM_BASE_URL=https://ai.skg.com/ezlink/v1，文本网关不一定提供 /audio/transcriptions 文件上传接口，导致音频文案步骤无法真实转写。

改动：api/main.py 新增 ASR_BASE_URL / ASR_API_KEY 和独立 ASR OpenAI client；音频转写只通过该 client 上传 audio.wav，不再绑死 LLM_BASE_URL。deploy/.env.production.example 增加生产 ASR 网关示例。

影响：文本/视觉模型仍走 LLM_BASE_URL，音频文件上传可单独切换到支持 Audio Transcriptions 的网关；/health 会回传 asr_base_url 供排障。

补充：当云端音频网关不兼容 OpenAI Audio Transcriptions 时，可设置 ASR_REMOTE_ENABLED=false，直接使用容器内 faster-whisper 做 CPU 转写。

问题：云端全流程中远端 whisper-1 转录可能长期停在“转录中”，页面没有 transcript，也不会进入后续分镜。

改动：api/main.py 的远端 ASR、Gemini 音频转写兜底和音频画像调用改为 llm().with_options(timeout=ASR_TIMEOUT_SECONDS) 后再发起请求，避免只在调用参数里传 timeout 时被兼容网关或 SDK 路径忽略。

影响：远端 ASR 超时后应进入本机 ASR 或多模态音频兜底，并最终给出成功 transcript 或明确失败状态；不会无限占用“音频文案”步骤。

问题：生产环境没有桌面浏览器，不能依赖 YTDLP_COOKIES_FROM_BROWSER 读取本机 Chrome 登录态；受限 TikTok 链接仍会在云端返回“Log in for access”。

改动：docker-compose.prod.yml 将宿主机 ./secrets/tiktok_cookies.txt 挂载到 API 容器 /run/secrets/tiktok_cookies.txt；deploy/.env.production.example 默认设置 YTDLP_COOKIES_FILE=/run/secrets/tiktok_cookies.txt；.gitignore 忽略 secrets/，避免 cookies 入库。

影响：云端只需要维护一个服务器私有 cookies 文件，配置后可对失败素材执行“重新下载”；yt-dlp 会在任务结束时回写 cookies，因此该挂载不能设为只读。cookies 过期时更换该文件并重启 API 容器即可。

问题：部分 TikTok 链接会返回“Log in for access”，后端已经接到任务并创建 job，但裸 yt-dlp 下载没有登录态，任务只能失败；失败素材再次点击“开始分析”也没有重新触发下载。

改动：api/main.py 新增 YTDLP_COOKIES_FILE / YTDLP_COOKIES_FROM_BROWSER 和 POST /jobs/{id}/download/retry。web/lib/api.ts 新增失败文案格式化和 retryJobDownload；web/app/page.tsx 在失败素材上清掉自动触发标记，无 video_url 时重新下载，有 video_url 时重新跑音频和视觉路；AdRecreationBoard 按状态显示“重新下载 / 重新解析”。

影响：用户无需删除素材再粘贴同一链接；配置 cookies 后可直接对原失败素材重新下载。cookies 属于敏感登录态，只能放本机或服务器私有路径。

问题：登录页已经形成黑底、草场绿、SKG 金色和玻璃登录卡片的质感，但进入工作台后仍偏黑红/青色，前后像两个不同系统。

改动：AdRecreationBoard 根节点增加 skg-board-theme，顶部、流程条、素材列和主工作区使用 skg-board-panel / skg-board-topbar；globals.css 增加暗场径向光、细网格、金绿边框、玻璃阴影和金色 focus 状态。流程状态和主按钮从玫红/高饱和青色收敛到登录页同源的 SKG 金色与草绿色。

影响：这次只改颜色、质感和系统感觉，不改变素材输入、抽帧、音频解析、主体模板、分镜规划等功能链路。

问题：“相似主体 / 主体模板”之前把内置模板选择和本次生成结果混在同一块里；后端主体数据库可用后，前端需要真的支持“已有模板可复用、新生成主体可人工命名后入库”。

改动：SourceReferenceBuildPanel 拆成“主体模板库”和“本次生成 / 入库草稿”两块：左侧同时读取 GET /subject-templates 数据库模板和 GET /character-library/skg 内置形象；右侧可填写模板名称、备注，并通过 POST /jobs/{id}/subject-templates 把本次生成主体视图保存入库。generateSubjectAssets 新增 subject_template_id，可用数据库模板继续生成新的相似主体。

影响：后续主体复用流程应理解为：先从数据库模板库选已有形象或用源视频关键帧生成新主体；新主体只有在人工确认、命名和备注后，才进入主体模板库供其他二创任务复用。

问题：参考帧池和右侧“已选关键帧”展示同一批图，造成重复占位；后续主体生成本来就是读取 selectedFrames，不需要第二套图片列表。

改动：SourceKeyframePicker 删除右侧已选栏，把空间还给参考帧池。参考帧缩略图自身用勾选状态表示是否已选，顶部只显示“已选 X / 默认全部”的数量提示。

影响：后续调用逻辑不变：有勾选就只传勾选帧，没有勾选就默认使用全部参考帧。

问题：关键帧和已选关键帧放在源视频工作区下方，用户看字幕时间轴时还要上下跳，下面主体生成区也被关键帧池占掉太多空间。

改动：AudioIntakePanel 在逐句时间轴左侧新增 SourceKeyframePicker，把参考帧池、已选关键帧、自动抽帧 12 张、删除关键帧和 hover 放大都放到时间轴旁。SourceReferenceBuildPanel 去掉下方重复关键帧池，改成只展示“相似主体 / 主体模板”、内置形象选择、主体类型、统一方向和生成后的相似主体白底视图。

影响：后续这里应理解为“上方完成源视频观看、字幕对齐和关键帧选择；下方只做主体模板和主体资产生成”。

问题：原版视频预览偏小，用户看人物动作和手动抽帧点不够直观；关键帧勾选后只在原网格里变状态，不方便确认实际会传给相似主体重构的帧。

改动：AudioIntakePanel 把原版竖屏视频列和播放器高度放大一档。SourceReferenceBuildPanel 在关键帧网格右侧新增“已选关键帧”窄列，点击左侧关键帧会同步出现在右侧，点击右侧缩略图可取消选择；没有选择时仍默认用全部关键帧。

影响：后续描述这里时，可以把左侧理解为“全部参考帧池”，右侧理解为“本次主体重构将使用的已选帧”。

问题：页面里的 01、02 只是硬编码视觉标签，用户无法判断编号代表什么流程，也看不出每一步是按什么条件通过、运行、阻塞或暂停。

改动：AdRecreationBoard 新增 buildWorkflowSteps，统一定义 01 素材输入、02 源视频下载、03 音频文案、04 抽帧参考、05 相似主体、06 产品素材池、07 分镜文案、08 画面首尾帧、09 视频候选。顶部新增 WorkflowOrderBar 展示顺序、状态和判定依据；素材输入、源视频区、四路状态条、产品素材池、分镜文案、画面规划和视频候选列共用 WorkflowStepBadge / PipelineLane 的同一编号。

影响：以后说“改 03 音频文案”或“08 首尾帧怎么判定”时，可以直接定位到这套步骤配置；编号不再散落在 JSX 里。

问题：首尾帧不能直接把全部主体视图和产品图丢给模型；每条视频真正需要先确定场景、人、产品和动作，再按需求选择人物参考视角。产品特写不需要人物时，也不能被后端默认强加透明骨架人。

改动：AudioStoryboardPlanPanel 的每条分镜补充可编辑人物描述；没有描述时按分镜角色自动补统一相似主体说明。selectSubjectRefsForRow 会根据人物描述、镜头类型、首尾帧状态、佩戴/后颈/近景等关键词，从已生成的 6/10 张主体视图里自动选择最多 5 张最相关视角。后端 generate_scene_asset 只有收到主体图时才加人物身份约束；没有主体图时不会给产品特写硬塞透明骨架人。

影响：后续描述需求时应把人物理解为“主体资产池里按镜头需求调度视角”，不是“每条首尾帧都传全部人物图”。

问题：每新增图片/视频板块都临时写缩略图，导致 hover 放大、删除按钮、预览浮层层级和图片完整显示规则反复不一致。

改动：新增 web/components/media-asset-tile.tsx 作为项目内媒体素材基底组件，并把当前主路径的关键帧、相似主体图、产品素材图、首尾帧和历史视频候选接入同一套缩略图、顶层 hover 预览、删除/重生按钮和忙碌遮罩逻辑；AGENTS.md 与 RULES.md 同步新增媒体素材 UI Contract。

影响：以后当前项目凡是图片、视频、抽帧、产品图、AI 生成图、首尾帧或视频候选，默认不能再手写孤立交互；只允许在统一组件参数上调整尺寸和显示内容。

问题：分镜还没有真实首尾帧时直接一键提交视频，会把几十上百条视频任务一次性打到 Seedance，成本不可控；同时旧逻辑还会把关键帧继续当作后续视频参考，偏离“关键帧只用于主体重构”的新流程。

改动：AudioStoryboardPlanPanel 取消当前主路径里的“生成本条 · Seedance”和“一键提交全部”，改成“保存本条规划 / 保存全部规划”。画面规划列新增 EndpointFrameSlot 首尾帧闸门，按行生成首帧和尾帧；endpointAssetRef 忽略旧的 keyframe 首尾帧，只认可 asset 类型首尾帧。generateEndpointFrameForRow 调用 generateSceneAsset，传相似主体白底视图和按行挑选的产品图。web/app/page.tsx 加暂停保护，旧视频回调误触也不会请求视频接口。

影响：后续正确链路是“抽帧选主体 → 生成相似主体视图 → 上传/识别产品 → 写新口播和画面规划 → 逐条生成首尾帧 → 人工审核首尾帧 → 再开放单条视频生成”。历史视频候选仍展示，但不会继续自动追加。

问题：信息流复刻不应该等音频字幕完成后才抽帧；字幕是分镜文案前置条件，但主体参考帧和产品资产可以并行准备。旧体验让用户感觉流程线性且复杂。

改动：web/app/page.tsx 新增并行启动逻辑：视频下载完成后触发 triggerTranscribe 解析音频，同时触发 analyzeJob 自动抽 12 张参考帧。api/main.py 允许抽帧在音频转写状态下排队执行，并在音频路已运行时跳过重复拆音轨，避免并发写同一个 audio.wav。AdRecreationBoard 顶部新增音频文案路、视频视觉路、主体资产和产品资产状态条，素材输入按钮改成“开始分析”。

影响：当时 AudioStoryboardPlanPanel 新增“一键提交全部”以验证批量提交思路；该视频提交入口已在后续“首尾帧闸门”改动中暂停，当前主流程只保存规划并先生成首尾帧。

问题：“画面规划 / 产品融入”默认把每句都理解成产品 + 人物视频，导致痛点铺垫、场景过渡和产品特写无法按信息流广告真实节奏拆开。

改动：AudioStoryboardPlanPanel 每行新增镜头类型、人物/产品开关、首帧规划、尾帧规划和产品出现方式；默认按角色把开场/痛点设为人物情绪、利益证明设为人物+产品、转化收口设为产品特写。StoryboardScene 新增 visual_mode、needs_product、needs_subject、first_frame_plan、last_frame_plan 和 product_placement，后端保存到 state.json。

影响：web/components/ad-recreation-board.tsx、web/app/page.tsx、web/lib/api.ts、api/main.py、RULES.md、docs/source-analysis.html。单条生成时，只有勾选产品才会自动选最多 6 张产品图；只有勾选人物才会传相似主体参考图，避免不需要产品/人物的镜头被硬塞错内容。

问题：相似主体高清视图包调用 gpt-image-2 时出现 ConnectError: nodename nor servname provided。排查确认 IMAGE_BASE_URL 配置正确、模型列表可访问，错误发生在连接层；本地 launchd 启动的 API 进程没有稳定继承交互 shell 的代理环境。

改动：api/main.py 新增 AI_HTTP_PROXY / IMAGE_HTTP_PROXY 支持，OpenAI-compatible client 和所有图片 /images/edits / 图片 URL 下载统一走 ai_http_client。/health 新增 models.ai_proxy_configured，只显示是否配置代理，不暴露代理地址。图片 DNS、ConnectError、连接拒绝、网络不可达等传输层失败会归类为 503，并提示检查本机网络或在 api/.env 配置代理后重启后端。

影响：api/main.py、api/.env.example、deploy/.env.production.example、RULES.md、docs/source-analysis.html。后续如果生图失败但模型名仍是 gpt-image-2，先区分 429 上游饱和、400 参数错误和 503 网络/代理错误，不要直接改 prompt 或换模型。

问题：相似主体仍按“6 视图”理解，只覆盖全身角度；肩颈按摩设备需要更清晰的脖颈、肩线、后颈和上背特写。桌面已有 5 套策划好的透明骨架形象，但主工作表没有提供内置形象选择。

改动：SourceReferenceBuildPanel 在“相似主体白底视图”中加入 5 套内置形象选择，默认仍可走源视频相似，选择内置形象后把 character_id 传给 generateSubjectAssets。主体生成默认请求 10 张 2048 高清图，包含全身多视角、肩颈正/左右近景和后颈肩背特写。后端不再把主体多参考图拼成参考板，而是把内置形象图和关键帧作为独立 image[] 交给 gpt-image-2，并在 prompt 中明确“创新变体，不照抄”。

影响：api/main.py、web/lib/api.ts、web/components/ad-recreation-board.tsx、RULES.md、docs/source-analysis.html。后续描述这个功能时应叫“相似主体高清视图包”，不要再只说 6 视图。

问题：同一产品素材池的视角标注仍显示通用 Vision 模型；缺角度补图固定拿第一张产品图作为参考，少侧面或内侧时容易用错误视角硬推，生成结果偏离产品真实结构。

改动：api/main.py 新增 PRODUCT_VIEW_MODEL=gpt-image-2，analyze_product_view / analyze_product_views_batch 改用该模型并在 /health 返回 models.product_view。generateProductAngleAsset 前端请求新增 source_refs 和 source_notes；AudioStoryboardPlanPanel 按目标视角给产品图打分，优先真实上传图、相邻视角、用途标签、置信度和低风险图，最多传 6 张。后端把多张参考图作为独立 image[] 提交给 gpt-image-2 生成目标角度，避免只照抄第一张，也避免参考板被模型当成拼图格式。

影响：api/main.py、web/lib/api.ts、web/components/ad-recreation-board.tsx、RULES.md、api/.env.example、deploy/.env.production.example、docs/source-analysis.html。后续补产品角度必须从同一产品素材池里挑多张证据图，不要再默认第一张。

问题：产品补角度遇到 gpt-image-2 上游 429 saturated 时，后端只间隔 1 秒重试 3 次，很容易直接失败；相似主体重构还把参考图作为 JSON image 参数提交到 /images/generations，在 GPT 图片接口下会返回 Unknown parameter: 'image'。

改动：_image_edit_call 和旧分镜图生图入口改为调用 /images/edits，用 multipart image 文件传参考图，继续固定模型 gpt-image-2。图像调用新增 429 / saturated 识别和退避重试；产品补角度单次请求提高到 5 次尝试，耗尽后返回 503 和“上游负载饱和，请稍后重试”的可读错误。web/lib/api.ts 对产品补角度和主体资产接口解析 FastAPI detail，不再把整段 JSON 原样堆进 toast。

影响：api/main.py、web/lib/api.ts、docs/source-analysis.html。后续生图仍然只走 gpt-image-2，但图生图必须走 edits 形态，不能再往 generations JSON 里传 image。

问题：关键帧和相似主体白底视图缩略图仍偏大；主体 6 视图只能整组重生，某一张不准时无法单独替换；白底视图也缺少删除入口。竖版视频参考生成的主体图还需要明确保持竖版画布。

改动：SourceReferenceBuildPanel 把关键帧网格改成更小的自适应列，把白底主体视图改成 9:16 固定小缩略图；每个主体视图新增重生和删除按钮。前端只展示每个 view 的最新一张；单张重生调用 generateSubjectAssets 并传 views=[当前 view] 与 replace_views=true，不会追加成第 7 张。后端 GenerateSubjectAssetsReq 新增 replace_views，并新增 DELETE /subject-assets/{asset_id}；竖屏参考帧会把 9:16 竖版画布要求写入 prompt，输出继续按源帧纵横比归一化。

影响：web/components/ad-recreation-board.tsx、web/lib/api.ts、api/main.py、docs/source-analysis.html。后续“重新生成某张主体图”应走同视角替换，不要追加多套六视图。

问题：部分生图路径仍保留 gpt-image-1.5 或 Gemini 图片模型 fallback，旧分镜生图区也还能选择 Gemini 模型；这会导致同一流程里不同图片入口走不同模型。

改动：api/main.py 把 GPT_IMAGE_MODEL、IMAGE_MODEL、SUBJECT_ASSET_IMAGE_MODEL 和 SUBJECT_ASSET_IMAGE_MODELS 全部锁定为 gpt-image-2；_image_edit_call、_image_text_call 和 /frames/{idx}/generate 即使收到旧前端 model 字段或旧 models 列表，也只使用 gpt-image-2。旧 Dashboard 生图选择器改成只展示 gpt-image-2，模型链路标注不再显示图片模型 fallback。

影响：api/main.py、web/components/ad-recreation-board.tsx、web/components/dashboard.tsx、api/.env.example、deploy/.env.production.example、RULES.md、docs/source-analysis.html。该阶段凡是“生图”，包括清洗、元素提取、主体 6 视图、产品补角度、首尾帧/场景图和旧分镜生图，都只能走 gpt-image-2；后续在保持 gpt-image-2 主模型不变的前提下增加了 Gemini 故障兜底。

问题：相似主体 6 视图生成后只能点击打开原图，不能像参考帧和产品图一样鼠标停留看大图；同时后端单张生成 prompt 里仍提到 six-view pack，容易让图片模型把多个视角拼进同一张图。

改动：SourceReferenceBuildPanel 给生成后的白底主体视图增加 createPortal 顶层悬停预览，缩略图保持小尺寸密排，停留时显示大图、视角标签和尺寸。generateSubjectAssets 把身份锁定说明改为“六视图属于同一主体，但每个输出文件只展示当前请求视角”，并为每次 view 生成加入单图规则，禁止 contact sheet、六视图拼图、多主体、多面板、标签或对比排版。

影响：web/components/ad-recreation-board.tsx、api/main.py、docs/source-analysis.html。后续用户说“6 视图”，应理解为 6 个独立图片文件，而不是一张六宫格大图。

问题：之前图片、文本、音频分析共用 LLM_BASE_URL，语音通道不够清晰，视频虽然已接豆包/Seedance，但模型标注没有把“生图 GPT / 语音 Azure / 视频 Seedance”三条高优先级链路清楚拆开。

改动：api/main.py 新增 IMAGE_BASE_URL、IMAGE_API_KEY、VOICE_PROVIDER、AZURE_OPENAI_BASE_URL、AZURE_OPENAI_API_KEY、AZURE_TTS_MODEL 等配置；图片调用改走图片专用 OpenAI-compatible client，文字生图走 /images/generations，图生图后续已收敛到 /images/edits，默认 gpt-image-2；TTS 新增 Azure OpenAI 协议 /audio/speech 通道，默认 VOICE_PROVIDER=azure_openai；GET /health 回传图片、主体、语音和视频的实际模型与 base URL 供前端模型标注使用。

影响：api/main.py、web/lib/api.ts、RULES.md、.project.json、docs/source-analysis.html。真实 key 仍只写本地 api/.env / 生产环境变量，不能入库。

问题：“相似透明骨架主体”实际已经在后端生成并写入 job，但前端的相似主体识别只匹配“相似主体 / similar subject”等窄名称，无法命中“相似透明骨架主体 / similar transparent skeleton humanoid subject”，所以界面仍显示 0/6，重复点击还会新增重复元素。同时 6 视图模型链路仍跟随通用 IMAGE_MODEL，默认显示 Gemini 图片模型，不符合主体资产必须走 GPT 图片模型的要求。

改动：api/main.py 新增 GPT_IMAGE_MODEL、SUBJECT_ASSET_IMAGE_MODEL 和 SUBJECT_ASSET_IMAGE_MODELS，当时把 generateSubjectAssets 切到 GPT 图片链路；后续已进一步收敛为所有生图入口都只使用 gpt-image-2。GET /health 返回 subject_image 和 subject_image_fallbacks。web/components/ad-recreation-board.tsx 扩大相似主体元素匹配规则，并在优先帧找不到时回退到全局关键帧里查找已生成主体资产，避免图片被当前选择集隐藏；模型标注改为显示主体专用 GPT 图片链路。

影响：api/main.py、web/lib/api.ts、web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续主体 6 视图不应复用通用补图模型链，必须走主体资产专用 GPT 图片模型配置。

问题：音频解析、产品识别、补图、6 视图、脚本改写和生视频都会调用模型，但界面没有明确显示当前使用哪个模型，也看不到调用链路和回退逻辑。

改动：api/main.py 的 GET /health 扩展返回 local_asr、vision、image 和 image_fallbacks；web/lib/api.ts 新增 RuntimeHealth、RuntimeModels 和 getRuntimeHealth；web/components/ad-recreation-board.tsx 新增 ModelTrace，在主路径每个模型动作旁直接显示模型名，点击后弹出小窗口显示逻辑链路。

影响：api/main.py、web/lib/api.ts、web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续任何新增模型动作都必须同时接入 ModelTrace，不要只在代码里隐藏模型名。

问题：“生成 6 视图”只有在用户先手动勾选关键帧后才可点击；但当前流程里自动抽出的 12 张帧本身就是相似主体参考池。生成提示也偏普通广告演员，没有锁定透明骨架人这类主体的透明皮肤、可见骨架和统一身份。

改动：SourceReferenceBuildPanel 改为有关键帧即可生成：未勾选时默认使用全部关键帧，勾选后只用已选帧；生成区新增“透明骨架 / 普通真人”主体类型和统一方向输入。generateSubjectAssets 后端提示词新增 identity lock，要求六视图先锁定同一个主体设定，再保持同一性别表现、年龄段、体型、材质、风格和视觉身份；透明骨架模式必须保持透明皮肤包裹白色骨架，且排除普通真人、纯骷髅和恐怖/医疗解剖风。

影响：web/components/ad-recreation-board.tsx、api/main.py、docs/source-analysis.html。后续这块不要再理解成“抽帧后复制人物”，而是“抽帧提供主体证据，再生成统一的新相似主体六视图”。

问题：顶部“音频文案依据 / 当前步骤 / 音频解析结果”仍然抢占主操作空间；左侧素材列重复放横版原视频预览，竖版视频会产生大黑边；“自动抽帧”入口不够显眼，用户会误以为能力被去掉。

改动：AdRecreationBoard 把状态压成紧凑标签，文案依据保持默认折叠；MaterialColumn 不再重复显示原视频预览；AudioIntakePanel 把音频解析结果改成默认折叠，主区域改为左侧 9:16 竖版播放器、右侧音频波形 + 逐句时间轴，播放器内覆盖“当前点抽帧”；SourceReferenceBuildPanel 保留并强化“自动抽帧 12 张”主按钮，缩略图更小更密，下面再放相似主角 6 视图。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续源视频分析先看竖版播放器、波形和逐句时间轴；参考帧池负责自动 12 帧、手动补帧后的删除和相似主角选择。

问题：参考帧区占在原视频和逐句时间轴中间，导致视频和字幕联动不直观；抽帧缩略图仍偏大，一屏可比较的帧数少；“生成 6 视图”和抽参考按钮平齐，语义上像同一级操作。

改动：AudioIntakePanel 改成上层“原版视频 + 逐句时间轴”左右排列，下层 SourceReferenceBuildPanel 横向铺开参考帧；时间轴侧栏改成时间 + 原文/中文双行，减少宽度占用；参考帧缩略图用 6/8/12 列响应式排列；“生成 6 视图”移动到相似主角白底视图区。AudioWaveform 新增鼠标悬停时间回传，标题栏显示当前播放、总时长和指针停点秒数。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续查看原片时先看视频和右侧逐句时间轴；参考帧池是下一行横向候选区。

问题：“当前点抽帧”放在关键帧池顶部不符合操作路径；抽出来的竖版画面被小缩略图裁切，用户无法快速判断整张帧是否适合做主角/动作参考。

改动：AudioIntakePanel 把“当前点抽帧”移动到原版视频标题栏右侧，并扩大原视频、参考帧和时间轴这组区域高度；SourceReferenceBuildPanel 只保留批量抽参考、生成 6 视图和删除，缩略图改为 aspect-[9/16] + object-contain 完整显示，鼠标停留时用 createPortal 在最上层展示放大完整帧。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续需要补某一秒画面时从视频播放器操作；需要判断帧内容时直接悬停缩略图看大图。

问题：上一版把原视频旁的自动抽帧从动作峰值改成人物主体后，结果更偏中心清晰画面，少了之前信息流广告需要的手势、表情、节奏点和镜头变化。

改动：SourceReferenceBuildPanel 的按钮改为“抽参考 12 帧”，调用 analyzeJob 时恢复使用 target=motion、quality=accurate、mode=replace。人物仍然是后续相似主角重构的选择对象，但自动抽帧不再只按清晰主体排序。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续这里的自动 12 帧应理解为“广告动作/节奏参考帧池”；若某个具体人物画面没抽到，用“当前点抽帧”手动补。

问题：原版视频区域偏小，只能看和播放；如果需要补某个具体画面，用户必须重新跑 12 帧抽取，并且抽错后缺少直接删除入口。

改动：AudioIntakePanel 放大原视频列和视频高度，并把逐句时间轴压成较窄侧栏；当时 SourceReferenceBuildPanel 接收当前播放秒数并提供“当前点抽帧”，后续已移动回原视频标题栏；关键帧缩略图右下角新增删除按钮，复用 deleteFrame，并展示全部已抽帧而不只截取前 12 张。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续描述这里时，应把原版视频旁的关键帧区理解为“广告参考帧池”，支持自动抽参考帧、按播放点补帧和单帧删除。

问题：原版视频旁的主动抽帧仍按动作变化优先，不符合当前“主体是人物”的相似主角流程；逐句时间轴侧栏也占用过多横向空间，挤压原视频和关键帧区。

改动：SourceReferenceBuildPanel 的“抽取 12 帧”改为“抽人物 12 帧”，调用 analyzeJob 时使用 target=subject、quality=accurate、mode=replace；AudioIntakePanel 的三列布局把逐句时间轴固定成较窄侧栏，把空间让给原视频和关键帧 / 相似主角区域。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续这里的 12 张关键帧默认是人物主体参考，不再按纯动作峰值理解。

问题：分镜行前面的“分镜 / 原内容”信息量很少，却占了过多横向空间；右侧 6 个视频候选槽被压成拥挤的 2x3 小格。

改动：AudioStoryboardPlanPanel 的行 grid 改为前两列固定窄列，宽屏下视频列固定放大；StoryboardVideoSlots 从 3 列 2 行改为一排 6 个竖版候选预览。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续这个区域按“工作表高密度排版”处理，低信息字段不再占大列宽。

问题：产品图文件虽然已写入 jobs/<jobId>/assets，但产品素材池列表、识别结果、备注和 AI 补图只存在前端 React state；代码热更新、刷新或切换任务后会清空，用户需要重新上传和重新计算。

改动：Job 新增 product_refs；后端新增 PUT /jobs/{id}/product-refs，前端新增 saveProductRefs。AudioStoryboardPlanPanel 在上传、识别、补图、备注编辑和删除时同步保存产品素材池，组件重新挂载时从 job.product_refs 恢复。

影响：api/main.py、web/lib/api.ts、web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续更新 UI 或重启本地服务不应再清掉用户已上传的产品图和标注。

问题：分镜行里的“参考帧 / 关键元素”会把抽帧、人物参考和单条生成混在每一行里，占空间，也容易让用户误解为要逐行抽取并复刻源视频人物。

改动：AudioIntakePanel 在原版视频旁新增 SourceReferenceBuildPanel：一键重新抽取 12 张关键帧，人工选择主角参考后生成 6 张白底相似主角视图；AudioStoryboardPlanPanel 移除每行参考帧/关键元素列，生成视频时按全局关键帧池匹配当前句时间点。generateSubjectAssets 新增 subject_style=source_actor 与 reconstruction_mode=similar，用于生成类似但不复刻的正常广告演员。

影响：api/main.py、web/lib/api.ts、web/components/ad-recreation-board.tsx、docs/source-analysis.html。旧透明骨架人主体资产仍保留默认模式；信息流主流程的相似主角不走透明骨架人 prompt，也不做像素提取或精确身份复刻。

问题：“原内容 / 新口播文案”两列占用空间偏多，并且新口播只是固定模板，不能按作者想法或原片节奏继续改写；单条生成前也无法微调文案。

改动：AudioStoryboardPlanPanel 在脚本区上方新增作者想法输入、整片改写和还原初稿；每行新口播改成可编辑 textarea，并提供“单段改写”。新增 POST /jobs/{id}/script/rewrite 和前端 rewriteStoryboardScript，后端根据原参考文案、当前新文案、分镜角色、时间段和作者想法返回中文口播。

影响：api/main.py、web/lib/api.ts、web/components/ad-recreation-board.tsx、docs/source-analysis.html。当前改写结果是页面级脚本状态，保存规划或生成首尾帧时会写入对应 StoryboardScene.action；后续如果要刷新后保留，应新增 job 级脚本草稿持久化字段。

问题：旧识别只要求模型在“正面/左45/右45/侧厚/触点/背底”里选一类，没有说明这是套在脖子上的 U 形肩颈按摩仪，也没有定义佩戴者左/右、上/下、贴颈内侧和外壳外侧，容易把图片左右当成产品左右，后续生视频会把局部细节和方向搞乱。

改动：api/main.py 将 analyzeProductViews 改为同一产品多图批量识别，prompt 固定产品为挂脖肩颈按摩仪，并新增 orientation 和 landmarks 输出；单图兜底 prompt 也同步要求产品坐标系。web/lib/api.ts 扩展 ProductViewAnalysisItem；ProductReferenceCard 展示“方向已识别”和结构点，悬停预览显示方向、结构和风险。

影响：首尾帧生成和后续单条视频生成时，buildStoryboardSceneFromAudioRow 会把“左/右按佩戴者身体左右，上/下按佩戴方向，内侧=贴颈触点，外侧=外壳按键”作为硬规则写入产品提示，并把每张选中产品图的方向和结构点一并交给模型。

问题：产品素材池底部图片悬停时，放大预览仍在滚动容器内部，容易被产品区或分镜框架裁掉；预览尺寸也偏小，不利于检查肩颈产品厚度、触点和左右差异。

改动：ProductReferenceCard 将悬停预览从卡片内绝对定位改为 createPortal(document.body) 渲染的固定浮层，宽度提升到最多 380px，并根据鼠标位置自动避开视口底部和右侧。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续产品图检查应继续使用该顶层预览，避免把预览重新放回带 overflow 的滚动容器里。

问题：同事容易把“上传最高清”理解为最好，但超大原图会拖慢上传、识别和后续生图/生视频，而且并不会让模型更稳定；低分辨率图也需要被标出来，避免后面误以为细节可靠。

改动：api/main.py 新增 normalize_product_asset_image，产品图上传和产品图库复制都会生成统一 AI 工作副本：最长边 1600px、JPEG 92，推荐原图长边 1200-2000px、短边至少 600px。超大图自动压缩，低分辨率图自动放大并标风险，透明底铺白；黑底/白底背景本身不强行转换。接口返回 ImageRef.asset_meta 记录原尺寸、工作图尺寸、自动动作和警告。

影响：web/lib/api.ts 增加 asset_meta 类型；ProductReferenceCard 展示工作图尺寸、“已标准化”和“需留意”标签，悬停预览里显示规格风险。后续视频/图片生成应优先使用该工作副本，不把超高清原图直接交给模型。

问题：产品图识别不能只知道“正面/侧面”，下一步生视频需要知道哪些图适合作为主外观、佩戴比例、触点、厚度、按键或材质参考；同时用户已确认上传图属于同一产品，不需要做不同产品身份识别。

改动：POST /jobs/{id}/assets/product-views/analyze 扩展返回 background、use_tags、risk。前端 ProductReferenceCard 展示背景、用途标签和风险标记；selectProductItemsForRow 从单纯按视角轮转改为按分镜角色、视角优先级、用途标签、置信度和风险评分，自动挑选最多 6 张产品参考图。

影响：api/main.py、web/lib/api.ts、web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续接入图库时，图库只负责确定同一产品身份；这里继续负责该产品多图的角度、背景、用途和生视频风险标注。

问题：视觉模型有时能判断视角，但返回的 JSON 含换行、引号或尾部格式问题，后端直接 json.loads 会失败，导致整张图被标成“识别失败”。

改动：api/main.py 新增 parse_product_view_response：先按严格 JSON 解析，失败后从原始输出里容错提取 view、note 和 confidence。同时收紧产品视角识别 prompt，要求模型输出单行 JSON。

影响：POST /jobs/{id}/assets/product-views/analyze 在模型输出不完全规范时也能保留视角结果，减少无意义 fallback；真正无法识别时才按上传顺序兜底。

问题：产品白底图不能固定最多 6 张。后续分镜很多，产品参考图应作为可持续扩充的素材池；但单条视频生成时也不能把素材池里的全部图片都提交给 AI。

改动：AudioStoryboardPlanPanel 移除上传数量上限，产品参考区改为不限量素材池，并用滚动网格承载更多图片。analyzeProductViews 和后端 POST /jobs/{id}/assets/product-views/analyze 不再只处理前 6 张；自动补缺失视角也不再因为已有 6 张素材而停止。新增 selectProductItemsForRow，单条分镜生成时按分镜角色、视角优先级和行号轮转，从素材池中自动挑选最多 6 张相关产品图写入 StoryboardScene.product_images。

影响：api/main.py、web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续需求应区分“产品素材池可无限上传”和“单条生成实际提交的产品参考图集合”。

问题：产品图上传后还让用户手动选择正面、45 度、侧面等视角，操作成本高，也容易把后续生视频的产品结构约束标错；缺失角度也不应该再让用户逐个判断后点击。

改动：新增 POST /jobs/{id}/assets/product-views/analyze 和前端 analyzeProductViews。AudioStoryboardPlanPanel 在上传产品白底图后自动识别每张图的视角、写入中文备注和置信度，再自动调用 generateProductAngleAsset 补齐缺失视角。ProductReferenceCard 移除视角下拉，改为只读“自动识别/自动补图”标签，用户只检查备注；MissingProductViewSlot 只作为自动补图失败后的重试入口。

影响：api/main.py、web/lib/api.ts、web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续描述需求时应说“自动识别/补图后的备注是否准确”，不要再按“手选产品视角”理解这个区域。

问题：只上传产品白底图还不够，生成视频前需要明确每张图是什么视角、有哪些结构重点；如果某些视角没拍到，也需要通过 AI 先补出可用参考图。

改动：AudioStoryboardPlanPanel 的产品参考区升级为产品视角工作台：每张图都有视角下拉和备注输入，鼠标悬停显示放大预览；缺失视角显示独立占位，并提供“AI 补角度”。新增 POST /jobs/{id}/assets/product-angle 和前端 generateProductAngleAsset，基于已有产品图生成缺失的白底产品视角。单条视频生成会把每张产品图的视角备注写入 StoryboardScene.product，用于约束左右非对称、厚度、内侧触点和肩颈佩戴比例。

影响：api/main.py、web/lib/api.ts、web/components/ad-recreation-board.tsx、docs/source-analysis.html。AI 补角度生成的新图保存在 jobs/<jobId>/assets，作为普通 ImageRef(kind="asset") 参与后续分镜视频生成。

问题：分镜行前半段占用横向空间偏多，右侧视频候选位太少；同时肩颈产品不是完全对称结构，只靠默认产品图容易生成左右一致、比例不准或佩戴尺寸跑偏。

改动：AudioStoryboardPlanPanel 顶部新增产品白底图上传条，建议上传 5 张、最多 6 张：正面、左 45、右 45、侧面厚度、内侧触点/佩戴比例，非对称明显时补背面或底部。分镜行前几列压缩宽度、字号和缩略图高度；右侧视频区改为 6 个候选槽，便于多次生成和筛选。生成本条时会把上传的产品图写入 StoryboardScene.product_images，并把“保留左右非对称、肩颈真实比例”加入产品融合提示。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。产品白底图当前作为当前页面会话内的复刻参考，单条生成时持久化进对应关键帧分镜；后续如果要跨刷新保留全局产品图组，应新增 job 级产品参考字段。

问题：信息流复刻不应该先全量抽帧和提元素，也不能空写分镜；主线应先按音频内容规划产品分镜，再按每条分镜定向抽参考帧，并把生成出的视频回挂到对应分镜。

改动：web/components/ad-recreation-board.tsx 新增 AudioStoryboardPlanPanel：从 job.transcript 生成纵向分镜行，每行内部从左到右展示时间/结构、原内容、新口播文案、画面规划/产品融入、参考帧/关键元素和生成视频。每行“抽参考帧”调用现有手动加帧接口，在对应时间段中点抽取原视频参考帧；“生成本条”会把该行规划保存到对应关键帧分镜，并复用现有 onGenerateVideo 提交 Seedance 候选，候选视频按 frame_idx 回显在该行右侧。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。当前不新增后端字段，继续复用 KeyFrame.storyboard 和 GeneratedVideo.frame_idx；后续模型改写、关键元素 6 视图和完整合成可以在该分镜行内继续接入。

问题：波形上的播放线只跟随 video.timeupdate 刷新，浏览器触发频率较低，播放时会一顿一顿。

改动：web/components/ad-recreation-board.tsx 在原视频播放期间启用 requestAnimationFrame 同步 currentTime，暂停、结束和卸载时停止帧循环；波形 SVG 点位用 useMemo 缓存，避免播放时重复计算整条包络。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续调整波形交互时，播放线应继续走帧同步，不要只依赖 timeupdate。

问题：只有逐句时间轴难以判断原视频节奏、停顿和爆点位置；普通柱状条也看不出高低音变化，无法辅助判断口播抬升、下沉和爆点。

改动：web/components/ad-recreation-board.tsx 在音频解析结果面板中加入原视频播放器和横向音频波形，布局为左侧原视频、右侧逐句时间轴、底部连续响度波形。视频播放时根据 currentTime 高亮并自动滚动当前字幕行；点击音频波形或字幕行会跳转原视频时间。音频波形只从真实 audio.wav 解码生成，用连续灰色包络显示响度和停顿；解码前显示加载状态，失败时明确提示，不再用假波形兜底。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续如果要做爆点标记，应基于当前连续响度波形和字幕时间轴继续加 marker，而不是恢复底部音频条。

问题：音频解析第一步顶部“音频文案依据”和主区域“原文案提取”同时展示全文，和逐句时间轴重复；逐句表格、讲话人/节奏/背景音分析也默认占用太多工作台版面。

改动：web/components/ad-recreation-board.tsx 将顶部“音频文案依据”改为默认折叠的 details；移除主面板里的“原文案提取”大卡片，不再把逐句时间轴和声音/背景音拆成两个并列区域；改为一个统一音频解析结果面板，顶部放声音/节奏/背景音 3 个短摘要，下面放紧凑可滚动逐句时间轴。

影响：web/components/ad-recreation-board.tsx、docs/source-analysis.html。后续如果需要全文原文案，只展开“音频文案依据”；如果需要查看完整分析文本，用悬停或后续扩展详情入口，不要恢复独立大卡片。

问题：当前 SKG 网关模型列表没有真实 /audio/transcriptions ASR 模型，whisper-1 原始调用返回 404；后续 gemini-2.5-flash 多模态 fallback 实际不能听到音频，却返回了 1 秒一段的重复假字幕，导致“逐句时间轴”乱掉。

改动：api/main.py 新增本机 mlx_whisper ASR fallback，并让它复用可用静态 ffmpeg，避免 Homebrew ffmpeg 动态库损坏。新增 ASR 质量校验：重复文本、逐秒合成时间轴、音频覆盖率过低的结果会被拒绝；转写失败时不再复用旧 transcript 或写入假时间轴。当前任务 ec90faadad27 已重新解析为 25 段真实时间轴。

影响：api/main.py、api/.env.example、RULES.md、docs/source-analysis.html。后续部署机器需要安装或配置可用 LOCAL_ASR_BIN；否则远端 ASR 不可用时会明确失败，而不是展示假逐句。

问题：粘贴 TK 链接后视频已经下载到 source.mp4，但本机 Homebrew ffprobe/ffmpeg 因缺少 libx265.215.dylib 直接崩溃，后端误显示为“下载失败”。同时用户不再需要底部音频展示。

改动：api/main.py 新增媒体二进制选择逻辑，先验证 PATH 里的 ffmpeg/ffprobe 是否可执行，失败时回退到本机静态 ffmpeg；没有可用 ffprobe 时用 ffmpeg -i 解析时长和分辨率。下载阶段把“元数据解析失败”和“下载失败”区分开。ASR 请求增加 ASR_TIMEOUT_SECONDS，后续补充本机 mlx_whisper fallback 后不再直接信任不可听的多模态假字幕。web/app/page.tsx 不再导入和渲染 AudioStrip，AdRecreationBoard 移除“打开音轨”按钮。

影响：api/main.py、web/app/page.tsx、web/components/ad-recreation-board.tsx、RULES.md、docs/source-analysis.html。后续音频预览如果需要恢复，应先明确是否仍放在右侧工作表，而不是默认恢复底部浮层。

问题：用户明确否定前一版“开始后自动抽帧、分镜、元素、合成”的推进方式，当前只需要把信息流广告快速复刻的第一步跑通：粘贴 TK 链接或上传视频，下载源视频，提取原音频文案，并分析讲话人、节奏和背景音。

改动：web/app/page.tsx 的开始流程改为下载完成后只自动触发 triggerTranscribe；上传视频也加入同一音频解析队列。AdRecreationBoard 主渲染改成左侧素材输入 + 右侧音频解析工作表，不再显示“追加分镜”“开始抽帧”“生成全部视频”。AudioStrip 右侧改为原文案/翻译/声音背景音分析。AudioScript 新增 background_audio_profile，后端 pipeline_transcribe 先保存原文案、中文翻译、讲话人、节奏和背景音分析，当前第一步不默认生成 SKG 新口播或 TTS 配音。

影响：web/app/page.tsx、web/components/ad-recreation-board.tsx、web/components/audio-strip.tsx、web/lib/api.ts、api/main.py、RULES.md、.project.json、docs/source-analysis.html。后续需求应先描述“音频解析完成后是否进入下一步”，不要默认把抽帧/分镜/合成塞进开始动作。

状态：已被上一条“收窄为第一步音频解析”覆盖；保留此记录用于解释旧代码和历史提交为什么存在。

问题：用户希望粘贴视频链接后点击一次“开始”，系统就自动完成素材准备：抽帧、音频分析、关键元素扫描和分镜初稿；人工只负责判断规划是否合理、选择关键元素、再单条或全量生成视频。

改动：web/app/page.tsx 新增开始生产编排状态：创建/激活 job 后，下载完成自动触发 analyzeJob 与 triggerTranscribe，关键帧出来后逐帧调用 describeFrame 并用 updateStoryboard 保存分镜初稿。视频生成时若分镜未显式选择产品图，会自动复制四张 desktop-skg-product-angle-01..04 作为 SKG 产品真源，并把已生成的关键元素 6 视图作为主体参考。AdRecreationBoard 把导入按钮改为“开始”，分镜卡里的候选元素可点击生成提取图 + 6 视图，顶部新增“生成全部视频”。AudioScript 新增 speaker_profile 和 rhythm_profile，用于展示讲话人 / 节奏参考。

影响：web/app/page.tsx、web/components/ad-recreation-board.tsx、web/components/nodes/index.tsx、web/lib/api.ts、api/main.py、RULES.md、.project.json、docs/source-analysis.html。后续需求应区分“开始生产自动编排”和“人工审核/选择/生成”的边界。

问题：四列横向生产流仍把音频文案、关键元素和视频生成拆开，用户真正需要的是每个分镜内部上下游一一对应，快速复刻信息流广告。

改动：AdRecreationBoard 改为左侧素材输入列 + 右侧单一分镜生产板块。右侧顶部保留音频解析、打开音轨、追加分镜和抽帧控制；下方每张 StoryboardSegmentCard 从上到下依次包含音频分镜文案、每个分镜需要的关键元素、视频生成候选。新增 DraftSegmentCard 支持先无限追加草稿分镜，再绑定关键帧后保存和生成候选视频。完整视频合成入口保留在底部，后端合成接口仍待接入。本地开发态隐藏 nextjs-portal，避免 Next Issue 浮层遮挡看板截图。

影响：web/components/ad-recreation-board.tsx、web/app/globals.css、RULES.md、.project.json、docs/source-analysis.html。后续需求应按“素材输入列 + 分镜生产板块 + 分镜卡片三层结构”描述。

问题：左侧抽屉式看板仍像单点操作面板，不符合用户要的“从左往右推进”的广告生产逻辑。

改动：AdRecreationBoard 改为全屏横向四列：素材输入列按文件任务管理素材；音频解析 / 新分镜文案列把分镜从上到下排列；视频关键元素 / 抽帧生成列把关键帧横向排列，并在每张帧卡上直接生成元素和候选片段；视频合成列汇总音频、候选片段和待接入合成接口。page.tsx 不再渲染右侧空白 ReactFlow 画布。

影响：web/components/ad-recreation-board.tsx、web/app/page.tsx、RULES.md、.project.json、docs/source-analysis.html。该方向已被上方“单一分镜生产板块”取代，保留为历史记录。

问题：此前主界面把输入、画面、音频、合成组织成 ReactFlow 可视化节点，但当前目标已确认是“快速产出信息流广告复刻片段”，节点式展示增加理解成本。

改动：新增 web/components/ad-recreation-board.tsx，把素材输入、视频抽帧、音频文案、关键帧选择、剧情规划/产品融入和候选片段选择合并到左侧工作表。web/app/page.tsx 主渲染改为左侧看板 + 右侧空白 ReactFlow 无限画布，画布节点和边暂不展示；web/next.config.mjs 清理 Next 16 已不支持的 eslint 配置，避免本地 dev 左下角 Issue 提示遮挡界面。

影响：web/app/page.tsx、web/components/ad-recreation-board.tsx、web/next.config.mjs、RULES.md、.project.json、docs/source-analysis.html。后续需求应优先描述“左侧看板里的哪一段工作表”和“右侧空白画布未来要承载什么”。

问题：生产登录页引用 /skg-logo-black.svg，但 Nginx 只公开了 /login/、/_next/、/assets/ 和 /oasis-source/，未登录访问该 SVG 会被重定向到 /login/，导致 logo 不显示。

改动：deploy/nginx.conf 新增 location = /skg-logo-black.svg，把官网 SKG 字标作为登录页必需静态资源公开；RULES.md 和本文档同步更新部署事实。

影响：deploy/nginx.conf、RULES.md、docs/source-analysis.html。

问题：SKG logo 放大后，右侧“营销内容工作台”的视觉水平线和 logo 内“未来健康”中文部分略有错位。

改动：web/app/globals.css 将系统标识连同分隔线整体下移，桌面端和移动端分别使用不同偏移，保持 logo 尺寸不变。

影响：web/app/globals.css、docs/source-analysis.html。

问题：登录页用户主要是华人，左上角系统标识继续使用英文 Marketing Studio 不够直接；SKG logo 在当前画面中略小，分隔线和文字需要更稳地水平对齐。

改动：web/app/login/page.tsx 将系统标识改为“营销内容工作台”；web/app/globals.css 放大桌面和移动端 logo，调整品牌组间距、分隔线高度、中文字号和字距。

影响：web/app/login/page.tsx、web/app/globals.css、docs/source-analysis.html。

问题：错误感叹号去掉后，保持登录和提交按钮之间仍保留了旧状态区空位；右侧表单整体也显得偏高。

改动：web/app/login/page.tsx 只在成功态渲染状态图标，不再为空闲/错误态保留固定高度；web/app/globals.css 将桌面端右侧表单继续下移到更贴近截图反馈的位置，移动端保持原排列。

影响：web/app/login/page.tsx、web/app/globals.css、docs/source-analysis.html。

问题：密码输入错误时，保持登录和按钮之间会出现一个感叹号图标，视觉上干扰登录表单。

改动：web/app/login/page.tsx 删除错误态 AlertCircle 图标渲染；错误反馈仍由动态角色的 error 状态承担，成功态勾选图标保留。

影响：web/app/login/page.tsx、docs/source-analysis.html。

问题：只放 SKG 字标还缺少具体系统识别；保持会话复选框没有文字说明；表单上方单独的小锁图标占位多余。

改动：web/app/login/page.tsx 在 SKG 字标旁加入 Marketing Studio 系统标识，复选框旁恢复“保持登录”，并删除表单上方独立锁图标；web/app/globals.css 增加品牌标识组合布局与移动端尺寸。

影响：web/app/login/page.tsx、web/app/globals.css、docs/source-analysis.html。

问题：登录页缺少 SKG 品牌识别；动态角色仍偏扁平，和玻璃草场背景的空间感不够一致。

改动：新增 web/public/skg-logo-black.svg，来源为官网 cn.skg.com/logo-black.svg；web/app/login/page.tsx 在组合登录框内加入 SKG 标识；web/app/globals.css 为标识做反相白色玻璃处理，并给四个动态角色加高光、暗边、内阴影、接触投影和透视层次。

影响：web/app/login/page.tsx、web/app/globals.css、web/public/skg-logo-black.svg、docs/source-analysis.html。

问题：组合登录框仍放在普通文档流的居中容器里，背景滚动或视口变化时视觉上会偏离画面中心。

改动：web/app/globals.css 将 login-source-overlay 改为固定覆盖全屏层；组合登录框自身用 position:fixed; left/top:50%; transform:translate(-50%,-50%) 直接锚定视口中心，避免网格或背景滚动状态造成偏移。

影响：web/app/globals.css、docs/source-analysis.html。

问题：左右排列后动态小人左侧区域偏窄，角色边缘被裁；上轮为处理底部黑边把 Oasis 背景硬锁成单屏，削弱了背景随鼠标和滚动变化的感觉。

改动：web/app/globals.css 扩大组合登录框和左侧角色列，提升角色区域高度与缩放比例；web/components/login/oasis-canvas.tsx 改为原生鼠标事件和 postMessage 双通道转发，输入框上移动鼠标也驱动草地；web/public/oasis-source/index.html 恢复完整滚动进度，保留末端阶段，只禁用原 footer 可见时的 canvas 上移逻辑来去除底部黑边。

影响：web/app/globals.css、web/components/login/oasis-canvas.tsx、web/public/oasis-source/index.html、docs/source-analysis.html。

问题：Oasis 原源码仍保留多段滚动页面高度，浏览器滚到最后一段或恢复 iframe 滚动位置时，相机会进入 footer 视角并在登录页底部露出黑边。

改动：web/public/oasis-source/index.html 的登录嵌入模式禁用 html/body 滚动，将隐藏的 #scroll-container 固定为单屏，并把隐藏 footer 固定到视口下方且高度归零，避免原脚本触发 canvas 上移。

影响：web/public/oasis-source/index.html、docs/source-analysis.html。

问题：登录框内动画角色和账号/密码表单仍是上下堆叠，不符合“左右排列”的要求。

改动：web/app/login/page.tsx 给表单加独立布局类；web/app/globals.css 将桌面端组合登录框改为两列网格，左侧放大动画角色，右侧放账号、密码、复选框和提交图标；移动端继续上下排列避免挤压。

影响：web/app/login/page.tsx、web/app/globals.css、docs/source-analysis.html。

问题：登录框主体已经没有可见文字，但 /login 仍会继承全站 title/description，背景 iframe 也保留了描述性 title，导致检查页面源码时还能看到文字。

改动：新增 web/app/login/layout.tsx 将登录路由 metadata 覆盖为空；web/components/login/oasis-canvas.tsx 删除 iframe 的 title 属性；web/next.config.mjs 禁用开发环境左下角 Next Dev Indicator。登录界面只保留动态图形、输入框、复选框和图标按钮。

影响：web/app/login/layout.tsx、web/components/login/oasis-canvas.tsx、web/next.config.mjs、docs/source-analysis.html。

问题：组合登录框内仍显示输入占位、保持会话、按钮文字和状态提示文字，不符合“登录框文字都删掉”的要求。

改动：web/app/login/page.tsx 删除账号/密钥输入框占位文字、保持会话文本、提交按钮文本、错误/成功状态文本以及表单控件上的可读 aria-label；表单视觉只保留图标、输入区域、复选框和箭头按钮。

影响：web/app/login/page.tsx、docs/source-analysis.html。

问题：登录页不应再出现旧版入口文案、流程状态和指标文字；小人独立玻璃框会扩大遮挡面积，网格背景也不需要。

改动：web/app/login/page.tsx 将动态角色和登录表单合并进同一个 login-source-auth-panel，删除独立角色框。web/app/globals.css 让浮层容器默认不接收指针事件，只让登录框接收交互；角色区域去掉网格、边框、底部阴影和单独背景。web/components/login/oasis-canvas.tsx 改用 document 捕获阶段监听鼠标移动，并向 Oasis iframe 派发原生 mousemove，让它复用原源码玻璃板覆盖时仍驱动草地的逻辑。

影响：web/app/login/page.tsx、web/components/login/oasis-canvas.tsx、web/app/globals.css、docs/source-analysis.html。

问题：登录页仍像内容页，保留了旧版入口营销文案、状态胶囊和底部指标，和“直接把源码背景写过来，上面只放登录和动画”的目标不一致。

改动：web/app/login/page.tsx 删除左侧营销文案、状态胶囊、标题、说明、Pipeline 和指标栏，只保留 OasisCanvas、动态角色透明框和登录表单。web/app/globals.css 新增 login-page--source、login-source-overlay、login-source-character-panel 等样式，让两个功能浮层直接叠在原版 Digital Oasis 背景上。

影响：web/app/login/page.tsx、web/app/globals.css、docs/source-analysis.html。

问题：原版 Digital Oasis 鼠标划过草地会产生响应，但登录页的表单和透明面板盖在 iframe 上方时，iframe 收不到鼠标坐标；同时右侧登录面板过大，左侧动态角色被压成小装饰。

改动：web/components/login/oasis-canvas.tsx 在捕获阶段监听父页面指针移动，并通过 postMessage 发送到 web/public/oasis-source/index.html，后者复用原 raycaster 逻辑驱动草地。web/app/login/page.tsx 将身份验证面板改成 290-320px 窄列、去掉强制大高度、压缩标题/输入/按钮间距；web/app/globals.css 将动态角色面板放大成左侧透明框架里的主视觉。

影响：web/app/login/page.tsx、web/components/login/oasis-canvas.tsx、web/public/oasis-source/index.html、web/app/globals.css、docs/source-analysis.html。

问题：登录页左右两块面板仍偏旧黑色实体面板，没有用上源码 Pillars 区域的透明玻璃质感。

改动：web/app/globals.css 将左侧内容面板和右侧登录面板统一改为源码 .pillar-card 的核心效果：rgba(10,18,10,.55) 半透明底、rgba(140,180,120,.12) 细边、16px 圆角、blur(16px)、0 8px 40px rgba(0,0,0,.4) 阴影和 hover 边框/背景变亮；输入框、动态图角色面板、Pipeline 胶囊和底部状态条也同步成同一透明体系。

影响：web/app/globals.css、docs/source-analysis.html。

问题：用户希望采用下载的 remix-3d-website-the-digital-o 视觉方向；登录页需要更有沉浸感，但不能回到具体产品展示。

改动：新增 web/public/oasis-source/index.html，直接复制下载包原始 WebGPU / Three.js 草场源码；web/components/login/oasis-canvas.tsx 改为 iframe 承载这份源码，登录页只做上层文案和表单覆盖。源码页仅用 CSS 隐藏 demo 站自己的导航、文字和设置面板，保留原草场、景深、风动和鼠标交互。

影响：web/app/login/page.tsx、web/components/login/oasis-canvas.tsx、web/public/oasis-source/index.html、web/app/globals.css、docs/source-analysis.html。

问题：登录页不应该放具体产品图，入口职责是进入内容生产系统，不是展示某个产品。

改动：移除登录页产品图、G7/Neck Massager 等产品文案和产品摄影卡，改为抽象流程视觉与旧版入口文案。四个动态几何角色作为独立小组件保留，继续响应鼠标眼神跟随、输入、显示密码、错误和成功状态。

影响：web/app/login/page.tsx、web/app/globals.css、docs/source-analysis.html。

改动：参考 skg.com 官网的浅灰产品橱窗、黑白强对比、胶囊按钮、SKG 标识、米白/香槟金健康产品光感，重构生产登录页左侧展示区；角色舞台从纯暗色网格改为官网感浅灰产品展示台，底部模块文案改为 Shop by Need / Recovery / Self-Care 语义。

影响：web/app/login/page.tsx、web/app/globals.css、docs/source-analysis.html。

改动：在保留四个几何角色结构的基础上，增加底座阴影、发光边、玻璃高光、内部面板和状态点，让角色更像 SKG 内容工作台里的小模块，而不是纯色几何块。

影响：web/components/login/animated-login-characters.tsx、web/app/globals.css、docs/source-analysis.html。

问题：角色舞台默认挂了 login-stage-breathe 无限循环，导致四个角色在登录页一直上下移动。

改动：移除默认呼吸动画，角色平时固定贴底；错误态只保留短暂横向抖动，成功态保留一次性反馈动画。

影响：web/app/globals.css、docs/source-analysis.html。

改动：新增 web/components/login/animated-login-characters.tsx，把登录页四个角色从 web/app/login/page.tsx 抽成独立组件；角色用配置数组渲染，眼睛、嘴型和黄色 SVG 嘴不再散落在页面主体。动效状态从全页 data-mood 改为挂在角色舞台 login-character-stage 上，样式作用域更清晰。

影响：web/app/login/page.tsx、web/components/login/animated-login-characters.tsx、web/app/globals.css、docs/source-analysis.html。

改动：放大登录页动画角色的鼠标跟随瞳孔位移，并加大显示密码时眼睛整体看向目标的偏移；同时略微放大白眼球，避免瞳孔大幅移动时显得被裁切。

影响：web/app/login/page.tsx、web/app/globals.css、docs/source-analysis.html。

问题：首版登录页把风格库的动画角色理解成圆润小球，视觉上偏幼稚，和 14 动画角色登录 的原始气质不一致。

改动：对照风格库 AnimatedCharacters.vue 和 demo，把角色重写为紫色高矩形、黑色矩形、橙色半圆、黄色圆角柱的贴底几何组合；保留鼠标视线跟随，并让输入、显示密码、错误、成功状态驱动 skew、眼睛和嘴型变化。

影响：web/app/login/page.tsx、web/app/globals.css、docs/source-analysis.html。

问题：公司域名部署后任何人知道地址都能打开工作台并调用生成能力。

改动：把浏览器 Basic Auth 改为应用内登录页：前端新增 web/app/login/page.tsx，参考风格库 14 动画角色登录 做四个几何角色、鼠标视线跟随、输入 / 显示密码 / 错误 / 成功状态反馈；后端新增 /auth/login、/auth/check、/auth/logout，使用 HttpOnly Cookie + HMAC 会话签名；生产 Nginx 通过 auth_request 保护工作台和 /api/。

影响：api/main.py、web/app/login/page.tsx、web/app/globals.css、web/lib/api.ts、docker-compose.prod.yml、deploy/nginx.conf、deploy/.env.production.example、api/.env.example、.project.json、RULES.md、docs/deploy-vps.md、docs/source-analysis.html。

改动：把生产入口确定为 https://marketing.skg.com，DNS 已解析到 VPS 76.13.31.179。新增 Docker Compose 生产配置：前端用 Next 静态导出 + Nginx，/api/ 反代到唯一容器名 skg-marketing-api:4291，避免与 Coolify 网络里其他项目的泛名 api 冲突；后端任务目录持久化到服务器 ./data/jobs；Traefik 通过既有 coolify 外部网络接管 80/443。已完成上线验证：HTTPS 首页 200，/api/health 返回 ok:true。

影响：Dockerfile.web、Dockerfile.api、docker-compose.prod.yml、deploy/nginx.conf、deploy/.env.production.example、docs/deploy-vps.md、.project.json、RULES.md、docs/source-analysis.html。

问题：通过 macOS Terminal 启动后端会每次弹出一个终端窗口，打开页面时干扰使用。

改动：新增 scripts/start-dev-background.sh 和 scripts/stop-dev-background.sh。启动脚本自动检查前端 4290 和后端 4291，缺哪个后台启动哪个，日志写入 .logs/，PID 写入 .pids/，以后无需通过 osascript 打开 Terminal。

影响：scripts/start-dev-background.sh、scripts/stop-dev-background.sh、.gitignore、RULES.md、docs/source-analysis.html。

问题：Seedance 生成时可能把颈部按摩仪当成可变形装饰物，导致产品样式变化、穿进透明身体或与骨架融合。

改动：产品融合 prompt 改为英文硬约束：四张 SKG 产品图是真实产品照片和唯一实物真源，生成时按外置刚性设备做 product placement / visual compositing；产品必须停留在透明皮肤外侧，后颈外侧承托、两端沿左右颈侧向前，保留遮挡、接触阴影、透视和真实比例，禁止 x-ray blending、穿模、融进骨架或重绘成其他颈带。

界面：产品融合顶部常驻显示桌面四张真实产品角度图，并支持鼠标停留放大查看。每行视频结果不再只显示最新一个，而是按历史持续追加横向结果条，鼠标停留任一结果会放大预览。

后端：生视频参考图顺序调整为主参考图之后优先传四张产品图，再传其余人物角色图，提高真实产品外观权重。

影响：web/app/page.tsx、web/components/lightbox.tsx、api/main.py、docs/source-analysis.html。

问题：产品融合视频能进入队列，但后台任务 5% 后失败，错误为 /contents/generations/tasks 返回 404。

根因：https://ai.skg.com/doubao 这个 SKG 豆包网关的真实视频入口是 /api/v3/contents/generations/tasks，不是火山方舟直连 base 下使用的 /contents/generations/tasks。

改动：后端默认路径识别 ai.skg.com/doubao 并自动使用 /api/v3/contents/generations/tasks、/api/v3/contents/generations/tasks/{id}、/api/v3/contents/generations/tasks/{id}/content；本机 api/.env 和 api/.env.example 同步更新。

影响：api/main.py、api/.env、api/.env.example、docs/source-analysis.html。

问题：当前产品融合不再需要手动首帧/尾帧，用户要的是从内置透明骨架人角色、场景描述、产品使用方式和享受状态直接生成视频。

改动：桌面 skg_anatomy_characters_20260514_120852 的 5 个角色、35 张图内置为 api/character_library/skg-characters。产品融合页新增角色下拉和角色预览，每行只保留场景/产品使用/享受描述、秒数、生成按钮和结果视频；选择不同角色时，6 行描述会自动改成对应角色的场景气质、产品使用动作和享受状态，并自主写入“本镜头主要参考哪几张角色图、生成什么场景”。生成前自动复制所选角色 7 张参考图和固定 4 张 SKG 产品图到当前 job。

后端：新增 GET /character-library/skg、GET /character-library/skg/images/{filename}、POST /jobs/{job_id}/assets/character-library。视频提交新增 subject_images，无首帧时主人物图以 reference_image role 传入 Ark/Seedance，而不是强制作为 first_frame。

影响：api/main.py、api/character_library/skg-characters、web/lib/api.ts、web/app/page.tsx、web/components/lightbox.tsx、docs/source-analysis.html。

问题：产品融合不能只写“人物使用产品”，还要稳定控制出场方式、景别、运镜、产品入画、佩戴贴合、使用感受和收尾；同时 SKG 产品是颈部/肩颈按摩仪，比例和佩戴位置不能跑偏。

改动：前端内置 36 条产品融合镜头语言模板，6 条为一组，对应建立出场、产品入画、佩戴贴合、使用感受、生活延展和收尾记忆；产品融合页新增“换一组”按钮，只刷新 6 行描述词，不改变已选角色和视频结果。视频 prompt 额外写入颈部/后颈/颈肩使用部位和真实尺寸比例约束。

影响：web/components/lightbox.tsx、web/app/page.tsx、docs/source-analysis.html。

问题：“提取音频”不能只做原音频转文字再改写，用户需要点击后直接得到介绍 SKG 产品的英文文案和配音，长度尽量贴近原音频，并且声音不能生硬。

改动：pipeline_transcribe 提取 audio.wav 后读取原音频时长，用该时长估算英文口播词数；_rewrite_audio_script_sync 改为生成自然、有趣、可直接 TTS 的 SKG 英文产品介绍。ASR/翻译保留为对照和节奏参考，ASR 不可用时仍继续生成产品口播。TTS voice_id 改为从 语音音色池 随机选择男声、女声或成熟声。

影响：api/main.py、api/.env.example、api/README.md、RULES.md、web/components/nodes/index.tsx、web/components/audio-strip.tsx、web/components/dashboard.tsx、docs/source-analysis.html。

问题：产品融合视频的动作描述不能泛泛写“人物使用产品”，需要稳定表达透明骨架人在具体场景中佩戴 SKG 产品，并呈现舒适享受状态。

改动：前端内置 20 条产品使用描述模板，覆盖卧室、客厅、办公、浴室、阳台、影棚、阅读角等场景；当前产品融合页默认把前 6 条预填到 6 行镜头，用户只在需要时直接改每行描述。

后端：generateProductFusionDescriptions 的兜底模板同步扩为 20 条，LLM 提示也改为生成 20 条 35-70 字描述，要求包含场景、佩戴/展示动作和舒适表情，同时排除医疗治疗承诺。

影响：api/main.py、web/components/lightbox.tsx、docs/source-analysis.html。

问题：原产品融合依赖白底人物、手动画区域、场景图和融合引导图，但当前透明骨架人二创流程更需要文字生成首尾帧，再把产品真源作为垫图传给视频模型。

改动：“场景图”页签改名为“首尾帧”，右侧用地点、风格、参考要素和 prompt 生成首帧/尾帧，生成后自动填入当前产品融合镜头。产品融合 6 行工作表改为首帧、尾帧、四张同一产品不同角度图、描述词、秒数和生成按钮，并提供桌面四角度填当前镜头/填满 6 镜头。

后端：generateSceneAsset 新增 asset_role，first_frame/last_frame 走文字生图并标记资产角色；ProductFusionShot 新增 first_image、last_image、product_images，视频提交直接把首尾帧和四张产品图交给 Seedance；产品库新增桌面 skg产品1-4.jpg 四角度条目。

影响：api/main.py、web/lib/api.ts、web/app/page.tsx、web/components/lightbox.tsx、docs/source-analysis.html。

问题：透明骨架人目标逐帧调用 Vision 验收会拖慢抽帧；切回本机算力后，如果自动档直接跑最高极准，也可能在展示时占满机器资源。

改动：transparent_human 目标保留，但抽帧阶段只走本地扫描、评分、去重和时间覆盖，不再逐帧调用 Vision。quality=auto 最高只自动选择精细；极准仍保留为手动选项。抽帧开始拆出 audio.wav 后会启动独立音频线程，视觉抽帧和音频处理并行，互不标失败。

影响：api/main.py、web/components/nodes/index.tsx、docs/source-analysis.html。

问题：刷新页面时 Next 报 Hydration mismatch，ReactFlow 节点服务端默认宽度和客户端 localStorage 里的用户调整宽度不一致；同时提交抖音链接时若后端正在 --reload 等后台任务结束，会出现 4291 端口占用但请求卡住。

改动：web/app/page.tsx 增加 clientReady，ReactFlow 和底部音频条只在浏览器挂载后渲染，避免服务端 HTML 和客户端本地布局缓存不一致。后端启动说明改为不带 --reload 的稳定命令，并更新 RULES.md、api/README.md 和本页运行入口。

影响：web/app/page.tsx、RULES.md、api/README.md、docs/source-analysis.html。本地 4291 后端已按无 reload 模式重启。

问题：等待抽帧完成后自动启动音频，不符合“先把声音文案拿出来审核”的工作流；用户需要在音频卡片上直接触发。

改动：移除前端抽帧完成后的自动转写逻辑；AudioNode 保留并固定显示“提取音频 / 重新提取音频”按钮，点击音频卡片也会立即打开底部音频条。后端 /transcribe 不再要求 frames_extracted，视频就绪后可直接从 source.mp4 拆出 audio.wav，并按原音频时长生成 SKG 英文产品介绍和 TTS 随机英文配音；抽帧中触发时不抢主状态，而是用 audio_script.status 表示音频处理中。当当前网关的 whisper-1 audio endpoint 返回 404 时，会 fallback 到 Gemini 多模态音频识别；ASR 不可用时也会继续按原音频时长生成产品口播，不把可用文案标成前端错误。

影响：web/app/page.tsx、web/components/nodes/index.tsx、api/main.py、docs/source-analysis.html。

问题：音频和文案只在节点或侧栏里展示，审核时缺少“文字和声音时间轴对应”的空间；英文口播和中文翻译也没有上下对齐。

改动：新增 web/components/audio-strip.tsx，在主工作台底部吸附显示，可拖拽调整高度、可收起。每个音频段按时间横向排列，上方显示英文，中间显示中文翻译，下方显示对应波形条；底部原音频播放器驱动时间轴，播放时绿色指针会沿全局波形移动，并在当前字幕节点内同步走过该段。右侧显示按原音频时长生成的 SKG 英文产品口播、TTS 随机英文配音和产品依据。后端新增 source_audio_url 和 GET /jobs/{id}/audio.wav 只读接口，前端用 Web Audio API 解码生成波形峰值。

影响：web/app/page.tsx、web/components/audio-strip.tsx、web/lib/api.ts、api/main.py、docs/source-analysis.html。

问题：音频识别成功后只显示改写文案，用户看不到它和原音频之间的变化关系，难以判断“是不是把参考视频转成我们自己的话”。

改动：AudioNode 增加轻量对照摘要：改前显示原音频识别/翻译预览，改后显示 SKG 英文产品口播；侧栏 Rewrite 面板改为完整审核视图，先列原音频逐段 ASR/翻译，再列英文产品介绍稿、产品卖点依据和 TTS 英文配音播放器。

影响：web/components/nodes/index.tsx、web/components/dashboard.tsx、docs/source-analysis.html。

问题：同时上传多个视频后，前端把已选关键帧和关键帧详情面板作为全局状态保存；切换 active 视频会清空选中帧，或者让详情面板指向另一个视频的同序号帧，容易误以为生图/自动化被终止或串任务。

改动：web/app/page.tsx 将 selectedFrames 和 expandedFrame 改为按 jobId 存储。切换视频只改变当前视图，不清空其他视频的选择；重新抽帧、删帧、手动加帧只清理或更新对应 job。异步生图、生视频、产品融合返回后按返回的 job.id 写回 jobs[]，不会落到切换后的 active job。轮询条件也把 audio_script.status=rewriting 纳入运行态，保证音频改写/配音阶段切换视频后仍继续刷新。

影响：web/app/page.tsx、docs/source-analysis.html。后端轮询本来已经覆盖所有运行中的 job，这轮主要修正前端 UI 工作上下文。

问题：点击视频抽帧时，后端 4291 端口能连接但 /health 和后续请求长时间不返回，前端看起来像按钮没有反应。

原因：pipeline_download 和 pipeline_analyze 声明为 async background task，但内部实际是同步 yt-dlp、ffmpeg 和 Vision 验收；Starlette 会在事件循环里执行 async background task，导致长抽帧把 API 主循环堵住。

改动：下载和抽帧 pipeline 改为普通同步函数，让 FastAPI/Starlette 按线程池后台任务执行；analyze_queue_worker 也改为同步 worker。服务启动恢复时，如果磁盘里有重启前遗留的 downloading、splitting 或 transcribing 运行态，会恢复成可重试状态，避免按钮一直 disabled。开发运行时改用不带 --reload 的后端命令，避免重载等待后台任务。

影响：api/main.py、docs/source-analysis.html。已重启本地 4291 后端并验证 /health 立即返回；遗留的 8b37e65521a6 job 已恢复为 downloaded，可重新点击抽帧。

问题：用户提供 https://ai.skg.com/doubao 作为视频模型网关；该网关应按 Seedance / 方舟内容生成任务格式提交，而不能误走普通 multipart 上传。

改动：video_uses_ark() 现在同时识别火山方舟域名和 ai.skg.com/doubao，统一使用 content JSON：文本 prompt、首帧、尾帧和产品参考图作为不同 role 传入。火山方舟直连按 /contents/generations/tasks/{id} 轮询；SKG 豆包网关按 /api/v3/contents/generations/tasks/{id} 轮询。api/.env.example 增加 SKG 豆包视频网关配置示例；生视频轮询上限改为 VIDEO_POLL_TIMEOUT_SECONDS，默认 900 秒，避免慢任务过早失败。

影响：api/main.py、api/.env.example、docs/source-analysis.html。本机 api/.env 已配置 VIDEO_API_BASE_URL=https://ai.skg.com/doubao 和视频专用 key。

问题：音频处理节点之前只说明“音轨 → ASR → 翻译 → 改写”，没有按原音频时长生成的产品介绍产物，也没有配音输出；用户无法直接拿到符合 SKG 产品语境的英文口播。

改动：Job 新增 audio_script，pipeline_transcribe 提取 audio.wav 后按原音频秒数生成 SKG 英文产品介绍文案，并在配置 语音 API Key 时调用 TTS T2A 输出 /jobs/{id}/audio-script.mp3。TTS voice_id 从英文男声、女声、成熟声池随机选择；前端 AudioNode 和侧栏 Rewrite 区显示模型链路、英文产品文案和配音播放器。

边界：TTS 官方 Speech API 当前接入的是 TTS 配音，不替代 ASR；原始音频文案提取仍走现有 OpenAI-compatible audio transcription 入口。

影响：api/main.py、api/.env.example、api/README.md、web/lib/api.ts、web/components/nodes/index.tsx、web/components/dashboard.tsx、web/app/page.tsx、docs/source-analysis.html。

问题：透明骨架人主题需要更稳定的素材覆盖，默认 5 帧太少，容易缺少可用于主体、场景和产品融合的角度。

改动：后端 KEYFRAME_COUNT 默认值、前端抽帧 fallback、API client 默认参数都改为 12；抽帧设置里的张数选项把 12 放到第一位。透明骨架人目标仍会对每个候选做 Vision 验收，不合格候选自动换下一帧。

影响：api/main.py、api/.env.example、web/lib/api.ts、web/app/page.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。

问题：透明人二创不能只靠清晰度抽帧，也不能只要出现“骨头”就算合格；需要确认同一人形角色同时具备透明/半透明外壳、干净白色骨架、足够大且清晰、非恐怖广告感。

改动：FrameExtractTarget 新增 transparent_human 并设为当前 UI 默认目标。后端抽帧先按本地清晰度、中心主体、对比度和去重扩大候选池，再逐张从原视频抽高清帧交给 Vision 评分；评分维度包括透明身体、可见骨架、人物占比、清晰度、商业风格和产品可用性。不合格帧会被删除并自动换下一候选，直到凑够目标张数或候选耗尽。

影响：api/main.py、web/lib/api.ts、web/app/page.tsx、web/components/nodes/index.tsx、web/components/lightbox.tsx、web/lib/workflow-target.ts、docs/source-analysis.html。

问题：一键清洗后会生成多张待应用清洗版，但用户仍需要逐张点“替换原图”，素材准备阶段操作成本偏高。

改动：“原图/清洗”页新增“待替换清洗版”状态和“一键替换待应用 N 张”按钮，并显示批量替换进度和失败数。该按钮只应用已经存在的清洗结果，不重新清洗；不满意的帧仍可先单张重洗或丢弃。

影响：web/components/lightbox.tsx、docs/source-analysis.html。

问题：产品融合页继续显示产品角度槽、辅助栏和产品图库会把操作变复杂；当前工作流只需要用户手动补人物首尾帧，产品图固定来自桌面 4 张 SKG 图。

改动：“产品融合”页每行只保留首帧、尾帧、已预填描述词、秒数、生成按钮和行末视频结果。生成单条或批量视频前，前端自动把内置的 4 张桌面 SKG 产品图复制为当前 job asset 并写入 product_images[4]；视频 prompt 增加 产品融合镜头ID 标记，用来把生成结果显示回对应行。

影响：web/components/lightbox.tsx、web/app/page.tsx、web/components/nodes/index.tsx、web/components/dashboard.tsx、docs/source-analysis.html。

问题：产品融合要生成 6 条视频，但旧排版只在列表里显示摘要，真正编辑区只展开当前镜头，用户无法从上到下同时检查 6 条镜头的产品、人物、场景和描述是否一一对应。

改动：“产品融合”页左侧改为纵向 6 行镜头工作表。每行包含产品图槽、白底人物图槽、人物图内产品区域画框、场景图槽、动作描述、秒数选择和单条生成按钮；右侧只保留模型状态、当前镜头状态、AI 草拟 6 条、批量排队和当前镜头产品图库。

影响：web/components/lightbox.tsx、docs/source-analysis.html。

问题：只把产品图作为参考图无法解决尺寸和位置融合，模型不知道产品应该放在人物或场景里的哪个区域。

改动：FrameLightbox 的“产品融合”页改为 6 行镜头组。每行绑定产品图、白底人物图、手动画出的产品区域、场景图、描述词和视频秒数；图片槽支持上传和粘贴，产品图也可从内置 SKG 白底图库选用。右侧固定显示图片模型 GPT Image 2 和视频模型 Seedance，支持 AI 草拟 6 条动作描述和批量排队；单条生成入口放在每一行镜头内。

后端：新增 POST /jobs/{job_id}/product-fusion/guide 和 POST /jobs/{job_id}/product-fusion/descriptions。前者把产品图按 product_region 合成到白底人物图上，生成普通 asset 引导图；后者用 LLM 或本地模板生成 6 条动作描述草稿。前端再把引导图作为 Seedance 首帧，并把产品图、人物图、场景图作为参考图提交。

影响：api/main.py、web/lib/api.ts、web/app/page.tsx、web/components/lightbox.tsx、web/components/nodes/index.tsx、web/components/dashboard.tsx、docs/source-analysis.html。

问题：卡片上的“复制”写入的是应用内 ImageRef 剪贴板，而产品融合槽位只监听系统剪贴板文件，导致复制后的素材无法在产品融合里粘贴。

改动：NodeData 和 FrameLightbox 新增 clipboard 传递链路；产品融合三类槽位的“粘贴”按钮优先使用应用内剪贴板，应用剪贴板为空时再提示可选中槽位后 Cmd+V 粘贴系统图片。

影响：web/app/page.tsx、web/components/nodes/index.tsx、web/components/dashboard.tsx、web/components/lightbox.tsx、docs/source-analysis.html。

问题：生成视频需要稳定的 SKG 产品真源，不能每次都依赖临时上传或从参考视频里找产品图；桌面已有整理过的 SKG 产品图，应作为内置数据库使用。

改动：从桌面 skg_product_downloads/all_products 的 gallery 中筛出 41 张白底产品图，生成 api/product_library/skg-products/manifest.json 和压缩预览图。FrameLightbox 新增“产品融合”页签，StoryboardWorkbench 的 SKG 产品参考区也接入同一个 ProductLibraryPicker，支持搜索、品类筛选、尺寸预览和一键加入。

后端：新增 GET /product-library/skg、GET /product-library/skg/images/{filename} 和 POST /jobs/{job_id}/assets/product-library。选中库内产品图时，后端会复制成当前 job 的 asset，后续仍通过既有 product_images 进入生视频接口。

影响：api/main.py、api/product_library/skg-products、web/lib/api.ts、web/components/product-library-picker.tsx、web/components/lightbox.tsx、web/components/storyboard-workbench.tsx、docs/source-analysis.html。

问题：场景图页不能只围绕当前单张图；它需要看到全部关键帧，并通过地点、风格、参考要素等关键词组合出可控 prompt，再生成场景。

改动：FrameLightbox 的“场景图”页左侧改为全部关键帧网格：点击图片设为生成目标，点击“选”加入场景参考。右侧新增地点、生成方式、风格、额外关键词和参考要素 chips，并自动拼出可编辑场景 prompt。

后端：generateSceneAsset 请求新增 prompt 和 source_frame_indices；多张参考帧会拼成 contact sheet 给图像模型，同时把用户 prompt 注入场景生成提示词。

影响：web/components/lightbox.tsx、web/lib/api.ts、api/main.py、docs/source-analysis.html。

问题：主体资产不是抠图，也不是只看当前单帧生成多角度；主体页需要看到全部参考帧，并用这些参考重新绘制一个完整主体。

改动：FrameLightbox 在“主体资产”页左侧显示参考帧网格，优先纳入所有已清洗帧，额外已选帧也会并入；小图排列，可点击切换当前帧。右侧仍负责统一主体确认和生成。人物/生物默认视图改为六张身份标准图：正面、背面、左侧、右侧、左前 45°、右前 45°；并把表情补充和动作补充折成独立分组，需要时再勾选。

后端：generateSubjectAssets prompt 改为“参考重绘”，明确禁止裁剪/抠图/粘贴源像素，要求主体完整居中、纯白/黑背景、无其他元素，并占画面约 85-95% 高度；落盘时会裁掉纯背景空白并放大主体。

影响：web/components/lightbox.tsx、web/components/nodes/index.tsx、api/main.py、docs/source-analysis.html。

问题：当前流程里抽多张关键帧的目的不是让每张图各自生成一个主体，也不是从单张图硬造多角度，而是用多张关键帧共同还原同一个主体的多角度、动作和表情。

改动：FrameLightbox 的主体页改成“统一主体”逻辑：全局只保留一个主体候选；生成主体资产包时默认传全部关键帧作为 source_frame_indices，用户手动选择关键帧时只传已选帧。场景图仍然按当前关键帧逐张生成，因此是一个主体包 + 多个场景图。

后端：generateSceneAsset 查找主体名称时改为从整个 job 的已生成主体资产中读取，而不是只看当前帧，确保任意关键帧生成场景图时都能移除统一主体。

影响：web/components/lightbox.tsx、web/components/nodes/index.tsx、api/main.py、docs/source-analysis.html。

问题：场景图如果先于主体资产生成，只能做普通背景清理，无法准确知道要移除哪个主体，也不利于后续生成相似但不同或同构换风格的场景。

改动：FrameLightbox 页签顺序改为“原图/清洗 → 主体资产 → 场景图 → 审核”；画面工作台缩略图和进度文案也同步为主体资产先于场景图。场景图页新增“去主体原场景 / 相似新场景 / 同构换风格”和风格选择，且在没有主体资产时提示先生成主体资产。

后端：generateSceneAsset 请求新增 scene_mode 和 scene_style；后端提示词会优先读取已生成主体资产对应的主体名称，生成去主体并补背景的场景图，再按模式决定是否做相似变化或风格变化。

影响：web/components/lightbox.tsx、web/components/nodes/index.tsx、web/lib/api.ts、api/main.py、docs/source-analysis.html。

问题：“原图/清洗、主体资产、场景图、审核”都应遵循同一结构：左侧负责看图和框选，右侧负责操作、状态和结果；旧布局把部分操作塞在左侧下方，导致左侧满、右侧空。

改动：FrameLightbox 统一为左侧主图、右侧操作栏。清洗按钮、批量清洗、清洗结果预览、场景图生成/复制、主体识别/主体资产包和审核状态都在右侧；切换到非清洗页时会退出框选模式，避免画框状态残留。

影响：web/components/lightbox.tsx、docs/source-analysis.html。

问题：单独清洗某一张关键帧时，前端使用全局 cleaning 布尔状态，导致切到其他关键帧后清洗按钮仍被禁用。

改动：FrameLightbox 改用 cleaningFrameIds 按 frame.index 记录正在清洗的帧，只禁用当前正在清洗的那一张；其他帧可以继续单独清洗。区域清洗完成时也只在用户仍停留于同一帧时清空当前框选，避免异步完成误清别的帧操作状态。

影响：web/components/lightbox.tsx、docs/source-analysis.html。

问题：画面工作台里的关键帧已经在抽帧阶段筛过，逐张点“清洗水印”会拖慢素材准备；但自动清洗又不能直接覆盖原图，否则模型误改时不好回退。

改动：FrameLightbox 的“原图/清洗”页新增“批量清洗”卡片，一键顺序清洗所有未处理素材帧，并显示进度和失败数。批量清洗只生成 cleaned 待审核版本，不自动应用；没清干净的帧再用单帧框选区域做手工补洗。

影响：web/components/lightbox.tsx、docs/source-analysis.html。后端暂未新增 batch API，前端复用 POST /jobs/{id}/frames/{idx}/cleanup 顺序执行。

问题：面板标题仍叫“关键帧详情 · 元素提取”，里面还露出普通 cutout 抠图、AI 提取、元素清单等旧流程入口；“选用此帧 / 加入目标帧”也无法说明实际价值，因为抽帧阶段已经筛过图，进入画面工作台的关键帧默认就应该参与素材准备。

改动：KeyframePanelNode 标题改为“关键帧素材准备”；FrameLightbox 的主体页改成“主体识别 / 主体清单 / 主体资产包”，移除普通抠图列表、AI 提取按钮、详情内的目标帧开关以及手动/框选加主体入口，改为只显示“已在素材准备流程”的状态说明；VisualLabNode 上方缩略图也不再展示普通抠图分组，只展示关键帧、主体包、场景图和视频任务。

影响：web/components/lightbox.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。底层旧 cutout 数据和接口暂保留兼容历史任务，但不再作为新素材准备流程的可见入口。

问题：画面工作台从展示缩略图扩展为素材生产中枢后，关键帧、主体资产包、场景图和视频任务继续混在一个列表里会让流程不清晰；关键帧详情面板也把清洗、识别、主体生成和场景生成都堆在一屏。

改动：VisualLabNode 改成素材准备进度看板，显示关键帧素材、主体资产、场景图和分镜/视频四个入口。FrameLightbox 新增“原图/清洗、主体资产、场景图、审核”四个页签，素材审核信息从普通列表中拆出来。

影响：web/components/nodes/index.tsx、web/components/lightbox.tsx、docs/source-analysis.html。这轮只重排工作台信息架构，批量自动准备队列仍留到下一阶段。

问题：抽帧阶段已经筛过图，画面工作台第一步应把已选关键帧转成可用于生视频的干净素材：同一主体一套多视角/动作/表情图，再基于主体生成每帧去主体场景图，而不是继续手动逐张抠普通 cutout。

改动：KeyFrame 新增 scene_assets 和 quality_report；KeyElement 新增 subject_kind 与 subject_assets。后端新增 generateSubjectAssets 和 generateSceneAsset，主体资产支持白/黑背景、原尺寸/固定尺寸、物体视角、人物/生物动作与喜怒哀乐等表情；当已选关键帧共同指向一个主体时，前端会把这些帧作为 source_frame_indices 传入，后端拼接参考板。

影响：api/main.py、web/lib/api.ts、web/components/lightbox.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。生成出的素材保存在 jobs/<jobId>/assets，可作为 asset 类型复制到后续分镜槽位。

问题：抽帧精度不应该每次都让用户判断；点击一个视频抽帧后，其他视频不应被全局禁用，而应该可以先后排队。另外打开视频抽帧侧边面板后，也应能自动抽帧。

改动：quality 新增 auto 默认值，后端按 CPU 核数、内存和视频时长解析为快速或精细；为了展示稳定，auto 不再自动进入极准，极准仅在用户手动选择时启用。后端新增内存队列 ANALYZE_QUEUE，多个 analyze 请求按顺序执行；前端轮询所有运行中的 job，不只轮询当前 active job。VideoFramePanelNode 内也加入同一套自动抽帧工具条。

影响：api/main.py、web/lib/api.ts、web/app/page.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。队列目前是进程内队列，重启后不会恢复未执行的排队任务。

问题：每个缩略图上方同时放目标、张数、精度和按钮太拥挤；另外追加抽帧时可能没有新增图片。

根因：追加模式下 frames 目录已经存在，但后端仍使用非 exist_ok 的 mkdir，触发 File exists 后任务进入解析失败。

改动：工具条默认只显示目标、抽帧/追加和设置按钮；张数、精度折叠到设置里。后端改为允许已存在的 frames 目录，追加模式不再因目录存在失败。缩略图高度增大到 192px，横屏/竖屏都按真实比例显示；抽帧评分也按视频原比例缩放，不固定 16:9。

影响：api/main.py、web/app/page.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。已用临时 job 验证 append：已有 1 张关键帧时追加 3 张后变为 4 张。

问题：当前抽帧默认偏轻量，用户机器是 Apple M2 Max、12 核 CPU、38 核 GPU、64GB 内存，足以承受更密集的本地候选扫描；但需要在 UI 里提示算力档位，避免长视频误用重模式。

改动：后端 /jobs/{id}/analyze 新增 quality 参数：快速为 2fps/360px，精细为 8fps/720px，极准为 12fps/960px；高精度模式还会提高本地评分图分辨率，保留竖屏比例，不再把竖屏压扁到 16:9。每个缩略图工具条新增精度选择。

影响：api/main.py、web/lib/api.ts、web/app/page.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。实测本机 64.5s、1080×1920、60fps 视频，12fps/960px 扫描 774 张候选约 2.61s；重型 ffmpeg 场景/模糊滤镜约 21.63s，因此继续使用本地 PIL/NumPy 评分更划算。

问题：统一放在缩略图浮条上方的抽帧工具条仍然不够明确，用户无法一眼判断当前会抽哪一个视频。

改动：抽帧目标、张数、精度和抽帧按钮改为渲染在每个视频缩略图正上方，并且每个 job 独立保存目标、张数和精度设置。点击某个缩略图上方的抽帧按钮时，前端直接把该 jobId 传给 analyzeJob，同时切换 active job 并进入该 job 的进度轮询。

影响：web/app/page.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。后续与输入视频相关的快捷操作都应优先贴近对应缩略图，不再依赖全局当前选择的心智。

问题：自动抽帧入口放在 Input 卡片正文里，离视频缩略图和预览工作区较远；用户需要在看缩略图时快速切目标、切张数并反复抽取。

改动：输入视频缩略图浮条上方新增自动抽帧快捷工具条，包含抽帧目标、张数快捷项和抽帧按钮。前端新增 frameCount 状态并把目标 / 张数传给 analyzeJob；已有关键帧时默认用 mode=append 追加抽取。

影响：api/main.py、web/lib/api.ts、web/app/page.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。后端追加模式会保留已有关键帧，避开非常接近的时间点，并用新的 frame index 落盘。

问题：单一“自动抽帧”无法表达这次要清晰人物、下次要转场变化或表情瞬间的不同目标；但把抽帧做成复杂参数面板会破坏 Input 卡片的轻量工作流。

改动：Input 节点新增抽帧目标，默认“综合关键帧”，可切换清晰主体、转场变化、表情瞬间、动作峰值。后端 /jobs/{id}/analyze 新增 target 参数，先低清低帧率扫描候选，再按目标评分、pHash 去重、时序分桶，最后只对选中的时间点从原视频抽高质量关键帧。

影响：api/main.py、web/lib/api.ts、web/app/page.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。当前“人物/动物表情”是本地近似评分，后续可把候选小图接入视觉模型重排。

问题：输入视频缩略图改为单击打开抽帧面板后，面板播放器如果自动播放带声音，会打断工作流。

改动：VideoFramePanelNode 的主播放器增加 muted，默认静音自动播放；用户仍可通过浏览器视频 controls 自行取消静音。

影响：web/components/nodes/index.tsx、docs/source-analysis.html。

问题：视频抽帧面板和画面工作台详情面板框架一致后，标题栏颜色也需要分别跟各自来源卡片一致；输入视频缩略图仍需要双击才能打开抽帧面板，操作偏重。

改动：视频抽帧面板标题栏使用 --grad-input，画面工作台详情面板标题栏使用 --grad-ai；输入视频缩略图改为单击打开抽帧面板，hover 仍负责尺寸预览。

影响：web/components/nodes/index.tsx、docs/source-analysis.html。后续面板颜色应从来源卡片类型继承。

问题：关键帧详情 / 元素提取面板虽然默认左侧吸附，但外层仍是旧橙色“钉住”框架，和视频抽帧面板的紫色标题栏、画布/左/右/底吸附按钮不一致。

改动：KeyframePanelNode 改为和 VideoFramePanelNode 同一套 Canvas Panel 外壳：紫色标题栏、画布模式、吸附左侧、吸附右侧、吸附底部、缩放、关闭和右下角拖拽缩放。面板定位状态从单一 pinned 语义升级为 framePanelDock。

影响：web/app/page.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。后续工作面板应复用这套 Canvas Panel 框架。

问题：画面工作台详情面板外层已有“关键帧详情 · 元素提取”工具栏，内层 FrameLightbox 嵌入态又显示一条橙红分镜导航栏，视觉上像两个窗口叠在一起。

改动：FrameLightbox 在 embedded 模式下不再渲染自己的顶部工具栏和外边框；上一帧 / 下一帧导航移动到 KeyframePanelNode 外层标题栏。

影响：web/components/lightbox.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。非嵌入式 lightbox 保留原标题栏。

问题：画面工作台点击关键帧后，关键帧详情 / 元素提取面板仍默认作为画布节点出现，还会触发 fitView 拉动画布；和视频抽帧面板默认左侧吸附的规则不一致。

改动：framePanelDock 初始值改为 left；从关闭状态打开关键帧详情时默认吸附左侧。若面板已打开，用户切回画布模式后继续切换关键帧，不会被强制吸回左侧；默认吸附状态下也不再触发画布 fitView。

影响：web/app/page.tsx、docs/source-analysis.html。画面工作台处理面板现在与视频抽帧面板保持同一默认策略：先贴左侧，需要时再切回画布。

问题：视频抽帧面板默认以画布节点方式打开时，用户还要再点一次吸附左侧，和“处理面板先贴边、需要时再拖回画布”的工作习惯不一致。

改动：videoPanelDock 初始值改为 left；从关闭状态双击输入视频缩略图时默认吸附左侧。面板已打开后，用户手动切换到画布 / 右侧 / 底部不会被找回动作覆盖。

影响：web/app/page.tsx、docs/source-analysis.html。后续同类处理面板应优先考虑“默认贴边，必要时切回画布”的交互。

问题：视频抽帧面板只能新增关键帧，用户看到“已抽关键帧”后不能在同一工作上下文里清理误抽的帧。

改动：已抽关键帧缩略图右上角增加删除按钮，点击后按 jobId + frameIdx 删除对应关键帧；删除期间显示小号 loading。图片类素材仍沿用快速删除策略，不弹确认。

影响：web/app/page.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。视频抽帧面板不再依赖当前 active job 来决定删除目标。

问题：视频抽帧面板吸附左侧 / 右侧时顶部仍留出明显空白；这不是实际板块遮挡，而是面板吸附样式里硬编码了 top: 72 和对应的高度预留。关键帧面板也保留了旧 storyboard 顶栏避让逻辑。

改动：新增统一吸附边距常量，视频抽帧面板和关键帧详情面板吸附时都贴近视口边缘，仅保留 8px 安全边距；移除关键帧面板对旧 data-storyboard-dock / data-storyboard-bar 的避让查询。

影响：web/components/nodes/index.tsx、docs/source-analysis.html。后续画布工作面板的吸附语义统一为“贴边”，不是为顶部旧板块预留空间。

问题：输入视频缩略图双击原来只在 Input 节点上方展开一个临时播放器，不能作为无限画布工作台移动、找回或吸附，后续其他板块也无法复用这种交互。

改动：新增 videoFramePanel ReactFlow 节点和 VideoFramePanelNode。双击输入视频缩略图会打开/找回画布内抽帧面板，面板可拖动、右下角缩放，也可一键吸附到左侧、右侧或底部边缘；面板内支持播放、时间轴定位、当前时间抽帧和查看已抽关键帧。

影响：web/app/page.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。原固定全屏 VideoLightbox 不再从 Input 双击路径进入；后续处理板块应复用同类画布工作面板语义。

问题：原始尺寸和 Fit 比例之前是左上角小号单行文字，用户在快速扫缩略图时不够醒目，无法马上感知素材分辨率差异。

改动：HoverPreview 左上角改为两层信息徽章：标题固定为“原始尺寸”，主数字用大号等宽字体显示 宽 × 高，旁边保留 Fit 百分比或 1:1 原寸 状态。

影响：web/components/nodes/hover-preview.tsx、docs/source-analysis.html。定位和 Fit / 1:1 行为不变，只提升尺寸信息可读性。

问题：浏览器原生删除确认会突然出现在页面顶部，和无限画布的操作上下文割裂；图片类素材如果每次删除都确认，也会拖慢快速整理素材的节奏。

改动：输入视频和生成视频任务删除改为画布内确认层，背景轻遮罩并支持点击背景 / Esc 取消；关键帧和元素提取图属于可快速整理的图片素材，点击删除后直接执行。

影响：web/components/nodes/index.tsx、docs/source-analysis.html。视频删除仍走既有删除接口；图片删除仍走原有回调，只调整确认策略。

问题：画布顶部输入视频缩略图只有切换和预览，没有删除入口；用户清理视频队列时只能删关键帧或生成视频任务，不能删除整个输入视频。

改动：新增 DELETE /jobs/{id}，前端新增 deleteJob 和 onDeleteJob；Input 缩略图右上角常驻删除按钮，确认后移除该 job、清理 URL 参数，并删除本地 jobs/<id> 目录。

影响：api/main.py、web/lib/api.ts、web/app/page.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。

问题：有些源视频和图片分辨率很大，完全按原尺寸展示会撑爆画布；但统一固定预览大小又会丢失素材真实尺寸感知。

改动：HoverPreview 默认按原比例适应可视区域，角标显示原始分辨率和当前 Fit 百分比；点击钉住后可切换到 1:1，超大素材在预览框内滚动查看局部。

影响：web/components/nodes/hover-preview.tsx。视觉缩略图高度同步放大，图片缩略图的复制 / 删除按钮改为常驻大号 icon。

问题：节点上方缩略图横排内容多时，原生横向滚动条太细且在画布缩放下不容易点中，用户很难拖动。

改动：新增 FloatingThumbnailStrip / ThumbnailScrollRail，在缩略图下方显示明显的大号紫色拖动轨道；轨道支持点击跳转、按住拖动和键盘左右移动，并用 nodrag nopan 避免误触发画布拖拽。

影响：web/components/nodes/index.tsx、web/app/globals.css、docs/source-analysis.html。Input、VisualLab 以及保留的旧视觉节点缩略图条共用同一交互。

问题：镜头拆解、元素改造、生成视频三个卡片在主画布上占同等权重，但它们只是视觉素材状态展示和入口；真正处理都在点击后的工作台/面板中完成。

改动：新增 VisualLabNode，把关键帧、元素 cutout、视频任务缩略图合并到一个“画面工作台 · Visual Lab”卡片里；DAG 从 Input → Keyframe → Storyboard → VideoGen → Compose 简化为 Input → VisualLab → Compose，音频线仍独立。

影响：web/app/page.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。底层数据、接口和旧节点组件暂不删除。

问题：点击或轻微拖动卡片右下角缩放把手时，节点会突然偏移/跳变，影响在无限画布上精调卡片大小。

原因：getComputedStyle(nodeEl).width/height 读到的已经是 ReactFlow 节点坐标下的布局尺寸，旧逻辑又除了一次 zoom，导致拖动起始宽高被放大或缩小；点击时 1px 级 pointermove 也会立刻写入错误宽高。

改动：起始宽高直接使用 computed style，只有鼠标移动量按 zoom 换算；增加 2px 点击死区，单纯点击缩放角不再改写节点尺寸。

影响：web/components/nodes/resize-handle.tsx、docs/source-analysis.html。

问题：用户要的是“鼠标停在卡片缩略图上时，原尺寸图片/视频在该缩略图上方边缘展示，并且仍属于无限画布”；不能贴节点卡片上边缘，也不能放到页面 fixed 层。

改动：HoverPreview 增加缩略图锚点坐标，预览层仍渲染在 ReactFlow 节点 DOM 内，但用缩略图的中心 x 和 top y 定位，预览底边贴缩略图上边缘；Input 视频、镜头拆解关键帧、元素改造 cutout、生成视频缩略图统一走该逻辑。

影响：web/components/nodes/hover-preview.tsx、web/components/nodes/index.tsx、docs/source-analysis.html。

问题：前端只从 URL ?job= 读 job 列表，没有任何本地或后端列表回填，打开 / 不带参数就是空白，之前跑过的 job 看不见。

改动：后端新增 GET /jobs 列表接口（返回 JobSummary：id/url/status/progress/duration/width/height/video_url/frame_count/video_count/thumbnail/error/mtime，按 state.json mtime 倒序，可带 limit）。前端 page.tsx 启动逻辑：URL 有 ?job= 时尊重 URL；没有时自动调 listJobs() 拿全部历史，反转后让最新 job 落在末尾（active）。持久化基于 api/jobs/<id>/state.json 磁盘文件，不依赖浏览器存储，换浏览器/清缓存都不会傻。

影响：api/main.py（JobSummary 类型 + list_jobs endpoint）、web/lib/api.ts（JobSummary + listJobs）、web/app/page.tsx（启动 useEffect）。

问题：本轮参考素材的主体可能是人形骷髅/透明骨骼人，不应被提示词强行替换成普通真人；核心是“用了 SKG 颈部按摩仪后状态变好”。

改动：prompt 允许保留人形骷髅作为视觉隐喻，要求正确佩戴 U 形颈部按摩仪，并通过从僵硬/揉脖子/疲惫到抬头/肩颈舒展/放松来表现状态改善；同时禁止恐怖化、血腥化或夸大医疗治愈。

影响：web/app/page.tsx。

问题：已经有真实 SKG 产品图后，提示词还偏“借鉴原视频”，容易让模型保留竞品或改变产品形态。

改动：生成视频 prompt 明确“上传的 SKG 产品图是唯一产品真源”，首尾帧只控制起止构图、场景和动作，原视频链接只参考节奏和镜头调度；增加产品一致性、产品呈现、禁止非 SKG 产品/竞品包装/随机新增结构等约束。

影响：web/app/page.tsx。

问题：SKG 产品参考不能只依赖从关键帧/元素里复制，用户需要手动上传同一产品的多角度图。

改动：SKG 产品参考 区支持点击上传和拖拽上传图片，一次可传多张，最多保留 6 张。后端新增 POST /jobs/{job_id}/assets 保存产品图资产，并返回 kind: "asset" 的 ImageRef；生成视频时这些资产会作为产品参考传入 Ark。

影响：web/components/storyboard-workbench.tsx、web/lib/api.ts、api/main.py。

问题：首尾帧可以控制视频起止，但还需要单独指定 SKG 产品图，避免模型只模仿原视频动作而没有稳定产品外观。

改动：分镜编排区新增 SKG 产品 槽，和首帧、尾帧并列；生成视频时把该槽作为 product_image 提交。Ark 请求会附加一张 reference_image 产品参考图；如果接口不接受额外参考图，后端自动回退到首尾帧生成。

影响：web/components/storyboard-workbench.tsx、web/app/page.tsx、api/main.py。

问题：赶交付时，顶部横向分镜缩略条占空间，4 图槽也不如“首帧到尾帧”直接；用户希望直接做首尾帧视频生成。

改动：移除 StoryboardBar 的横向分镜缩略图区域，只保留标题栏和展开按钮；StoryboardWorkbench 改成首帧 / 尾帧两个槽，首帧默认当前分镜，尾帧默认下一张已选分镜，也可从剪贴板粘贴指定结束画面。后端 /storyboard/video 支持 first_image/last_image，Ark 请求同时传 first_frame/last_frame，如果接口不接受尾帧字段则自动回退到单首帧。

影响：web/components/storyboard-bar.tsx、web/components/storyboard-workbench.tsx、web/app/page.tsx、web/lib/api.ts、api/main.py。

问题：用户赶交付，希望直接把上传的原视频链接给视频模型参考，而不是只靠单张关键帧。

改动：前端提交生视频时增加 source_ref: { kind: "source_video", url: job.url }；Ark 请求体在文本 prompt 和首帧之外追加 video_url 参考视频，用于模仿节奏、镜头运动和动作顺序。如果 Ark 返回 400/422 不接受参考视频字段，后端自动回退到“当前关键帧首帧生成”，保证这次不会直接阻断出片。

影响：web/app/page.tsx、web/lib/api.ts、api/main.py、docs/source-analysis.html。

问题：赶交付时不适合再让 4 图槽决定首帧；如果某个槽里是抠图元素，模型会拿碎元素当第一帧，视频容易不连贯。

改动：“生成视频”按钮改成直接用当前分镜关键帧作为首帧提交，4 图槽和改造目标只作为提示词参考；提示词强调一镜到底、首帧稳定、时间线连续、禁止跳切/换场景/主体变形。后端取关键帧时优先使用未应用的清洗版，否则使用当前 frame 文件。

影响：web/app/page.tsx、web/components/storyboard-workbench.tsx、api/main.py。

问题：用户提供火山方舟 https://ark.cn-beijing.volces.com/api/v3 作为生视频通道；这个通道不是 Poe 的 /videos 形态，而是内容生成异步任务。

改动：后端识别 Ark base 后，提交改为内容生成任务接口，火山方舟直连使用 POST /contents/generations/tasks，SKG 豆包网关使用 POST /api/v3/contents/generations/tasks。请求体使用 content 数组：文本 prompt + 首帧 image_url data URL；轮询对应的 {id} 任务地址，成功后读取 content.video_url 下载 MP4。本机默认 Seedance 模型改为 Ark 可见的 doubao-seedance-2-0-fast-260128。

影响：api/main.py、api/.env.example、docs/source-analysis.html。本机 api/.env 需要把 VIDEO_API_BASE_URL/VIDEO_API_KEY/VIDEO_CREATE_PATHS/VIDEO_STATUS_PATH 指向 Ark。

问题：SKG ezlink 的 OpenAI 兼容 base 可列出部分模型，但常规 /videos 入口返回 404/unsupported；用户确认可用的视频模型在 Poe 通道里。

改动：后端新增 POE_API_BASE_URL/POE_API_KEY 配置，未显式配置 VIDEO_API_BASE_URL 时优先走 Poe；Seedance / Kling / Veo/Voe 业务别名默认映射到 Poe 真实模型 seedance-2-fast、kling-omni、veo-3.1-fast。Poe 提交使用 input_image base64，继续轮询 /videos/{id} 并下载 /videos/{id}/content。

影响：api/main.py、api/.env.example、docs/source-analysis.html。密钥只放本地 api/.env，不进入源码解析页。

问题：虽然当前探测到常见视频入口返回 404/unsupported，但模型层确实有视频模型，不能在前端简单判定“未开通”并禁用。

改动：撤掉分镜编排里的前置禁用；后端允许提交 seedance / kling / veo / voe，并支持通过 VIDEO_CREATE_PATHS 逗号分隔配置多个候选生成入口，逐个尝试。

影响：api/main.py、api/.env.example、web/app/page.tsx、web/components/storyboard-workbench.tsx。

问题：提交生视频失败时，前端把 generateStoryboardVideo 503 {"detail": ...} 原样展示，用户无法快速判断是配置、端点还是 UI 问题。

改动：generateStoryboardVideo 解析后端 JSON 的 detail 后再抛错；后端错误文案区分“模型存在”和“入口不可用”；Video Gen 失败卡把 /videos 404 长错误压缩成一句可读原因。

影响：web/lib/api.ts、web/components/nodes/index.tsx、api/main.py。

问题：Video Gen 节点上方失败/完成任务卡只有整卡点击复制，不够明确；失败任务也无法从界面清掉。

改动：每个视频任务卡左上角增加复制 prompt 按钮，右上角增加删除任务按钮；后端新增 DELETE /jobs/{job_id}/storyboard-videos/{video_id}，删除 generated_videos 记录并清理本地任务目录。

影响：web/components/nodes/index.tsx、web/app/page.tsx、web/lib/api.ts、api/main.py。

问题：4 图槽已经粘贴参考图后，用户要直接调用生视频 API，而不是只生成 prompt 或图片任务。

改动：分镜编排明细区增加 Seedance / Kling / Veo 3 模型选择和“调用模型生成视频”按钮；后端新增 /jobs/{job_id}/frames/{idx}/storyboard/video。提交后按 VIDEO_CREATE_PATHS 逐个尝试生成入口，成功后轮询并保存 MP4；失败时保留任务卡和具体入口错误，方便继续排查网关实际路径。VideoGenNode 读取 job.generated_videos 展示排队、生成中、失败和完成视频。

影响：api/main.py、api/.env.example、web/components/storyboard-workbench.tsx、web/components/nodes/index.tsx、web/app/page.tsx、web/lib/api.ts。Sora 不再作为默认模型；真实模型 ID 通过 VIDEO_MODEL_SEEDANCE、VIDEO_MODEL_KLING、VIDEO_MODEL_VEO3 配置，真实视频 API 地址通过 VIDEO_API_BASE_URL/VIDEO_API_KEY 配置。

问题：分镜编排明细区默认占用太多顶部面积，展开后下方画布空间不足。

改动：明细区默认高度降为 320px，并增加底部拖拽手柄，可上推缩到 180px，也可下拉放大查看完整内容。

影响：web/components/storyboard-workbench.tsx。

问题：顶部分镜缩略图条和下方内嵌工作台都带分镜导航，看起来像两个不同板块。

改动：StoryboardBar 成为唯一分镜导航；StoryboardWorkbench 移除自己的标题栏、左侧分镜列表和底部快捷栏，只保留当前分镜的 4 图槽与改造目标明细。

影响：web/components/storyboard-bar.tsx、web/components/storyboard-workbench.tsx、web/app/page.tsx。

问题：元素改造节点等入口仍会打开 fixed inset-0 的全屏 StoryboardWorkbench，用户感觉像跳转页面。

改动：移除 StoryboardWorkbench 的 portal 全屏承载方式，改为渲染在顶部分镜栏下方；所有“打开编排”入口只展开这个内嵌区域。

影响：web/components/storyboard-workbench.tsx、web/components/storyboard-bar.tsx、web/app/page.tsx、web/components/nodes/index.tsx。

问题：关键帧详情钉住在浏览器左侧固定位置时，会遮挡顶部分镜头编排栏展开后的缩略图区域。

改动：给 StoryboardBar 增加稳定 DOM 标记；钉住面板实时读取该区域下边缘，并吸附到其下方。展开 / 折叠分镜头编排时，钉住面板自动让位。

影响：web/components/storyboard-bar.tsx、web/components/nodes/index.tsx。

问题：顶部 StoryboardBar 的“进入编排”和分镜缩略图点击会打开全屏 StoryboardWorkbench，打断当前画布流程。

改动：顶部按钮改为“展开编排”，只下拉展示当前分镜列表；缩略图点击只聚焦该分镜，不再触发全屏跳转。后续已把工作台整体改成内嵌下拉，见上方最新记录。

影响：web/components/storyboard-bar.tsx、web/app/page.tsx。

问题：钉住后仍像自由浮层一样停在画布附近，用户继续缩放画布或调整面板尺寸时容易把它和画布节点混在一起。

改动：钉住后统一吸附到浏览器左侧边缘，脱离 ReactFlow 画布缩放；钉住瞬间把当前可见大小转换成面板真实尺寸，之后只由右下角拖拽或标题栏按钮调整。

影响：web/components/nodes/index.tsx；钉住语义从“原地浮在上层”改为“左侧停靠工作面板”。

问题：只有按钮缩放不够直观；钉住后仍作为画布节点，会继续随 ReactFlow 画布缩放。

改动：增加右下角拖拽缩放手柄；钉住时通过 portal 固定到浏览器上层，脱离 ReactFlow 画布缩放和平移。

影响：web/components/nodes/index.tsx、web/app/page.tsx；未钉住时仍是画布节点，钉住后保持屏幕固定位置。

问题：面板可以拖动后，用户仍可能误拖；切换图片时希望保持固定工作位置。

改动：在标题栏增加钉子按钮。钉住后面板节点禁止拖动，切换关键帧只切换内容不移动位置；取消钉住后可继续拖动。

影响：web/app/page.tsx、web/components/nodes/index.tsx。

问题：用户把关键帧详情面板拖到合适位置后，再点击下一张关键帧会把面板拉回默认位置，造成视觉疲劳。

改动：已打开的面板只切换内容，不移动位置；只有面板不存在、首次打开时才放到默认位置并自动聚焦。

影响：web/app/page.tsx；关闭后重新打开仍会出现在默认位置。

问题：关键帧详情面板作为画布节点后可以随画布缩放，但面板自身没有尺寸控制，用户无法单独放大或缩小它。

改动：在面板标题栏增加 -、百分比重置、+ 控制，支持 75% 到 135% 的面板级缩放。

影响：web/app/page.tsx、web/components/nodes/index.tsx；点击新关键帧仍会找回到默认位置，缩放比例保留。

问题：关键帧详情 / 元素提取面板固定在左侧 drawer，和 ReactFlow 无限画布割裂，也不会跟随画布缩放。

改动：移除主页面隐藏渲染的 Dashboard drawer 承载方式，新增独立 keyframePanel ReactFlow 节点来挂载 FrameLightbox。

影响：web/app/page.tsx、web/components/nodes/index.tsx；点关键帧后面板默认出现在流程左侧空白画布里，不遮挡 Input / Keyframe 主节点；标题栏可拖动，跟随 ReactFlow 平移和缩放。再次点击关键帧缩略图会把面板找回到默认位置，并自动把视野拉到“关键帧 + 面板”。

问题：元素改造节点的 hover 预览虽然已改为节点内显示，但仍比关键帧节点复杂，多了“来源原帧 / 提取元素”两栏和元素名称，信息过载。

改动：改成和镜头拆解关键帧一致的简单预览：只显示来源原帧，底部显示分镜编号和时间。

影响：web/components/nodes/index.tsx；元素改造板块 hover 现在更轻，不干扰当前判断。

问题：上一版把元素预览用 createPortal 挂到 body，DevTools 里会出现额外 fixed 层，交互形态和关键帧节点不一致。

改动：改成节点内 group-hover 预览，不再向 body 插入预览层。后续又简化为只展示来源原帧，见上方最新记录。

影响：web/components/nodes/index.tsx；元素改造板块的 DOM 和交互效果更接近关键帧缩略图。

目的：把产品功能区、源码位置、接口、数据模型、需求描述方式固定下来，减少“描述不准导致改偏”。

影响：新增 docs/source-analysis.html，不接入 Next 应用，不影响工作台运行。

以后描述：可以直接引用本页的功能区名称、节点职责和源码文件名。

问题：元素改造节点上方小图 hover 没有像镜头拆解节点一样显示原图预览，并且首次修复时出现运行时错误。

原因：节点内部 overflow 裁剪了预览；随后 portal 预览里把变量写成了不存在的 aspectRatio。

影响：web/components/nodes/index.tsx。该记录之后又改为节点内预览，见上方最新记录。

问题：Vision 识别可能错，但元素列表像最终结果；点击提取图会跳页面，打断用户思路。

改动：支持元素改名、改英文提示、改位置、删除元素、重复提取、删除单张提取图；提取图不再用链接跳新页。

影响：FrameLightbox、web/lib/api.ts、PATCH /jobs/{job_id}/frames/{idx}/elements/{element_id}。

问题：从 Storyboard 或顶部分镜条进入编排时，没有明确定位到用户正在看的那一帧。

改动：工作台接受 focusedFrame，点击缩略图会打开工作台并聚焦对应分镜。

影响：page.tsx、StoryboardBar、StoryboardWorkbench、StoryboardNode。

问题：SKG 网关 audio 不通时，视觉解析也容易被标记失败。

改动：analyze 主流程强调拆轨和关键帧，声音文案轨独立处理。

影响：api/main.py、page.tsx、节点语义说明。