修复旧精修事务稳定入口迁移

从已校验旧事务快照推导原稳定入口路径允许稳定入口缺失时在下一次提交重建补充旧事务连续精修回归测试与文档
2026-08-22 17:31:20 +08:00
parent b4788d6f87
commit 52a58f7514
4 changed files with 133 additions and 6 deletions
@@ -14353,6 +14353,7 @@

 - 图片精修的 manifest 继续指向不可变正式版本 `assets/canvas/<name>--<commitId>.png`；游戏源码已引用的原路径（例如 `assets/direct-game-background.png`）是稳定运行入口，不要求代码改写。
 - “设为最终图”提交、幂等重放和事务恢复都会校验不可变版本的字节、SHA-256、尺寸后刷新稳定入口。稳定入口缺失或损坏时，以不可变版本为恢复来源。
+- 旧事务 journal 尚无稳定入口字段时，后续精修必须从该事务已校验的 `manifest.before.json` 迁移原入口路径，不能因为当前 manifest 已指向 `assets/canvas/**` 而丢失游戏运行入口。

 ## 2026-08-21 JavaScript 工程统一为 npm workspaces

@@ -911,7 +911,7 @@ cancelling
 | A35 | 精修文件名包含历史提交后缀 | 后续精修重新打开当前 `localPath`，或再次生成 / 设为最终图 | 统一剥离文件名末尾一个或多个 `--<uuid>` 后缀并规范化为合法 1..=80 字符显示名；生成与最终提交使用同一结果 |
 | A36 | 确定性提交参数无效 | 候选提交名称或用途在校验阶段失败 | 在读取候选、staging、transaction 或 ledger 写入前零副作用失败；UI 作为输入校验错误允许继续编辑，不触发安全恢复 |
 | A37 | 候选首次确认 | 生成完成后与旧 autosave 并发 | 前端先同步 authoritative layers 并保存确认；确认前后端把未确认候选层合回旧保存，重启恢复可从私有 ledger 重建候选层，确认后的显式删除仍允许 |
-| A38 | 稳定运行入口 | 精修替换已在游戏源码中引用的图片 | manifest 指向不可变正式版本，同时原稳定入口路径不变并刷新为新版本字节；幂等重放和事务恢复会修复缺失或不匹配入口，游戏源码不需要改路径 |
+| A38 | 稳定运行入口 | 精修替换已在游戏源码中引用的图片，或继续精修旧版本事务创建的资源 | manifest 指向不可变正式版本，同时原稳定入口路径不变并刷新为新版本字节；新事务可从旧事务 `manifest.before.json` 迁移稳定入口身份，幂等重放和事务恢复会修复缺失或不匹配入口，游戏源码不需要改路径 |

 阶段一至五最终审计只有在矩阵对应的纯模型、共享 React、Web adapter、Tauri adapter、Rust 持久化与 AppSurface 测试全部通过后，才可宣称图片素材创作正式闭环完成。