设计哲学：最小核心，可见控制

分析 Pi 的 minimalism、developer-first 与 control vs automation，不把取舍包装成绝对优势。

Minimal 不是代码越少越好

Developer-first 的四个表现

1. 状态可观察

Agent event 区分 agent、turn、message 与 tool execution 生命周期。UI 不需要猜测“是不是还在运行”。

2. 控制可插入

before/after tool hooks、prepareNextTurn、steering/follow-up queue 和 abort signal 都是明确边界。

3. 历史可回放

Session JSONL 保存分支与配置变化，而不是只存最终回答。

4. 宿主可替换

interactive、print、JSON、RPC 与 SDK 共享 runtime，不把产品形态固化在 CLI。

Control vs Automation

Pi 不把 human-in-the-loop 简化成“每次都弹确认”。控制可以是：

• 开始前选择 project trust。
• 运行中 steering 或 abort。
• extension 对某类 tool call 做 policy decision。
• session tree 回到决策点重走。
• 在外部 sandbox 限制真实权限。

工程取舍

Pi 独特的地方

不是拥有某个其他框架绝无仅有的功能，而是把 minimal runtime + strong extension surface + session tree + terminal control 组合在一起，并公开承认权限边界。独特性来自组合与优先级，不来自功能清单。