01-AI 工具与智能体/07-Harness - 合集 - Cygnus Tech Blog

第01章 Agent 的 70 年简史 —— 从符号推理到深度学习

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

你刚装好 Claude Code，输入一条命令，它就开始读代码、写文件、跑测试。一切都自动化了——感知代码库、推理目标、采取行动。这一切的背后是什么？是什么让一个模型变成了一个 agent？

什么是 Agent

Agent 的本质从 70 年前就没变过——一个在环境中感知、推理、行动的模型。

第02章 LLM 时代的 Agent 革命 —— 2023-2026 爆发期

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们看到 Agent 的 70 年演变——从符号 AI 到深度学习。本章我们聚焦 2023-2026 年的爆发期：Agent 从游戏和实验室走向真实世界。

为什么是 LLM

2023 年初，ChatGPT 只能聊天。2025 年底，Claude Code 可以独立完成一个完整项目。这中间发生了什么？

第03章 Harness 概念溯源 —— "模型是大脑，Harness是身体"

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们看到 LLM Agent = Model + Harness。本章我们深入理解 Harness 这个概念——Agent 在特定领域工作的能力边界。

什么是 Harness

一句话定义：Harness 是 Agent 在特定领域工作所需要的一切——工具、权限、上下文、知识、行动接口的总和。

第04章 Harness 核心架构 —— 四层模型详解

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们理解了 Harness 的五大组件。本章我们拆解 Harness 的四层架构——环环相扣，循环不息。

四层模型概述

一句话核心：Harness 由四层组成——Loop层（心跳）、工具层（手脚）、管理层（大脑辅助）、扩展层（外挂）。

第05章 Harness vs Agent vs Model —— 三者关系辨析

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们拆解了 Harness 的四层架构。本章我们辨析 Model、Agent、Harness 三者的精确定义——很多人混淆这些概念。

Model 是什么

一句话定义：推理引擎——输入→输出的函数，无状态、无感知、无行动。

第06章 Claude Code Harness 架构剖析 —— 编程 Agent 的标杆实现

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们辨析了 Model、Agent、Harness 三者的关系。本章我们深入剖析 Claude Code——Harness 工程的标杆实现。

Claude Code 是什么

一句话定义：Anthropic 官方的编程 Agent——Claude 模型 + IDE/终端 Harness，专为软件工程设计。

第07章 Codex CLI Harness 架构剖析 —— OpenAI 的命令行 Agent

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们剖析了 Claude Code 的完整架构。本章我们看 Codex CLI——OpenAI 的命令行 Agent 实现。

Codex CLI 是什么

一句话定义：OpenAI 官方的命令行 Agent——GPT-4 模型 + Shell Harness，专为命令行自动化设计。

第08章 OpenClaw/Poco Harness 架构 —— 多渠道个人助手

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们剖析了 Codex CLI 的轻量架构。本章我们看 OpenClaw/Poco——更美观易用的多渠道个人助手。

OpenClaw/Poco 是什么

一句话定义：多渠道 AI 助手平台——Claude 模型 + 多渠道通信 Harness，专为生活管理和团队协作设计。

第09章开源 Harness 生态全景 —— 还有哪些值得关注的实现

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们剖析了 OpenClaw/Poco 的多渠道架构。本章我们全景扫描开源 Harness 生态——还有哪些值得关注的实现。

开源 Harness 分类

分类维度：按定位、复杂度、技术栈分类。

第10章 Agent Loop —— Harness的心跳

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们全景扫描了开源 Harness 生态。本章我们深入核心——Agent Loop，理解 observe→think→act→feedback 的持续循环。

Agent Loop 是什么

一句话定义：Agent 的核心心跳——持续循环的感知-推理-行动机制。

第11章工具系统 —— 从Bash到MCP的工具分发

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们深入了 Agent Loop 的核心机制。本章我们看工具系统——Agent 的双手，如何从Bash扩展到MCP。

工具系统是什么

一句话定义：Agent 可以采取的行动集合——文件读写、命令执行、网络请求、浏览器控制等。

第12章权限系统 —— deny→ask→allow的安全边界

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们剖析了工具系统的分发机制。本章我们看权限系统——保护安全的三级边界。

权限系统是什么

一句话定义：安全边界和审批流程——控制哪些操作可以自动执行，哪些需要用户确认。

第13章上下文管理 —— 自动注入、压缩与惰性加载

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们剖析了权限系统的三级边界。本章我们看上下文管理——防止溢出、压缩历史、惰性加载。

上下文管理是什么

一句话定义：管理 messages 数组的增长——防止溢出、压缩历史、按需加载知识。

第14章 MCP集成 —— 扩展Harness的能力边界

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们剖析了上下文管理的四层策略。本章我们看 MCP集成——连接 AI 和外部系统的开放协议。

MCP 是什么

一句话定义：Model Context Protocol——连接 AI 和外部工具的开放协议，扩展 Harness 能力边界。

第15章技能系统 —— 按需注入领域知识

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们剖析了 MCP 的扩展机制。本章我们看技能系统——按需注入领域知识的 Markdown 文件。

技能系统是什么

一句话定义：按需注入的领域知识 Markdown 文件——技术文档、编码规范、领域知识。

第16章 Agent 的生命周期 —— 从 prompt 到执行完成

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们深入了 Skills 的按需加载机制。本章我们看 Agent 的完整生命周期——从用户 prompt 到任务完成。

Agent 生命周期是什么

一句话定义：Agent 从启动到完成的完整流程——初始化→循环→完成→清理。

第17章 Harness 是 Agent 的操作系统 —— 一个深刻的类比

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们了解了 Agent 的完整生命周期。本章我们用一个类比深化理解——Harness 就是 Agent 的操作系统。

为什么这个类比很重要

一句话定义：Harness 为 Agent 提供运行环境，就像 OS 为程序提供运行环境。

第18章 Agent-Harness 协作模式 —— 推理与执行的完美配合

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们用类比深化理解。本章我们看 Agent 与 Harness 如何协作——推理与执行的完美配合。

Agent-Harness 协作是什么

一句话定义：Agent 推理决策，Harness 执行落地——两者配合完成任务。

第19章多智能体架构模式 —— 从单 Agent 到 Agent 团队

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们了解了 Agent-Harness 协作模式。本章我们看多智能体架构——从单 Agent 到 Agent 团队。

多智能体架构是什么

一句话定义：多个 Agent 协作完成复杂任务——主 Agent + 子 Agent + 专用 Agent。

第20章子代理隔离与上下文管理 —— 防止污染的核心机制

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们了解了多智能体架构模式。本章我们深入子代理隔离机制——防止上下文污染的核心。

子代理隔离是什么

一句话定义：子 Agent 使用独立上下文，执行完成后只返回结果，不泄露历史。

第21章 Agent 间通信协议 —— 子代理的标准化对话

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们深入了子代理隔离机制。本章我们看 Agent 间通信协议——标准化对话机制。

Agent 间通信是什么

一句话定义：主 Agent 与子 Agent 的标准化对话格式——请求、结果、状态、错误。

第22章从零构建 Mini-Harness —— Agent Loop 的最小实现

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们了解了 Agent 间通信协议。本章我们从零构建一个 Mini-Harness——Agent Loop 的最小实现。

Mini-Harness 是什么

一句话定义：Agent Loop 的最小实现——observe→think→act→feedback 的核心循环。

第23章添加工具系统与权限控制 —— Mini-Harness 的安全升级

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们从零构建了 Mini-Harness。本章我们添加工具系统与权限控制——提升安全性。

为什么需要权限控制

Mini-Harness 的安全风险

graph TB
 subgraph SecurityRisks["Mini-Harness 安全风险"]
 R1[无权限检查<br/>所有操作自动执行]
 R2[危险命令执行<br/>Bash可执行任意命令]
 R3[文件覆盖风险<br/>Write可覆盖任意文件]
 R4[系统文件删除<br/>可能删除关键文件]
 end
 
 style SecurityRisks fill:#FFE0E0

风险	说明	示例
无权限检查	所有操作自动执行	无需用户确认
危险命令执行	Bash 可执行 rm -rf /	系统崩溃
文件覆盖风险	Write 可覆盖任意文件	覆盖 .env 文件
系统文件删除	可能删除关键系统文件	删除 /bin/bash

权限控制的好处

graph TB
 subgraph PermissionBenefits["权限控制的好处"]
 B1[安全保护<br/>危险操作需审批]
 B2[用户控制<br/>用户决定是否执行]
 B3[风险降低<br/>防止误操作]
 B4[信任建立<br/>用户信任Agent]
 end
 
 style PermissionBenefits fill:#E0FFE0

好处	说明	价值
安全保护	危险操作需用户审批	系统安全
用户控制	用户决定是否执行	用户主导
风险降低	防止误操作	防止损失
信任建立	用户信任 Agent	期使用

权限系统设计

三级权限模式

graph LR
 A[工具调用请求] --> B{权限检查}
 B -->|deny| C[❌ 禁止执行]
 B -->|ask| D[⚠️ 请求审批]
 B -->|allow| E[✅ 自动执行]
 
 D -->|批准| E
 D -->|拒绝| C

权限模式	行为	适用场景	示例
deny	禁止执行，返回错误	极危险操作	rm -rf /
ask	请求用户审批，等待确认	中等风险	git push
allow	自动执行，无需用户干预	安全操作	Read 文件

权限规则配置

{
 "permissions": {
 "deny": [
 {"tool": "Bash", "command": "rm -rf /"},
 {"tool": "Bash", "command": "sudo"},
 {"tool": "Read", "file_path": ".env"}
 ],
 "ask": [
 {"tool": "Bash", "command": "git push"},
 {"tool": "Bash", "command": "npm install"},
 {"tool": "Write"},
 {"tool": "Edit"}
 ],
 "allow": [
 {"tool": "Read"},
 {"tool": "Glob"},
 {"tool": "Grep"}
 ]
 }
}

Step 1：权限检查模块

实现目标

一句话定义：检查工具调用是否匹配 deny/ask/allow 规则。

第24章添加 MCP 与多智能体支持 —— Mini-Harness 的能力扩展

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们添加了工具系统与权限控制。本章我们添加 MCP 与多智能体支持——扩展能力边界。

MCP 集成是什么

一句话定义：通过 MCP 协议连接外部系统——数据库、云服务、企业 API。

第25章 2026 年 Harness 生态全景 —— 开源、企业与个人工具

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们构建了完整的 Mini-Harness。本章我们看 2026 年 Harness 生态全景——开源、企业与个人工具。

2026 年 Harness 生态是什么

一句话定义：开源项目、企业平台、个人工具构成的完整生态系统。

第26章从规则到环境的范式转移 —— Harness 的下一个十年

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们了解了 2026 年 Harness 生态全景。本章我们看范式转移——从规则到环境。

范式转移是什么

一句话定义：从编写规则约束 Agent，到构建环境塑造 Agent——范式转移。

第27章智能体的未来 —— 从工具到伙伴，从辅助到协作

ruohuyang@163.com (Cygnus Yang) — Sat, 23 May 2026 00:00:00 +0800

上一篇我们了解了范式转移。本章我们展望智能体的未来——从工具到伙伴。

智能体的未来是什么

一句话定义：Agent 从工具辅助进化为智能伙伴——自主、协作、创造性。

01-AI 工具与智能体/07-Harness - 合集 - Cygnus Tech Blog

第01章 Agent 的 70 年简史 —— 从符号推理到深度学习

什么是 Agent

第02章 LLM 时代的 Agent 革命 —— 2023-2026 爆发期

为什么是 LLM

第03章 Harness 概念溯源 —— "模型是大脑，Harness是身体"

什么是 Harness

第04章 Harness 核心架构 —— 四层模型详解

四层模型概述

第05章 Harness vs Agent vs Model —— 三者关系辨析

Model 是什么

第06章 Claude Code Harness 架构剖析 —— 编程 Agent 的标杆实现

Claude Code 是什么

第07章 Codex CLI Harness 架构剖析 —— OpenAI 的命令行 Agent

Codex CLI 是什么

第08章 OpenClaw/Poco Harness 架构 —— 多渠道个人助手

OpenClaw/Poco 是什么

第09章 开源 Harness 生态全景 —— 还有哪些值得关注的实现

开源 Harness 分类

第10章 Agent Loop —— Harness的心跳

Agent Loop 是什么

第11章 工具系统 —— 从Bash到MCP的工具分发

工具系统是什么

第12章 权限系统 —— deny→ask→allow的安全边界

权限系统是什么

第13章 上下文管理 —— 自动注入、压缩与惰性加载

上下文管理是什么

第14章 MCP集成 —— 扩展Harness的能力边界

MCP 是什么

第15章 技能系统 —— 按需注入领域知识

技能系统是什么

第16章 Agent 的生命周期 —— 从 prompt 到执行完成

Agent 生命周期是什么

第17章 Harness 是 Agent 的操作系统 —— 一个深刻的类比

为什么这个类比很重要

第18章 Agent-Harness 协作模式 —— 推理与执行的完美配合

Agent-Harness 协作是什么

第19章 多智能体架构模式 —— 从单 Agent 到 Agent 团队

多智能体架构是什么

第20章 子代理隔离与上下文管理 —— 防止污染的核心机制

子代理隔离是什么

第21章 Agent 间通信协议 —— 子代理的标准化对话

Agent 间通信是什么

第22章 从零构建 Mini-Harness —— Agent Loop 的最小实现

Mini-Harness 是什么

第23章 添加工具系统与权限控制 —— Mini-Harness 的安全升级

为什么需要权限控制

Mini-Harness 的安全风险

权限控制的好处

权限系统设计

三级权限模式

权限规则配置

Step 1：权限检查模块

实现目标

第24章 添加 MCP 与多智能体支持 —— Mini-Harness 的能力扩展

MCP 集成是什么

第25章 2026 年 Harness 生态全景 —— 开源、企业与个人工具

2026 年 Harness 生态是什么

第26章 从规则到环境的范式转移 —— Harness 的下一个十年

范式转移是什么

第27章 智能体的未来 —— 从工具到伙伴，从辅助到协作

智能体的未来是什么

第09章开源 Harness 生态全景 —— 还有哪些值得关注的实现

第11章工具系统 —— 从Bash到MCP的工具分发

第12章权限系统 —— deny→ask→allow的安全边界

第13章上下文管理 —— 自动注入、压缩与惰性加载

第15章技能系统 —— 按需注入领域知识

第19章多智能体架构模式 —— 从单 Agent 到 Agent 团队

第20章子代理隔离与上下文管理 —— 防止污染的核心机制

第22章从零构建 Mini-Harness —— Agent Loop 的最小实现

第23章添加工具系统与权限控制 —— Mini-Harness 的安全升级

第24章添加 MCP 与多智能体支持 —— Mini-Harness 的能力扩展

第26章从规则到环境的范式转移 —— Harness 的下一个十年

第27章智能体的未来 —— 从工具到伙伴，从辅助到协作