📖 项目简介

本项目是一套系统性解读 Anthropic Claude Code (v2.1.88) 内部引擎与架构的开源笔记。通过 8 个核心模块的切分，共产出 56 篇高质量的技术解析文档。旨在帮助深入理解当前顶尖前沿 AI Agent 框架的落地实现、交互架构与安全设计。

文档特点：

• 🔍 源码级剖析：深入到每一行关键代码的实现细节。
• 🏗️ 架构可视化：大量的高质量 Mermaid 架构图、数据流图。
• 💡 面试与思考 Q&A：每篇文章均附带“设计决策”、“权衡与优化”等高频 Q&A，将理论与实战思考结合。
• 🇨🇳 全中文语境：降低深度技术的阅读门槛。

🗺️ 核心导读

若您是第一次来到本项目，强烈建议从总览开始阅读：
👉 00-全局架构总览 —— 包含 7 大核心架构设计、宏观数据流以及模块依赖拓扑图。

📋 面试题大全 484 题 —— 全部文章 Q&A 汇总索引，按设计决策 / 原理分析 / 权衡优化 / 实战应用四类分组，一站式备考。

📚 目录大纲 (56 篇全覆盖)

本项目依据源码的物理模块划分为了 8 大专区。你可以直接点击对应子目录查看深入的分析报告：

• 🚀 01-核心入口：探究 CLI 引导程序、并行防抖启动机制与双路径路由引擎（MDM/Keychain）。
• 🛠️ 02-工具系统：揭秘 MCP 动态加载、BashTool 沙箱防御机制以及 ToolDef 工厂模式体系。
• ⚡️ 03-命令系统：解读三路优先级指令链、故障注入策略 (bridge-kick) 与缓存零痕迹 (btw) 处理。
• 🧠 04-Agent协调：核心剖析！QueryLoop 生命周期、强大的四级上下文压缩流水线及原子通知机制；三层多 Agent 协作架构（Swarm 进程内运行器、Coordinator 纯编排模式、Task 系统与权限传递）；Fork 子 Agent 机制与消息构建策略最大化 Prompt Cache 命中率。
• 🔌 05-扩展系统：掌握外部世界联动能力：插件联合分派机制、状态机技能设计以及组合键和弦输入。
• 🧱 06-服务与基础：全局视角：7级证书优先级的安全验证、Zod防向后循环引用以及不可变Store层；System Prompt 分段缓存架构（SYSTEM_PROMPT_DYNAMIC_BOUNDARY、CLAUDE.md 层级发现、MCP 增量注入）；四层上下文压缩策略详解（工具结果截断/图片替换/Context Collapse/AutoCompact 互斥机制）。
• 🎨 07-UI与交互：React 19 自定义协调前端、Yoga WASM 高性能 Flex 布局以及确定性的 Buddy 伴侣算法。
• 🌐 08-网络与远程：探析 KAIROS 守护观察机制、BoundedUUIDSet 去重、Protobuf 定制化封包与上游代理隧道。
• 🛠️ 09-实战指南：基于源码架构的动手实践指南，从零搭建轻颗粒 Agent 客户端，覆盖 QueryLoop、工具系统、上下文压缩与流式输出的完整实现路径。