最近两年Agent项目遍地开花GitHub满眼都是“下一代智能体”“生产级Agent框架”。很多同学把Demo跑通不难但是一旦要深入底层、二次开发、自研Agent立刻就卡住。只看官方README、使用教程只能学会调用API看不懂底层架构取舍会话状态如何持久化工具调用完整管线如何流转沙箱安全模型怎么设计插件扩展点埋在哪里不同框架在记忆、多模型、多进程上踩过哪些坑网上绝大多数中文资料停留在“如何使用”缺少摘录真实源码、逐段讲解设计动机的深度剖析材料。于是我整理了这套面向彻底剖析的中文技术课程完整开源在GitHub。https://github.com/ArronAI007/agent‑framework‑insights这套课程不是翻译文档而是直接拿真实项目源码逐段解读做到先会用再懂原理最后学会扩展改造Agent框架。仓库使用MIT协议大家可以自由阅读学习。仓库根目录一共5大模块PI拆解earendil‑works/pi极简编码AgentDeepSeek‑ Harness拆解DeepSeek开源Harness插件框架Hermes‑Agent拆解NousResearch Hermes生产级自进化AgentHarness‑from‑scratch从零手写一套Agent Harnessv1‑v15完整路线Agent‑from‑scratch从零构建Agent新增Agent评测框架内容推荐阅读顺序Agent‑from‑scratch → PI → DeepSeek‑Harness → Hermes‑Agent → Harness‑from‑scratch由从零手写实现到现成项目剖析过渡复杂度逐步升高。模块一PI极简终端编码AgentPI是代码体量很小的编码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真实生产打磨的自进化AgentHermes‑Agent和前两个“干净架构演示”项目气质完全不同。万行级Python核心模块面向个人与团队真实生产环境。✅7种可插拔终端后端local/docker/SSH/Singularity/Modal/Daytona/Vercel Sandbox✅Skills自我进化学习环Agent从对话自动生成、迭代更新Skill技能✅单进程消息网关同时对接Telegram/Discord/Slack/Email等平台✅Cron定时调度支持本地、Chronos无服务器托管模式✅SQLiteFTS5自研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好不好”这个工程难题。三大开源项目架构哲学速览PIDeepSeek HarnessHermes Agent扩展方式精简核心 TypeScript扩展/Skills/Prompt模板万物皆插件Cordis三元Capability Seam结构PluginContext Footprint Ladder六级决策框架框架依赖无独立元框架扩展内置Vendor自持Cordis源码可打补丁审计无独立元框架插件逻辑内置会话表示JSONL追加日志事件溯源日志SessionEventMapSurface投影SQLite WALFTS5中文分词会话链拆分沙箱依赖外部容器自建多平台沙箱C手写Landlock内核7种可插拔终端后端OS级网络隔离进程形态单一CLI进程Host/Client物理分离编译期RPC契约单进程多平台网关多前端共享JSON‑RPC独有卖点内核小巧可单独复用引擎自研沙箱内核、编译期RPC契约Skill自我进化、消息网关、训练轨迹批量生成仓库Hermes章节内有一篇《插件架构对比精讲》来自Hermes团队对Pi的源码级评审读完PI再阅读收获会更大。✍️这套课程适合谁不想只会调用API希望吃透Agent底层原理的开发者计划自研Agent需要参考成熟开源项目架构选型做Agent二次开发、插件扩展、安全沙箱、记忆上下文开发需要搭建Agent评测体系做智能体能力评估学生、研究人员做Agent方向学习与课题参考仓库信息仓库地址https://github.com/ArronAI007/agent‑framework‑insights开源协议MIT欢迎Star欢迎提交issue交流思路。写在最后现在Agent生态Demo遍地但工程落地坑非常多。很多问题不在大模型本身藏在会话状态、工具管线、安全沙箱、上下文压缩、错误降级这些底层工程细节。希望这套课程帮大家少踩坑看懂别人的设计最终做出自己的Agent系统。文末互动你开发Agent踩过最大的工程坑是什么欢迎评论区一起交流。