Skip to content
Jefferson Gonçalves
← Back to projects

Pi Deep Dive

A source-guided Chinese deep dive into the Pi Agent Framework

#Pi Deep Dive

从 Agent 基础到源码实现，完整理解 Pi Agent Harness。

在线阅读：https://tt-a1i.github.io/pi-deep-dive/

这不是 Pi README 的视觉改写，而是一套基于固定源码快照的中文技术教材。网站先解释 Agent 的基本心智模型，再沿着 pi-ai → pi-agent-core → pi-coding-agent 的真实边界进入 Runtime、Context、Tool、Extension、Session 与 CLI，最后提供 SDK 与 Extension 实践。

#Research baseline

研究证据与设计提炼见：

#Stack

  • Astro 7
  • TypeScript
  • MDX
  • Astro Content Collections
  • Hand-authored SVG/CSS interaction + Mermaid source files

#Local development

要求 Node.js 22+。

npm install
npm run dev

打开 http://localhost:4321。

#Verification

npm run check         # Astro + TypeScript
npm run test:content  # 内容、slug、链接与源码证据约束
npm run build         # 类型检查 + 生产构建
npm test              # 内容检查 + 生产构建

#Content architecture

src/
├── components/       # Navigation, Sidebar, Callout, diagrams, evidence UI
├── layouts/          # Base and three-column docs layouts
├── pages/            # Home, About, dynamic content route
├── content/docs/     # MDX curriculum
├── diagrams/         # Mermaid sources
├── styles/           # Design tokens and prose system
└── utils/            # Site metadata and source pin

内容使用 collection schema 强制 section、order、level、阅读时间与 sourcePaths。动态路由按 order 生成章节和上一章/下一章导航。

#Design direction

视觉不是复制 Mintlify、Vercel 或 Stripe，而是从仓库中的 Design DNA 研究提炼出“technical editorial instrument”：窄正文、高密度三栏、发丝边界、克制苔绿色、衬线叙事标题、monospace 证据标签，以及只服务于状态解释的交互。

#Source accuracy policy

  1. Pi 实现事实必须能定位到固定 commit 的文件或符号。
  2. 官方文档说明与源码事实分开表达。
  3. 竞品比较注明快照日期，不做无来源排名。
  4. Agent OS 章节明确标为未来推演。
  5. Pi 没有内置 sandbox；Project Trust 不能描述为工具权限系统。

#License and affiliation

本项目是独立、非官方的学习资料。Pi 上游代码遵循其自身 MIT License；本项目引用链接指向固定上游源码，不复制大段源文件。

New version available.