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自我进化、消息网关、训练轨迹批量生成