源码剖析 · Agent 实战框架

本分组收录 Agent 实战框架的源码阅读系列，三套代码对应 agent 工程的三种典型形态：

• DeepSeek Harness 源码（9 篇，完本）—— DeepSeek 开源的 agent harness 底座，副标题「Everything is a Plugin」，平台级插件化架构（TypeScript）。
• Hermes Agent 源码（6 篇）—— NousResearch 的「越用越懂你」个人 agent 产品：从经验中创建技能、跨会话记住用户（Python）。
• Pi Web 源码（8 篇，完本）—— pi coding agent 的官方生态 Web UI：进程内 SDK 集成、SSE 事件流与 608 个提交里的渐进式长成（TypeScript）。

三者的对照与取舍在各自系列的收尾篇中有横向比较，建议先读 DeepSeek Harness 打底，再看 Hermes 与 Pi Web 两种产品化路线。

文章目录

目录

• DeepSeek Harness 源码

  • 0001 开箱全景：dsh 是什么，凭什么「一切皆插件」
  • 0002 Cordis 基石：插件、服务与可逆副作用
  • 0003 装配的艺术：Profile / Bundle / Patch 三层组装
  • 0004 会话即事实：只追加的 SessionEvent 日志
  • 0005 心脏：Agent Loop 逐行剖析（1756 行）
  • 0006 工具流水线：注册、把关与执行
  • 0007 能力 Seam：换一个 Provider 就换了整个产品
  • 0008 LLM 适配层与 DeepSeek 私有协议扩展
  • 附篇 · dsh × Pi × Claude Code：三种 harness 哲学对照

• Hermes Agent 源码

  • 0001 开箱全景：The agent that grows with you
  • 0002 巨核与窄腰：agent loop、上下文工程与工具系统
  • 0003 学习闭环与数据飞轮：为训练下一代模型而生的记忆系统
  • 0004 产品化外围：网关、多端与任务编排
  • 0005 安全模型与插件生态：一条按信任分层的供应链
  • 0006 对照篇 · hermes × dsh：选地基还是选成长

• Pi Web 源码

  • 0001 开箱全景：pi-web 是什么，pi 和 web 凭什么能结合
  • 0002 进程内集成：把 AgentSession 关进 Next.js
  • 0003 SSE 事件流：让浏览器看到 agent 的每一次心跳
  • 0004 会话文件：一份 JSONL，两种读法
  • 0005 TUI 桥接：把终端扩展生态整体搬进浏览器
  • 0006 演进史：608 个提交里的渐进式长成
  • 0007 安全边界：一个能执行命令的网页如何关进笼子
  • 0008 总结：给 agent 换皮的三条路线与 borrow/build 清单