首页
# AI Agent 实战手册
**31 章中文教程 + 一个能给你项目打分的命令行工具。**
不是教你"会用"某个框架，而是让你看清一个 Agent 项目缺哪根柱子。
[](https://github.com/Xwh630/ai-agent-handbook)
[](https://pypi.org/project/agent-handbook/)
[](https://pypi.org/project/agent-handbook/)
[](LICENSE)
30 秒：给你的 Agent 项目做个体检¶
uvx 零安装；也可以用 pipx run agent-handbook doctor . 或 pip install agent-handbook。
大多数「Agent 跑不稳」不是模型不行，而是第 25 章那五根柱子少了几根。
doctor 静态扫描你的代码，告诉你缺哪根、该读手册的哪一节——把方法论变成可核对的清单。
| 命令 | 干什么 |
|---|---|
handbook doctor . |
五支柱体检，0–10 分 + 补齐建议 |
handbook doctor . --md |
输出 Markdown 表格，直接贴进 issue / README |
handbook search 上下文压缩 |
31 章全文检索，给出章节 + 行号 + 片段 |
handbook new my-agent |
生成自带五支柱的 Agent 骨架（生成即满分） |
handbook stars / handbook list / handbook open 25 |
热度表 / 章节清单 / 章节定位 |
零依赖、纯标准库、离线可用（章节数据随包安装）。
放进 CI：分数掉了就让 PR 变红¶
它会把 --md 报告贴进 PR 评论，并在 Job Summary 里留一份，评审时能直接看到这次改动动了哪根柱子。
这本手册解决什么¶
| 你现在的处境 | 手册给的答案 |
|---|---|
| "Agent 能跑 demo，一上生产就崩" | 第 25 章：任务边界 / 上下文管理 / 状态持久化 / 失败恢复 / 权限体系 |
| "token 费用莫名爆炸" | 第 27 章：一次轮次的 token 构成解剖、压缩三板斧 |
| "团队经验带不进 Agent" | 第 26 章：SKILL.md 六字段规范与渐进式披露 |
| "不知道选哪个框架" | 第 18 章选型决策树 + 第 28 章 2026 顶流全景 |
| "完全没接触过" | 第 0 章：10 分钟跑通第一个 Agent |
三条阅读路径
- 🌱 零基础：第 0 章 → 第 1 章 → 第 2 章 → 第 7 章（Dify）
- 💻 会编程：第 2 章 → 框架三选一 → 第 25 章
- 🏗️ 要上生产：第 25 章 → 第 27 章 → 第 26 章 → 第 15 章
目录¶
| 编号 | 章节 | 一句话 |
|---|---|---|
| 00 | 新手快速入门 | 10 分钟跑通第一个 Agent |
| 01 | AI Agent 基础概念 | Agent 本质、核心组件、ReAct 模式 |
| 02 | 从零手写 ReAct Agent | 完整实现一个最小可用 Agent |
| 03 | LangGraph 图编排 | 复杂工作流、状态机、检查点 |
| 04 | CrewAI 多智能体 | 角色化团队、任务分配 |
| 05 | AutoGen / MAF | 对话驱动协作、迭代求解 |
| 06 | LlamaIndex RAG | 文档检索、向量数据库 |
| 07 | Dify 低代码 | 可视化拖拽构建应用 |
| 08 | OpenAI Agents SDK | 轻量级多 Agent |
| 09 | Claude Agent SDK | Anthropic 官方工具 |
| 10 | Mastra TypeScript | TS 优先的 Agent 框架 |
| 11 | MCP 协议 | 标准化工具连接（含 2026 无状态核心） |
| 12 | Ollama 本地部署 | 隐私保护、离线场景 |
| 13 | 多 Agent 协作模式 | 6 种协作模式与决策树 |
| 14 | 记忆系统与状态管理 | Mem0、向量记忆、持久化 |
| 15 | Token 成本优化 | 生产环境成本控制 |
| 16 | 调试与可观测性 | LangSmith、日志、追踪 |
| 17 | 全栈实战：研究报告系统 | 整合所有技术的完整项目 |
| 18 | 选型决策树 | 如何选择合适的框架 |
| 19 | Agent 通用工具箱 | 工具注册中心 / 审批网关 / 成本追踪等六件套 |
| 20 | Codex CLI | MCP 集成、四种审批模式、沙箱隔离 |
| 21 | DeepSeek Harness | 四种模式、SWE-bench、500+ 插件 |
| 22 | Continue 编辑器 | VSCode / JetBrains 插件 |
| 23 | Aider 代码助手 | 多模型、Git 集成、会话恢复 |
| 24 | Trae IDE | AI 原生 IDE 工作流 |
| 25 | Harness Engineering | 五支柱：2026 年 Agent 上生产的分水岭 |
| 26 | Agent Skills 编写实战 | SKILL.md 六字段规范 + 渐进式披露 |
| 27 | 上下文工程 | Context Rot 机理 + 压缩三板斧 |
| 28 | 2026 热门项目全景 | 六大顶流串联地图 |
| 29 | Agent 经济与商业化 | x402 / AP2 / Agent Identity |
| 30 | Agent 评测体系 | EDD、三层评测金字塔 |
| 99 | 中英对照术语表 | 130+ 术语通俗解释 |
配套：11 个可运行示例 · Agent Skill 包（装进 Agent 即可查阅全手册）· PDF 全本 · 在线站点
📡 Agent Radar 周刊¶
每周一期，追踪 Agent 圈的新项目、框架版本、协议与玩法。这是唯一一个每周都会更新的栏目——想跟进度就 Watch 它。
| 期数 | 日期 | 亮点 |
|---|---|---|
| 第 5 期 🆕 | 2026-10-30 | 评测成为主战场、Agent 间协议互认、Harness 从概念走向榜单 |
| 第 4 期 | 2026-10-23 | 终端 Agent 三国杀、上下文压缩工程化、开源评测集升温 |
| 第 3 期 | 2026-10-13 | 上下文变成产品：claude-mem、context-mode、OptMem 三条路线 |
| 第 2 期 | 2026-10-09 | Skills 时代开启、MCP 无状态化、上下文工程崛起 |
| 第 1 期 | 2026-10-02 | Harness 元年、Skills 生态爆发、Computer Use 走向生产 |
动手跑起来¶
git clone https://github.com/Xwh630/ai-agent-handbook.git
cd ai-agent-handbook
pip install -r requirements.txt
cp .env.example .env # 填 DeepSeek / 智谱 / OpenAI 任一 Key
cd examples/01-react-agent && python main.py
不想装 Python？docker compose up -d && docker compose run dev bash。
想参与¶
- 你的项目用了这本手册？ 提 PR 进
projects/，会被收进下一期 Radar 的「社区精选」固定位。 - 发现问题 / 想加章节？ 直接开 Issue，或来 Discussions 聊。
- 翻译：英文版进度见 TRANSLATION_STATUS，目前 4/31 章，欢迎认领。
- 详细规范见 CONTRIBUTING.md。
支持这个项目¶
这是一个在校学生用课余时间维护的项目——写代码、查资料、跟 CI 打架，都在放学后和周末。
如果这份手册帮你少踩了一个坑：
- ⭐ 点个 Star：它决定我下个周末是继续写第 32 章，还是去写作业
- 👁️ Watch → Releases only：每期 Radar 和每个版本都会通知你
- 手册核心永久免费开源（MIT）
许可与引用¶
MIT License，详见 LICENSE。用于课程、文章或项目时欢迎引用：
@misc{ai_agent_handbook2026,
title = {AI Agent 实战手册 (AI Agent Handbook)},
author = {Xwh630},
year = {2026},
url = {https://github.com/Xwh630/ai-agent-handbook},
note = {31 章中文教程 + 11 个可运行示例 + agent-handbook CLI}
}
[报告问题](https://github.com/Xwh630/ai-agent-handbook/issues) · [功能建议](https://github.com/Xwh630/ai-agent-handbook/discussions) · [在线文档](https://xwh630.github.io/ai-agent-handbook/)