auto-save 2026-05-14 02:02 (+3, ~5)

docs/source-analysis.html

@@ -618,7 +618,7 @@ api/main.py
           <div class="flow-row">
             <div><strong>你看到的区域</strong><span>镜头拆解节点上方关键帧</span></div>
             <div><strong>主要源码</strong><span><code>KeyframeNode</code> 内嵌 <code>FrameLightbox</code>；后端 <code>/frames</code>、<code>/describe</code>、<code>/cleanup</code>。</span></div>
-            <div><strong>适合怎么描述</strong><span>“关键帧详情面板在无限画布上怎么展示、缩放、跟随，以及清洗/识别/元素提取的操作顺序”。</span></div>
+            <div><strong>适合怎么描述</strong><span>“关键帧详情面板在无限画布上怎么展示、缩放、跟随；缩略图 hover 原尺寸预览要贴缩略图上边缘，不是贴节点卡片上边缘”。</span></div>
           </div>
           <div class="flow-row">
             <div><strong>你看到的区域</strong><span>元素列表和提取图</span></div>
@@ -628,7 +628,7 @@ api/main.py
           <div class="flow-row">
             <div><strong>你看到的区域</strong><span>元素改造 · Storyboard 节点</span></div>
             <div><strong>主要源码</strong><span><code>StoryboardNode</code>；上方元素缩略图来自所有已提取 cutouts。</span></div>
-            <div><strong>适合怎么描述</strong><span>“这里是素材入口，不是最终视频编辑器；点击是否进入工作台要不要打断当前任务”。</span></div>
+            <div><strong>适合怎么描述</strong><span>“这里是素材入口，不是最终视频编辑器；缩略图 hover 预览仍在无限画布里，并贴当前缩略图的上边缘”。</span></div>
           </div>
           <div class="flow-row">
             <div><strong>你看到的区域</strong><span>顶部分镜条</span></div>
@@ -831,6 +831,18 @@ api/main.py
         <h2>变更记录</h2>
         <p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
         <div class="changelog">
+          <article class="change">
+            <header>
+              <h3>2026-05-14 · 缩略图 hover 原尺寸预览贴缩略图上边缘</h3>
+              <span class="tag violet">Canvas</span>
+              <span class="tag blue">HoverPreview</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>用户要的是“鼠标停在卡片缩略图上时，原尺寸图片/视频在该缩略图上方边缘展示，并且仍属于无限画布”；不能贴节点卡片上边缘，也不能放到页面 fixed 层。</p>
+              <p><strong>改动：</strong><code>HoverPreview</code> 增加缩略图锚点坐标，预览层仍渲染在 ReactFlow 节点 DOM 内，但用缩略图的中心 x 和 top y 定位，预览底边贴缩略图上边缘；Input 视频、镜头拆解关键帧、元素改造 cutout、生成视频缩略图统一走该逻辑。</p>
+              <p><strong>影响：</strong><code>web/components/nodes/hover-preview.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-13 · 打开应用自动恢复历史 job</h3>