Agent 源码拆解
这个栏目解决什么问题
这个栏目不是简单摘抄源码，而是通过阅读 Agent / Multi-Agent 项目，学习系统架构、运行链路、工具调用、状态管理、评测反馈和工程化设计。
源码拆解的目标不是背代码，而是形成自己的 Agent 工程判断能力——看懂一个项目的模块边界、理解任务如何流转、学习工具调用如何组织、掌握状态如何维护、了解结果如何评估和反馈。
为什么要做源码拆解
源码拆解的价值在于：
- 从 Demo 思维转向工程思维：Demo 能跑通不代表能维护，源码拆解让你看到真实项目如何处理边界情况
- 学习真实项目如何组织模块：模块划分、依赖关系、接口设计，这些不是文档能教的
- 学习 Agent 任务如何流转：从用户输入到最终输出，中间经过哪些环节、每个环节做什么
- 学习工具调用如何封装：工具注册、选择、参数生成、结果回填、错误处理
- 学习状态和执行轨迹如何保存：状态对象设计、Trace 记录、断点恢复
- 将开源项目经验迁移到自己的项目设计中：不是照搬代码，而是学习设计思路
统一拆解框架
每个项目统一按照以下结构整理：
- 项目定位：这个项目解决什么问题、适合学习什么
- 为什么值得拆：从哪些角度值得学习
- 推荐阅读顺序：先看什么、再看什么、最后看什么
- 核心模块观察点：关注哪些模块、每个模块关注什么
- 运行链路观察点：任务从输入到输出的完整路径
- 工程亮点：哪些设计值得借鉴
- 可迁移设计：哪些思路可以迁移到自己的项目
- 当前限制：哪些内容还需要补充
- 面试表达：如何在面试中表达源码拆解的收获
当前拆解对象
- Hermes Agent — Agent 执行链路学习
- Harness Engineering — Agent 工程化与评测学习
- OpenClaw — 复杂 Agent 系统分层学习
重要说明
当前阶段主要整理源码拆解框架、阅读路线和观察点。对于未实际确认的源码路径、函数名、类名，不做编造；后续在完成真实源码阅读后再补充具体文件路径和调用链。