看编码 Agent 的日志,我会先问两件事。模型说要改文件,到底是谁动了手?改完以后,程序又凭什么决定再问一次模型?
Pi Coding Agent 是一个开源、可扩展的终端编码代理。模型提出要读文件、编辑代码或跑命令,Pi 负责调用工具,把执行结果写回会话,再决定是否进入下一轮。你可以直接在终端用,也可以通过扩展、SDK 或 RPC 把它接进自己的工具链。Pi 官方介绍
我把这段执行过程做成了一个能点、能单步走的网站。打开 Pi 架构白皮书 · 直接进执行实验室
先做一个小实验
打开实验室的「并行与消息顺序」场景,点「单步继续」,对照「工具」和「消息」两个面板。工具完成事件按实际完成先后出现,回写给模型的 toolResult 则按模型提出调用的顺序排列。同一批工具有两套顺序,排查日志时要先分清自己看的是哪一套。

还可以切到「修复一个小 Bug」,跟着一次读文件、修改、测试走完,再试试工具报错或中途取消。实验室把固定版本的 runAgentLoop 放进浏览器,用脚本模型和内存文件模拟执行,打开网页就能操作。对应版本的循环源码
如果你在考虑接入自己的项目,可以接着看社区扩展选型和企业二开落地。前者适合查工具,后者可以顺着「仓库修复」走一遍,看看任务、隔离环境、审批和草稿 PR 该怎么交接。