用途：面向 Pi 扩展开发者的综合参考手册，帮助在构建扩展、调试扩展行为、选择合适实现模式时快速定位所需文档。
主要能力：以三大主文档为核心——ARCHITECTURE.md（写扩展代码前的心理模型、执行流程与事件语义）、PATTERNS.md（38 个可复制粘贴的模式及确切导入）、ANTI-PATTERNS.md（15 个常见错误及修正）；配套 guides/ 提供从 5 分钟快速上手到生产架构、RPC 模式、内部机制、高级模式的渐进教程，references/ 提供完整 API、事件、UI 组件、多智能体模式、TUI 渲染与启动优化等参考。
使用方式：按“先读 ARCHITECTURE，再按任务查 PATTERNS，调试时查 ANTI-PATTERNS”的顺序使用；决策树辅助判断用哪种文档或范式。示例以命令行创建扩展文件，放入 ~/.pi/agent/extensions/，用 pi -e ~/.pi/agent/extensions/hello.ts 临时加载测试，该目录下扩展自动发现。导入示例含 @earendil-works/pi-coding-agent、@sinclair/typebox、@earendil-works/pi-tui 等包。
适用场景：编写新扩展、排查扩展故障、优化扩展启动速度、构建 TUI 组件、实现多智能体模式、自定义 provider 或 OAuth、处理 RPC 安全与文件变更队列等。
限制：资料仅说明文档结构与用法，未提供具体价格、平台支持范围或效果承诺；完整代码示例需查阅对应文档文件。