auto-save 2026-05-27 14:53 (+1, ~6)

docs/source-analysis.html

@@ -1277,6 +1277,18 @@ ProductRefStateItem {
         <h2>变更记录</h2>
         <p>这个记录不是 git log 的替代品。它记录“产品理解发生了什么变化、影响了哪些源码、你以后描述需求时该怎么说”。后续每次改功能都要补一条。</p>
         <div class="changelog">
+          <article class="change">
+            <header>
+              <h3>2026-05-27 · 视频完成后自动回填画布节点</h3>
+              <span class="tag violet">Canvas</span>
+              <span class="tag amber">Video</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>画布视频任务提交后，完成状态主要依赖单个 <code>VideoNode.vue</code> 组件内部长轮询。如果组件轮询中断、页面后台挂起或节点未稳定挂载，服务端已经生成好的视频不会立刻写回当前画布，用户需要刷新页面后才看到结果。</p>
+              <p><strong>改动：</strong><code>web/canvas-app/src/hooks/useApi.js</code> 新增 <code>readVideoTask</code>，用于按 <code>skg:&lt;jobId&gt;:&lt;videoId&gt;</code> 读取服务端当前视频状态；<code>web/canvas-app/src/views/Canvas.vue</code> 增加页面级待完成视频同步器，每 5 秒扫描带 <code>taskId</code> 且没有 <code>url</code> 的视频节点，完成后自动写入视频 URL、清掉 <code>taskId</code> 并保存画布；<code>VideoNode.vue</code> 只负责展示节点状态，不再承担任务同步。</p>
+              <p><strong>影响：</strong>视频排队、生成中和完成状态会在当前打开的画布里自动更新；刷新页面仍可恢复未完成任务，但不再是看到视频结果的必要步骤。</p>
+            </div>
+          </article>
           <article class="change">
             <header>
               <h3>2026-05-27 · 修复刷新后画布记录被本地缓存覆盖</h3>