从零构建 Agent
如果你想知道 Half-Pi 为什么被拆成 Mind、Face 和 Hand，不必一开始就钻进源码。先沿着这条路线走：从一次普通模型问答出发，逐步补上循环、工具、安全、状态、远程执行、审批和审计。
每一章只回答一个核心问题，也只引入解决它所必需的结构。读完之后，你再回到架构手册或源码，会更容易看出每个模块为什么存在。
flowchart TD
A["模型问答"] --> B["Agent 循环与工具"]
B --> C["安全执行与状态"]
C --> D["Face / Mind / Hand"]
D --> E["恢复、审计与压缩"]
E --> F["可用 Agent 系统"]
这不是 API 手册，也不是从文件树开始的源码导览。它更像一条建设路线：先遇到问题，再比较方案，最后落到 Half-Pi 当前采用的实现。
章节形式会随问题变化：有的章逐轮走读一次 Agent 循环（第 2 章），有的章用攻击场景证明“注册工具”不等于“安全执行”（第 5 章、第 11 章），也有章节把几种设计摆开对比，再解释为什么选择其中一种（第 9 章、第 14 章）。
每章开头会接住上一章留下的问题；中间的折叠检查点适合先自己判断再展开；章末的证据地图用于回查实现与测试。被否决的方案也值得看，因为很多架构边界正是从这些失败路径里长出来的。