kangwan/20260512-skg-tk
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

auto-save 2026-05-14 05:32 (~4)

Browse Source
This commit is contained in:
kang
2026-05-14 05:32:54 +08:00
parent 2c19b52a81
commit f3636a5ec7
4 changed files with 60 additions and 97 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
docs/source-analysis.html
View File

@@ -554,9 +554,9 @@
<div class="step"><div class="num">1</div><h3>输入</h3><p>TK 链接或本地上传，后端下载/保存源视频。</p></div>
<div class="step"><div class="num">2</div><h3>镜头拆解</h3><p>拆轨、抽关键帧、手动加帧，形成参考分镜池。</p></div>
<div class="step"><div class="num">3</div><h3>清洗水印</h3><p>对关键帧做全图或区域清洗，必要时应用为当前参考图。</p></div>
<div class="step"><div class="num">4</div><h3>Vision 识别</h3><p>识别场景和候选元素，只是候选，不应锁死。</p></div>
<div class="step"><div class="num">5</div><h3>元素提取</h3><p>编辑/新增/删除元素，对元素反复生成提取图。</p></div>
<div class="step"><div class="num">6</div><h3>元素改造</h3><p>把参考主体、场景、动作和 SKG 产品放入分镜结构。</p></div>
<div class="step"><div class="num">4</div><h3>主体识别</h3><p>识别场景和主体候选，只是候选，不应锁死。</p></div>
<div class="step"><div class="num">5</div><h3>素材准备</h3><p>清洗关键帧，生成场景图和主体多视角/动作/表情资产包。</p></div>
<div class="step"><div class="num">6</div><h3>分镜改造</h3><p>把参考主体、场景、动作和 SKG 产品放入分镜结构。</p></div>
<div class="step"><div class="num">7</div><h3>生成视频</h3><p>用分镜 4 图槽、改造目标和时长调用 Seedance / Kling / Veo 3 生视频 API，结果回写到画面工作台节点。</p></div>
<div class="step"><div class="num">8</div><h3>合成成品</h3><p>片段、字幕、配音、转场合成最终 mp4。当前未实现。</p></div>
</div>
@@ -571,7 +571,7 @@
<tbody>
<tr><td><code>web/app/page.tsx</code></td><td>产品工作台主状态：jobs、activeJobId、selectedFrames、clipboard、ReactFlow 节点和边；负责打开/找回画布工作面板。</td></tr>
<tr><td><code>web/components/nodes/index.tsx</code></td><td>DAG 节点定义：Input、VisualLab、Audio、Compose，以及画布工作面板 KeyframePanel / VideoFramePanel；旧 Keyframe/Storyboard/VideoGen 组件保留但不再挂主画布。</td></tr>
<tr><td><code>web/components/lightbox.tsx</code></td><td>镜头拆解和元素提取的主工作面板：清洗、识别、元素编辑、区域提取、抠图。</td></tr>
<tr><td><code>web/components/lightbox.tsx</code></td><td>关键帧素材准备面板：清洗、场景图、主体候选、主体资产包和审核。</td></tr>
<tr><td><code>web/components/storyboard-bar.tsx</code></td><td>顶部分镜编排条：展示选入编排的关键帧，并作为唯一分镜导航。</td></tr>
<tr><td><code>web/components/storyboard-workbench.tsx</code></td><td>顶部分镜编排条下方的明细区：4 图槽、改造目标、时长、自动保存。</td></tr>
<tr><td><code>web/lib/api.ts</code></td><td>前端类型和 API client，是前后端数据契约镜像。</td></tr>
@@ -618,12 +618,12 @@ api/main.py
</div>
<div class="flow-row">
<div><strong>你看到的区域</strong><span>画面工作台 · Visual Lab</span></div>
<div><strong>主要源码</strong><span><code>VisualLabNode</code> in <code>web/components/nodes/index.tsx</code>；它现在是素材准备看板，汇总关键帧、场景图、主体资产包、普通抠图和视频任务。</span></div>
<div><strong>主要源码</strong><span><code>VisualLabNode</code> in <code>web/components/nodes/index.tsx</code>；它现在是素材准备看板，汇总关键帧、场景图、主体资产包和视频任务。</span></div>
<div><strong>适合怎么描述</strong><span>“画面工作台的素材准备进度、分组缩略图、关键帧审核入口和后续分镜入口应该如何组织”。</span></div>
</div>
<div class="flow-row">
<div><strong>你看到的区域</strong><span>关键帧素材审核面板</span></div>
<div><strong>主要源码</strong><span><code>FrameLightbox</code>；按“原图/清洗、场景图、主体包、审核”四个页签组织；相关接口包括 <code>cleanupFrame</code>、<code>generateSceneAsset</code>、<code>generateSubjectAssets</code>、<code>cutoutElement</code>。</span></div>
<div><strong>主要源码</strong><span><code>FrameLightbox</code>；按“原图/清洗、场景图、主体资产、审核”四个页签组织；相关接口包括 <code>cleanupFrame</code>、<code>addElement</code>、<code>generateSceneAsset</code>、<code>generateSubjectAssets</code>。</span></div>
<div><strong>适合怎么描述</strong><span>“某张关键帧的水印、场景图、主体多视角/动作/表情图和质量风险应该如何审核”。</span></div>
</div>
<div class="flow-row">
@@ -664,7 +664,7 @@ api/main.py
</div>
<div class="card">
<h3>KeyElement</h3>
<p>从关键帧里识别或手动添加的可借鉴元素。Vision 给的是候选，用户可编辑，并可多次生成提取图。</p>
<p>从关键帧里识别或手动添加的主体候选。Vision 给的是候选，用户可编辑、删除，并可基于它生成主体资产包。</p>
<pre>KeyElement {
id,
name_zh, name_en, position,
@@ -751,7 +751,7 @@ SubjectAsset {
</tr>
<tr>
<td><span class="tag violet">画面工作台 Visual Lab</span></td>
<td>作为素材准备看板：显示准备进度、质量风险、关键帧 / 场景图 / 主体包 / 分镜视频四个入口；上方缩略图按关键帧、场景图、主体包、普通抠图、视频任务分组。点击关键帧进入素材审核面板，点击资产图复制到分镜编排。</td>
<td>作为素材准备看板：显示准备进度、质量风险、关键帧 / 场景图 / 主体包 / 分镜视频四个入口；上方缩略图按关键帧、场景图、主体包、视频任务分组。点击关键帧进入素材审核面板，点击资产图复制到分镜编排。</td>
<td>不要在主卡片里堆复杂表单；主卡片只做状态总览和入口。</td>
<td><code>VisualLabNode</code>、<code>FrameLightbox</code>、<code>generateSceneAsset</code>、<code>generateSubjectAssets</code>、视频任务接口</td>
</tr>
@@ -787,8 +787,8 @@ SubjectAsset {
<li>视频下载或本地保存，ffmpeg 抽关键帧。</li>
<li>手动按时间戳加关键帧。</li>
<li>关键帧清洗水印，全图或区域清洗。</li>
<li>Vision 识别关键帧，输出 scene、objects、style、suggested_prompt。</li>
<li>元素增改删、区域元素添加、元素多次提取图。</li>
<li>Vision 识别关键帧，输出 scene、objects、style、suggested_prompt，并作为主体候选来源。</li>
<li>主体候选增改删、区域主体添加、主体资产包生成。</li>
<li>分镜工作台 4 图槽和改造说明自动保存。</li>
<li>nano-banana-pro image-to-image 生图。</li>
</ul>
@@ -813,8 +813,8 @@ SubjectAsset {
<h2>需求描述模板</h2>
<div class="todo">
<div class="todo-item">
<h3>改镜头拆解 / 元素提取</h3>
<p>“我在关键帧 lightbox 里，Vision 识别后的元素列表应该怎么编辑/重提取/删除；点击元素不要跳转；提取图怎么预览和复制。”</p>
<h3>改关键帧素材准备</h3>
<p>“我在关键帧素材准备面板里，主体候选应该怎么编辑/删除；场景图和主体资产包怎么生成、审核、复制到分镜。”</p>
</div>
<div class="todo-item">
<h3>改 Storyboard 节点</h3>
@@ -839,6 +839,18 @@ SubjectAsset {
<h2>变更记录</h2>
<p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
<div class="changelog">
<article class="change">
<header>
<h3>2026-05-14 · 关键帧详情改为素材准备面板</h3>
<span class="tag violet">FrameLightbox</span>
<span class="tag blue">UX</span>
</header>
<div class="body">
<p><strong>问题：</strong>面板标题仍叫“关键帧详情 · 元素提取”，里面还露出普通 cutout 抠图、AI 提取、元素清单等旧流程入口；“选用此帧”也无法说明它其实是在维护目标关键帧集合。</p>
<p><strong>改动：</strong><code>KeyframePanelNode</code> 标题改为“关键帧素材准备”；<code>FrameLightbox</code> 的主体页改成“主体识别 / 主体清单 / 主体资产包”，移除普通抠图列表和 AI 提取按钮；“选用此帧”改为“加入目标帧 / 目标帧 · 点击移出”。<code>VisualLabNode</code> 上方缩略图也不再展示普通抠图分组，只展示关键帧、场景图、主体包和视频任务。</p>
<p><strong>影响：</strong><code>web/components/lightbox.tsx</code>、<code>web/components/nodes/index.tsx</code>、<code>docs/source-analysis.html</code>。底层旧 cutout 数据和接口暂保留兼容历史任务，但不再作为新素材准备流程的可见入口。</p>
</div>
</article>
<article class="change">
<header>
<h3>2026-05-14 · 画面工作台改为素材准备看板</h3>
@@ -847,7 +859,7 @@ SubjectAsset {
</header>
<div class="body">
<p><strong>问题：</strong>画面工作台从展示缩略图扩展为素材生产中枢后，关键帧、场景图、主体资产包和视频任务继续混在一个列表里会让流程不清晰；关键帧详情面板也把清洗、识别、场景和主体生成都堆在一屏。</p>
<p><strong>改动：</strong><code>VisualLabNode</code> 改成素材准备进度看板，显示目标关键帧、场景图、主体资产和分镜/视频四个入口，并在上方缩略图中按关键帧、场景图、主体包、普通抠图、视频任务分组。<code>FrameLightbox</code> 新增“原图/清洗、场景图、主体包、审核”四个页签，素材审核信息从普通元素列表中拆出来。</p>
<p><strong>改动：</strong><code>VisualLabNode</code> 改成素材准备进度看板，显示目标关键帧、场景图、主体资产和分镜/视频四个入口。<code>FrameLightbox</code> 新增“原图/清洗、场景图、主体资产、审核”四个页签，素材审核信息从普通列表中拆出来。</p>
<p><strong>影响：</strong><code>web/components/nodes/index.tsx</code>、<code>web/components/lightbox.tsx</code>、<code>docs/source-analysis.html</code>。这轮只重排工作台信息架构，批量自动准备队列仍留到下一阶段。</p>
</div>
</article>