v1.5.0 · 全面大更新：商业篇两章（Agent 经济 + 评测体系）

v1.5.0 — 全面大更新：新增「商业篇」两章

手册从 29 章扩展到 31 章，新增一条中文世界基本空白的主线：Agent 怎么学会花钱和赚钱、以及你怎么证明自己的 Agent 值钱。

💼 第 29 章 · Agent 经济与商业化（中文首发）

• x402 微支付 / Google AP2 可问责支付 / Stripe·PayPal Agent Toolkit 三路线选型
• Agent Identity 三层身份体系与资金安全红线
• 开发者变现四级火箭：内容 → 产品收款 → 机器可付费端点 → 企业交付

🧪 第 30 章 · Agent 评测体系

• 评测驱动开发（EDD）与三层评测金字塔
• LLM-as-Judge 三原则、评测集沉淀方法
• promptfoo / DeepEval / Langfuse 选型与 CI 集成

📎 附件

• ai-agent-handbook.pdf：228 页全本离线版（封面口径已同步为 31 章）

其他

• README 新增「进阶内容预告」（免费层永久完整 MIT）
• ROADMAP 新增 Part 9 商业化铺垫
• llms.txt / mkdocs / Skill 包 / CLI 文案计数口径全部同步

v1.4.1 · 修好「装不上」与两处数字口径

v1.4.1 — 修好「装不上」与两处数字口径

这是一个修补版本：上一版对外最好用的能力（CLI 体检）其实谁也装不上，
另有两处数字口径与仓库实际不符。功能没有变化，但「能用来」和「数字对得上」
这两件事这次是真的了。

🔧 CLI 现在真的能装了（#30）

pip install agent-handbook 在 PyPI 上还是 404，而 pip install git+...
装出来的是空壳——chapters/ 与 data/ 是仓库根的单一数据源，包内副本
在 .gitignore 里，git ls-files src 只有 6 个 .py。装完 handbook list
直接报「没找到 chapters/ 目录」。

改成构建时自动同步：新增 in-tree PEP 517 后端 build_backend.py，
在每个构建入口把章节与数据复制进包内；MANIFEST.in 保证 sdist 同样完整。
新增 .github/workflows/cli-package.yml 守住底线——干净检出上构建、
校验产物、装进全新 venv 实跑 list / search / doctor。

pip install git+https://github.com/Xwh630/ai-agent-handbook.git
handbook doctor .

实测：装好后 handbook list 输出 30 个章节文件、8895 行；
handbook new 生成的骨架自评 10/10。

📐 可运行示例是 11 个，不是 12（#29）

examples/ 下实际 11 个目录，README 有 5 处、PDF 封面有 1 处写成 12。
全部改正——宁要准不要好看。

🏆 Radar 新增「社区精选」固定栏目（#32）

projects/README.md 承诺「第一个提交者会被写进下一期社区精选头条」，
但周刊模板里没有这个栏目。现在每期都有固定位置，没有新收录时也会明确写
「下一个位置留给第 1 位提交者」。

📄 PDF

220 页 / 5.4 MB，封面已更正为「29 章 · 11 个可运行示例」与可用的安装命令。

---

完整变更：#29 · #30 · #32 · #33
上一个版本：v1.4.0（PDF 分发 + 读者项目机制）

v1.4.0 — PDF 全本 + CLI + 第 28 章

📥 AI Agent 实战手册 v1.4.0

这是第一个带 PDF 附件的版本——通勤、断电、断网都能读。

✨ 新增

项	说明
📕 PDF 全本	220 页 / 5.4 MB，含封面与目录。由 scripts/build_pdf.py 一键生成
🔧 agent-handbook CLI	pip install agent-handbook：doctor 五支柱体检 / search 全文检索 / new 生成 Harness 骨架 / list / open / stars
📖 第 28 章	2026 热门项目全景：hermes-agent / firecrawl / ponytail / agency-agents / Langflow / System Prompts 六大顶流串联
🧪 读者项目机制	projects/：把你的项目收录进来，命名规范 GitHub用户名-项目名，第一个提交者上 Radar 周刊头条

🔧 修复

• Stars Snapshot 自动化改用 PAT 建 PR，根治 required checks 永不过导致的 auto-merge 死锁（历史僵尸 PR 已全部清账）

📊 数据

29 章 · 12 个可运行示例 · 16 个框架/顶流项目热度追踪（每周五自动刷新）· 中英术语 133 条

🔗 链接

• 在线文档：https://xwh630.github.io/ai-agent-handbook/
• CLI：pip install agent-handbook && handbook doctor .

---

本手册由一名在校学生利用课余时间维护。如果它帮到了你，点亮 Star 就是最好的鼓励 ⭐

v1.3.0 — Agent Skills 与上下文工程

🎯 v1.3.0：Agent Skills 与上下文工程

本版本聚焦 2026 年 Agent 工程两大前沿主题：Agent Skills 与上下文工程，新增约 2.5 万字。

📖 新增章节

1. 第 26 章 Agent Skills 编写实战 — SKILL.md 六字段规范逐条拆解、渐进式披露四阶段、token 预算红线、手搓一个可发布的 skill、发布自检清单
2. 第 27 章 上下文工程 — Context Rot 机理、一次轮次的 token 构成解剖（用户问题仅占 3%）、工具集 46→15 的账、压缩/笔记/子 Agent 三板斧

🧩 官方 Skill 包

3. skills/agent-handbook/ — 装进客户端后 Agent 可直接查阅本手册 28 章内容

🛠️ 可运行示例

4. examples/10-agent-skill/ — 零依赖的 SKILL.md 规范校验器（20+ 项检查，可直接接 CI）+ 符合规范的最小样例

📡 Radar 周刊

5. 第 2 期发布 — Skills 时代开启、MCP 无状态化、上下文工程崛起

📚 内容保鲜

6. 术语表 +30 词 — SKILL.md、Context Engineering、JIT Retrieval、Sub-agent Isolation 等 2026 前沿术语

🔧 工程基建

7. llms.txt — LLM 爬虫友好文件，提升 AI 搜索收录
8. build_docs.py — 文档站点暂存构建脚本，本地预览更顺畅

---

完整更新日志见 README 最新更新。

v1.2.0 - Freshness & Infrastructure

What is New

• 3 CI workflows: freshness check, examples smoke test, Stars weekly snapshot PR
• 3 maintenance scripts: freshness_check.py / smoke_test_examples.py / refresh_stars.py
• data/ directory: stars.json + stars-history.csv (framework Stars snapshots)
• Chapter 19 placeholder: Agent Toolbox (planned)
• Radar Issue 2 + TEMPLATE.md
• ROADMAP.md: quarterly iteration plan and execution board

What Changed

• All 26 chapters now have version declaration frontmatter
• Chapter 11 MCP major update (~30% rewrite): 2026-07 stateless core architecture, SDK migration, serverless deployment
• Glossary added 30 new 2026 frontier terms (SKILL.md / Context Engineering / A2A / Harness Engineering / GAIA / METR)
• README fully redesigned: dynamic badges, roadmap entry, updated project structure
• Fixed Check Links CI failing for 6 weeks: added .lycheeignore, fixed aider repo migration, fixed DeepSeek doc links

Next

• Chapter 26: Agent Skills Workshop (P0)
• Chapter 27: Context Engineering (P0)
• C1 Innovation: skills/agent-handbook official Skill package

v1.1.0 — 第 25 章 Harness Engineering + Agent Radar 周刊

🎉 v1.1.0 更新亮点

🏗️ 新增第 25 章：Harness Engineering 驾驭工程

2026 年 Agent 领域最重要的共识：Agent 的竞争力不取决于底层模型，而取决于驾驭它的工程系统。本章系统讲解 Harness 五大支柱（任务边界 / 上下文管理 / 状态持久化 / 失败恢复 / 权限体系），并给出 60 行可运行的最小 Harness 实现。

📡 新增「Agent Radar」周刊栏目

每周一期，追踪 Agent 圈最新项目、框架版本、论文与玩法。第 1 期主题：Harness 元年、Skills 生态爆发、Computer Use 走向生产。

📝 README 第一屏重构

新增 Banner 与 Star History 图表，一句话定位前置，访客 15 秒内看懂项目价值。

🤖 新增 llms.txt

让 Copilot / Cursor / Claude 等 AI 编码助手能正确索引本手册内容（AI 时代文档新标配）。

🔧 修复与优化

• 修复 examples 目录重复编号（04-rag-knowledge → 09-rag-knowledge）
• mkdocs 在线文档导航同步新增「工程化专题」与「Agent Radar」

---

完整变更：cf88d47...f27b939

如果这份手册对你有帮助，欢迎 ⭐ Star 支持！

AI Agent 实战手册 v1.0.0 🎉

{"value" => "## ?? AI Agent ???? v1.0.0 -- ??????!\n\n???? ???????? ? AI Agent ???????,?? 10+ ????,???????\n\n### ? ????\n\n- ?? 21 ?????:? Agent ???ReAct ????,? LangGraph / CrewAI / AutoGen / LlamaIndex / Dify / MCP / Ollama ????????\n- ?? 9 ??????:????,python examples/xxx.py ???\n- ?? Docker ???:????????????(? Ollama ?????)\n- ?? ????:????????(00/01/99 ???)\n- ?? ??????:https://xwh630.github.io/ai-agent-handbook/\n- ??? ????:???????ELI5 ???Mermaid ???????(DeepSeek/??/??)????\n\n### ?? ????\n\nbash\ngit clone https://github.com/Xwh630/ai-agent-handbook.git\ncd ai-agent-handbook\n# ???:Docker(????)\ndocker compose up -d\n# ???:?? Python\npip install -r requirements.txt\npython examples/01_hello_agent.py\n\n\n### ?? ????\n\n| ?? | ?? |\n|------|------|\n| ???? | 10 ?????? + ??????? |\n| ??? | Agent ????? ReAct?Dify ????Ollama ???? |\n| ??? | LangGraph?CrewAI?AutoGen?LlamaIndex?OpenAI/Claude SDK?MCP?????????? |\n| ??? | ? Agent ??????????????????? |\n| ???? | ???????????????? |\n\n### ?? ????\n\n???? Issue / PR / ??!?? CONTRIBUTING.md\n\n### ? ????\n\n???????????,??? Star,???????????!\n\n---\n\n### ?? ?????(2026-08-24)\n\nv1.0.0 ???,?????????????????(commit 7a18615),??????????? API ????,????:\n\n- OpenAI Agents SDK:?? @function_tool ?????;? Agent ???? handoffs ??????\n- Mastra:prompt() ? generate()/stream();trigger ? triggerSchema/triggerData\n- LangGraph:?????? compile(debug=True) ??,?? get_graph().draw_ascii() ???;?? checkpoint_id ??????\n- CrewAI:?? Agent ????(role/goal/backstory);?? Process ?? sequential/hierarchical ??\n- ????:?????? eval()(??????????),???? AST ?????,?????\n- API ??:chromadb count()?pydantic v2 field_validator?LangChain create_tool_calling_agent?FastMCP ??????\n- ????:README(??)?? Stars ??? 2026-08 ????;requirements.txt ?? openai-agents?langchain-ollama ??\n- ??:9 ???????????;01-react-agent ???? 16 ???????;??? CI ????\n", "PSPath" => "C:\TRAE WORK\GUTHUB\ai-agent-handbook\.release_body.md", "PSParentPath" => "C:\TRAE WORK\GUTHUB\ai-agent-handbook", "PSChildName" => ".release_body.md", "PSDrive" => {"CurrentLocation" => "Users\25092\WorkBuddy\2026-08-24-task-11", "Name" => "C", "Provider" => "Microsoft.PowerShell.Core\FileSystem", "Root" => "C:\", "Description" => "Windows ", "MaximumSize" => nil, "Credential" => "System.Management.Automation.PSCredential", "DisplayRoot" => nil}, "PSProvider" => {"ImplementingType" => "Microsoft.PowerShell.Commands.FileSystemProvider", "HelpFile" => "System.Management.Automation.dll-Help.xml", "Name" => "FileSystem", "PSSnapIn" => "Microsoft.PowerShell.Core", "ModuleName" => "Microsoft.PowerShell.Core", "Module" => nil, "Description" => "", "Capabilities" => 52, "Home" => "C:\Users\25092", "Drives" => "C D"}, "ReadCount" => 1}