Pi Coding Agent 的设计与运行机制解释它为什么采用小核心、怎样将模型与工具连接起来，以及如何在连续任务中组织状态和历史。
内容范围
- 设计理念与能力边界：核心与扩展的分工及其使用代价。
- 架构与 Agent Loop：模型接入、工具执行、运行事件及应用层之间的关系。
- 会话与上下文管理：历史存储、分支选择、恢复与上下文压缩。
理解这些主题时，需要区分产品功能、一次运行的流程和跨运行保存的会话。模型响应结束不一定代表整个任务结束；会话保存完整也不代表模型每次读取全部历史。
可以先从设计选择理解各组件的职责，再沿一次任务观察消息与工具结果，最后理解会话如何为下一次运行提供上下文。官方仓库提供组件划分，会话文档说明用户可见的历史操作。