Skip to content

README.zh-CN.md

Latest commit

 

History

History
122 lines (89 loc) · 6 KB

README.zh-CN.md

File metadata and controls

122 lines (89 loc) · 6 KB
Raw

Harness Engineering Guide

构建 AI Agent Harness 的实战指南——每篇文章都有可复制运行的真实代码。

Stars License

🌐 中文站 | English

English | 中文

Harness 是将裸语言模型变成 Agent 的 Runtime 封装层——一个能够感知环境、做出决策、跨多个步骤执行操作的自主系统。Harness 处理模型自身无法完成的一切：执行工具、管理记忆、组装上下文、执行安全边界。

本指南从第一性原理到生产模式覆盖 Harness Engineering，每篇文章都有真实代码。

入门

主题 描述
什么是 Harness？ 3 分钟理解概念。如何将模型变成 Agent。Harness vs Framework vs Runtime。
你的第一个 Harness 50 行 Python 构建可运行的 Harness。可复制运行的完整代码。
Harness 与 Framework 的区别 何时用原始 Harness vs LangChain/CrewAI。决策树 + 代码对比。

核心概念

主题 描述
Agentic Loop Think → Act → Observe 循环。Turn 预算、并行 Tool 调用、循环检测、流式传输。
Tool 系统 Tool 注册表、静态 vs 动态加载、MCP 协议、描述质量模式。
Memory 与 Context Context 组装、Session 管理、双层 Memory。AGENTS.md 和 MEMORY.md 模式。
Guardrails 权限模型、信任边界、沙箱、Prompt 注入防御。

实战

主题 描述
Context 工程 优先级组装、压缩三道防线、Token 预算。
Sandbox Docker 和 Firecracker 配置、网络隔离、文件系统限制。
Skill 系统 Skill 打包、按需加载、SKILL.md 格式、薄 Harness + 厚 Skill。
Sub-Agent Leader-Worker 模式、文件通信、Session 隔离、并行执行。
错误处理 错误分类、重试策略、优雅降级、断点续传。
多 Agent 编排 编排模式（流水线、扇出、监督者），Context 隔离，实战案例（Multica、Paseo、OpenClaw）。
定时任务与自动化 Cron、Heartbeat、事件触发。Session 目标、交付、LangSmith vs Harness 原生对比。
长时运行 Harness 设计 Context 焦虑、自评估偏差、Reset vs Compaction、GAN 启发的生成器-评估器架构。
Managed Agents 架构 Brain/Hands/Session 三层解耦、Pets vs Cattle、凭证隔离、TTFT 改进。
评测基础设施噪声 资源配置导致 Benchmark 得分波动 6 个百分点。Floor+Ceiling 执行策略。
基于分类器的权限审批 用模型分类器替代 approval fatigue。双层防御、四种威胁模型、reasoning-blind 设计。
Eval Awareness Agent 意识到被评估时的行为。新型 contamination、Multi-Agent 放大效应、Harness 防御。
Agent Teams 16 个并行 Claude 造 100K 行 C 编译器。Ralph-loop、Git 协调、GCC-as-oracle 二分法。
Initializer + Coding Agent 模式 长时运行 Agent 的两阶段 Harness。Feature list JSON、启动仪式、Clean state commit。

参考

主题 描述
主流 Harness 实现对比 OpenClaw、Claude Code、Codex、Cline、Aider、Cursor 并排对比。
术语表 关键术语定义。

分享

主题 描述
Windows 客户端百亿 Token 实战 打包 15min→4min，安装 10min→2min。Electron 打包流水线重建全记录。
1000+ 幽灵账号盗刷排查实录 上线 15 天被盗刷 1000+ 账号的血泪排查全过程。

如何贡献

  1. 进入 Issues → New Issue
  2. 选择 "📬 Submit a Resource"
  3. 填写标题、链接和推荐理由

也可以直接提交 PR——参见 CONTRIBUTING.md。

社区

关于

由 Nexu 维护——开源的 Claude Co-worker & Managed Agent 平台。

许可证

MIT License

如果觉得这份指南有用，请考虑给个 ⭐

@misc{nexu_harness-engineering-guide_2026,
  author = {Nexu Team},
  title = {Harness Engineering Guide},
  year = {2026},
  publisher = {GitHub},
  howpublished = {\url{https://github.com/nexu-io/harness-engineering-guide}}
}