Skip to content

Commit 71f0dbb

Browse files
joeylee12629-starjoey
andauthored
fix: sync README + guide-data with all 18 articles (#60)
- README EN/ZH now includes all 5 sections: Getting Started, Core Concepts, Practice (7), Reference, Showcase (2) - Added Multi-Agent Orchestration + Scheduling to Practice - Added Ghost Account Hunting to Showcase in guide-data.ts - Total: 18 articles Co-authored-by: joey <joey@joeydeMacBook-Air.local>
1 parent 1c136cf commit 71f0dbb

3 files changed

Lines changed: 55 additions & 22 deletions

File tree

README.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,8 @@ This guide covers harness engineering from first principles to production patter
5555
| [Skill System](guide/skill-system.md) | Skill packaging, on-demand loading, SKILL.md format, thin harness + thick skills. |
5656
| [Sub-Agent](guide/sub-agent.md) | Leader-Worker pattern, file-based communication, session isolation, parallel execution. |
5757
| [Error Handling](guide/error-handling.md) | Error classification, retry strategies, graceful degradation, checkpoint/resume. |
58+
| [Multi-Agent Orchestration](guide/multi-agent-orchestration.md) | Orchestration patterns (pipeline, fan-out, supervisor), context isolation, real-world examples (Multica, Paseo, OpenClaw). |
59+
| [Scheduling & Automation](guide/scheduling-and-automation.md) | Cron, heartbeats, event triggers. Session targeting, delivery, LangSmith vs harness-native comparison. |
5860

5961
## Reference
6062

@@ -63,6 +65,13 @@ This guide covers harness engineering from first principles to production patter
6365
| [Implementation Comparison](guide/comparison.md) | Side-by-side comparison of OpenClaw, Claude Code, Codex, Cline, Aider, Cursor. |
6466
| [Glossary](guide/glossary.md) | Key terms defined. |
6567

68+
## Showcase
69+
70+
| Topic | Description |
71+
|-------|-------------|
72+
| [Shipping Our Windows Client](guide/nexu-windows-packaging.md) | Build time 15min→4min, install time 10min→2min. How we rebuilt the Electron packaging pipeline. |
73+
| [Ghost Account Hunting](guide/ghost-account-hunting.md) | 1000+ ghost accounts drained our platform in 15 days. The full post-mortem. |
74+
6675
---
6776

6877
## How to Contribute

README.zh-CN.md

Lines changed: 45 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
</p>
66

77
<p align="center">
8-
<em>AI Agent Harness 实战指南 — 每篇配有可运行的代码示例。</em>
8+
<em>构建 AI Agent Harness 的实战指南——每篇文章都有可复制运行的真实代码。</em>
99
</p>
1010

1111
<p align="center">
@@ -14,7 +14,7 @@
1414
</p>
1515

1616
<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>
1818
</p>
1919

2020
<p align="center">
@@ -23,55 +23,64 @@
2323

2424
---
2525

26-
**Harness** 是包裹语言模型的运行时层,将裸模型变成一个 **Agent** — 能感知环境、做出决策、多步执行动作的自主系统。Harness 负责模型自身做不了的一切:执行 Tool、管理 Memory、组装 Context、以及强制执行安全边界
26+
**Harness** 是将裸语言模型变成 **Agent** 的 Runtime 封装层——一个能够感知环境、做出决策、跨多个步骤执行操作的自主系统。Harness 处理模型自身无法完成的一切:执行工具、管理记忆、组装上下文、执行安全边界
2727

28-
本指南从第一性原理到生产模式,每篇文章都配有可运行的代码
28+
本指南从第一性原理到生产模式覆盖 Harness Engineering,每篇文章都有真实代码
2929

3030
---
3131

3232
## 入门
3333

3434
| 主题 | 描述 |
3535
|------|------|
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。决策树 + 代码对比。 |
3939

4040
## 核心概念
4141

4242
| 主题 | 描述 |
4343
|------|------|
44-
| [Agentic Loop](guide/agentic-loop.md) | thinkactobserve 循环。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) | ThinkActObserve 循环。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 注入防御|
4848

4949
## 实战
5050

5151
| 主题 | 描述 |
5252
|------|------|
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 原生对比。 |
5860

5961
## 参考
6062

6163
| 主题 | 描述 |
6264
|------|------|
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+ 账号的血泪排查全过程。 |
6574

6675
---
6776

6877
## 如何贡献
6978

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)
7180
2. 选择 **"📬 Submit a Resource"**
7281
3. 填写标题、链接和推荐理由
7382

74-
也欢迎直接提交 PR参见 [CONTRIBUTING.md](CONTRIBUTING.md)
83+
也可以直接提交 PR——参见 [CONTRIBUTING.md](CONTRIBUTING.md)
7584

7685
---
7786

@@ -85,8 +94,22 @@
8594

8695
## 关于
8796

88-
[Nexu](https://github.com/nexu-io) 维护 — 开源 Claude Co-worker & Managed Agent 平台。
97+
[Nexu](https://github.com/nexu-io) 维护——开源的 Claude Co-worker & Managed Agent 平台。
8998

90-
## 协议
99+
## 许可证
91100

92101
[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+
```

site/lib/guide-data.ts

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -57,6 +57,7 @@ export const guideSections: GuideSection[] = [
5757
zhLabel: "分享",
5858
items: [
5959
{ slug: "nexu-windows-packaging", title: "Shipping Our Windows Client", zhTitle: "Windows 客户端百亿 Token 实战" },
60+
{ slug: "ghost-account-hunting", title: "Ghost Account Hunting Post-Mortem", zhTitle: "1000+ 幽灵账号盗刷排查实录" },
6061
],
6162
},
6263
];

0 commit comments

Comments
 (0)