Pi 版本雷达

Pi 1.0：全屏成为默认、codemode 瘦身四成、脚本里直接生成图片

• 全屏 TUI 成为默认模式——从 v0.84 的实验特性到 1.0 的默认形态；想保留终端普通滚动用 tuiMode: "regular" 或 --tui-mode regular

  TUI

• codemode 大幅瘦身：默认工具下 GPT-5.6 请求从约 5300 降到约 3300 token——工具声明只写一行调用方式，详细 models API 让模型按需去读；报错会教模型怎么自我恢复

  第5章第8章

• codemode 脚本可以生成图片：models.generateImages() 用会话凭据调图片模型，返回 base64 由 image() 附进结果，花费计入会话成本；扩展对应 ctx.modelRegistry.generateImages()

  第5章扩展

• MCP OAuth 加固：oauth.authServerMetadataUrl 应对错误的服务器元数据、RFC 9207 iss 校验防跨服务器混用、凭据按「服务器名+URL」存储、补充授权时保留已授予的 scope

  安全

• Radius 进入 /login：登录后一键配置 Radius MCP 服务器；Anthropic 新增 copy code 登录，浏览器在另一台机器的无头环境也能授权

  Provider

• quietStartup: "header" 只保留版本号和按键提示的精简启动头

  TUI

Codemode 与 MCP 登场：模型写 JavaScript 编排工具；虚拟模型、分类器、ChatGPT 登录一起来

• codemode：模型写的 JavaScript 在 QuickJS 沙箱里并行调用 Pi 工具，配 tool_search 按需声明未暴露的工具——工具编排从「一个一个调」变成「写脚本调」

  第5章

• MCP 服务器支持：stdio 与 streamable HTTP 传输、OAuth 登录、mcp.json 全局或项目级配置、/mcp 与 pi mcp add 管理；v0.99.2 起默认 codemode 曝光的服务器不再阻塞首条 prompt，改在系统提示词的 mcp_servers 短段落里列名

  第5章扩展

• 扩展工具编排 API：exposure（direct / model-only / codemode / deferred / hidden）、namespace、outputSchema 结构化输出、ctx.executeTool() 嵌套调用并记录 nestedCalls——第 5 章的工具系统长出了「元工具」层

  第5章扩展

• 实验性虚拟模型 pi.registerVirtualModel()：扩展按请求路由到不同物理模型，页脚显示路由结果、/session 按物理模型分别计成本；Jev 分类器模型内建，llama.cpp 模型也能当分类器

  第4章扩展

• Sign in with ChatGPT：OpenAI Provider 直接用 ChatGPT 订阅登录，旧 OpenAI Codex Provider 改名 legacy；GPT-6.1 Sol 上线并成为 Codex 新默认（v0.99.1）

  Provider

• system 主题成为默认：Pi 的颜色跟随终端自己的调色板，明暗切换自动重建——终端是什么样，Pi 就是什么样

  TUI

会话上下文可以「改视图不改历史」，Claude Opus 5.5 与 GPT-6 Sol/Luna 新模型上线

• 追加式上下文编辑 ContextEditEntry：sessionManager.appendContextEdit() 把某条消息从未来 Provider 上下文里略去，原始历史、用量统计和 UI 展示原封不动——上下文工程多了把「手术刀」

  第8章第10章

• context_with_system 扩展事件：在 context 之后对含系统消息的完整转录做每请求变换；同时 context 处理器不再能看到系统消息，过滤导致的 prompt 和工具声明丢失由 Pi 自动恢复

  第7章扩展

• 按模型配置图片输入限制：models.json 里 inputLimits.images.resize 做缓存安全的缩放，对附件、read 和工具结果里的图片统一生效

  第8章

• 新模型：Claude Opus 5.5（adaptive thinking + 1M 上下文）、GPT-6 Sol / GPT-6 Luna 上线，GitHub Copilot 同步支持；xAI 默认模型改为 Grok 4.7（v0.87.1）

  第4章Provider

• 不兼容shouldStopAfterTurn 选项移除：改用 finishTurn 返回 { action: "end" }，且 finishTurn 也会收到出错和中止的响应——「每轮后是否停」的判断换了钩子

  第3章扩展

• 不兼容SessionManager 成为 Provider 上下文的唯一权威：直接赋值 session.agent.state.messages 不再影响后续请求，须用 SessionManager.inMemory() / navigateTree() / refreshContext()；TurnEndEvent 增加必填边界字段、新增 agent_before_settle 事件

  第7章第10章

Prompt 缓存学会「保温」、对话中途换提示词与工具不再断档、约束采样默认转正、压缩预算可按模型配；Meta Muse 新 Provider 随 v0.86.1 登场

• 成本感知的 Prompt 缓存保温：长工具运行期间（可选空闲时）自动刷新保住缓存前缀，附 /session 诊断、转录提示和 cache_warming_decision 扩展事件——第 8 章缓存经济学有了主动武器

  第8章

• 对话中途更新系统提示词和工具定义可跨 resume 与分支导航保留，同时尽量保住缓存前缀（before_agent_start）——消息历史从「静态快照」变成「可演进转录」

  第6章第10章扩展

• 严格 JSON Schema 约束采样对内置 read / bash / powershell / edit / write 默认开启，不再需要 PI_EXPERIMENTAL——工具调用的 schema 保障正式转正

  第5章

• 按模型配置压缩预算：compaction.modelOverrides 里为不同模型单独设 reserveTokens / keepRecentTokens，普通压缩设置作为兜底

  第9章

• 不兼容pi-ai 自定义 Provider 流输入从 Context 改为规范化 TranscriptContext：系统提示词和工具声明改用 getCurrentSystemPrompt() / getCurrentTools() 读取；ToolCall.arguments 与 ToolResultMessage.details 限定为 JSON 兼容值——自定义 Provider 需要迁移

  第4章Provider

• 不兼容user_bash 改为失败即关闭：handler 抛错或返回非法结果会直接中止命令，不再放行本地执行——bash 拦截的安全默认值反转

  第5章扩展

GPT-6 Astra 上线、Claude thinking 力度跨轮保持、SDK 能恢复外部存储的内存会话

• GPT-6 Astra 模型上线：OpenAI API key 和 OpenAI Codex 订阅都能直接用（v0.85.1）

  第4章Provider

• 持久化 Claude thinking effort：支持的 Anthropic 传输层会保留每轮 effort，并从签名 thinking 不匹配中安全恢复——thinking 设置不再「一轮就丢」

  第4章

• SessionManager.inMemory() 支持恢复外部管理的会话条目——SDK 场景下内存会话也能「断点续传」

  第10章

• 全屏转录新增「跳到最新消息」按钮，工作指示器内嵌进编辑器边框并跟随 thinking 级别配色；Alt+滚轮五倍速滚动（v0.85.1）

  TUI

• 修复 0.85.0 误发布内部实验代码导致的 SDK 导入失败：client 与 experimental/plugin 子路径改为仅源码提供，受支持的本地 SDK 与 stdio RPC API 不变（v0.85.1）

  工程

• GPT-5.6+ Responses 模型的长 prompt 缓存改用 prompt_cache_options.ttl: "30m"，替代不再适用的 24h 保留字段（v0.85.1）

  第8章

全屏 TUI、远程会话客户端、Markdown 显示变换——Pi 开始把「界面」和「接入方式」都开放出来

• 实验性全屏 TUI 模式（--tui-mode fullscreen）：粘性编辑器、状态栏与 widget 停靠、可拖动滚动条，转录区独立滚动

  TUI

• 实验性远程会话客户端 API：传输中立的 PiClient、CBOR 协议、Unix-socket 传输，以及带转录 reducer 的 RemoteSession 控制器——可以把 Pi 的会话接到自己的前端上

  第7章第10章

• registerMarkdownTransformer() 钩子：对用户和助手的 Markdown 做「仅显示」转换，可链式注册——显示层与消息层分离的典型应用

  第6章扩展

• Mermaid 图表的 Unicode 终端渲染，交互式消息里也能画图（含流式渲染）

  TUI

• pi auth check 认证预检：验证 Provider 凭据是否可用；Qwen Token Plan Individual 成为内置 Provider（v0.84.1）

  第4章Provider

• 扩展的 tool_call 事件支持 terminate：拦截工具调用后可以直接终止整批，不再多发一次模型请求（v0.84.1）

  第5章扩展

• defaultTools 设置：全局或按项目配置启动时加载的内置工具集（v0.84.2）；Windows 新增可选原生 PowerShell 工具（v0.84.3）

  第5章

• /thinking 选择器上线，模型与 thinking 选择默认只在当前会话生效，Ctrl+S 才显式保存为全局默认——告别「选一次就改了全局配置」（v0.84.3）

  第4章TUI

• session_compact_failed 扩展事件：压缩失败与中止暴露原因、重试状态和错误信息；大工具结果越过阈值时改为同一轮内「先执行工具、再压缩、再继续」（v0.84.3 / v0.84.4）

  第9章扩展

• RPC clear_queue 可取回并清空排队的 steering / follow-up 消息；ui_prompt_start / ui_prompt_end 事件让宿主区分「agent 在干活」和「在等用户输入」（v0.84.4）

  第7章

• 不兼容GoogleThinkingLevel 类型更名为 GoogleApiThinkingLevel，新增 ResolvedGoogleThinkingLevel——写 Google 相关扩展的需要改名（v0.84.3）

  扩展

凭据导出与无头登录，stop reason 开始「说真话」

• pi auth print-api-key / print-bearer-token：把配置好的凭据导出给外部客户端用，OAuth 自动刷新、可设最小有效期

  第4章

• 无头环境 OpenRouter 登录：SSH 场景下粘贴重定向 URL 或授权码即可完成 /login

  Provider

• 原始 stop reason 透传：Google / Anthropic / Bedrock / Mistral / OpenAI 的终止原因不再被抹平，未映射的终止原因会上报为 Provider 错误而不是假装成功——容错设计的重要一课

  第6章第7章

• 新增 "pending" stop reason 表示流式消息只到了一部分，自定义 Provider 可以表达「还没完」

  第7章

• 不兼容TypeBox 升级到 1.3.7，移除多个废弃 API——写扩展时用到旧 API 的需要迁移

  扩展

约束采样让工具调用更可靠，OAuth 登录进入 /login

• 约束工具采样（Constrained Sampling）：工具可以要求严格 JSON Schema 输出或用语法约束生成，模型能力元数据自动拦截不支持的请求——「工具用严格 schema」从建议变成机制

  第5章

• OpenRouter 和 Kimi Code 订阅支持 /login OAuth 授权，不用再手动配 API key

  Provider

• bash 工具获得会话环境变量（PI_SESSION_ID / PI_PROVIDER / PI_MODEL 等），RPC 的 bash 命令支持流式输出事件

  第5章第7章

• DNS 解析失败（ENOTFOUND / EAI_AGAIN）现在会触发自动重试——瞬时网络故障不再直接打断对话

  第7章

压缩学会「弹性」：Provider 抖动时按策略重试，全过程可观测

• 弹性压缩与分支摘要：压缩时遇到 Provider 临时故障会按配置的重试策略重试，重试生命周期事件暴露给交互界面、JSON、RPC 和 SDK——第 9 章压缩算法的生产化续集

  第9章

• pi-ai 新增 retryAssistantCall()：对瞬时 assistant 故障做有界重试，带生命周期回调和 abort 处理

  第7章

• GitHub Releases 附带确定性、带校验和的源码归档，可独立重建二进制

  工程

• 修复 Kimi K3 模型：使用 OpenAI thinking 格式并支持 reasoning effort

  Provider

max thinking 级别、长上下文精确定价，pi-ai 旧 API 迁移到 compat（持续一个月的密集修补）

• 新增 max thinking 级别（在 xhigh 之上），GPT-5.6 与 adaptive Claude 模型原生支持

  第4章

• 基于输入量的定价阶梯：长上下文请求按阶梯精确计费，自定义模型也可配置——成本核算进入「看得见的成本」时代

  第8章

• 不兼容pi-ai 旧全局 API（stream / complete / getModel…）移至 /compat 入口，新代码应使用 createModels() / Provider-factory

  第2章

• 选择性 Provider 入口：pi-ai/base + pi-agent-core/base，打包应用只带用到的 Provider 传输层

  第2章

• 压缩后 token 估算数随压缩结果和事件返回，客户端可以展示「压掉了多少」

  第9章

• 导出 InMemorySessionStorage / JsonlSessionStorage，会话存储层正式成为可编程接口；会话条目 ID 改用 uuidv7 随机尾部

  第10章

• 修复压缩摘要请求串行化（避免单并发 Provider 收到重叠请求）、compact 后输出预算忽略过期用量等一系列第 9 章相关的边界修复

  第9章

项目信任机制上线：加载项目本地配置前先问你一句

• 项目信任保护：加载项目本地的设置、资源、指令和包之前会请求确认，支持记住决定和 --approve / --no-approve 非交互控制——prompt 注入防线前移到了启动时刻

  安全

• project_trust 扩展事件：扩展可以接管信任决策（决定 / 记住 / 推迟）

  扩展

• 页脚显示最近一次请求的 prompt 缓存命中率（CH）——缓存效果第一次「看得见」

  第8章

• 压缩摘要的系统提示词改为中立措辞，非编码类 agent 复用压缩器时不再被「编程助手」人设带偏

  第9章

命名会话、可点击文件链接，扩展能感知自己运行在什么模式里

• 命名启动会话：--name / -n 在交互、print、JSON、RPC 各模式下都能启动前指定会话显示名

  第10章

• 内置文件工具的路径渲染为 OSC 8 file:// 超链接，终端里直接点开（含 tmux）

  第5章TUI

• 扩展上下文新增 ctx.mode 与 ctx.getSystemPromptOptions()：扩展可以区分自己跑在 TUI / RPC / JSON / print 哪种模式，并检查基础系统提示词输入

  扩展

• 新增容器化文档与 Gondolin 示例：把内置工具路由进本地 micro-VM 执行

  安全

工具可以按名单禁用，输入事件能区分「排队」和「插队」

• --exclude-tools / -xt：按名字禁用指定内置、扩展或自定义工具，其余照常——最小权限原则落到 CLI 参数上

  第5章

• 扩展输入事件新增 streamingBehavior：区分空闲输入、流式中途的「插队」指令和排队 follow-up——第 7 章事件流的粒度再细一档

  第7章扩展

• SIGTERM/SIGHUP 退出时先触发 session_shutdown 让扩展清理资源（如 socket），终端再关闭——优雅停机不再是可选项

  第7章

• Claude Opus 4.8 模型元数据与 adaptive-thinking 覆盖更新

  Provider

会话 ID 可以显式指定，bash 输出可以不进上下文

• --session-id <id>：脚本可以精确创建或恢复某个项目本地会话——自动化场景的基础能力

  第10章

• RPC bash 命令支持 excludeFromContext：命令执行了，但输出不随下一条 prompt 发给模型——上下文精打细算的又一工具

  第8章

• Provider 重试与超时全面可控：retry.provider.maxRetries 显式生效，Codex WebSocket/SSE 等待都有界

  第7章

• 修复图片附件的 token 估算与用户消息、工具结果不一致的问题

  第8章

启动时自动检查更新，扩展宿主预编译提速

• 启动时自动检查新版本并提示，不必再手动 pi update

  工程

• 扩展宿主构建期预编译，消除 jiti 导入开销，扩展加载更快

  扩展

• 修复 /compact 对默认压缩提示的处理

  第9章

包作用域迁移到 @earendil-works，Codex 有了 WebSocket 长连接

• 不兼容包作用域从 @mariozechner 迁移到 @earendil-works——本指南所有包名均以新作用域为准

  第2章

• OpenAI Codex WebSocket 传输（websocket-cached）：ChatGPT Plus/Pro 用户保持长连接，后续请求更快

  第4章第7章

• Anthropic 模型支持扩展 thinking 级别 high / xhigh

  第4章

• ChatGPT Pro 用户新增 o3 / o4-mini

  Provider

自更新支持包名迁移，models.json 接受注释和尾逗号

• pi update --self 支持跨包名自更新：自动卸载旧的全局包并安装新作用域的包

  工程

• OAuth Provider 可以在 /login 里呈现多个登录选项，交互式认证流程成形

  Provider

• models.json 支持 JSONC 风格解析（注释 + 尾逗号），自定义 Provider 配置更好维护

  第4章