auto-save 2026-05-14 03:59 (~3)

docs/source-analysis.html

@@ -596,7 +596,7 @@
 web/app/page.tsx
   -> ReactFlow 节点：web/components/nodes/index.tsx
   -> 主画布：Input → VisualLab / Audio → Compose
-  -> 画布内视频抽帧面板：InputNode 双击视频缩略图打开 videoFramePanel
+  -> 画布内视频抽帧面板：InputNode 单击视频缩略图打开 videoFramePanel
   -> 画布内镜头拆解面板：VisualLabNode 打开 keyframePanel，内嵌 web/components/lightbox.tsx
   -> 分镜工作台：web/components/storyboard-workbench.tsx（底层保留）
   -> API 契约：web/lib/api.ts
@@ -701,7 +701,7 @@ api/main.py
             <tr><td>创建任务</td><td><code>POST /jobs</code></td><td><code>createJob</code></td><td>提交 TK 链接，后台开始下载，停在 downloaded 等用户点解析。</td></tr>
             <tr><td>上传视频</td><td><code>POST /jobs/upload</code></td><td><code>uploadJob</code></td><td>保存 source.mp4，然后同样进入下载完成状态。</td></tr>
             <tr><td>删除输入视频</td><td><code>DELETE /jobs/{id}</code></td><td><code>deleteJob</code></td><td>从任务队列、URL 和磁盘 <code>jobs/&lt;id&gt;</code> 目录移除整个 job，包括源视频、关键帧、元素提取图和生成视频。</td></tr>
-            <tr><td>解析视频</td><td><code>POST /jobs/{id}/analyze</code></td><td><code>analyzeJob</code></td><td>拆轨 + 抽关键帧。当前不自动跑 ASR，避免 audio 阻塞视觉管线。</td></tr>
+            <tr><td>解析视频</td><td><code>POST /jobs/{id}/analyze?frames=&amp;target=</code></td><td><code>analyzeJob</code></td><td>拆轨 + 目标化抽关键帧。<code>target</code> 支持综合、清晰主体、转场变化、表情瞬间、动作峰值；当前不自动跑 ASR，避免 audio 阻塞视觉管线。</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>
@@ -723,7 +723,7 @@ api/main.py
           <tbody>
             <tr>
               <td><span class="tag blue">输入 Input</span></td>
-              <td>创建/上传任务，显示视频就绪，触发解析；双击视频缩略图打开画布内抽帧面板。</td>
+              <td>创建/上传任务，显示视频就绪，选择抽帧目标并触发解析；单击视频缩略图打开画布内抽帧面板。</td>
               <td>不要自动一路跑到 ASR 或生图；用户需要控制解析节奏。</td>
               <td><code>page.tsx</code>、<code>InputNode</code>、<code>VideoFramePanelNode</code>、<code>api/main.py</code></td>
             </tr>
@@ -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>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>
           <article class="change">
             <header>
               <h3>2026-05-14 · 视频抽帧面板默认静音播放</h3>