3

Harness 公式

Tools + Knowledge + Observation + Action + Permissions

核心公式

OpenHarness 的整体架构可以用一个简单的公式概括: Harness = Tools + Knowledge + Observation + Action + Permissions 让我们逐一拆解每个部分:

🔧 Tools(工具)— 43+ 个内置工具

工具是 Agent 与外部世界交互的接口。OpenHarness 内置了 43+ 个工具,覆盖了: • 文件操作:Read、Write、Edit、Glob、Grep • Shell 命令:Bash • 搜索:WebFetch、WebSearch • Agent 协作:Agent、SendMessage • 任务管理:TaskCreate、TaskUpdate • MCP 集成:MCPTool • 工作流控制:EnterPlanMode、EnterWorktree 每个工具都有统一的接口:接收参数 → 执行操作 → 返回结果。

📚 Knowledge(知识)— 按需加载

Agent 不可能把所有知识都放在一个巨大的提示词里。OpenHarness 的 Skills 系统允许按需加载特定领域的知识,就像一个图书馆 —— 需要什么主题的书就去取什么。

👀 Observation(观察)— 实时反馈

每次工具执行完毕,结果会被反馈给 LLM。这就是「观察」—— Agent 能看到自己的行动产生了什么效果,然后决定下一步怎么做。

⚡ Action(行动)— 循环执行

Agent 不是一次性完成任务的。它通过一个循环(Agent Loop)不断地:思考 → 调用工具 → 观察结果 → 再思考。这个循环是 Agent 的心跳,我们在第 4 章会详细讲解。

🛡️ Permissions(权限)— 安全护栏

让 AI 自由操作是危险的。OpenHarness 提供了三级权限模式,确保 Agent 不会执行不当操作。这是 Harness 最重要的设计之一。

OpenHarness 的 10 大子系统

在代码层面,OpenHarness 把上述五大能力拆分成了 10 个子系统: 1. Engine(引擎)— Agent Loop 核心循环 2. Tools(工具)— 43+ 个内置工具 3. Skills(技能)— 知识按需加载 4. Plugins(插件)— 扩展机制 5. Permissions(权限)— 安全检查 6. Hooks(钩子)— 生命周期事件 7. Commands(命令)— 54 个用户交互命令 8. MCP(模型上下文协议)— 外部集成 9. Memory(记忆)— 跨会话持久化 10. Tasks(任务)— 后台任务管理 接下来的章节,我们会逐一深入每个子系统。
📌 关键要点
五大能力,十大子系统
记住这个公式:Harness = Tools + Knowledge + Observation + Action + Permissions。OpenHarness 在代码层面将其实现为 10 个清晰分离的子系统,每个子系统负责单一职责,通过注册表模式组合在一起。
🧠 检验理解
Harness 公式中的「Observation」指的是什么?