|
5 | 5 | </p> |
6 | 6 |
|
7 | 7 | <p align="center"> |
8 | | - <em>AI Agent Harness 实战指南 — 每篇配有可运行的代码示例。</em> |
| 8 | + <em>构建 AI Agent Harness 的实战指南——每篇文章都有可复制运行的真实代码。</em> |
9 | 9 | </p> |
10 | 10 |
|
11 | 11 | <p align="center"> |
|
14 | 14 | </p> |
15 | 15 |
|
16 | 16 | <p align="center"> |
17 | | - 🌐 <b><a href="https://harness-guide.com/zh/">harness-guide.com/zh</a></b> | <a href="https://harness-guide.com">English</a> |
| 17 | + 🌐 <b><a href="https://harness-guide.com/zh/">中文站</a></b> | <a href="https://harness-guide.com">English</a> |
18 | 18 | </p> |
19 | 19 |
|
20 | 20 | <p align="center"> |
|
23 | 23 |
|
24 | 24 | --- |
25 | 25 |
|
26 | | -**Harness** 是包裹语言模型的运行时层,将裸模型变成一个 **Agent** — 能感知环境、做出决策、多步执行动作的自主系统。Harness 负责模型自身做不了的一切:执行 Tool、管理 Memory、组装 Context、以及强制执行安全边界。 |
| 26 | +**Harness** 是将裸语言模型变成 **Agent** 的 Runtime 封装层——一个能够感知环境、做出决策、跨多个步骤执行操作的自主系统。Harness 处理模型自身无法完成的一切:执行工具、管理记忆、组装上下文、执行安全边界。 |
27 | 27 |
|
28 | | -本指南从第一性原理到生产模式,每篇文章都配有可运行的代码。 |
| 28 | +本指南从第一性原理到生产模式覆盖 Harness Engineering,每篇文章都有真实代码。 |
29 | 29 |
|
30 | 30 | --- |
31 | 31 |
|
32 | 32 | ## 入门 |
33 | 33 |
|
34 | 34 | | 主题 | 描述 | |
35 | 35 | |------|------| |
36 | | -| [什么是 Harness?](guide/what-is-harness.md) | 3 分钟理解核心概念。模型如何变成 Agent。Harness vs Framework vs Runtime。 | |
37 | | -| [搭建你的第一个 Harness](guide/your-first-harness.md) | 50 行 Python 搭建一个可运行的 Harness。完整代码可直接复制。 | |
38 | | -| [Harness 与 Framework 的区别](guide/harness-vs-framework.md) | 什么时候用 Harness,什么时候用 LangChain/CrewAI。决策树 + 代码对比。 | |
| 36 | +| [什么是 Harness?](zh-guide/what-is-harness.md) | 3 分钟理解概念。如何将模型变成 Agent。Harness vs Framework vs Runtime。 | |
| 37 | +| [你的第一个 Harness](zh-guide/your-first-harness.md) | 50 行 Python 构建可运行的 Harness。可复制运行的完整代码。 | |
| 38 | +| [Harness 与 Framework 的区别](zh-guide/harness-vs-framework.md) | 何时用原始 Harness vs LangChain/CrewAI。决策树 + 代码对比。 | |
39 | 39 |
|
40 | 40 | ## 核心概念 |
41 | 41 |
|
42 | 42 | | 主题 | 描述 | |
43 | 43 | |------|------| |
44 | | -| [Agentic Loop](guide/agentic-loop.md) | think → act → observe 循环。Turn 预算、并行 Tool 调用、循环检测、Streaming。 | |
45 | | -| [Tool System](guide/tool-system.md) | Tool 注册、静态 vs 动态加载、MCP 协议、描述质量模式。 | |
46 | | -| [Memory & Context](guide/memory-and-context.md) | Context 组装、Session 管理、两级 Memory(日志 + 长期记忆)。AGENTS.md 和 MEMORY.md 模式。 | |
47 | | -| [Guardrails](guide/guardrails.md) | 权限模型、信任边界、Sandbox、Prompt Injection 防御。 | |
| 44 | +| [Agentic Loop](zh-guide/agentic-loop.md) | Think → Act → Observe 循环。Turn 预算、并行 Tool 调用、循环检测、流式传输。 | |
| 45 | +| [Tool 系统](zh-guide/tool-system.md) | Tool 注册表、静态 vs 动态加载、MCP 协议、描述质量模式。 | |
| 46 | +| [Memory 与 Context](zh-guide/memory-and-context.md) | Context 组装、Session 管理、双层 Memory。AGENTS.md 和 MEMORY.md 模式。 | |
| 47 | +| [Guardrails](zh-guide/guardrails.md) | 权限模型、信任边界、沙箱、Prompt 注入防御。 | |
48 | 48 |
|
49 | 49 | ## 实战 |
50 | 50 |
|
51 | 51 | | 主题 | 描述 | |
52 | 52 | |------|------| |
53 | | -| [Context Engineering](guide/context-engineering.md) | 优先级组装、压缩三道防线、Token 预算。 | |
54 | | -| [Sandbox](guide/sandbox.md) | Docker 和 Firecracker 配置、网络隔离、文件系统限制。 | |
55 | | -| [Skill System](guide/skill-system.md) | Skill 打包、按需加载、SKILL.md 格式、薄 Harness + 厚 Skill。 | |
56 | | -| [Sub-Agent](guide/sub-agent.md) | Leader-Worker 模式、文件通信、Session 隔离、并行执行。 | |
57 | | -| [Error Handling](guide/error-handling.md) | 错误分类、重试策略、优雅降级、Checkpoint/Resume。 | |
| 53 | +| [Context 工程](zh-guide/context-engineering.md) | 优先级组装、压缩三道防线、Token 预算。 | |
| 54 | +| [Sandbox](zh-guide/sandbox.md) | Docker 和 Firecracker 配置、网络隔离、文件系统限制。 | |
| 55 | +| [Skill 系统](zh-guide/skill-system.md) | Skill 打包、按需加载、SKILL.md 格式、薄 Harness + 厚 Skill。 | |
| 56 | +| [Sub-Agent](zh-guide/sub-agent.md) | Leader-Worker 模式、文件通信、Session 隔离、并行执行。 | |
| 57 | +| [错误处理](zh-guide/error-handling.md) | 错误分类、重试策略、优雅降级、断点续传。 | |
| 58 | +| [多 Agent 编排](zh-guide/multi-agent-orchestration.md) | 编排模式(流水线、扇出、监督者),Context 隔离,实战案例(Multica、Paseo、OpenClaw)。 | |
| 59 | +| [定时任务与自动化](zh-guide/scheduling-and-automation.md) | Cron、Heartbeat、事件触发。Session 目标、交付、LangSmith vs Harness 原生对比。 | |
58 | 60 |
|
59 | 61 | ## 参考 |
60 | 62 |
|
61 | 63 | | 主题 | 描述 | |
62 | 64 | |------|------| |
63 | | -| [实现对比](guide/comparison.md) | OpenClaw、Claude Code、Codex、Cline、Aider、Cursor 横向对比。 | |
64 | | -| [术语表](guide/glossary.md) | 关键术语定义。 | |
| 65 | +| [主流 Harness 实现对比](zh-guide/comparison.md) | OpenClaw、Claude Code、Codex、Cline、Aider、Cursor 并排对比。 | |
| 66 | +| [术语表](zh-guide/glossary.md) | 关键术语定义。 | |
| 67 | + |
| 68 | +## 分享 |
| 69 | + |
| 70 | +| 主题 | 描述 | |
| 71 | +|------|------| |
| 72 | +| [Windows 客户端百亿 Token 实战](zh-guide/nexu-windows-packaging.md) | 打包 15min→4min,安装 10min→2min。Electron 打包流水线重建全记录。 | |
| 73 | +| [1000+ 幽灵账号盗刷排查实录](zh-guide/ghost-account-hunting.md) | 上线 15 天被盗刷 1000+ 账号的血泪排查全过程。 | |
65 | 74 |
|
66 | 75 | --- |
67 | 76 |
|
68 | 77 | ## 如何贡献 |
69 | 78 |
|
70 | | -1. 前往 [**Issues → New Issue**](https://github.com/nexu-io/harness-engineering-guide/issues/new/choose) |
| 79 | +1. 进入 [**Issues → New Issue**](https://github.com/nexu-io/harness-engineering-guide/issues/new/choose) |
71 | 80 | 2. 选择 **"📬 Submit a Resource"** |
72 | 81 | 3. 填写标题、链接和推荐理由 |
73 | 82 |
|
74 | | -也欢迎直接提交 PR — 参见 [CONTRIBUTING.md](CONTRIBUTING.md)。 |
| 83 | +也可以直接提交 PR——参见 [CONTRIBUTING.md](CONTRIBUTING.md)。 |
75 | 84 |
|
76 | 85 | --- |
77 | 86 |
|
|
85 | 94 |
|
86 | 95 | ## 关于 |
87 | 96 |
|
88 | | -由 [Nexu](https://github.com/nexu-io) 维护 — 开源 Claude Co-worker & Managed Agent 平台。 |
| 97 | +由 [Nexu](https://github.com/nexu-io) 维护——开源的 Claude Co-worker & Managed Agent 平台。 |
89 | 98 |
|
90 | | -## 协议 |
| 99 | +## 许可证 |
91 | 100 |
|
92 | 101 | [MIT License](LICENSE) |
| 102 | + |
| 103 | +--- |
| 104 | + |
| 105 | +如果觉得这份指南有用,请考虑给个 ⭐ |
| 106 | + |
| 107 | +``` |
| 108 | +@misc{nexu_harness-engineering-guide_2026, |
| 109 | + author = {Nexu Team}, |
| 110 | + title = {Harness Engineering Guide}, |
| 111 | + year = {2026}, |
| 112 | + publisher = {GitHub}, |
| 113 | + howpublished = {\url{https://github.com/nexu-io/harness-engineering-guide}} |
| 114 | +} |
| 115 | +``` |
0 commit comments