LLM漫谈（十一）| 5 个开源Agent 源码剖析

最近两年Agent项目遍地开花，GitHub满眼都是"下一代智能体""生产级Agent框架"。很多同学把Demo跑通不难，但是一旦要深入底层、二次开发、自研Agent，立刻就卡住。

只看官方README、使用教程，只能学会调用API，看不懂底层架构取舍：

会话状态如何持久化？
工具调用完整管线如何流转？
沙箱安全模型怎么设计？
插件扩展点埋在哪里？
不同框架在记忆、多模型、多进程上踩过哪些坑？

网上绝大多数中文资料停留在"如何使用"，缺少摘录真实源码、逐段讲解设计动机的深度剖析材料。

于是我整理了这套面向彻底剖析的中文技术课程，完整开源在GitHub。

https://github.com/ArronAI007/agent‑framework‑insights

这套课程不是翻译文档，而是直接拿真实项目源码逐段解读，做到：先会用，再懂原理，最后学会扩展改造Agent框架。仓库使用MIT协议，大家可以自由阅读学习。

仓库根目录一共5大模块：

PI：拆解earendil‑works/pi极简编码Agent
DeepSeek‑ Harness：拆解DeepSeek开源Harness插件框架
Hermes‑Agent：拆解NousResearch Hermes生产级自进化Agent
Harness‑from‑scratch：从零手写一套Agent Harness，v1‑v15完整路线
Agent‑from‑scratch：从零构建Agent，新增Agent评测框架内容

推荐阅读顺序：Agent‑from‑scratch → PI → DeepSeek‑Harness → Hermes‑Agent → Harness‑from‑scratch，由从零手写实现到现成项目剖析过渡，复杂度逐步升高。

模块一：PI｜极简终端编码Agent

PI是代码体量很小的编码Agent，核心保持精简，几乎全部能力依靠TypeScript扩展、Skills、Prompt模板挂载。统一多模型层，兼容OpenAI / Anthropic / Google / Bedrock。

课程合计30篇文档，覆盖快速上手、monorepo工程、Agent运行时、Tool Calling工具调用、会话持久化、上下文压缩、Hook事件系统、TUI差分渲染、遥测、Evals测试评估。内核足够小巧，适合入门学习Agent底层，引擎部分可以直接拿来复用。

模块二：DeepSeek‑Harness｜万物皆插件元框架

DeepSeek‑Harness构建在Cordis元框架之上，万物皆插件。几乎每一项能力拆成 Service Definition → Provider → Tool 三元能力接缝。Node宿主Host与浏览器Client物理分离，编译期生成RPC契约通信；包含C11手写Linux Landlock沙箱内核，同时提供NDJSON‑RPC的Python SDK，可以把Agent运行时作为子进程调用。

课程带你吃透Cordis插件内核、ReactLoopAgent智能体循环、事件溯源会话日志、流式输出、沙箱权限审批、子代理委派、Workflow工作流引擎。适合研究生产级插件化Agent、自研沙箱、跨语言RPC桥接。

模块三：Hermes‑Agent｜真实生产打磨的自进化Agent

Hermes‑Agent和前两个"干净架构演示"项目气质完全不同。万行级Python核心模块，面向个人与团队真实生产环境。✅7种可插拔终端后端：

local/docker/SSH/Singularity/Modal/Daytona/Vercel Sandbox✅Skills自我进化学习环：Agent从对话自动生成、迭代更新Skill技能✅单进程消息网关，同时对接Telegram/Discord/Slack/Email等平台✅Cron定时调度，支持本地、Chronos无服务器托管模式✅SQLite+FTS5+自研CJK分词会话存储，面向训练轨迹独立压缩器

全套40篇文档，从部署、运行时状态机、工具管线、三层安全防御，到MCP双向集成、多智能体看板编排、评测体系全部覆盖。做业务落地、团队级Agent，能看到大量现实工程问题与落地解法。

模块四：Harness‑from‑scratch｜从零手写Harness

前面三套都是分析现成开源项目，而这个模块走向动手实现。完整v1‑v15系列路线图，带你从零一步一步实现一套Agent Harness，理解一个Agent运行时到底需要哪些组件，每一步为什么这么设计。适合想要自研Agent框架的同学。

模块五：Agent‑from‑scratch｜从零构建Agent + Agent评测框架

仓库最新新增模块，除了从零搭建Agent，重点加入Agent evaluation framework评测框架。不仅实现Agent本体，同时把评测体系完整搭建起来，解决"怎么衡量Agent好不好"这个工程难题。

三大开源项目架构哲学速览

|------|-------------------------------------|-----------------------------------|----------------------------------------|
| | PI | DeepSeek Harness | Hermes Agent |
| 扩展方式 | 精简核心 + TypeScript扩展/Skills/Prompt模板 | 万物皆插件（Cordis），三元Capability Seam结构 | PluginContext + Footprint Ladder六级决策框架 |
| 框架依赖 | 无独立元框架，扩展内置 | Vendor自持Cordis源码，可打补丁审计 | 无独立元框架，插件逻辑内置 |
| 会话表示 | JSONL追加日志 | 事件溯源日志SessionEventMap+Surface投影 | SQLite WAL+FTS5中文分词，会话链拆分 |
| 沙箱 | 依赖外部容器 | 自建多平台沙箱，C手写Landlock内核 | 7种可插拔终端后端，OS级网络隔离 |
| 进程形态 | 单一CLI进程 | Host/Client物理分离，编译期RPC契约 | 单进程多平台网关，多前端共享JSON‑RPC |
| 独有卖点 | 内核小巧，可单独复用引擎 | 自研沙箱内核、编译期RPC契约 | Skill自我进化、消息网关、训练轨迹批量生成 |

仓库Hermes章节内有一篇《插件架构对比精讲》，来自Hermes团队对Pi的源码级评审，读完PI再阅读，收获会更大。

✍️这套课程适合谁

不想只会调用API，希望吃透Agent底层原理的开发者
计划自研Agent，需要参考成熟开源项目架构选型
做Agent二次开发、插件扩展、安全沙箱、记忆上下文开发
需要搭建Agent评测体系，做智能体能力评估
学生、研究人员，做Agent方向学习与课题参考

仓库信息

仓库地址：