标签: Agent Loop

源码架构

本文基于本地 Pi 源码 checkout 和 packages/coding-agent/docs/，梳理 Pi Coding Agent 的核心架构。当前校对的 @earendil-works/pi-coding-agent 包版本为 0.75.5。下文源码路径均以 Pi 仓库根目录为基准。

1. Monorepo 分层

Pi 仓库是一个 monorepo，核心包如下：

包	路径	职责
`@earendil-works/pi-ai`	`packages/ai`	统一 LLM Provider API、模型定义、streaming、OAuth/API key、成本统计
`@earendil-works/pi-agent-core`	`packages/agent`	Agent Loop、消息状态、工具调用、steering/follow-up 队列
`@earendil-works/pi-coding-agent`	`packages/coding-agent`	CLI、TUI、会话、内置工具、扩展系统、SDK/RPC
`@earendil-works/pi-tui`	`packages/tui`	终端 UI 组件、差分渲染、输入处理

MorseWayne2026/5/25...大约 6 分钟

会话循环机制

在上一篇文章中，我们了解了 OpenCode 的整体架构。现在，让我们深入到最核心的部分：Agent Loop（会话循环）。

这是 AI Agent 的"心脏"，理解它，就理解了 Agent 为什么能自主完成任务。

什么是 Agent Loop？

传统的 Chat 应用是单轮交互：

用户发消息 → AI 回复 → 结束

MorseWayne2025/1/20...大约 8 分钟