pi 系统学习手册 第 09 / 12 章 总目录 单页全本 架构图 GitHub

手册/第 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 循环本身。

顺带一个数字:基准测试

作者用 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 的职责是不挡路。

本章学习记录

记录仅保存在当前浏览器。