更新日志

最后更新：2026-10-19

这里记录上游 earendil-works/pi 的重要变更，以及本站文档的同步情况。只收录对使用者有影响的变化，完整的提交历史请看上游仓库。

2026 年 10 月

v1.3.0：/share 上传目的地、思考缓存保持（2026-10-15 上游）

/share 现在可以选择上传目的地：sessionShareDestination 可设为 auto、gist 或 radius。OpenAI GPT-6（API key 模式）会话中途切换思考级别不再失效 prompt 缓存。Kimi Code 改走 OpenAI Chat Completions 协议（https://api.kimi.com/coding/v1），对话中途新增工具也不再失效缓存；注意 models.json 里覆盖 kimi-coding 的 base URL 现在必须带 /v1。切换模型时会丢弃上一模型的思考块（不再作为纯文本塞给新模型）。--resume 恢复会话保留其活跃工具集，--tools +name/-name 叠加在其上生效。另修复新装混装不兼容包的问题：内部依赖已钉到确切发布版本。

v1.2.0：按 key 的 OpenRouter 模型列表、配置 Schema（2026-10-12 上游）

用 OpenRouter key 时，Pi 只列出该 key 可用的模型（含上下文长度、最大输出、价格，支持 models.json 里配的区域端点）。配置 Schema 公开发布：settings.json、models.json、键位、主题可加 $schema 做编辑器校验和补全。远程会话中复制可用 PI_CLIPBOARD_OSC52=1 把文本发回远端客户端剪贴板。codemode 工具声明显示输入约束（整数、最小/最大值、默认值），行尾显示耗时与总耗时。before_agent_start 现在也对扩展触发的 run 生效。⚠️ 破坏性变更：主题 schema 迁至 https://pi.dev/schemas/theme.schema.json（旧 $schema 引用要改，复用颜色放 vars 下，删掉不支持的元数据）；BeforeAgentStartEvent 按 messageType 分为 "user"/"custom"，只关心用户提示的 handler 需显式检查 event.messageType === "user"。

v1.1.0：程序状态上报、Claude Haiku 5.5（2026-10-07 上游）

支持 OSC 7501 的终端与 Agent 仪表盘现在能看到 Pi 的实时状态：运行中、卡在对话框或登录、已完成或失败。新模型 anthropic/claude-haiku-5-5 支持自适应思考（最高 xhigh/max 档）。--tools 新增 +name/-name 写法（如 pi -t +codemode,-write），在默认工具集上做增减而不是整体替换。另外 GPT-6 Luna 开始可用作分类模型，codemode 的 models.classify() 接受图片输入。

v1.0.4：工具通配符与 --no-mcp（2026-10-05 上游）

--tools / --exclude-tools 支持 * 通配符（如 --tools read,codemode,'mcp__radius__*'）；--tools 不再默认剔除 MCP 工具（除非条目以 mcp__ 开头）；新增 --no-mcp 单次禁用 MCP。codemode 的 tools.read() 读取图片文件现在返回图片块，可直接用 image() 展示。

v1.0.3：Azure provider 改名（破坏性变更，2026-10-05 上游）

⚠️ 破坏性变更：Azure provider 由 azure-openai-responses 改名为 azure，需要同步改 auth.json、models.json、settings.json 中的 provider key（或重新 /login）。同时 azure 开始支持 Azure Foundry Chat Completions 部署（首批 azure/deepseek-v4-pro）。codemode 的 image() 生成的图片还会落盘到临时文件并在结果中给出路径，方便后续轮次复制或移动。

v1.0.0–v1.0.2 版本补录（2026-10-01–04 上游）

v1.0.0 起 TUI 默认全屏运行（tuiMode: "regular" 可恢复滚动回看）；codemode 精简约 40% prompt token 并支持图片生成（models.generateImages()）；/login 支持 Radius 一步登录。v1.0.1 新增 Nix 安装方式（nix run github:earendil-works/pi/stable）和项目级 MCP 覆盖（.pi/mcp.json）。v1.0.2 新增按思考级别配置采样参数（samplingParamsByThinkingLevel）。

MCP Codemode（2026-10-01 上游）

codemode 现在可以作为 MCP 服务运行：用 /mcp 命令管理，通过 pi mcp list | login | logout 查看与授权。codemode 的运行时在首次使用时按需加载，不再常驻内存。如果你用 Pi 给其他 Agent 提供编码能力，这个变化值得关注。

pi-agent-core 精简（2026-10-01 上游）

实验性的 harness 相关代码从 pi-agent-core 中移除，核心包现在只保留 Agent、agent loop、proxy stream 及类型定义。持久化会话能力移至 @earendil-works/pi-durable。如果你在做二次开发并直接依赖了这些内部模块，升级时注意调整 import 路径。

2026 年 9 月

Eval 提示词校验改进（2026-09 上游）

coding-agent 的 eval 流程改为从 transcript 回放中验证文档变体，而非依赖重载后的会话配置。主要是开发者向的改进，普通用户无感。

本站文档同步记录

• 2026-10-19：补录上游 v1.0.0–v1.1.0 条目（10-15 当轮部署被只读预备模式拦下，顺延至今），新增 v1.2.0（10-12 上游）与 v1.3.0（10-15 上游）条目，含 Kimi Code 协议变更与主题 schema 迁移提示；"最后更新"日期刷新为 2026-10-19。
• 2026-10-10：新增本更新日志页；全站"最后更新"日期刷新；页脚新增 AI Agent 评分榜入口。
• 2026-08-18：部分页面内容增补。
• 2026-07-13：文档站初版上线（架构、核心包、核心概念、运行调试、模型供应商等）。

相关链接

• 上游仓库 earendil-works/pi（源码、Issue、完整更新历史）
• AI Agent 评分榜（含 Pi Agent 的透明评分）
• 文档中心