auto-save 2026-05-14 05:05 (~6)

docs/source-analysis.html

@@ -655,6 +655,8 @@ api/main.py
   index, timestamp, url,
   description,
   cleaned_url, cleaned_applied,
+  quality_report,
+  scene_assets: SceneAsset[],
   elements: KeyElement[],
   storyboard: StoryboardScene,
   generated_images: GeneratedImage[]
@@ -669,7 +671,25 @@ api/main.py
   source: auto | manual | region,
   region,
   cutouts: string[],
-  cutout_id
+  cutout_id,
+  subject_kind: object | living,
+  subject_assets: SubjectAsset[]
+}</pre>
+          </div>
+          <div class="card">
+            <h3>SceneAsset / SubjectAsset</h3>
+            <p>画面工作台素材准备阶段生成的组图资产。实际图片保存在 <code>jobs/&lt;jobId&gt;/assets</code>，可作为 <code>asset</code> 类型复制到分镜槽位。</p>
+            <pre>SceneAsset {
+  id, label, url,
+  width, height, quality, size,
+  quality_report
+}
+
+SubjectAsset {
+  id, view, label, url,
+  background: white | black,
+  width, height, size,
+  source_frame_indices[]
 }</pre>
           </div>
           <div class="card">
@@ -708,6 +728,8 @@ api/main.py
             <tr><td>应用清洗</td><td><code>POST /cleanup/apply</code></td><td><code>applyCleanedFrame</code></td><td>物理覆盖 frames/{idx}.jpg，并备份原图。</td></tr>
             <tr><td>元素增改删</td><td><code>POST/PATCH/DELETE /elements</code></td><td><code>addElement/updateElement/deleteElement</code></td><td>让用户修正 Vision 错误，避免候选结果锁死。</td></tr>
             <tr><td>元素提取</td><td><code>POST /elements/{element_id}/cutout</code></td><td><code>cutoutElement</code></td><td>调用图像模型生成独立白底素材图，每次累积一张 cutout。</td></tr>
+            <tr><td>场景资产</td><td><code>POST /frames/{idx}/scene-asset</code></td><td><code>generateSceneAsset</code></td><td>为每张已选关键帧生成一张去水印、高清增强的场景图，保留历史版本用于人工审核。</td></tr>
+            <tr><td>主体资产包</td><td><code>POST /elements/{element_id}/subject-assets</code></td><td><code>generateSubjectAssets</code></td><td>根据用户选择的视图、动作和表情生成主体资产包；当多个关键帧都指向同一主体时，前端把已选关键帧作为 <code>source_frame_indices</code> 传入，后端拼参考板。</td></tr>
             <tr><td>分镜保存</td><td><code>PUT /frames/{idx}/storyboard</code></td><td><code>updateStoryboard</code></td><td>保存 4 图槽、时长和改造说明。</td></tr>
             <tr><td>生图</td><td><code>POST /frames/{idx}/generate</code></td><td><code>generateImage</code></td><td>基于关键帧或已选生成图做 image-to-image，目前可用。</td></tr>
           </tbody>
@@ -729,9 +751,9 @@ api/main.py
             </tr>
             <tr>
               <td><span class="tag violet">画面工作台 Visual Lab</span></td>
-              <td>在一个画布卡片里展示关键帧、元素 cutout 和视频任务；点击缩略图进入对应处理面板。</td>
+              <td>在一个画布卡片里展示关键帧、元素 cutout、场景图、主体资产包和视频任务状态；点击缩略图进入对应处理面板。关键帧详情面板负责生成场景资产和主体多视角/动作/表情资产。</td>
               <td>不要在主卡片里堆复杂表单；主卡片只做状态总览和入口。</td>
-              <td><code>VisualLabNode</code>、<code>FrameLightbox</code>、<code>StoryboardWorkbench</code>、视频任务接口</td>
+              <td><code>VisualLabNode</code>、<code>FrameLightbox</code>、<code>generateSceneAsset</code>、<code>generateSubjectAssets</code>、视频任务接口</td>
             </tr>
             <tr>
               <td><span class="tag violet">分镜工作台</span></td>