Harness（运行框架） 产品与架构

它是什么

Harness（运行框架，外壳）是模型与真实世界之间的第一道连接：它自己不是智能，而是让模型能持续行动的最小运行框架——循环 + 工具执行器 + 注入的模型接口。Claude Code 那 1700 多行的主循环之所以能叠加十几个保护机制而不散架，靠的就是这层骨架：复杂字段全是保护机制，内核就是几十行 while。

最小内核

harness 的最小内核三件套：循环（think → act → observe，两个停止条件）、工具执行器（executeTool：执行、把失败也变成数据回填给模型）、注入的模型接口（callLlm(messages, tools)，内部消息 ↔ 厂商 wire 格式由 Provider 负责）。它对外提供「模型能持续行动」的能力，对内不掺任何业务判断——所有决策留给模型与上层。

在本教程的位置

第 14 章把它落在产品上：loop.mjs（主循环产品版：注册表执行 + onEvent trace 回调）就是自己产品的 harness；ch15 起 harness 从「发日志」升级为「发协议事件」，同一内核服务 CLI 与 HTTP 两个界面。