手册/第 09 章
09
一年演进:博客是快照,仓库是现状
这是把两个素材源交叉验证后最有价值的产出。只看博客会学到过时的结论,只看代码会不知道设计意图。 下面每一行都能在仓库里找到对应证据。
| 主题 | 博客(2025-11-30) | 仓库(531340f,2026-10-27) |
|---|---|---|
| MCP | 明确不支持,且「将来也不会」 | 支持:pi mcp add/list/remove、/mcp、packages/mcp |
| system prompt | 一段静态字符串,约 20 行 | 7 个可独立替换的 section,可按工具集动态生成 rules |
| 工具集 | 默认 4 个(read/write/edit/bash) | + grep / find / ls / powershell、codemode、MCP 命名空间工具 |
| 包名 | @mariozechner/pi-ai 等 |
@earendil-works/*(含 chord、pi-telemetry 等) |
| 仓库形态 | 以 coding agent 为中心 | 11 包 monorepo:ai / agent / tui / coding-agent / durable / chord / codemode / mcp / env / evals / telemetry |
| 会话格式 | JSONL + 树 | 同一思路,但已显式版本化(version 字段),entry 类型固定为 12 种 |
| 非 LLM 模型 | 未涉及 | codemode 引入分类器 / 图像模型等非对话模型 |
| 安全表述 | 「权限提示是安全剧场」 | 保留该立场,但补了完整文档:security / containerization / project trust |
从这张表里能学到什么
1. 立场会变,原则不变。MCP 从「不做」变成「做」,但实现方式仍然服从统一的工具管线与工具过滤,
没有变成第二个平行的能力系统。
2. 可观测性诉求一路加强。system prompt 从一整块变成可替换分节、会话格式加版本号, 都是为了让「模型到底看到了什么」更可解释。
3. 外围包在扩张。durable(7.4 万行)、chord(3.5 万行)这些包的体量远超 agent 核心, 说明产品化成本主要落在工作流、编排与持久化上,而不是 agent 循环本身。
2. 可观测性诉求一路加强。system prompt 从一整块变成可替换分节、会话格式加版本号, 都是为了让「模型到底看到了什么」更可解释。
3. 外围包在扩张。durable(7.4 万行)、chord(3.5 万行)这些包的体量远超 agent 核心, 说明产品化成本主要落在工作流、编排与持久化上,而不是 agent 循环本身。
顺带一个数字:基准测试
作者用 Terminal-Bench 2.0 做了完整跑测(每个任务 5 次试验,达到提交排行榜的要求), 让 pi + Claude Opus 4.5 与 Codex、Cursor、Windsurf 等 harness 各自搭配原生模型比较。 他特别提到榜单上 Terminus 2 的表现:那个 agent 只给模型一个 tmux 会话, 没有花哨工具,只靠文本命令与终端输出解析,却能和一些工具复杂得多的 agent 打平。
"More evidence that a minimal approach can do just as well."
这进一步证明,最小化的方法同样能做得一样好。
这句话其实是整份手册的论点小结:能力来自模型,harness 的职责是不挡路。