Agent Harness 中文手册

Agent harness 是模型之外，让长时间运行的 agent 工作能交接、能验收、能恢复的那一层。本文讲它管哪些事，与 agent framework、模型 API 的边界，以及中文现有的几种叫法。

从需求简报到任务包、上下文胶囊与提交信封，Flowness 把一项工作的依据、权限和结果连成可追溯的交接链，也让复查能够按原因退回负责层。

把需要多天推进的工作交给系统，先保存需求、边界和完成条件，再安排会话换手、暂停范围和收货检查。任务继续、会话存活与验收合格，是三种不同状态。

先检查关键问题是否闭合，再看信息质量，输出足够、有条件足够或仍需补充的建议。

Flowness 按执行、修复、审阅和规划的角色组织材料，分别记录原文交付与审计投影，避免把一份短材料误认成完整依据。

2026 年 6 月的一次自开发任务发现：胶囊内核和语义检查已经实现，生产会话却仍使用占位引用。任务接通工作会话的启动与完成，以及规划、共识的会话起点，再用范围内接受、范围外拒绝的正反控制验收。

企业的方法可以从一个真实项目开始生长：按需求接入必要流程，交付业务成果，同时留下设计判断与检查依据。共享技能与运行时工具逐步更新，项目事实和定制保留；下一项目检验这些方法是否仍然适用。

先检查前置工作是否完成，再在可运行任务中安排优先级，避免并发数量增加了，项目仍卡在同一条链上。

结合剩余额度、消耗速度与重置时间，计算还能承受多少并发，并为正在运行的工作留出缓冲。

为自动恢复设置独立次数预算，耗尽后持久记录停止状态，把任务交给需要改变条件的处理过程。

同一机器再次报告同一问题时，Flowness 查找仍开放的告警，记录复发；问题不同、原告警已经结束，就重新提出。

把新事件补进索引，只在查询命中时展开记录，让不断增长的工作历史仍然可以按任务读取。

当完成声明藏在通用事件包装中，写入许可与消费含义可能错位。Flowness 的一次修正把禁止包装的规则放进两条写路共用的校验边界，并以逻辑读视图保留合法历史事件，再用 AST 守卫约束生产者与消费者的演化。

把修复经验变成可执行约束，还需要证明约束实际运行在将要合入的代码上。一次通过数足够却漏掉守卫的反例，推动了逐目标审计、合并后树验证和关口负对照。

一批信号可以重读，却不能重复加到累计值里。沿着丢信号与重复计数两个故障窗口，推导游标、计数和字节水位的写入顺序。

租约到期允许新的执行者接手，存储端再核对世代号，阻止旧身份继续写入受保护的账本。