问题：连续按宽度铺满虽然消除了左右空白，但 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 消息作为聊天泡逐条显示；“我们将不再强制……”这类模型确认句默认收起，界面只展示当前生成要求摘要、保留元素 chips 和记录计数，最终英文 prompt 仍通过固定弹窗确认。

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

改动：SourceSubjectPipeline 恢复轻量对话式转换层：参考帧池缩略图新增 + 操作送入转换层；转换层内可选 GPT/Gemini 套件、分析 1-3 张参考图、查看特征 chips、通过对话生成英文 prompt。subject-agent/message 返回后只打开提示词确认弹窗，不直接生图；用户点“确定生成”才调用 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，默认 en，用于按官方建议降低英文素材延迟；翻译请求也套用 ASR_TIMEOUT_SECONDS。生产配置临时改成 ASR_REMOTE_ENABLED=false、ASR_LOCAL_FALLBACK_ENABLED=true、ASR_AUDIO_FALLBACK_ENABLED=false，云端用容器内 faster-whisper tiny.en 复制本地“真实本机转写”路径。

影响：音频解析不再卡在不存在的 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、节点语义说明。