From 8ac8f2ff5d2dbb8f7295f58344f400fd5f6e8a9b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=8E=8B=E5=BE=B7=E5=AE=87?= Date: Wed, 23 Sep 2026 19:12:19 +0800 Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=20run-workflow=20=E7=9A=84?= =?UTF-8?q?=E8=BD=AE=E6=AC=A1=E3=80=81=E6=BC=82=E7=A7=BB=E4=B8=8E=E5=86=99?= =?UTF-8?q?=E5=9B=9E=E5=B9=82=E7=AD=89=E5=8F=A3=E5=BE=84?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 检查点行补充 outdated 与起始 revision，明确 write-back / outdated 都是轮次结束行 - 追加前截断半行，避免崩溃留下的半行夹在日志中间 - 文档中途漂移时追加 outdated 并返回错误，由下一次调用显式开新一轮，不在同一次调用内自动重启 - 写回按「目标 State 与文档当前 State 相等」判幂等，并记录该判据成立的前提 - 切图资源失败不回滚，NeedReview 由 separation DTO 的 problematic_nodes 在编排阶段统一回写 --- ...技术方案】UI编辑器Agent工具化重写-2026-09-23.md | 13 +++++++++++-- 1 file changed, 11 insertions(+), 2 deletions(-) diff --git a/docs/technical/【技术方案】UI编辑器Agent工具化重写-2026-09-23.md b/docs/technical/【技术方案】UI编辑器Agent工具化重写-2026-09-23.md index b2d6c8c77..a7ecbddf9 100644 --- a/docs/technical/【技术方案】UI编辑器Agent工具化重写-2026-09-23.md +++ b/docs/technical/【技术方案】UI编辑器Agent工具化重写-2026-09-23.md @@ -39,15 +39,24 @@ 不再有合并、组件绑定与页面级 profile/finalize 阶段；`recognize` 之前不做任何前置发现。 +`NeedReview` 与 `component_status` 的清理是 `separation` DTO 的一部分：问题节点由 DTO 的 +`problematic_nodes` 给出，编排阶段统一回写，重放时不需要模型再判一次；文案与判据镜像 +前端 `features/ui-editor/separationStatus.ts`。 + ## 崩溃恢复 检查点是文档旁一条追加式 JSONL 日志，方案与被否方案见 [ADR：UI 工作流检查点用追加式 JSONL 日志](../adr/【ADR】UI工作流检查点用追加式JSONL日志-2026-09-23.md)。 - 位置：`ui/.<文档文件名去扩展名>-workflow.jsonl`，与文档同级，不进 manifest、不推进项目 revision。 -- 行格式：`run`（原始 State 快照）、`recognize`（DTO）、`separate`（DTO）、`write-back`（新 revision）；行内另带 `at` 时间戳。 +- 行格式：`run`（原始 State 快照 + 起始 revision）、`recognize`（DTO）、`separate`（DTO）、`write-back`（新 revision）、`outdated`（本轮作废原因）；行内另带 `at` 时间戳。 - 判据只有一条：「本步有没有对应的行」。每行必须一次性原子追加，崩溃留下的半行一律视为该步未完成。 -- 轮次：一轮以 `run` 行开头，以该轮第一行 `write-back` 结束；恢复只针对最后一个没有 `write-back` 的轮次。 +- 轮次：一轮以 `run` 行开头，以该轮第一行 `write-back` 或 `outdated` 结束；只有最后一轮没有结束行时才需要恢复。`outdated` 只作废未完成的那一轮，不删除既有行。 +- 半行：追加前先把日志截断到最后一个换行，丢掉崩溃留下的半行，避免它夹在日志中间。 +- 漂移：文档在轮次中途被改动（当前 State 与 `run` 行快照不一致）时，追加一行 `outdated` 并**返回错误**，不在同一次调用里自动重开新一轮；下一次调用看到 `outdated` 才从头开新一轮，且以当前文档为基准。 +- 写回幂等：`save` 成功但 `write-back` 行没追加时，重放会重建出同一份目标 State，此时按「目标 State 与文档当前 State 相等」判定为已写完，直接补 `write-back` 行并返回成功。这条判据成立的前提是工作流这条路不产生随机身份：识别树的根节点 id 来自 DTO，切图资源 id 走 manifest 的 by-path 复用。 +- 切图资源不回滚：切分产出的图片与已登记资源在失败后保留，重放靠 by-path 复用接上，不做回滚清理。 - 切分 op 内部的细粒度恢复仍由 `SeparationState` 承担（`ui-editor-separation-state.v2` sidecar），日志只记录工作流层面的步骤完成，不复制它的进度。 +- 不引入跨语言 fixture 比对：镜像的四个 seam 都是简单变换，靠同语义实现与各自单测覆盖，不为它们额外维护一套 golden。 ## 模块布局