Module 1: 源码考古与工程地图
回顾泄露事件始末,建立对生产级 Agent 系统的全局认知。
Ch01
泄露事件复盘
.map 文件如何让 Harness 裸奔、Bun 构建流水线竞态、课程地图
Ch02
工程地图
模块依赖拓扑、核心 vs 辅助模块、架构阅读路线图
Ch03
构建系统
Bun + TypeScript 编译链路、模块解析、生产构建与安全
Ch04
类型体系索引
Harness 核心 TypeScript 类型层级,建立源码阅读词汇表
Ch05
REPL 入口精读
main.tsx 4,683 行启动流程,Provider 初始化与模式路由
Module 2: Agent Loop 架构详解
08 讲了概念,10 带你逐层解析 query.ts 的两层状态机设计。
Ch06
外层 Agent Loop 状态机
状态定义、转移条件、中断/恢复、错误分类与差异化重试
Ch07
内层 queryLoop
SSE 流式解析、AsyncGenerator 桥接、工具调用增量 JSON 累积
Ch08
QueryEngine 生命周期
查询创建→轮询→取消→超时,SDK 层的完整状态流
Ch09
Message Bus
发布/订阅模式、消息类型体系、背压处理、错误隔离
Ch10
会话持久化
Session JSON 序列化、对话分支树、断点续传 resume
Module 3: 工具系统架构解析
08 定义了 Tool Protocol,10 带你解析 13+ 个生产级工具的架构实现。
Ch11
Tool 接口 · buildTool 工厂
JSON Schema 参数约束、执行管线、参数验证与审批流程
Ch12
ToolRegistry
注册/发现/冲突解决、优先级链 builtin>skill>mcp
Ch13
文件操作三件套
Read 分块/Write 原子/Edit 精确匹配,路径安全与编码检测
Ch14
Bash 沙箱
子进程管理、SIGTERM→SIGKILL 优雅终止、输出截断
Ch15
高级工具
Agent 嵌套、Task 状态机、WebSearch/WebFetch
Module 4: 扩展机制架构解析
08 教了怎么写,10 带你解析 Claude Code 的扩展机制架构。
Ch16
Skills 加载器
Frontmatter 解析、技能索引树、chokidar 热加载
Ch17
Hooks 事件引擎
事件体系、subprocess 执行管线、matcher 模式匹配
Ch18
MCP Client
JSON-RPC + stdio/SSE 双传输、多 Server 管理
Ch19
Memory 三层存储
短期缓冲→中期 LLM 压缩→长期 MEMORY.md 索引
Ch20
CLAUDE.md 指令管线
全局→项目→子目录三层注入、冲突合并
Module 5: 多 Agent 协作架构
08 讲了概念,10 带你解析 Swarm 框架的架构设计。
Ch21
Sub-Agent 调度
完整嵌套调用链、上下文隔离、深度限制防递归
Ch22
Swarm 框架
Leader/Teammate 模型、文件邮箱通信、任务分解
Ch23
三种执行模式
进程/tmux/iTerm2 隔离的代码实现与权衡
Ch24
Worktree 隔离
Git Worktree 创建/合并/清理、并发冲突处理
Ch25
Verification Agent
双因子校验:逻辑规则+AI 校验、纵深防御
Module 6: 隐藏特性与工程深度
公开的工程化策略 + 工业级工程细节 + 全课程架构对比总结。
Ch26
未公开工具与隐藏 Flag
Feature Toggle、环境变量开关、A/B 测试框架
Ch27
命令注入防御
四层纵深过滤:转义→黑名单→白名单→审批
Ch28
Prompt 工程内部
6 层 System Prompt 拼装、模板引擎、版本管理
Ch29
可观测性
结构化日志、AsyncLocalStorage Trace、Metrics 采集
Ch30
架构对比总结
工业级 vs 教学级 10 大差异、设计模式萃取、学习路径