METHODOLOGY

不是 README 的另一种排版。

Pi Deep Dive 是独立制作的中文技术教材。它以固定源码快照为事实底座,以官方文档补充用户层语义,并把推演明确标记为推演。

分析边界

证据等级

A · Source fact

可直接定位到固定 commit 的文件、符号或测试。

B · Official intent

来自 Pi 官方 README、文档与贡献指南。

C · Interpretation

基于 A/B 的架构解释或未来推演;正文会显式说明。

关键起点

README.md:13-45package boundaries + permissionsCONTRIBUTING.md:5-17minimal core philosophypackages/agent/src/agent-loop.ts:155-275runLoop()packages/coding-agent/src/core/session-manager.ts:30-174session entry model

名称说明

历史版本常见 @mariozechner/pi-*;本快照已使用 @earendil-works/pi-*,上游首页名称为 “Pi Agent Harness”。文中讨论“Pi Coding Agent”时,特指 monorepo 中的 packages/coding-agent