修复素材精修提交与事务恢复

统一解析精修素材名并剥离历史提交后缀将候选提交参数校验前移到零副作用阶段严格识别被后续提交取代的旧事务并增加并发提交门禁支持生成占位卡拖动和精修候选唯一提交补充素材画布回归测试与合同文档
2026-08-22 15:18:16 +08:00
parent c4bf7e02d0
commit 502dc231c1
11 changed files with 1307 additions and 43 deletions
@@ -4808,3 +4808,10 @@

 - 只依赖共享画布的全局 `MIN_SCALE/MAX_SCALE`，或只在“复位”时 fit，不会约束滚轮和平移拖拽；用户仍能把整个资源世界移到视口外。每一个 viewport 写入口都必须经过同一个边界函数，容器尺寸和资源 extent 改变后也要重新约束。
 - 隐藏边界不能从搜索后的 `visibleResources` 派生，否则输入搜索词会突然收缩边界并跳动 viewport。应使用全项目布局 positions、真实卡片尺寸和分区世界 extent，搜索只控制渲染与连线可见性。
+
+## 素材画布旧提交不能只按当前状态猜测恢复（2026-08-22）
+
+- 现象：同一 refine 资源的旧事务停在 `reconciliation-required`，后续另一笔事务已成功并更新当前 manifest/revision。恢复器只对比旧事务自己的 before/after 快照时，会把“已被后续提交取代”永久误报为需要人工对账。
+- 处理：只有后继事务 committed、项目/草稿/资源身份一致、旧 after 与后继 before 精确衔接、后继 after 与当前 manifest/revision 精确一致、两份候选文件与 manifest 唯一引用都验证通过时，才把旧事务标为 `superseded`；候选文件和审计记录都保留。任何证据不完整继续失败关闭。
+- 门禁：同一资源存在 prepared 或 reconciliation 事务时，新的“设为正式图”提交必须先被拒绝并引导安全恢复，不能继续制造另一笔可能覆盖旧结果的提交。`committed/rolled-back/superseded` 是可继续后续提交的终态。
+- 关联坑：正式文件路径会追加 commitId，重新打开 refine 时不能把整个文件 stem 当作下一次素材名，否则多次精修后超过 80 字符并阻塞提交。路径只推导显示名，且必须循环剥离历史 `--<uuid>` 后缀；确定性名称/用途校验要发生在读取候选与 staging 前，并按输入错误处理而不是进入事务恢复。