Agent 源码学习四册

从 Pi 到 DeepSeek Harness,理解设计取舍,追踪运行机制,再横向检验工程选择。35 章、5 页横向对照,沿一条完整的阅读路线深入。

Pi 系统学习手册 →

第 1 册 · 12 章

从心智模型、设计哲学与架构,到会话、扩展和动手改造。

  1. 01 心智模型
  2. 02 设计哲学
  3. 03 架构图
  4. 04 一次提问
  5. 05 六个机制
  6. 06 会话与上下文
  7. 07 刻意不做
  8. 08 扩展与集成
  9. 09 演进对比
  10. 10 动手练习
  11. 11 延伸阅读
  12. 12 作者自述

深入理解 Pi →

第 2 册 · 6 章

追踪循环、工具、会话树、压缩算法、扩展事件和类型契约。

  1. 一个 turn 的全过程
  2. 工具契约
  3. append-only 树
  4. 压缩算法
  5. 扩展面
  6. 类型即契约

理解插件树、事件域、执行流程、持久化与可替换能力。

  1. 01 心智模型
  2. 02 设计哲学
  3. 03 架构图
  4. 04 一次提问
  5. 05 五个机制
  6. 06 会话与持久化
  7. 07 刻意不做
  8. 08 扩展与集成
  9. 09 演进对比
  10. 10 动手练习
  11. 11 延伸阅读

深入理解 dsh →

第 4 册 · 6 章

沿源码拆解 turn、工具、日志、压缩、Hooks 与持久执行。

  1. 一个 turn 穿过插件树
  2. 工具注册表是插件
  3. 只追加与 replace
  4. 压缩流水线
  5. hooks 兼容层
  6. 崩溃可续

Pi × dsh 横向对照 →

横向对照 · 5 页

总览、dsh 解读、八项深挖、读书指南与故障恢复。

  1. 读书指南
  2. 逐项深挖
  3. 读懂 DeepSeek Harness
  4. pi vs DeepSeek Harness
  5. 故障→恢复映射表

源码、版本与配套实作

本系列由站点作者编写,引用官方文档、仓库源码和作者博客。Pi 固定于 531340f(2026-10-27),dsh 固定于 22ddee3(2026-10-23),与配套实作课的 v1.4.0 快照分别保留。源码引用采用各自 MIT 许可;学习记录仅保存在本机。