Kairos Artifact 模型

“实现已经完成”这样的结果有价值,但它并不是实现本身。审核者和后续执行者还需要一种持久方式,找到真正产出的 Commit、文档、报告、归档包或上传文件。

Kairos 把这种具体交付物称为 Artifact。Submission 解释结果,Artifact 则让结果在原会话消失后仍然可以被检查。

声明预期交付物

Workflow Task Definition 可以声明具名 Artifact 要求。名称是稳定契约标识,描述用于说明应交付什么。成功 Submission 必须为每个声明名称提交一次 Artifact,也可以附加额外交付物。

Blackboard Task 通过描述说明预期交付物,不使用结构化 Artifact 契约。

Kairos 不在 Task Definition 中编码媒体类型、文件格式、数量范围或存储策略;这些内容属于工作说明或部署配置。

从创建到提交

执行者只有在持有 Active Task Claim 时才能创建 Artifact,可以:

Artifact 在 submit_task 携带其 ID 前只暂存于创建它的 Claim。提交会原子校验 Claim 归属和 Workflow 要求、创建不可变 Submission、绑定 Artifact,并结束执行责任。

后续协作者能看到什么

暂存 Artifact 只在创建它的 Claim 内可见。提交后 Artifact 对整个 WorkItem 可见;即使 Review 驳回结果,它仍保留在对应 Submission 历史中。

WorkItem 的产物列表是完整提交历史,并不表示“当前有效成果”。循环、重试和审核修订可以产生同名 Artifact,名称只在同一次 Submission 内唯一。控制台的 Workflow 产物历史以 Definition node 为一级入口,节点内按 Task 执行实例和 Submission 展示;Blackboard 按独立 Task 分组,不合并同名 Task。显示提交时间、审核状态和反馈,并默认折叠较早的执行或提交。节点执行次数不是整个 WorkItem 的全局轮次。

执行上下文将产物分成三类:当前 Active Claim 的暂存产物;Workflow 本次直接输入的产物;Blackboard 的共享提交历史。Workflow 输入来自当前 Activation 记录的已应用推进决策所绑定的具体 Submission,不按名称或时间选最新版,也不自动补入祖先产物。跳过来源或没有 Artifact 的输入不产生分组;失败重试保留原输入关联。Blackboard 共享历史包含待审核和已驳回材料,以来源和审核状态区分;Task Relation 不用于裁剪这个共享范围。

Context 只返回 Artifact 元数据,不直接注入文件内容。托管内容通过独立的认证端点下载或预览。控制台可在对应 Submission 与审核历史旁预览小型文本成果。精确字段与预览边界见 API 参考。

重试不会覆盖已提交 Artifact。新的执行尝试会创建新的 Artifact 和 Submission,保留之前的证据。

如果一份报告被 Review 驳回,原文件仍留在对应 Submission 下。下一位执行者上传修订版并单独提交,审核者可以比较两次尝试,而不是只看到一份历史已经消失的可变文件。

Artifact 存储与保留

部署方拥有一个托管 Store,并决定上传、保留和垃圾回收策略。托管 Artifact 使用稳定的 kairos:// URI,并保存 Digest 与大小。大体积交付物应放在持久外部存储中,再登记绝对 URI。

Active Claim 会保护其暂存 Artifact。Claim 结束后,旧的未提交 Artifact 和未完成上传记录可以被回收;已提交 Artifact 作为工作历史保留。

精确上传方式、上限、重放语义、权限和默认值见 API 参考与 OpenAPI。

Artifact 不变量