auto-save 2026-05-14 04:10 (~4)

docs/source-analysis.html

@@ -817,6 +817,18 @@ api/main.py
         <h2>变更记录</h2>
         <p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
         <div class="changelog">
+          <article class="change">
+            <header>
+              <h3>2026-05-14 · 自动抽帧快捷工具条移到缩略图上方</h3>
+              <span class="tag violet">Input</span>
+              <span class="tag blue">Frame Target</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>自动抽帧入口放在 Input 卡片正文里，离视频缩略图和预览工作区较远；用户需要在看缩略图时快速切目标、切张数并反复抽取。</p>
+              <p><strong>改动：</strong>输入视频缩略图浮条上方新增自动抽帧快捷工具条，包含抽帧目标、张数快捷项和抽帧按钮。前端新增 <code>frameCount</code> 状态并把目标 / 张数传给 <code>analyzeJob</code>；已有关键帧时默认用 <code>mode=append</code> 追加抽取。</p>
+              <p><strong>影响：</strong><code>api/main.py</code>、<code>web/lib/api.ts</code>、<code>web/app/page.tsx</code>、<code>web/components/nodes/index.tsx</code>、<code>docs/source-analysis.html</code>。后端追加模式会保留已有关键帧，避开非常接近的时间点，并用新的 frame index 落盘。</p>
+            </div>
+          </article>
           <article class="change">
             <header>
               <h3>2026-05-14 · 自动抽帧支持目标化扫描</h3>
@@ -825,7 +837,7 @@ api/main.py
             </header>
             <div class="body">
               <p><strong>问题：</strong>单一“自动抽帧”无法表达这次要清晰人物、下次要转场变化或表情瞬间的不同目标；但把抽帧做成复杂参数面板会破坏 Input 卡片的轻量工作流。</p>
-              <p><strong>改动：</strong>Input 节点新增一个抽帧目标下拉，默认“综合关键帧”，可切换清晰主体、转场变化、表情瞬间、动作峰值。后端 <code>/jobs/{id}/analyze</code> 新增 <code>target</code> 参数，先低清低帧率扫描候选，再按目标评分、pHash 去重、时序分桶，最后只对选中的时间点从原视频抽高质量关键帧。</p>
+              <p><strong>改动：</strong>Input 节点新增抽帧目标，默认“综合关键帧”，可切换清晰主体、转场变化、表情瞬间、动作峰值。后端 <code>/jobs/{id}/analyze</code> 新增 <code>target</code> 参数，先低清低帧率扫描候选，再按目标评分、pHash 去重、时序分桶，最后只对选中的时间点从原视频抽高质量关键帧。</p>
               <p><strong>影响：</strong><code>api/main.py</code>、<code>web/lib/api.ts</code>、<code>web/app/page.tsx</code>、<code>web/components/nodes/index.tsx</code>、<code>docs/source-analysis.html</code>。当前“人物/动物表情”是本地近似评分，后续可把候选小图接入视觉模型重排。</p>
             </div>
           </article>