5.1 KiB
任务、工具与事件
任务冻结输入
任务包含 task_id、task_type、run_purpose、content_purpose、command_id、work_id、target_ref、branch_id、base_revision、selection、protected_ranges、author_instruction、source_scope、context_snapshot_id、input_hash、flow_version、role_policy_version、resource_release_id、预算及停止条件。
source_scope 固定允许作品和资料、叙事截止位置、来源状态、用途及可见结构版本。角色、模型和工具策略来自已启用版本，实际执行保存冻结副本。生产不读取测试配置或目标章答案。
两种用途
run_purpose 表示执行隔离，取 production、evaluation 或 maintenance；content_purpose 表示内容消费，取 planning、generation、detection 或 extraction。两者不能混用。评测写手是 evaluation 加 generation，仍按 generation 裁剪字段，同时受评测数据库权限约束。
字段 aiContext 和来源允许用途针对 content_purpose；候选生产确认、数据库角色和实验产物隔离针对 run_purpose。上下文快照及投影同时绑定两项，模型不得改变其中任一项。
步骤与调用
步骤有 step_id、处理器身份、输入哈希、检查点和依赖；尝试有 attempt_id、lease_token、租约到期时间、心跳及结果。完成写入校验尝试与租约身份，不能仅凭 task_id 接受迟到输出。
确定性步骤与模型调用分开。模型调用统一经历策略冻结、预算预留、调用、明确终态核对、结构校验、证据保存和结算。流结束但没有有效完成依据时保留部分或失败；未知用量单独表示。
已发出而结果不明的调用必须先对账。确定已完成且输出可靠保存时复用结果；再次调用是新的有预算尝试。外部模型不承诺恰好执行一次。
调用对账只固定调用事实并写入恢复检查点，不产生步骤完成事件。模型对账同时要求预算已结算与原调用的完整响应证据。恢复后由所属处理器消费已存结果，工具请求回合继续执行工具和后续模型回合，最终结构与必需证据通过后才能完成角色步骤。作者恢复只重新开放原批准的剩余额度，不重置已花金额、调用次数或总截止时间。
工具合同
每次调用的身份来自已冻结任务，不能由模型参数指定更宽 work_id、purpose 或 as_of。工具只接收任务范围内的查询条件，并返回来源、数据版本、结构及投影版本、片段与剔除原因。
初始工具集合包括：查询作品规划、查询截至时点事实、读取允许的历史正文、检索绑定方法、读取引用资料和回读证据。资料研究任务可以使用明确登记的网页或榜单读取工具；结果是带来源的资料，不取得系统指令地位。
只读工具不暴露作者写入身份、数据库连接、任意文件路径、任意 SQL 或正式确认命令。宿主没有能力增加工具、改变来源范围或把评测用途改成生产。
事件合同
事件包含 event_id、task_id、step_id、attempt_id、sequence、event_type、occurred_at、payload_version 和类型化 payload。sequence 在任务内有序，event_id 唯一；客户端按最后已处理事件续接并去重。
事件类型至少覆盖任务创建、步骤开始、文本片段、工具读取、候选保存、检查完成、等待作者、步骤失败、任务取消和任务结束。文本片段不是完成事件。持久化记录是事实来源；事件提交后才可通知客户端。
若游标对应事件已超出在线保留范围，接口返回重新读取任务快照与可用事件范围的动作，不静默丢失中间状态。心跳用于连接存活，不冒充持久化业务进展。
恢复与停机
领取事务及时结束，模型调用期间不保持长数据库事务。进程停机停止领取新步骤，完成或释放正在执行的租约；重启从持久化状态判断结果，不依赖 UI 或主会话。
取消后旧输出可以作为该尝试的历史证据，不能更新当前候选。恢复重验来源、结构、授权和剩余预算；缺条件时等待作者或创建新的输入版本。评测执行与生产共享机制，但使用隔离权限和结果去向。
恢复检查与处理器一样，由代码按流程 ID 和版本登记。HTTP、CLI 和主会话只提交同一具名控制请求，S02 在控制事务中核对冻结计划并调用对应 owner 的检查；接入不能传入空回调或自报“已重验”。各业务包负责登记自己当前来源、结构、授权与预算的真实检查。
raw 与资源
raw 保存必要输入、响应、模型及工具证据，凭据在持久化和日志前脱敏。受控暂存只用于可验证的补交，不能补造已丢失的运行证据。生产加载资源发布身份及哈希，不读取未审工作树或依赖 tests、.git 和当前目录。
临时敏感原文、获准持久化的证据和受控归档按原文证据生命周期区分。保存输入或响应还需满足具体来源的保留授权，不能把“运行需留证”解释为所有原文均可永久入库。