auto-save 2026-05-14 03:31 (~4)

docs/source-analysis.html

@@ -817,6 +817,42 @@ 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">Visual Lab</span>
+              <span class="tag blue">Dock</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>画面工作台点击关键帧后，关键帧详情 / 元素提取面板仍默认作为画布节点出现，还会触发 <code>fitView</code> 拉动画布；和视频抽帧面板默认左侧吸附的规则不一致。</p>
+              <p><strong>改动：</strong><code>framePanelPinned</code> 初始值改为 <code>true</code>；从关闭状态打开关键帧详情时默认吸附左侧。若面板已打开，用户取消钉住后继续切换关键帧，不会被强制吸回左侧；默认吸附状态下也不再触发画布 <code>fitView</code>。</p>
+              <p><strong>影响：</strong><code>web/app/page.tsx</code>、<code>docs/source-analysis.html</code>。画面工作台处理面板现在与视频抽帧面板保持同一默认策略：先贴左侧，需要时再切回画布。</p>
+            </div>
+          </article>
+          <article class="change">
+            <header>
+              <h3>2026-05-14 · 视频抽帧面板默认左侧吸附</h3>
+              <span class="tag violet">Canvas Panel</span>
+              <span class="tag blue">Dock</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>视频抽帧面板默认以画布节点方式打开时，用户还要再点一次吸附左侧，和“处理面板先贴边、需要时再拖回画布”的工作习惯不一致。</p>
+              <p><strong>改动：</strong><code>videoPanelDock</code> 初始值改为 <code>left</code>；从关闭状态双击输入视频缩略图时默认吸附左侧。面板已打开后，用户手动切换到画布 / 右侧 / 底部不会被找回动作覆盖。</p>
+              <p><strong>影响：</strong><code>web/app/page.tsx</code>、<code>docs/source-analysis.html</code>。后续同类处理面板应优先考虑“默认贴边，必要时切回画布”的交互。</p>
+            </div>
+          </article>
+          <article class="change">
+            <header>
+              <h3>2026-05-14 · 视频抽帧面板支持删除已抽关键帧</h3>
+              <span class="tag violet">Canvas Panel</span>
+              <span class="tag blue">Frames</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>视频抽帧面板只能新增关键帧，用户看到“已抽关键帧”后不能在同一工作上下文里清理误抽的帧。</p>
+              <p><strong>改动：</strong>已抽关键帧缩略图右上角增加删除按钮，点击后按 <code>jobId + frameIdx</code> 删除对应关键帧；删除期间显示小号 loading。图片类素材仍沿用快速删除策略，不弹确认。</p>
+              <p><strong>影响：</strong><code>web/app/page.tsx</code>、<code>web/components/nodes/index.tsx</code>、<code>docs/source-analysis.html</code>。视频抽帧面板不再依赖当前 active job 来决定删除目标。</p>
+            </div>
+          </article>
           <article class="change">
             <header>
               <h3>2026-05-14 · 吸附工作面板贴近视口边缘</h3>