staged

2026-07-30 15:43:22 +08:00
parent 3a64411e8c
commit a3d83b2d06
17 changed files with 901 additions and 77 deletions
@@ -16,6 +16,17 @@

 ---

+## 2026-07-29 画布 Agent 工具生命周期区分确认任务与即时执行
+
+- 背景：原 `EditorAgentTool` 默认要求每个工具都实现定价、确认展示和 external job payload，无法表达不调用生成模型、零收费且无需确认的确定性拆图；同时角色动作已有正式 worker 能力但尚未进入 Agent 工具面。
+- 决策：工具统一声明 `ConfirmedExternalJob` 或 `Immediate` 生命周期。收费生成工具仅在产生待确认输出后读取运行时定价，确认后复用既有 external job；`generate-character-animation` 复用 `editor_character_animation_generation`。`split-elements` 只接受当前画布项目中的 `ui-design` / `icon-spritesheet`，在规划回合内直接复用连通域切片、项目资源 / 素材库持久化和画布回填，成功消息直接写 `completed`，不读取定价、不展示确认卡、不创建零价队列任务。同一规划运行内按源资源复用即时拆图结果，避免模型重复调用造成重复切片。
+- 边界：不修改 SpacetimeDB schema、外部 OpenAPI、钱包规则或现有生成 job；直接拆图仍受现有图片尺寸、像素数、切片数量、资源归属和画布写回门禁约束。
+- 影响范围：`platform-editor-agent` 工具定义与 prompt、`api-server/src/editor_agent` 生命周期和结果持久化、既有图集拆分 helper、Agent 前端完成态刷新及编辑器专题文档。
+- 验证方式：运行 `cargo test -p platform-editor-agent --manifest-path server-rs/Cargo.toml`、`cargo test -p api-server editor_agent --manifest-path server-rs/Cargo.toml`、即时 UI 拆图来源类型测试、Agent 前端 hook 定向测试、`cargo check -p api-server --manifest-path server-rs/Cargo.toml`、`npm run typecheck`、编码和 diff 检查。
+- 关联文档：`docs/【编辑器】画布Agent对话面板-2026-07-03.md`、`docs/technical/【后端架构】外部生成Worker化方案-2026-06-03.md`、`docs/technical/【前端架构】图片画布编辑器MVP接入方案-2026-06-11.md`。
+
+---
+
 ## 2026-07-29 角色带背景原图与透明图统一交付尺寸

 - 背景：图片画布已将模型原生回图归一到统一业务像素矩阵，但角色分支为了保留 provider 原生分辨率，先持久化带背景原图，只在扣背后归一透明主图。因此同一个 1K 角色任务会同时给出模型原生大图和长边 `1024` 的透明图。