auto-save 2026-05-27 14:42 (~2)

docs/source-analysis.html

@@ -1277,6 +1277,19 @@ 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 blue">Backend</span>
+              <span class="tag green">Data</span>
+            </header>
+            <div class="body">
+              <p><strong>问题：</strong>画布项目从服务端拉取后，前端还会把浏览器 <code>localStorage</code> 里的项目通过 <code>POST /canvas-projects/import</code> 再导入一次；如果本地缓存是旧的、瘦身后的或缺少图片数据，可能覆盖同一个服务端项目，用户刷新后看到历史节点或生成记录变少。</p>
+              <p><strong>改动：</strong><code>web/canvas-app/src/stores/projects.js</code> 在画布节点变更时会调用 <code>scheduleRemoteSave(project)</code>，把当前项目正式同步到 <code>PUT /canvas-projects/{id}</code>；<code>api/main.py</code> 的 <code>/canvas-projects/import</code> 改为只迁移服务端缺失的本地旧项目，已存在项目直接返回服务端版本，不再由 localStorage 导入覆盖。</p>
+              <p><strong>影响：</strong>Postgres 里的 <code>canvas_projects</code> 重新成为主存储；刷新、换浏览器或本地缓存异常时，不应再把服务端项目缩小或清空。旧项目首次迁移仍可用，但迁移动作变为非破坏性。</p>
+            </div>
+          </article>
           <article class="change">
             <header>
               <h3>2026-05-26 · AI 润色改为意图分类和冲突校验</h3>