1 引言
智能体 = 模型 + Harness。 模型提供智能;Harness 则通过循环、工具、上下文管理、安全控制、编排与扩展接口,把这份智能变成实际的工作。 在短短五个月里,Harness 工程(harness engineering)从一个厂商博客文章中造出的短语,成长为一门拥有实践者指南、正式定义、自动演化系统乃至自身 arXiv 学术谱系的学科(第 2.1 节)。 这门学科目前还缺少的是一部“参考书”:一份立足于生产级源代码的论述,说清 Harness 究竟是什么、由什么构成,以及该领域领先的实现彼此之间有何差异。 本文正是这样一部参考书,并且带着一个论点而来:Harness 已不再只是工具,而是成为了平台。
现有文献两条都够不着。 基准测试综述只报告分数(通常是 SWE-Bench [1]),不触及架构;概念性分类体系 [5, 6] 描述模式却缺乏实现;唯一一项同步开展的源码级分类研究 [34] 则把定义该领域前沿的厂商原生系统排除在外。 没有一项工作深入到那些决定一个 Harness 是否可靠、可扩展、可部署的工程决策:循环如何组织、工具如何定义与沙箱隔离、安全如何强制执行、上下文如何配给。 也没有任何工作追问这个品类本身正走向何方。
我们在源码层面研究了 11 个系统,全部固定在 2026 年 7 月的发布版本上。 其中四个是主流商业 LLM 供应商的旗舰产品:Claude Code(Anthropic,TypeScript,通过流传的源码快照获得)、Codex CLI(OpenAI,Rust)、Gemini CLI(Google,TypeScript)与 Mistral Vibe(Mistral AI,Python)。 七个是开源项目,覆盖了该领域的完整光谱:OpenHands(事件溯源 SDK,2026 年年中起还成为其他竞争 Harness 的宿主)、Aider(13 种多态编辑格式)、Mini-SWE-Agent(100 行代码的研究底线)、Hermes(GitHub 上增长最快的 Harness,带自我改进的技能循环)、Pi(极简内核的逆流者)、OpenCode(星标最多的专用编码智能体,拥有本语料库中最彻底的客户端/服务器架构),以及 OpenClaw(多通道网关,我们的非 SWE 对照点)。 第十二个系统 Omnigent(Databricks)是第一个元 Harness——架在其他系统之上的编排层——作为第二个对照点加以分析。 由于其中 8 个系统在本研究 2026 年 4 月版中已被审计过,保留的快照构成了一个受控的纵向样本:同一批 Harness,跨一个季度的源码 diff。
本文做出七项贡献。 第一是这门学科的参考解剖学(第 2 节):给出 Harness 的定义及其谱系与边界案例,并绘制七个标准子系统的组件地图——每个子系统都给出观察到的最小实现与最大实现——这张地图组织起论文的其余部分。 在这张地图之上,论文对 11 个 Harness 构建了系统性的源码级对比,这是首个同时覆盖全部四个厂商原生系统、两个采用最广的开源 Harness,以及每个系统标志性能力(表 4)的语料库。 审计得到 13 条跨领域的观察和一份收录 29 个复现模式的目录,其中若干属于首次记录:智能体自维护的记忆管线、停止时校验守卫(verify-on-stop guards)、谱系压缩、会话树版本控制、以日志为队列的循环、语法感知的命令权限控制、缓存方言扇出,以及 Harness 模仿。
由于原有 8 个系统是被重新固定版本而非替换,本研究还包含一项纵向分析(第 14.5 节):以源码度量的九十天 Harness 演化——趋同变成模仿(Hook 词汇被逐字复制、插件格式被采纳、会话导入器被发布)、模式沿着语料库向下扩散、行为策略从提示词散文迁移到配置文件。 两个经验性缺席在 11 系统规模上得到确认,并在语料库扩大三倍后依然成立:没有任何智能体运行时使用通用智能体框架,也没有任何运行时对代码使用基于嵌入的检索;它们的历史解答在于 Harness 与框架的合并。 这一合并引出平台化转向论点(第 14 节),并以具名工件加以记录:Harness SDK 与框架构建的 Harness 在同一种形态上汇合、带供应链安全的插件与技能市场、跨厂商会话导入器、移动设备管理(MDM)治理、智能体即模型的网关,以及对第一个元 Harness 的源码级分析。 分析最终凝结为一份实践者指南:18 条设计建议,每条都锚定于一条有引用支撑的观察和一个实现了它的系统,外加一个 90 行的最小可用 Harness 脚手架——它直接实现了其中十条建议,并与其余各条兼容。
论文其余部分的组织如下。 第 2 节定义 Harness 及其七个子系统。 第 3 节综述相关工作与 2026 年的领域格局。 第 4 节阐述研究方法;第 5 节给出系统概览。 第 6–12 节在全部语料上解剖七个子系统。 第 13 节归纳跨领域的观察。 第 14 节展开平台化转向论点,包括元 Harness 与纵向分析。 第 15 节讨论意涵与局限。 第 16 节把分析提炼为 18 条设计建议和 90 行脚手架。 第 17 节收束全文。