资产任务编排与发布

一张餐桌放进房间后，几何检查通过了，入口到座位的通道却被挡住。规划器把桌子移开，视觉审核又要求取消这次布局。此时系统既要恢复任务自己的修改，也要保留期间发生的人工编辑；工具超时或进程中断还可能让执行结果暂时未知。

模型从需求中找出候选资产，工具把资产写入场景，验证器判断结果是否符合要求。三者处理不同的信息：模型处理语义与候选，工具执行明确的状态变化，验证器读取实际产物。任务记录连接这些步骤，中断以后据此恢复。

本文沿任务J布置房间R和桌子T。J先创建房间与桌子，移动A调整桌子位置，导航拒绝后移动B让出通道。技术门禁通过时进入视觉审核；审核取消则逆序撤销B、A和创建操作。人工编辑与取消相遇时，审核者决定保留哪些对象，执行器据决议继续清理。发布是另一条分支：审核批准绑定完整布局哈希，消费者加载该版本。各专题中的版本、回执和游标都对应这批对象。

任务状态与产物

任务先记录自己推进到哪里，再记录这一阶段实际产生的场景与报告。J把移动A后的验证命名为V1，移动B后的验证命名为V2；两份报告分别归属自己的布局快照。下面的记录串起正向执行、审核和取消。

阶段	消费的记录	产生的记录
创建与移动A	固定资产、场景读集和条件计划	宿主回执、实际对象与关系版本
V1拒绝、移动B	V1失败位置及新的场景读集	B回执、V2绑定的实际快照
视觉审核	V2报告、同一快照的预览	批准记录或取消请求
发布	批准候选及完整不可变清单	入口代次与发布回执
取消	全部已接纳操作的终态	补偿链、冲突决议及残留清单

状态推进

任务从接收需求进入解析、规划、计划校验、执行、技术验证和视觉审核。每次转换记录前置条件、输入、输出和责任方。执行失败进入返工或失败状态，取消先停止派发新操作，等待已发工具返回终态或完成对账，再按登记补偿已应用的变更，最后进入取消终态；只有对应产物通过门禁，才能进入批准状态。

text

Received -> Parsed -> Planned -> PlanValidated -> Executing
         -> TechnicalValidation -> VisualReview -> Approved
Approved -> Publishing -> Published
Any active stage -> Rework / Failed / Cancelling
Cancelling -> Cancelled / CancelledWithRetainedObjects / CompensationConflict
CompensationConflict -> Cancelling / CancelledWithRetainedObjects

这是流程状态定义。调度器将当前状态与输入输出ID持久化，模型上下文只用于重建推理所需的信息。若资产已经生成但状态记录丢失，恢复时通过操作ID与产物清单对账，而不是重新生成一份。

任务与产物记录

任务记录保存需求、目标平台、约束、工作流版本、工具权限、当前阶段、尝试次数、输入输出ID、验证结果和成本。产物记录保存稳定ID、内容哈希、来源与许可、派生关系、模型与工具版本、提示词、随机种子、编辑历史和发布状态。

这条派生链让维护者能回答“哪个输入产生了这个模型”“换一个依赖会影响哪些下游资产”。文件名相同而哈希不同，就是不同内容。人工调整形成新版本，并保存它相对上一生成版本的字段差异。重跑时以旧生成G0为共同基线，比较人工版本U与新生成G1：U未改的字段可用G1；只有U改的字段保留U；两者都改且值不同则进入冲突。对象删除与引用变化按稳定ID参与相同对照。比如人工移动了桌子，新计划也换了桌子尺寸，保留人工位置后还要重新检查净空，不能只把人工字段贴回去就认定新布局有效。

推理与工具接口

角色与数据契约

需求解析角色输出尺寸、风格、预算和格式，缺失与冲突单独记录。规划角色把需求分解成功能区、通道和约束；资产选择角色在批准目录内筛选候选；执行角色只应用已校验的目标布局。验证角色读取结果与既定规则，输出具体失败位置和返工建议。

每个角色声明输入、可调用工具、输出结构、判断标准和失败表达。输出先经过结构校验，再进入下一阶段。模型生成了合法JSON，只能说明字段可解析；资产是否存在、尺寸是否兼容、布局是否可达，仍由数据查询与规则检查决定。

提示词保存稳定职责和少量示例，当前资产通过检索返回有限候选。查询先按许可、平台、尺寸上限和格式等硬约束过滤，再把剩余条目的稳定ID、版本、尺寸、预算与预览交给模型排序。模型选中的ID必须属于该次结果集合，资产版本写入计划。没有满足硬约束的候选时报告缺失条件，不能生成一个目录中不存在的ID来让计划通过。

计划校验还检查父子引用无环、每个目标ID唯一、变换数值有限，以及每项操作所需权限。结构合法后才计算几何和预算；执行器只接受同一计划哈希，不允许模型在执行过程中无记录地换资产。这样每次决策都能对应到实际查询结果与被批准的计划。

工具参数与执行边界

text

search_assets(query, constraints)
get_asset_metadata(asset_id)
spawn_asset(asset_id, transform, parent, operation_id)
move_asset(instance_id, transform, operation_id)
validate_scene(scene_id, ruleset)
render_preview(camera_id, preset)
publish_staging(job_id, expected_hash)

这是接口示意。变换参数注明单位与坐标系，资产与场景使用稳定ID，修改操作带操作ID、计划哈希、读取集合和修改集合。返回值包含结果、实际变更的产物、错误码、警告与重试属性，便于调度器区分输入错误和暂时性故障。

规划器只读需求与目录，执行器写入任务专属暂存场景，验证器读取产物并写报告，发布器在批准条件满足后切换正式版本。路径与网络范围由执行层校验；外部文档、资产名和元数据始终作为数据处理，其中出现的命令不能改变工具权限。

调度职责

调度器负责状态转换、截止时间、取消、并发配额、持久化和人工审核。模型在需要语义判断的节点提出候选，确定的执行与门禁由代码推进。工具长期无响应时，调度器保留请求ID并查询状态，避免把超时误记为未执行。

规划器把“桌子不要挡路”变成可测条件时，尺寸、碰撞、站位和导航需要使用同一份世界几何。具体检查见资产布局的几何验证。

资产验收与发布

资产布局的几何验证中的几何、交互和平台检查汇入同一份不可变候选。发布入口从这里消费被接纳的完整报告与审核结果，正常布局和接管后的残留布局采用相同的批准事务。

审核与不可变候选

审核入口接收候选ID、任务ID、快照哈希、验证尝试ID和报告哈希，先核对它们共同指向同一产物清单，再显示需求、固定相机预览、来源、工具版本与不确定项。正常任务J消费V2；维护任务JR接管取消后保留的对象，建立验证尝试VR1，并消费VR1或当前后继报告。接管流程见补偿隔离与冲突接管。审核中的场景修改使对应候选失效。确定性规则负责可测门禁，模型评分辅助语义判断，视觉方向与正式发布按审核权限确认。

批准记录与发布回执

批准记录绑定任务ID、验证尝试ID、报告哈希、产物清单哈希、输入哈希、规则版本、审核版本。发布前将全部产物写入不可变存储并从发布环境核对依赖可读取，正式入口只保存这份清单的引用。如此发布后不需要再逐个修改活动场景对象；客户端读取入口后加载完整场景版本，加载失败保留原版本并返回失败，避免显示一半新布局。

控制数据库在一个事务中检查：任务仍允许发布、批准记录仍有效且版本匹配、正式入口代次等于计划的expectedGeneration。成功时共同写入新入口、新代次和以操作ID为键的发布回执。批准撤销也更新同一数据库记录；若撤销先提交，发布比较失败；若发布先提交，撤销随后触发明确的撤回操作。仅在进程里先查批准、过一会儿再更新指针，会漏掉这段并发窗口。

发布调用超时后按操作ID查询回执，有回执就返回当时的新代次，不再次覆盖入口。没有回执时重新检查全部条件再尝试。取消若与发布并发，由该事务中的任务状态判定先后：取消先登记则发布失败；发布已完成则按撤回流程条件更新入口。撤回只在入口仍是本任务发布的代次时恢复旧内容，并产生更高的新代次；若后续任务已发布，保留其结果并报告冲突。这样即使入口内容发生往返，旧操作也不能因哈希碰巧相同而覆盖新版本。

例如任务发布代次11后结果响应丢失，人工又发布12。恢复根据回执确认11成功，既不重放到13，也不把12撤回到10。批准、发布、取消和恢复都围绕同一份持久回执判断，任务日志则保存这些结果供追踪。

日志保存每次工具调用、状态变化、重试、补偿和批准记录。密钥与个人信息在写日志前脱敏；完整提示词和私有输入保存在对应访问范围内。

评估使用固定历史任务与失败集，同时记录检索准确率、布局通过率、人工返工率、工具恢复成功率、预算漏检、平均成本及人工修改保留率。生成数量增加而正式通过率下降，意味着系统把成本转移给了人工审核。

实现与证据

本页说明资产管线的设计协议与接口条件，未部署Agent、连接DCC、构建实际导航或执行资产发布。公式与数例可作机制推演，宿主事务、幂等性、恢复和发布仍需由各工具实现验证。事务边界的可运行示例见RPC。

参考资料

SQLite Transaction：本地操作登记的事务边界。
etcd API guarantees：条件事务与发布指针仲裁；场景工具不由数据库自动获得原子性。