第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。

07 Build Your Own - Cygnus Tech Blog

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

Mini-Harness 是什么

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

为什么需要权限控制

Mini-Harness 的安全风险

权限控制的好处

权限系统设计

三级权限模式

权限规则配置

Step 1：权限检查模块

实现目标

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

MCP 集成是什么

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

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

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