《御舆:解码 Agent Harness》是一本中文技术书(约 42 万字 / 英文 75K+ 词),对 Claude Code 的架构做深度剖析,主题是「Agent Harness」——承载并驱动智能体运转的运行时框架。全书 15 章 + 4 篇附录,从对话循环讲到如何构建你自己的 Agent Harness,定位是「不教你怎么用 AI Agent,而带你拆开它」:讲架构分析与设计哲学,而非 API 文档或 Prompt 技巧。重要声明(书中明确):本书基于对 Claude Code 公开文档和产品行为的架构分析编写,未引用、未使用任何未公开或未授权的源码;Claude Code 为 Anthropic 产品,本书不隶属于也未获授权于 Anthropic。许可为 CC BY-NC-SA 4.0,约 3,380 stars,提供在线阅读站。
来源:README.md(书名与定位、声明段落、数据一览、目录);GitHub 仓库元数据(stars=3380、homepage 在线阅读站);License 徽章(CC BY-NC-SA 4.0) 查看 GitHub 仓库 →随着 Agent 编码工具(尤其 Claude Code)成为热点,「想知道一个生产级 Agent 系统的骨架到底怎么搭」的需求强烈,但市面多是「怎么写 Prompt / 怎么调 API」的使用类资料,缺少系统的架构剖析。这本书正好填补这一空白——用 139 张架构图、50+ 个「为什么这样设计」的决策分析,给出一套可迁移到任何 Agent 框架的心智模型,且为中文长篇深度内容,因而获得关注。截至数据采集约 3,380 stars。
来源:README.md(这本书有什么不同、数据一览);GitHub 仓库元数据(stars=3380)不讲「怎么调用」,讲「为什么这样设计」——对 50+ 个设计决策追溯动机、分析权衡、指出反模式。
来源:README.md(这本书有什么不同 表格)从异步生成器到断路器模式,每章提炼可迁移到任何 Agent 框架(LangChain/AutoGen/CrewAI 或从零构建)的设计原则与心智模型。
来源:README.md(这本书有什么不同 → 设计哲学/可迁移的认知模型)用 139 张 Mermaid 架构图/流程图/状态机讲解,覆盖工具系统、权限管线、上下文压缩、记忆、钩子、子智能体、MCP、技能、流式架构、Plan 模式等核心子系统。
来源:README.md(数据一览:139 张图、覆盖核心子系统)提供中文与英文版本、在线阅读站,以及模块定位/工具/功能标志/术语(100 条中英对照)四篇附录便于查阅。
来源:README.md(双语徽章、在线阅读、快速导航、附录)本书(注意是书而非软件)以建立心智模型→深入子系统→动手构建的结构组织。Part 1 基础篇建立对 Agent Harness 的整体认知(智能体编程新范式、对话循环作为「心跳」的 while(true) 异步生成器主循环、工具系统的 Tool 协议、四阶段权限管线);Part 2/3 深入各核心子系统——工具系统、权限管线、上下文压缩、记忆系统、钩子系统、子智能体调度、MCP 集成、技能插件、流式架构、Plan 模式等;并在末章带读者构建自己的 Harness。全书附 4 篇附录(模块定位、工具、功能标志、术语中英对照),含约 100 条术语、89 个功能标志、50+ 注册工具的梳理。内容方法是「追溯动机、分析权衡、指出反模式」,强调可迁移的设计原则而非具体实现复制。
来源:README.md(目录 Part 1、数据一览、快速导航、这本书有什么不同)中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成
Mermaid(架构图/流程图/状态机)适合想真正理解「生产级 Agent 系统骨架如何搭建」的工程师、Agent 框架开发者和技术学习者:建立对 Agent Harness 的系统心智模型、读懂对话循环/权限管线/上下文压缩/子智能体等子系统的设计决策与权衡,并把这套可迁移的原则应用到自己用 LangChain/AutoGen/CrewAI 或从零构建的 Agent 上。它是学习与认知性资料,不是可运行的代码库;结论基于公开信息的架构分析,读者应结合实际框架与官方文档验证。
来源:README.md(这本书有什么不同、快速导航、声明段落)本页未追踪正式发行版;本书以 Markdown 仓库 + GitHub Pages 在线阅读形式持续维护更新(README 提供 Last Commit 徽章)。内容随作者对 Claude Code 公开信息的分析而迭代。
来源:README.md(Last Commit 徽章、在线阅读)《御舆:解码 Agent Harness》在「想看懂 Agent 系统怎么搭」这一稀缺方向上做得很扎实:42 万字、139 张架构图、50+ 个设计决策分析,系统拆解了 Claude Code 的对话循环、权限管线、上下文压缩、子智能体等子系统,并提炼出可迁移到任意框架的设计原则。对 Agent 框架开发者和想建立深层心智模型的工程师很有价值。要清楚它的边界:基于公开信息的非官方架构分析,可能与内部实现有差异、会随产品演进而过时,且是认知性书籍而非可运行代码。作为中文社区少见的 Agent 架构深度读物,质量和诚实度都值得肯定。
来源:综合 README.md 的定位、数据规模、声明与许可