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

auto-save 2026-05-14 05:54 (~3)

Browse Source
This commit is contained in:
kang
2026-05-14 05:54:57 +08:00
parent a98639a33e
commit 6904a28c7a
3 changed files with 105 additions and 173 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
docs/source-analysis.html
View File

@@ -623,7 +623,7 @@ api/main.py
</div>
<div class="flow-row">
<div><strong>你看到的区域</strong><span>关键帧素材审核面板</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><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">
@@ -724,7 +724,7 @@ SubjectAsset {
<tr><td>解析视频</td><td><code>POST /jobs/{id}/analyze?frames=&amp;target=&amp;mode=&amp;quality=</code></td><td><code>analyzeJob</code></td><td>拆轨 + 目标化抽关键帧。<code>target</code> 支持综合、清晰主体、转场变化、表情瞬间、动作峰值；<code>mode=append</code> 追加新关键帧；<code>quality=auto</code> 根据本机算力和视频时长自动选择快速、精细或极准。多个抽帧请求进入后端队列顺序处理。</td></tr>
<tr><td>手动加帧</td><td><code>POST /jobs/{id}/frames?t=</code></td><td><code>addManualFrame</code></td><td>按视频时间戳抽一帧，index 递增但 frames 按 timestamp 排序。</td></tr>
<tr><td>Vision 识别</td><td><code>POST /frames/{idx}/describe</code></td><td><code>describeFrame</code></td><td>写入 frame.description，后续可从 objects 加候选元素。</td></tr>
<tr><td>清洗水印</td><td><code>POST /frames/{idx}/cleanup</code></td><td><code>cleanupFrame</code></td><td>支持全图和区域清洗，生成 cleaned 待应用版本；前端批量清洗会顺序调用该接口，不自动覆盖原图。</td></tr>
<tr><td>清洗水印</td><td><code>POST /frames/{idx}/cleanup</code></td><td><code>cleanupFrame</code></td><td>支持全图和区域清洗，生成 cleaned 待应用版本；前端批量清洗会顺序调用该接口，不自动覆盖原图。单帧清洗状态按 frame.index 隔离，清洗某一张不会禁用其他关键帧的清洗按钮。</td></tr>
<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>
@@ -839,6 +839,30 @@ 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">Layout</span>
</header>
<div class="body">
<p><strong>问题：</strong>移除旧元素提取和手工加主体入口后，关键帧详情右侧内容变少，继续占用大列会压缩左侧主图和清洗操作区。</p>
<p><strong>改动：</strong><code>FrameLightbox</code> 在“原图/清洗、场景图、审核”页把右侧改成固定窄状态栏，左侧主图和操作区获得更大宽度；“主体资产”页仍保留较宽右栏，用于主体识别、主体清单和资产包。</p>
<p><strong>影响：</strong><code>web/components/lightbox.tsx</code>、<code>docs/source-analysis.html</code>。</p>
</div>
</article>
<article class="change">
<header>
<h3>2026-05-14 · 单帧清洗不再全局锁住其他帧</h3>
<span class="tag violet">FrameLightbox</span>
<span class="tag blue">Bugfix</span>
</header>
<div class="body">
<p><strong>问题：</strong>单独清洗某一张关键帧时，前端使用全局 <code>cleaning</code> 布尔状态，导致切到其他关键帧后清洗按钮仍被禁用。</p>
<p><strong>改动：</strong><code>FrameLightbox</code> 改用 <code>cleaningFrameIds</code> 按 <code>frame.index</code> 记录正在清洗的帧，只禁用当前正在清洗的那一张；其他帧可以继续单独清洗。区域清洗完成时也只在用户仍停留于同一帧时清空当前框选，避免异步完成误清别的帧操作状态。</p>
<p><strong>影响：</strong><code>web/components/lightbox.tsx</code>、<code>docs/source-analysis.html</code>。</p>
</div>
</article>
<article class="change">
<header>
<h3>2026-05-14 · 清洗页支持一键批量清洗</h3>