御舆：解码 Agent Harness
一部 42 万字的中文技术书，逐章拆解 Claude Code 的 Agent Harness 架构，从对话循环到亲手构建自己的 Harness。
本仓库是技术书籍/文档而非可执行 Agent 产品；能评估的是仓库自身工程。工作流使用最小权限（check 用 contents:read，star-history 仅 contents:write）并有并发组与 timeout，得 2 分。依赖以确切版本固定（jsdom 26.1.0、mermaid 11.17.0），dependency_security 给 2。README 明确声明非官方出版物、第三方许可不覆盖，source_attribution 给 3。user_confirmation、data_flow_transparency、sensitive_data_handling、rollback 仅在书稿主题中提及（权限管线、钩子安全），仓库自身无运行时机制可验证，扣分至 1。无证据表明存在恶意行为或越权默认。
tests/test_star_history.py 覆盖了调度边界、确定性渲染、自我包含 SVG、甚至校验 workflow cron 与 README 图片路径，内部一致性较好，self_consistency 给 2。CI（check-book.yml）运行全部检查且 Node/Python 版本固定，dependency_availability 给 2。仓库代码中几乎没有面向用户的错误消息可评估，failure_messages 仅 1。
README 提供多种阅读路径（初次/动手/按需查阅），章节组织清晰，audience_and_scenarios 给 3。阅读说明明确区分'源码可确认行为、架构推演和教学示例'，并声明数量与耗时示例不代表发行版承诺，capability_boundaries 给 2。trigger_precision 不适用于文档型仓库，仅凭附录索引给 1。环境要求明确（Node ≥22、Python 3.12），environment_fit 给 2。
信息架构极佳：15 章四篇 + 4 附录、导航地图、术语表，information_architecture 给 3。许可明确为 CC BY-NC-SA 4.0 并区分第三方权利，license 给 3。贡献流程与提交前检查命令写明，maintenance_responsibility 给 2。安装说明给出 npm ci、check 脚本，install_notes 给 2。未见 CHANGELOG 或版本号体系，versioning_changelog 仅 1。known_limitations 靠阅读说明的免责声明支撑，给 2。
作为拆解 Claude Code 架构的中文技术书，选题独特、结构完整、含动手练习与构建路线图，marginal_value 给 2。章节均可在线阅读且本地化良好（自包含 SVG、双语同步要求），output_usability 给 2。成本为阅读时间，换取系统性架构理解，cost_benefit 给 2；未给满分是因为书籍内容本身未在本次静态审查中逐章验证，准确性无法保证。
附录 A 提供源码导航地图与数据流路径，claim_traceability 给 2。阅读说明明确要求读者区分事实与推演，fact_inference_separation 给 3。书中断言未与其他独立来源交叉印证，也未提供引用 Claude Code 具体版本/commit 的机制（在可见文件中），cross_source_corroboration 扣至 1。
- 这是一本关于 Claude Code 的第三方分析书籍，非 Anthropic 官方出版物；书中描述的行为可能随 Claude Code 版本演进而过时，关键决策请以官方文档与源码为准。
- 书中含'架构推演'与'教学示例'，与源码可确认行为不同；读者应按阅读说明区分，勿将推演当作事实。
- 本书许可为 CC BY-NC-SA 4.0（署名-非商业-相同方式共享），商业使用受限；第三方源码内容不在该许可覆盖内。
- 本次为静态审查，未执行任何章节练习或验证书中技术断言的准确性。
这个 Agent 能做什么，适合哪些场景？
《御舆：解码 Agent Harness》是 lintsinghua/claude-code-book 仓库的开源中文技术书，共 15 章、4 篇附录，深度剖析 Anthropic Claude Code 的内部架构。全书按四部分组织：基础篇建立心智模型（对话循环、工具系统、权限管线），核心系统篇拆解配置、记忆、上下文管理与钩子，高级模式篇覆盖子智能体、多智能体编排、技能插件与 MCP 集成，工程实践篇讲解性能优化与六步构建自有 Harness 的路线图。书名取自《考工记》'舆'的意象，寓意承载智能体运转的运行时框架。附录提供 16 个核心模块的架构导航地图、50+ 工具清单、89 个功能标志速查表和 100 条中英对照术语。文字采用 CC BY-NC-SA 4.0 许可，支持在线阅读与双语版本。
这不是可运行的软件，而是一部文档型技术书。它阅读和引用 Claude Code 源码，产出带 Mermaid 架构图的章节文本：第 2 章解析 while(true) 异步生成器主循环、五种 yield 事件与 QueryDeps 依赖注入；第 3 章解析 Tool<I,O,P> 协议与 buildTool 工厂；第 4 章拆解四阶段权限管线；第 7 章给出四级上下文压缩链（Snip→MicroCompact→Collapse→AutoCompact）；第 12 章讲解 MCP 五态连接管理与 Bridge 通信；第 15 章给出从零构建 Harness 的六步路线图。附录 A 提供 16 模块依赖树与 6 条数据流路径，附录 B/C/D 覆盖 50+ 工具、89 个功能标志与术语表。仓库自带 scripts/check_book.py 与单元测试用于校验内容，Mermaid 图检查需 Node.js 22。
- 想深入理解 Claude Code 内部机制的资深工程师，需要权威的架构拆解而非官方碎片文档
- 正在设计自有 AI Agent 运行时的架构师，可参考第 15 章的六步实现路线图与安全威胁模型
- 准备为 Claude Code 开发工具、插件或 MCP 服务器的开发者，可用附录 B 的工具清单与第 11/12 章的技能、插件、MCP 章节作为接口参考
- 研究 Agent 上下文工程与记忆系统的技术人员，可学习第 6/7 章的四类记忆模型与四级压缩策略
- 需要中文术语统一口径的技术写作者或翻译者，附录 D 的 100 条中英对照术语可直接引用
这个 Agent 有哪些优点和局限？
- 目前少见的系统性 Claude Code 架构拆解，15 章覆盖从对话循环到多智能体编排的完整链路
- 附录提供的 16 模块依赖树、50+ 工具清单、89 个功能标志表是可按需检索的参考资料，而非只有线性叙述
- 明确区分源码可确认行为、架构推演与教学示例，并声明非官方出版物，学术态度严谨
- 第 15 章给出可落地的六步构建自有 Harness 路线图，含循环依赖方案与四层可观测性体系
- 功能标志与工具数量依赖特定构建和运行时版本，内容可能随 Claude Code 演进而过时
- 部分内容是架构推演而非源码逐行验证，读者需自行甄别
- 以中文为主（有英文版），非中文读者需依赖双语同步质量
- 采用 CC BY-NC-SA 4.0 禁止商业使用，且许可不覆盖 Claude Code 本身的第三方源码
如何安装或部署这个 Agent？
无需安装软件。在线阅读：访问 https://lintsinghua.github.io/ 。本地阅读：git clone https://github.com/lintsinghua/claude-code-book.git 后直接打开仓库中的 Markdown 章节（如 00-前言.md）。若要参与修订，还需 Python 3 运行校验脚本，以及 Node.js 22（npm ci 后执行 npm run check:diagrams 检查 Mermaid 图）。
如何使用这个 Agent？
初读路线：从前言开始，按 01 → 02 → 04 → 15 顺序阅读；动手构建路线：先读基础篇与工程实践篇，再按需查阅核心系统篇与高级模式篇；速查场景：使用附录 A 定位模块、附录 B 查工具属性、附录 C 查功能标志、附录 D 查术语。阅读时注意区分源码可确认行为与架构推演，功能标志与工具可用性取决于构建和运行时配置。
这个 Agent 与同类方案有什么区别？
本书定位与 Anthropic 官方 Claude Code 文档互补：官方文档讲'如何使用'，本书讲'内部如何运作'，更适合需要架构层面理解的读者，但不替代官方文档作为使用指南。