删除已退役的客户端素材创作无限画布阶段一合同文档

- `docs/technical/【技术方案】客户端素材创作无限画布阶段一合同-2026-08-05.md` 整篇退役:该文档描述的中央 asset-canvas 状态、草稿 sidecar、Tauri 草稿/媒体/staging 命令、正式资产提交事务、提交事件、画布状态机与图片生成账本已随机制删除,按四不写不留墓碑文档。
- 仍有效内容已迁往:共享画布包目录与依赖方向、禁止复制的验收门、Host Port 边界、共享 chrome 与主题、图片能力与后续分期迁入 `docs/technical/【前端架构】图片画布编辑器前端拆分计划-2026-06-17.md`;成功投影顺序与焦点守卫迁入 `docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md`;共享源码与资源派生闭环现状迁入 `docs/technical/【技术方案】AI游戏创作智能体App实施计划-2026-06-24.md`。
- 全类型现有资源非破坏性编辑的现成权威条款为 `docs/technical/【技术方案】AGC资源派生与非破坏性编辑合同-2026-09-09.md`,它是 `project/resource_editor.rs` 的现行合同,已改写为 derive + editKind='image-reference' 口径。
- decision-log 的 2026-09-09 条目改写为决策文体:写清退役理由与现权威口径所在文档,历史条目保留原样。
- 过渡项删除条件:资源画布重建快速编辑后,`normalize_local_project_raster_resource` 重新获得前端调用方,届时删除 `apps/ai-game-creator-shell/scripts/check-config.mjs` 中该 allowlist 条目。
This commit is contained in:
2026-09-09 20:32:38 +08:00
parent 4c935ba219
commit 91396f0615
2 changed files with 4 additions and 1014 deletions
@@ -8189,11 +8189,12 @@ CI 上 `background_agent_runtime_recovers_stale_running_before_pending_task` 在
- 问题回答携带被回答卡片的 questionId,在已有回合锁内核对 Session 和当前问题;自由文本回答同样绑定问题,已完成回合保留幂等重放。此身份匹配服务于用户提交,不增加恢复门禁或模型输出要求。
- hydrate 结果(包括空结果)写入前端状态前同时核对请求序列和当前项目路径;过期结果直接丢弃,不重试、不阻塞正常 run。
## 2026-09-09 AGC asset-canvas 精修草稿整体退役(四不写)
## 2026-09-09 AGC 图片编辑改走资源派生,asset-canvas 精修草稿退役(四不写)
- V3.0 决策取消"单个图片的精修草稿"图片编辑统一走 `derive_local_project_resource``editKind='image-reference'`,结果固定创建新素材,源素材不变旧草稿画布按四不写整体删除,不保留兼容实现、墓碑注释或防御性测试
- 决策:V3.0 取消"单个图片的精修草稿"这一形态。理由有三:草稿画布把"编辑中间态"做成了需要持久化、锁、revision CAS、恢复对账和事务 journal 的第二套业务真相,成本与出错面远超它提供的价值;素材不可变(编辑产出新素材)与替换队列已经覆盖同一批用户场景,不需要原地改稿;网站美术编辑器与客户端各维护一份草稿画布,长期必然分叉。因此图片编辑统一走 `derive_local_project_resource``editKind='image-reference'`,结果固定创建新素材,源素材不变旧草稿画布按四不写整体删除。
- 现权威口径:图片及其它类型的来源核验、请求 DTO、幂等与恢复、资源身份血缘以新增的 `docs/technical/【技术方案】AGC资源派生与非破坏性编辑合同-2026-09-09.md` 为准;资源画布交互、投影与焦点竞态以 `docs/technical/【技术方案】GameAgent资源自由画板与快速编辑-2026-08-20.md` 为准;共享画布包、Host Port 与共享 chrome 以 `docs/technical/【前端架构】图片画布编辑器前端拆分计划-2026-06-17.md` 为准;工作台状态机以 `docs/prd/【AI游戏创作】项目开发工作台PRD-2026-07-20.md` 为准。原《客户端素材创作无限画布阶段一合同》整篇退役。
- 删除范围:Rust `project/asset_canvas.rs``project/asset_canvas/generation.rs``project/asset_canvas_tests.rs``project.rs` 的模块声明与再导出、`commands.rs` 的 18 个 Tauri 命令、`main.rs` 的 18 行注册;前端 `features/asset-canvas/` 四个文件、`index.tsx` 的草稿路由与提交事件链路、`styles.css``resources.asset-canvas` 选择器、`tests/assetCanvasSurface.test.tsx` 与相关草稿用例。
- 保留项:`canvas.asset_generate` 命令契约(`packages/shared``shared-contracts` 的正式权限合同,Agent Runtime 仍在使用);`asset-canvas-references``legacyPrefix=generated-character-drafts` 是 api-server 直传票据白名单契约,服务端白名单本次不动;`packages/image-canvas-core|react` 继续服务网站美术编辑器与资源画本视口;manifest 资产来源 `kind='canvas'`(网页画板项目)与本次退役无关。
- 路由口径:`resolveProjectResourceEditCapability` 不再返回 `image-canvas`PNG/JPEG/WebP 与其他图片类型一样走 `derive + image-reference`,不再要求先正规化为正式 manifest asset。
- 临时项`scripts/check-config.mjs` 的 native-only 白名单新增 `normalize_local_project_raster_resource`原前端调用方随草稿画布删除);资源画布重建快速编辑后重新获得调用方,届时删除该白名单条目。
- 过渡项(带删除触发条件)`scripts/check-config.mjs` 的 native-only 白名单新增 `normalize_local_project_raster_resource`,因为原前端调用方随草稿画布一起删除。资源画布重建快速编辑后,该命令重新获得前端调用方,届时删除这条 allowlist 条目。
- 存量数据:`.agent/workbench/asset-canvas/` 不写清理代码,不做迁移;只对目录做一次性手工清理,`.agent/workbench/` 下 resource-edits、replacement-queue 等在役目录不得整体删除。