diff --git a/.memory/worklog.json b/.memory/worklog.json index 8f126e4..aed135a 100644 --- a/.memory/worklog.json +++ b/.memory/worklog.json @@ -1,19 +1,5 @@ { "entries": [ - { - "files_changed": 3, - "hash": "e1bc89a", - "message": "auto-save 2026-05-12 17:12 (~3)", - "ts": "2026-05-12T17:12:16+08:00", - "type": "commit" - }, - { - "files_changed": 1, - "hash": "4fd43e8", - "message": "auto-save 2026-05-12 17:17 (~1)", - "ts": "2026-05-12T17:17:49+08:00", - "type": "commit" - }, { "files_changed": 2, "hash": "e6b8615", @@ -3352,6 +3338,19 @@ "type": "session-heartbeat", "message": "Claude 会话活跃 · 最近命令：claude · 2 项未提交变更 · 最近提交：auto-save 2026-05-14 06:11 (~6)", "files_changed": 2 + }, + { + "ts": "2026-05-14T06:17:00+08:00", + "type": "commit", + "message": "auto-save 2026-05-14 06:16 (~5)", + "hash": "f3f4c56", + "files_changed": 5 + }, + { + "ts": "2026-05-13T22:18:51Z", + "type": "session-heartbeat", + "message": "Codex 会话活跃 · 最近命令：codex · 2 项未提交变更 · 最近提交：auto-save 2026-05-14 06:16 (~5)", + "files_changed": 2 } ] } diff --git a/docs/source-analysis.html b/docs/source-analysis.html index 0f01d1b..52ae5d3 100644 --- a/docs/source-analysis.html +++ b/docs/source-analysis.html @@ -555,7 +555,7 @@
2

镜头拆解

拆轨、抽关键帧、手动加帧，形成参考分镜池。

3

清洗水印

对关键帧做全图或区域清洗，必要时应用为当前参考图。

4

主体识别

识别场景和主体候选，只是候选，不应锁死。

-
5

素材准备

清洗关键帧，先生成主体多视角/动作/表情资产包，再生成去主体、相似或换风格场景图。

+
5

素材准备

清洗关键帧，把多张关键帧作为同一主体的参考，先生成一个统一主体资产包，再按关键帧生成多个去主体、相似或换风格场景图。

6

分镜改造

把参考主体、场景、动作和 SKG 产品放入分镜结构。

7

生成视频

用分镜 4 图槽、改造目标和时长调用 Seedance / Kling / Veo 3 生视频 API，结果回写到画面工作台节点。

8

合成成品

片段、字幕、配音、转场合成最终 mp4。当前未实现。

@@ -571,7 +571,7 @@ web/app/page.tsx产品工作台主状态：jobs、activeJobId、selectedFrames、clipboard、ReactFlow 节点和边；负责打开/找回画布工作面板。 web/components/nodes/index.tsxDAG 节点定义：Input、VisualLab、Audio、Compose，以及画布工作面板 KeyframePanel / VideoFramePanel；旧 Keyframe/Storyboard/VideoGen 组件保留但不再挂主画布。 - web/components/lightbox.tsx关键帧素材准备面板：清洗、主体候选、主体资产包、去主体场景图和审核。 + web/components/lightbox.tsx关键帧素材准备面板：清洗、统一主体候选、统一主体资产包、每帧去主体场景图和审核。 web/components/storyboard-bar.tsx顶部分镜编排条：展示选入编排的关键帧，并作为唯一分镜导航。 web/components/storyboard-workbench.tsx顶部分镜编排条下方的明细区：4 图槽、改造目标、时长、自动保存。 web/lib/api.ts前端类型和 API client，是前后端数据契约镜像。 @@ -623,8 +623,8 @@ api/main.py
你看到的区域关键帧素材审核面板
-
主要源码FrameLightbox；按“原图/清洗、主体资产、场景图、审核”四个页签组织；左侧只放主图/框选画布，右侧承载当前页操作、状态和结果；场景图依赖主体资产，支持去主体原场景、相似新场景和同构换风格。相关接口包括 cleanupFrame、addElement、generateSubjectAssets、generateSceneAsset。
-
适合怎么描述“某张关键帧的水印、主体多视角/动作/表情图、去主体场景图和质量风险应该如何审核”。
+
主要源码FrameLightbox；按“原图/清洗、主体资产、场景图、审核”四个页签组织；左侧只放主图/框选画布，右侧承载当前页操作、状态和结果；主体资产页只确认一个统一主体，默认用全部关键帧或已选关键帧作为参考；场景图依赖主体资产，按当前关键帧生成去主体原场景、相似新场景或同构换风格。相关接口包括 cleanupFrame、addElement、generateSubjectAssets、generateSceneAsset。
+
适合怎么描述“这一组关键帧如何共同生成一个统一主体包；某张关键帧的水印、去主体场景图和质量风险应该如何审核”。
你看到的区域顶部分镜头编排下拉面板
@@ -664,7 +664,7 @@ api/main.py

KeyElement

-

从关键帧识别结果里确认出来的主体候选。Vision 给的是候选，用户可编辑、删除，并可基于它生成主体资产包。

+

从关键帧识别结果里确认出来的主体候选。当前素材准备流程只保留一个统一主体；多张关键帧通过 source_frame_indices 作为该主体的参考帧。

KeyElement {
   id,
   name_zh, name_en, position,
@@ -730,8 +730,8 @@ SubjectAsset {
             应用清洗POST /cleanup/applyapplyCleanedFrame物理覆盖 frames/{idx}.jpg，并备份原图。
             元素增改删POST/PATCH/DELETE /elementsaddElement/updateElement/deleteElement让用户修正 Vision 错误，避免候选结果锁死。
             元素提取POST /elements/{element_id}/cutoutcutoutElement调用图像模型生成独立白底素材图，每次累积一张 cutout。
-            主体资产包POST /elements/{element_id}/subject-assetsgenerateSubjectAssets根据用户选择的视图、动作和表情生成主体资产包；当多个关键帧都指向同一主体时，前端把已选关键帧作为 source_frame_indices 传入，后端拼参考板。
-            场景资产POST /frames/{idx}/scene-assetgenerateSceneAsset在主体资产之后生成去主体背景板；请求包含 scene_mode 和 scene_style，可做原场景补背景、相似新场景或同构换风格，保留历史版本用于人工审核。
+            主体资产包POST /elements/{element_id}/subject-assetsgenerateSubjectAssets根据用户选择的视图、动作和表情生成一个统一主体资产包；前端默认把全部关键帧作为 source_frame_indices，如果用户手动选择了关键帧则只传已选帧，后端拼参考板。
+            场景资产POST /frames/{idx}/scene-assetgenerateSceneAsset在统一主体资产之后，按当前关键帧生成去主体背景板；请求包含 scene_mode 和 scene_style，可做原场景补背景、相似新场景或同构换风格，保留历史版本用于人工审核。
             分镜保存PUT /frames/{idx}/storyboardupdateStoryboard保存 4 图槽、时长和改造说明。
             生图POST /frames/{idx}/generategenerateImage基于关键帧或已选生成图做 image-to-image，目前可用。
           
@@ -753,7 +753,7 @@ SubjectAsset {
             
             
               画面工作台 Visual Lab
-              作为素材准备看板：显示准备进度、质量风险、关键帧 / 主体包 / 场景图 / 分镜视频四个入口；上方缩略图按关键帧、主体包、场景图、视频任务分组。点击关键帧进入素材审核面板，点击资产图复制到分镜编排。
+              作为素材准备看板：显示准备进度、质量风险、关键帧 / 统一主体包 / 场景图 / 分镜视频四个入口；上方缩略图按关键帧、主体包、场景图、视频任务分组。点击关键帧进入素材审核面板，点击资产图复制到分镜编排。
               不要在主卡片里堆复杂表单；主卡片只做状态总览和入口。
               VisualLabNode、FrameLightbox、generateSceneAsset、generateSubjectAssets、视频任务接口
             
@@ -841,6 +841,19 @@ SubjectAsset {
         
变更记录

         
这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。

         

+          

+            

+              
2026-05-14 · 主体资产改为统一主体参考帧生成

+              FrameLightbox
+              Workflow
+            

+            

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

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

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

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

+            

+          

           

             

               
2026-05-14 · 场景图改为主体资产之后生成