For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /news.md.

新闻

Pi Coding Agent 及其子包的版本发布记录。

v1.5.2(2026-11-10)

Pi Coding Agent

新功能

  • Fork 工作目录已消失的会话 – 会话原来的文件夹被移动或删除后,现在可以 fork 到当前文件夹,而不只是继续,这样之后再恢复就不会再问。详见 继续或切换会话。

变更

  • 会话的工作目录已不存在时(例如项目文件夹被重命名),交互模式现在提供 Continue、Fork 或 Cancel,而不只是继续。Continue 在当前目录运行会话,不保存这个选择,和以前一样;Fork 把它复制到当前目录,成为带新 ID 的新会话,类似 --fork,下次恢复不再询问。这适用于启动时(--session、--resume)、/resume、/import,以及扩展的 ctx.switchSession()(#11975 由 @petrroll 贡献,修复 #11060)。

修复

  • 修复了 /import 一个工作目录已不存在的会话时,会在会话目录留下一份副本,继续它又会留下第二份相同 ID 的副本(s.jsonl 和 s-1.jsonl)的问题;失败的副本现在会被删除(#11975 由 @petrroll 贡献,修复 #11060)。
  • 修复了 Anthropic OAuth 请求报告过时的 Claude Code 版本。
Pi AI

修复

  • 修复了 Anthropic OAuth 请求报告过时的 Claude Code 版本。

v1.5.1(2026-11-09)

Pi Coding Agent

新功能

  • Shell 登录和登出 – 不启动会话即可使用 pi auth login <provider> 和 pi auth logout <provider>,并支持 API Key 和无浏览器登录。详见 凭证命令。
  • 空闲时的 Prompt 缓存预热 – 当一次刷新预计能收回成本时,符合条件的缓存现在会在运行之间保持温暖最多 30 分钟。详见 cacheWarming。
  • Anthropic message threads – 服务器继续对话时,请求只发送新消息;更早的上下文变化时回退到完整请求。详见 Anthropic 兼容性。
  • 更丰富的 Mermaid 图 – 支持饼图、作者定义的样式、在支持的终端上可点击的标签,以及展开的分支摘要和压缩摘要中的图。详见 显示设置 和 Markdown 转换器。
  • GitHub Copilot 分类器 – 通过 codemode 的 models.classify() 调用 Microsoft-Decision-1,得到带类型的决策和概率。详见 使用分类器模型。
  • 包更新摘要 – pi update --extensions 报告每个包的 npm 版本或 git commit 变化,并区分未变化、已跳过和带警告的更新。详见 更新 Pi 或包。

不兼容变更

  • 自定义 GrepOperations.readFile 回调不再为上下文行调用。该字段仍作为可选且已弃用的参数接受,以便现有集成仍能编译。grep 工具现在从 ripgrep 取得上下文行,不再自己读取匹配的文件。要搜索远程系统,覆盖 grep 的 execute();见 远程执行(#9276)。
  • 在用过工具的会话中禁用全部工具时,OpenAI 兼容模型不再发送 "tools": [],该字段会被省略。这修复了 vLLM 0.20+(也包括 LiteLLM 后面的)返回的 400 错误(tools must not be an empty array)。如果代理在历史含有 tool call 后仍要求 tools,例如旧版 LiteLLM 放在 Anthropic 前面,在 models.json 里为该模型设置 compat.requiresToolsWithToolHistory: true(#11843)。

新增

  • pi update 现在列出每个已更新的包及其 npm 版本或 git commit 变化,例如 npm:foo 1.2.0 -> 1.3.0,没有变化时打印 Packages are already up to date。没有变化但某次更新打印了警告时(例如 npm 在解析过期的 registry 元数据后仍留下旧版本),改为打印 No packages were updated, see the warnings above;离线模式下打印 Skipped package updates (offline mode)。PackageManager.update() 把每个发生变化的包报告为新的 result 进度事件,其 message 就是那一行(#11707、#11711)。
  • Anthropic 会话现在使用 message threads:每次请求只发送新消息,服务器从上次回复继续;对话发生变化时(例如压缩后或工具列表变化)回退到完整请求。对 api.anthropic.com 上的 anthropic Provider 默认开启;在 models.json 中设置 compat.supportsMessageThreads,可为转发 thread 字段的网关开启,或把它关掉。缓存预热不会触碰会话的 thread(#11545)。
  • pi.registerMarkdownTransformer() 接受可选的 { messageTypes },用来选择转换器作用的 Markdown 界面。除了用户、助手和 thinking 的 Markdown,转换器现在还可以选择 custom(自定义消息和 Skill 块)、summary(分支摘要和压缩摘要)和 changelog(What's New、/changelog、Extension Updates 通知和 Update Available 说明)。不传选项时,转换器仍作用于用户、助手和 thinking 的 Markdown,和以前一样。内置 Mermaid 渲染器现在也会在展开的分支摘要和压缩摘要中绘图。
  • pi auth login <provider> 从 Shell 登录某个 Provider,不启动会话,例如 pi auth login radius。它在浏览器中用账号登录后退出;--api-key 改为保存 API Key,--no-browser 改用设备码或复制验证码登录。登录 Radius 还会配置 Radius MCP 服务器。pi auth logout <provider> 移除已保存的凭证,和 /logout 一样。
  • ctx.ui.custom() overlay 现在遵守 blocked 选项:从 overlay 显示到它调用 done() 期间,pi 报告阻塞的程序状态(OSC 7501),用 setHidden() 隐藏时也一样。关掉一个 overlay 后,其他仍打开的问题保持阻塞(#11816)。
  • 添加了 qwen-token-plan-individual-cn Provider,用于中国端点上的 Qwen Token Plan Individual,使用 QWEN_TOKEN_PLAN_CN_API_KEY(#7989 由 @bigoldcat123 贡献)。
  • 添加了通过 GitHub Copilot 使用 Microsoft-Decision-1 分类器的支持,包括 codemode 的 models.classify()(#11679 由 @Marvae 贡献)。
  • 添加了 compat.promptCacheKeyMode("auto"、"enabled" 或 "disabled"),用于为兼容的代理启用 Prompt 缓存键,或为拒绝它们的端点省略它们。使用 pi 时在 models.json 中设置(#9442 由 @dannote 贡献)。
  • 添加了 compat.requiresNonNullAssistantContent,用于要求把只含 tool call 的 assistant 消息中的 null 换成空字符串的 OpenAI 兼容端点。使用 pi 时在 models.json 中设置(#8118 由 @gaoyk19 贡献)。
  • 为 read 和 write 视图添加了 Dart、Nix、Groovy 和 Gradle 文件的语法高亮(#11643)。
  • 把 GLM 5.3 加入 Qwen Token Plan Individual 的模型允许列表(#11658)。
  • 为 anthropic Provider 添加了 Claude Fable 5.2(claude-fable-5-2)(每百万输入/输出 Token $8/$40,1M 上下文,128K 输出)。和 Fable 5.1 一样,它使用按消息的 effort 和对话中途的系统消息;其安全分类器在任何输出之前拒绝的请求,会由 Claude Opus 5 通过服务端回退回答,并按 Opus 5 的价格计费。其他 Provider 上的 Claude Fable 5.2 和 Mythos 5.2(例如 OpenRouter 的 anthropic/claude-fable-5.2)获得同样的按消息 effort 支持。

变更

  • anthropic Provider 的默认模型现在是 Claude Opus 5.5(claude-opus-5-5),不再是 Claude Opus 4.8。
  • 默认模型换成了价格相同或更低的更新模型:amazon-bedrock 为 Claude Opus 5.5,azure 为 GPT-6.1 Sol,google 和 google-vertex 为 Gemini 4 Argon,vercel-ai-gateway 为 GLM 5.3,baseten 为 GLM 5.3,minimax 和 minimax-cn 为 MiniMax-M3,qwen-token-plan 和 qwen-token-plan-cn 为 Qwen3.8 Max,opencode-go 为 Kimi K3.1 Pro;moonshotai、moonshotai-cn、huggingface、opencode、openrouter、cloudflare-workers-ai 和 cloudflare-ai-gateway 用 Kimi K2.7 Code 代替 Kimi K2.6。
  • cacheWarming 的默认值现在是 "idle",不再是 "streaming":pi 也会在 agent 运行之间把符合条件的 Prompt 缓存保持温暖最多 30 分钟,但只在一次刷新预计能收回成本时。要恢复以前的行为,在全局设置中设 "cacheWarming": "streaming"。
  • 连续的缓存预热现在显示为一行 Cache warmed: $<total>,带累计成本,而不是每次预热一行。
  • OpenAI Codex Provider 在 /login 和模型选择器中再次显示为 "OpenAI Codex",不再是 "OpenAI Codex (legacy)"。
  • /login 和 /logout 的 Provider 列表,以及 /login <provider> 的补全,现在先显示首选合作伙伴 Radius 和 OpenRouter,然后按字母顺序列出其他 Provider。在 Provider 列表中,合作伙伴标有 ✦,选中的 Radius 行以 Radius 标志颜色闪烁,选中的 OpenRouter 行以 OpenRouter 品牌色发光(深色主题为青柠色,浅色主题为紫色)。
  • 升级了终端 Mermaid 渲染,支持更多图类型,包括饼图、作者定义的样式,以及在支持超链接的终端上可点击的标签(#8158 由 @xl0 贡献)。

修复

  • 修复了 grep 工具的 glob 从 pi 启动的文件夹匹配、而不是从 path 匹配的问题:path: "repo"、glob: "migrations/main/*.js" 时,即使 repo/migrations/main/a.js 存在也返回 No matches found。glob 现在相对于 path,和 grep 打印结果的形式相同,path 是符号链接时也一样。开头的 ./(./src/*.ts)会被忽略,而不是什么都不匹配(#11807、#10998)。
  • 修复了 Prompt 模板参数丢掉撇号并合并单词的问题:单词内部的撇号(如 doesn't)不再开启引号;没有闭合匹配的引号按文本保留;"..." 内的 \"(或 '...' 内的 \')得到字面引号(#11861)。
  • 修复了命令已经退出、但它启动的后台进程一直写输出直到超时,bash 工具只报告 Command timed out 的问题。错误现在也会报告 Shell 的退出码和退出时间(#11613)。
  • steering 和 follow-up 消息中的图片(包括流式期间的 prompt())现在会像空闲 Prompt 中的图片一样缩放,而不是以原始尺寸发送和保存(#11738)。
  • MCP 连接的 Token 刷新失败不再注册 OAuth 客户端,也不会替换正在进行的登录的 PKCE verifier,那会让该登录失败。MCP 登录现在即使用 loopback 回调端口变了,也用已保存的客户端刷新已保存的 Token,而不是注册新客户端并打开浏览器。/mcp 中的 Ctrl+C 和 pi mcp login 的 --timeout 现在也会在登录等待另一个 pi 进程的 Token 刷新(最多 25 秒)时停止它;刷新锁因等待以外的原因失败时,登录会失败,而不是打开浏览器。
  • 修复了 pi mcp list 把带 "auth": { "provider": "<provider>" } 的 MCP 服务器(例如 Radius)报告为需要登录的问题,尽管该 Provider 已经登录:Shell 命令没有发送 Token。它现在发送该 Provider 的 /login Token,过期时会刷新。对这些服务器,登录提示写的是 /login <provider> 而不是 pi mcp login,pi mcp login 和 pi mcp logout 会指向 /login 和 /logout,而不是以 "does not use OAuth" 失败。
  • 修复了 RPC 模式在空闲时忽略扩展的 ctx.shutdown()(例如来自定时器)的问题:进程会一直运行,直到客户端再发一条命令。pi 现在在空闲时立即关闭;扩展命令请求的关闭会等到该命令的 prompt 响应写完(#11599)。
  • 修复了已安装包版本带预发布后缀(如 0.1.5-20261020.7)时,changelog 说明在每次全新启动都重复的问题:保存的版本被读成 0.1.0,于是 0.1.1 到 0.1.5 的说明每次都算新的。没有 major.minor.patch 的已保存版本现在不显示说明,并被已安装版本替换,而不是显示整份 changelog(#11703)。
  • 修复了 stdin 关闭和 SIGTERM 同时到达时,RPC 模式切断关闭清理(例如未完成的 MCP Token 刷新)的问题,Paseo 和 systemd 这类进程管理器会这样做。Pi 丢失了刷新后的 Token,MCP 服务器撤销了登录。关闭一旦开始,stdin EOF 或单个信号不再打断它;第二个信号仍会立即退出。print 模式同样不再因最终清理期间到达的信号而退出(#11599)。
  • 修复了设置 context 时 grep 工具把每个匹配文件读进内存、在大文件上耗尽内存的问题;上下文现在来自 ripgrep,这也修复了 UTF-16 文件和匹配行中的单独 CR,并且恰好存在 limit 个匹配时不再出现匹配上限提示(#9276、#11423)。
  • 修复了恰好有 limit 个文件匹配时 find 工具报告结果上限,以及 find 和 ls 中 limit: 0 返回全部结果或空列表的问题;小于 1 的上限现在表示 1(#7121)。
  • 修复了 grep 匹配行、codemode 输出、工具结果的压缩摘要,以及 MCP 错误和服务器摘要在截断时把 emoji 或其他非 BMP 字符切成两半、在文本中留下无效的孤立 surrogate 的问题(#7121)。
  • 修复了 Windows 上 find 工具对带 Windows 分隔符的模式(如 src\**\*.ts)不返回结果,以及 fd 10.5.1(pi 现在会下载它)对所有路径模式(如 src/**/*.ts)不返回结果的问题。Windows 路径模式现在对每个 fd 版本以相同方式匹配:src/**/*.ts 也会找到 src/ 直接下的文件,src/*.ts 不再找到子目录中的文件(#9262)。
  • 修复了 read 工具把整个文件载入内存、即使有 offset/limit 也会在大文件上耗尽内存的问题;它现在流式读取文件,只保留显示的行。自定义 ReadOperations 也可以通过新的可选 createReadStream 流式读取(#9654)。
  • 修复了 pi 在刷新过期 Token 时被停掉后,openai 和 anthropic 等 OAuth 登录以 invalid_grant 失败的问题,例如 RPC 客户端在启动后立即停掉 pi,而后台目录刷新正在运行。Token 端点已经替换了 refresh token,但 pi 在保存新 Token 之前退出了。退出时,pi 现在会等待正在进行的 Token 刷新保存完成(#11692)。
  • 修复了活动模型是另一个模型时,Ctrl+P 不能切换到范围内唯一模型(或唯一可用模型)的问题;它显示 "Only one model in scope"。从范围外的模型向前循环现在也会选中第一个范围内的模型,而不是跳过它(#11806)。
  • 修复了扩展有不止一个 ctx.ui.custom({ overlay: true }) 打开时,/reload 和会话切换把扩展 overlay 留在屏幕上的问题:只移除了最上层 overlay,其他 overlay 仍保持焦点和输入,尽管打开它们的扩展已经不在。现在会移除并释放所有扩展 overlay,包括隐藏的;pi 自己的 overlay 保持打开。
  • 修复了浏览器登录成功后 /mcp 登录在 "Connecting…" 上停留数分钟、Ctrl+C 无效的问题:pi 在等浏览器断开到 OAuth 回调端口的一条未使用连接。回调服务器现在在关闭时断开剩余连接(#11311)。
  • 修复了反复读取图片后 pi 中止(zsh: abort)的问题,报告于 macOS arm64 和 Node 24.16。每次图片缩放都会启动一个 worker 线程,pi 没有等它停止,于是下一次缩放在前一个 worker 仍在关闭时启动了新 worker。这次崩溃很可能是这个重叠触发的 Node bug,在 Linux 上无法复现;图片缩放现在会等前一个 worker 停止,每张图片大约增加 15 ms(#10695)。
  • 修复了 tool_search 和 searchTools() 找不到本地 $ref 后面的属性名和描述的问题,例如 MCP input schema 把模型放在 $defs 里。被引用的定义只读一次,所以递归 schema 不会循环,没有任何引用的定义不进入搜索文本(#11803)。
  • 修复了 codemode 工具的 resolves to 摘要漏掉本地 $ref 后面的字段名的问题,例如 MCP output schema 把模型放在 $defs 里时显示 structuredContent? 而不是 structuredContent?: { results }(#11803)。
  • 修复了任何可调用工具(例如 MCP 工具)的 schema 里有带畸形百分号转义的 $ref(#/$defs/%E0)时,每个 codemode 脚本都因 URI malformed 失败的问题,即使脚本不调用那个工具。该参数现在在工具声明中渲染为 unknown(#11803)。
  • 修复了 agent 工作时运行的 ! 和 !! 命令输出无法用 ctrl+o 展开或折叠的问题。新的 !/!! 输出现在以当前展开状态开始,排队 steering 或 follow-up 消息时输出不再消失,并在 agent 完成时移入聊天,而不是在下一条提交的消息时(#11875)。
  • 修复了恢复会话时,/tree 导航到 /thinking 变更之前会恢复旧 thinking level 的问题。和模型一样,当前 thinking level 现在会随下一条 Prompt 记录到新分支上(#11451)。
  • 修复了全屏模式下内联图片在 Orca 中只显示第一行、而普通模式显示完整的问题。全屏现在在每个终端上于图片覆盖的行之后绘制 Kitty 图片,和以前对 WezTerm 的做法一样(#11835)。
  • 修复了 edit 工具改写混合 CRLF/LF 或单独 CR 换行的文件中未改动行的换行,以及文件已经写入后在大文件上耗尽内存的问题;diff 现在只覆盖变更行及其周围,并在写入前计算(#8544)。
  • 修复了 Windows 安装器(irm https://pi.dev/install.ps1 | iex)在 Windows PowerShell 5.1 中因 npm 或 Node.js 打印任何警告(例如未知 .npmrc 键导致的 npm warn Unknown user config)而以 NativeCommandError 中止的问题。迁移 npm 安装时它在操作菜单之前失败,托管安装期间也会失败。无效的 managed-install.json 现在会被报告,而不是让安装器中止(#11944)。
  • 修复了某个 Provider 的登录过期时,pi update --models 以 Could not refresh model catalogs: openai: OAuth refresh failed for openai: ... invalid_grant 失败的问题。目录来自 pi.dev 的内置 Provider(如 openai)在目录刷新时不再刷新 OAuth Token。对用登录列出模型的 Provider(如 Radius 和 OpenRouter),Token 刷新失败现在会打印一条警告,指出该 Provider 和 pi auth login <provider>,其他目录仍会刷新;命令只在其他错误(如网络失败)时失败。
  • 修复了 Windows PowerShell 5.1 下,原生命令成功但 stderr 被重定向时(如 git push 2>&1 | Select-Object -Last 3),powershell 工具报告 Command exited with code 1 的问题。Windows PowerShell 5.1 把该 stderr 变成错误记录;这类命令现在报告 PowerShell 7 报告的退出码(#8842)。
  • 修复了用 Backspace 删除粘贴标记会破坏后面较短标记(如 [paste #2])、导致提交标记文本而不是粘贴内容的问题(#11923)。
  • 修复了被报告为 "cut short after the reply had begun" 的中断 Provider 流没有触发自动重试的问题(#11879)。
  • 修复了子 agent 扩展示例在启动编译后的 pi 二进制时,把 Bun 的 Windows 虚拟入口路径当作 Prompt 的一部分传入的问题(#11865)。
  • 修复了后台目录刷新或搜索结果到达时,模型选择器和 llama.cpp Hugging Face 搜索移动选中项的问题(#9109)。
  • 修复了内部光标标记泄漏到终端输出的问题,包括多个标记或水平裁剪的内容(#9441 由 @muyiyr 贡献)。
  • 修复了子 agent 扩展示例把运行中的任务显示为已完成、丢失子进程失败诊断、以及中止时无法停止子进程的问题。agent 发现和信任检查现在使用每个任务的工作目录,单个结果和链式结果在截断时不会丢失完整的工具细节(#8250 由 @terrorobe 贡献)。
  • 修复了切换编辑器、打开自定义 UI 或恢复排队消息时,大段粘贴文本被字面粘贴标记替换的问题(#10146 由 @w-winter 贡献)。
  • 修复了异步输入钩子、认证或分支摘要期间,Prompt 和会话树导航重叠、可能装上错误对话上下文的问题(#9155 由 @acmerfight 贡献)。
  • 修复了 Claude Sonnet 5 请求发送不支持的 temperature 参数的问题(#7961 由 @jingtao-wisdomgraph 贡献)。
  • 修复了通过符号链接路径加载的扩展无法解析依赖的问题:导入前先解析入口文件的真实路径(#8112 由 @cad0p 贡献)。
  • 修复了 plan 模式扩展示例漏掉 thinking 块中的完成标记和常见完成短语、丢掉格式化或较长的计划步骤,以及额外发送一轮模型调用来确认完成的问题(#7950 由 @giannisCKS 贡献)。
  • 修复了 OpenAI Responses 请求发送 session_id 而不是文档中的 session-id 亲和头的问题(#11639)。
  • 修复了已投递的仅图片 steering 和 follow-up 消息仍留在待处理队列中的问题(#8612 由 @wutongyuonce 贡献)。
  • 修复了惰性 Provider 加载或认证期间的取消被报告为错误而不是中止的问题(#8635 由 @Mallikarjun-0 贡献)。
  • 修复了会话 runtime 释放在活动工具完成中止并记录结果之前拆掉扩展的问题(#9126 由 @acmerfight 贡献)。
  • 修复了会话树搜索光标对输入法不显示或未定位的问题(#9157 由 @Perlence 贡献)。
  • 修复了响应或压缩仍在运行时,SDK 和 RPC 重载替换扩展的问题;重载现在要求调用方等待(#9222 由 @acmerfight 贡献)。
  • 修复了变更在行首插入文本时,渲染的 edit diff 丢失共享缩进的问题(#9274 由 @dannote 贡献)。
  • 修复了更早的输出块已被丢弃时,! 和 !! 命令省略截断提示和完整输出文件链接的问题(#10165 由 @acmerfight 贡献)。
  • 修复了扩展选择对话框超出终端高度的问题;它们现在显示最多十个选项的滚动窗口(#11072 由 @DivineDominion 贡献)。
  • 修复了 pi config 忽略 keybindings.json 中自定义快捷键的问题(#11651)。
  • 修复了通过指向同一 auth.json 的符号链接路径并发刷新 OAuth 的问题:现在在解析后的文件上共享锁(#11655)。
  • 修复了 Provider 连接错误把底层原因(如连接被拒绝或证书错误)藏在笼统消息后面的问题(#11695)。
  • 修复了 Windows 和 WSL 上 Ctrl+V 不能粘贴剪贴板图片或文本的问题;Ctrl+V 和 Alt+V 现在都是那里的默认粘贴快捷键(#11765)。
  • 修复了 llama.cpp 连接错误省略服务器 URL 和底层网络错误的问题(#11745)。
  • 修复了 TERM_PROGRAM 未设置时不启用 Alacritty 超链接的问题;检测现在也使用 TERM 和 ALACRITTY_WINDOW_ID(#11767)。
  • 修复了 OpenAI Codex SSE 重试在每次退避后保留 abort 监听器、反复重试时监听器堆积的问题(#11708)。
  • Azure OpenAI 模型现在保留 OpenAI 的长上下文价格档,因此输入 Token 超过 272K 的请求按 Azure 的长上下文费率计费(#11948)。
  • 修复了 Claude 因超出严格工具限制而拒绝后,Anthropic 和 Bedrock 在之后每次请求仍把 strict: "prefer" 工具再发成严格模式、每轮多一次被拒绝的请求(400)的问题。同一 sessionId 的后续请求现在立即以非严格模式发送这些工具,直到 cleanupSessionResources(sessionId)(#11626)。
  • 修复了 Type.BigInt() 和 Type.Undefined() 参数的工具参数被拒绝的问题:现在按 TypeBox 的方式转换("42" 和 42 转为 42n,null 转为 undefined),因为 pi-schema 已支持这两种类型。Type.Void() 仍拒绝所有 JSON 参数。
  • 修复了 Azure GPT-6 Astra、Luna、Sol、GPT-6.1 Sol 和 GPT-6.1 Terra 使用 272K 上下文窗口、而不是 Azure Foundry 部署的 1,050,000 Token 的问题(#11742)。
  • 修复了 OpenRouter 对输出上限接近上下文窗口的模型(如 DeepSeek flash)以 400(This endpoint's maximum context length is ...)拒绝请求的问题。OpenRouter 用自己的分词器计算输入,可能比 Provider 的计数高几个百分点,而 pi 只留了 4,096 Token 余量。pi 随后把这个 400 当作上下文溢出并压缩会话,即使当时大约只用了窗口的 20%。默认输出上限现在留出估计输入的 15% 不用,接近满窗口时最多请求 32,768 个输出 Token(#10497)。
  • 修复了 Anthropic 非严格工具 schema 丢掉根级 $defs 和 definitions、使属性 $ref 指向空的问题。Claude 随后为这类工具生成错误参数(MCP 服务器中常见),例如用 JSON 字符串而不是对象,一些 Anthropic 兼容网关会直接拒绝请求(#9557)。
  • 修复了工具列表、系统 Prompt 或更早历史变化后,OpenCode Go Claude Haiku 5.5 以 400(Invalid signature in thinking block ... bound to a different conversation)失败、之后每次重试都失败的问题。OpenCode Go 和 Zen 的 Claude 5.5 模型、Opus 5 和 Fable 5.1 现在使用按消息的 effort,并发送 thinking.block_binding: drop_block,和 Anthropic Provider 一样(#10954)。
  • 修复了 Markdown 把 HTML 注释(<!-- ... -->)显示为可见文本的问题(#11710)。
  • 修复了 codemode 的 console.* 输出和抛出的非 Error 值把 NaN、Infinity 和 -Infinity 打印成 null 的问题(#11901)。
  • 修复了大型 MCP stdio 消息在 chunk 到达时被反复复制和扫描、导致工具响应变慢的问题(#11761)。
  • 修复了只有 CR 换行的 MCP Streamable HTTP SSE 回复以 "stream ended without a response" 失败的问题(#11764)。
  • 修复了超大 MCP SSE 响应在消息大小限制拒绝它们之后仍保持 HTTP 连接打开的问题(#11729)。
  • 修复了服务器主进程已经退出后,MCP stdio 服务器子进程在断开连接或 pi 退出时于 POSIX 上仍然存活的问题(#11721)。
  • 修复了 MCP Streamable HTTP JSON 回复绕过消息大小限制、以及 HTTP 错误缓冲整个响应体的问题。超大回复和超出前 8 KiB 的错误体内容现在会被取消(#11335)。
  • 修复了 schema 把本地 $ref 和相对根 $id(如 schemas/tool.json)组合时,有效工具参数被拒绝的问题(#11697)。
  • 修复了 find 工具在父目录查找期间被取消时启动一个未被跟踪的 fd 进程的问题(#11974 由 @petrroll 贡献)。
Pi AI

不兼容变更

  • openai-completions 在请求没有工具、但对话包含 tool call 或工具结果时,不再发送 "tools": [],该字段会被省略。这修复了 vLLM 0.20+(也包括 LiteLLM 后面的)返回的 400 错误(tools must not be an empty array)。历史含有 tool call 后仍要求 tools 的代理(例如旧版 LiteLLM 放在 Anthropic 前面)现在会拒绝这些请求;在这些模型上设置 compat.requiresToolsWithToolHistory: true 可以再次发送空数组(#11843)。

新增

  • 带 sessionId(且 cacheRetention 不是 "none")的 Anthropic 请求现在使用 message threads(message-threads-2026-08-12 beta):服务器从上次回复继续,pi 只发送新消息而不是整段对话。请求中更早的部分有变化,或服务器无法继续该 thread 时,会发送完整请求。Token 计数和 Prompt 缓存不变。默认只对 api.anthropic.com 上的 anthropic Provider 开启;设置 compat.supportsMessageThreads 可以改变这一点,例如对转发 thread 字段的网关。会话结束时调用 cleanupSessionResources(sessionId) 以释放按会话的状态(#11545)。
  • 添加了 StreamOptions.disableContinuation,阻止请求使用或替换服务端继续状态(如 Anthropic message threads)。对重复更早请求的请求设置它,例如缓存预热(#11545)。
  • 把 Prompt 缓存预热策略添加为共享辅助函数,使每个宿主以相同方式预热:getPromptCacheTtlMs()、getCacheWarmingDelayMs()、isCacheWarmingReplayable()、getCacheWarmingRequestOptions()、evaluateCacheWarming() 和 CACHE_WARMING_* 常量(从 pi-coding-agent 的缓存预热器移入)。
  • 添加了 @earendil-works/pi-ai/lazy-oauth(registerLazyOAuthFlows())和 @earendil-works/pi-ai/lazy-bedrock-provider(registerLazyBedrockProvider(),基于新的 setBedrockProviderLoader()),供在动态 import 处拆分的 Node bundle 使用:OAuth 登录流程和 Bedrock 通过字面动态 import 加载,因此打包器把它们留在 bundle 内,作为首次使用时加载的 chunk,而不是通过会在运行时加载 pi-ai 自身文件的变量说明符 import。不调用它们则没有变化。
  • 为 anthropic Provider 添加了 Claude Fable 5.2(claude-fable-5-2)(每百万输入/输出 Token $8/$40,1M 上下文,128K 输出)。和 Fable 5.1 一样,它使用按消息的 effort 和对话中途的系统消息;其安全分类器在任何输出之前拒绝的请求,会由 Claude Opus 5 通过服务端回退回答,并按 Opus 5 的价格计费。其他 Provider 上的 Claude Fable 5.2 和 Mythos 5.2(例如 OpenRouter 的 anthropic/claude-fable-5.2)获得同样的按消息 effort 支持。
  • 添加了 Provider.refreshModelsAuth。对 refreshModels() 读取不需要 Provider 凭证的目录(如 pi.dev)的 Provider,把它设为 "configured":Models.refresh() 仍会跳过未配置的 Provider,但不再先刷新过期的 OAuth Token,因此过期登录(invalid_grant)不再让该 Provider 的目录刷新失败。该网络阶段的 context.credential 为 undefined。
  • 添加了 qwen-token-plan-individual-cn Provider,用于中国端点上的 Qwen Token Plan Individual,使用 QWEN_TOKEN_PLAN_CN_API_KEY(#7989 由 @bigoldcat123 贡献)。
  • 添加了通过 GitHub Copilot 使用 Microsoft-Decision-1 分类器的支持,包括 codemode 的 models.classify()(#11679 由 @Marvae 贡献)。
  • 添加了 compat.promptCacheKeyMode("auto"、"enabled" 或 "disabled"),用于为兼容的代理启用 Prompt 缓存键,或为拒绝它们的端点省略它们。使用 pi 时在 models.json 中设置(#9442 由 @dannote 贡献)。
  • 添加了 compat.requiresNonNullAssistantContent,用于要求把只含 tool call 的 assistant 消息中的 null 换成空字符串的 OpenAI 兼容端点。使用 pi 时在 models.json 中设置(#8118 由 @gaoyk19 贡献)。
  • 把 GLM 5.3 加入 Qwen Token Plan Individual 的模型允许列表(#11658)。

变更

  • 把 "OpenAI Codex (legacy)" Provider 改回 "OpenAI Codex"。

修复

  • Azure OpenAI 模型现在保留 OpenAI 的长上下文价格档,因此输入 Token 超过 272K 的请求按 Azure 的长上下文费率计费(#11948)。
  • 修复了 Type.BigInt() 和 Type.Undefined() 参数的工具参数被拒绝的问题:现在按 TypeBox 的方式转换("42" 和 42 转为 42n,null 转为 undefined),因为 pi-schema 已支持这两种类型。Type.Void() 仍拒绝所有 JSON 参数。
  • 修复了工具列表、系统 Prompt 或更早历史变化后,OpenCode Go Claude Haiku 5.5 以 400(Invalid signature in thinking block ... bound to a different conversation)失败、之后每次重试都失败的问题。OpenCode Go 和 Zen 的 Claude 5.5 模型、Opus 5 和 Fable 5.1 现在使用按消息的 effort,并发送 thinking.block_binding: drop_block,和 Anthropic Provider 一样(#10954)。
  • 修复了 Anthropic 非严格工具 schema 丢掉根级 $defs 和 definitions、使属性 $ref 指向空的问题。Claude 随后为这类工具生成错误参数(MCP 服务器中常见),例如用 JSON 字符串而不是对象,一些 Anthropic 兼容网关会直接拒绝请求(#9557)。
  • 修复了 OpenRouter 对输出上限接近上下文窗口的模型(如 DeepSeek flash)以 400(This endpoint's maximum context length is ...)拒绝请求的问题。OpenRouter 用自己的分词器计算输入,可能比 Provider 的计数高几个百分点,而 pi 只留了 4,096 Token 余量。pi 随后把这个 400 当作上下文溢出并压缩会话,即使当时大约只用了窗口的 20%。默认输出上限现在留出估计输入的 15% 不用,接近满窗口时最多请求 32,768 个输出 Token(#10497)。
  • 修复了 Azure GPT-6 Astra、Luna、Sol、GPT-6.1 Sol 和 GPT-6.1 Terra 使用 272K 上下文窗口、而不是 Azure Foundry 部署的 1,050,000 Token 的问题(#11742)。
  • 修复了 Claude 因超出严格工具限制而拒绝后,Anthropic 和 Bedrock 在之后每次请求仍把 strict: "prefer" 工具再发成严格模式、每轮多一次被拒绝的请求(400)的问题。同一 sessionId 的后续请求现在立即以非严格模式发送这些工具,直到 cleanupSessionResources(sessionId)(#11626)。
  • 修复了被报告为 "cut short after the reply had begun" 的中断 Provider 流没有触发自动重试的问题(#11879)。
  • 修复了 pi-ai 被打包时,惰性 OAuth 和 Bedrock 的 import 相对于 bundle 位置解析、而不是相对于模块 URL 解析的问题。
  • 修复了 Claude Sonnet 5 请求发送不支持的 temperature 参数的问题(#7961 由 @jingtao-wisdomgraph 贡献)。
  • 修复了 OpenAI Responses 请求发送 session_id 而不是文档中的 session-id 亲和头的问题(#11639)。
  • 修复了惰性 Provider 加载或认证期间的取消被报告为错误而不是中止的问题(#8635 由 @Mallikarjun-0 贡献)。
  • 修复了 Provider 连接错误把底层原因(如连接被拒绝或证书错误)藏在笼统消息后面的问题(#11695)。
  • 修复了 OpenAI Codex SSE 重试在每次退避后保留 abort 监听器、反复重试时监听器堆积的问题(#11708)。
Pi Agent

新增

  • streamProxy() 现在转发 disableContinuation,使被代理的请求可以退出服务端继续状态,例如 Anthropic message threads(#11545)。
Pi TUI

修复

  • 修复了 Markdown 把 HTML 注释(<!-- ... -->)渲染为可见文本的问题(#11710)。
  • 修复了 Orca 中全屏 Kitty 图片只显示第一行的问题。Orca 的 xterm.js 图片插件把图片存在它们覆盖的单元格里。TuiAltScreen 现在在每个终端上于清除并写入图片覆盖的行之后绘制 Kitty 图片,不只是 WezTerm(#11835)。
  • 修复了用 Backspace 删除粘贴标记会破坏后面较短标记(如 [paste #2])、导致提交标记文本而不是粘贴内容的问题(#11923)。
  • 修复了内部光标标记泄漏到终端输出的问题,包括多个标记或水平裁剪的内容(#9441 由 @muyiyr 贡献)。
  • 修复了 TERM_PROGRAM 未设置时不启用 Alacritty 超链接的问题;检测现在也使用 TERM 和 ALACRITTY_WINDOW_ID(#11767)。

v1.5.0(2026-11-02)

Pi Coding Agent

新功能

  • 扩展更新 changelog – 已安装扩展包更新后,下次全新启动可以看到变更。包作者可以选择 changelog 路径,collapseChangelog 会把通知收成一行。详见 显示 changelog。
  • 更快的流式输出 – 大型工具调用改为增量解析,代码较多的回答和工具行会复用高亮和已渲染的 Markdown,而不是每次更新都重做。详见 保持渲染响应迅速。
  • 自定义自更新命令 – 用 PI_SELF_UPDATE_COMMAND 或 selfUpdateCommand,通过包装脚本或其他包管理器更新 pi。详见 自定义更新命令。
  • GPT-6.1 Terra – 可通过 OpenAI、Azure OpenAI Responses 和 OpenAI Codex 使用,支持工具搜索、会话中途切换 thinking 级别,以及 thinking off。Codex 提供 500K 上下文窗口。详见 模型。

不兼容变更

  • 工具参数校验改为在 @earendil-works/pi-schema 上运行。JSON Schema 之外的 TypeBox 特性(Type.Refine()、Type.BigInt()、Type.Undefined()、codec、Format.Set() 注册的格式)不再作用于工具参数;见 工具参数模式与 TypeBox。普通 JSON Schema 工具(包括 MCP 工具)现在与 TypeBox 工具得到相同的强制转换,例如把数字字符串转成数字、把单个值包进数组。模型看到的校验失败列出 pi-schema 的消息(- path: missing、- limit: expected number, got string),而不再是 TypeBox 的(must have required properties path、must be number)。

新增

  • 扩展包现在可以在更新后显示 changelog。Pi 从包的 package.json 读取 pi.changelogPath,或读取包根目录的 CHANGELOG.md,并在下次全新启动时于「Extension Updates」下显示比上次见过的版本更新的条目。collapseChangelog 设置把它收成每个包一行(#5958、#8790)。
  • pi.exec() 接受 maxBuffer 选项,限制 stdout 和 stderr 的合计大小,结果里的 truncated 在输出超出上限时为 true(#11360)。
  • 设备码登录(例如 GitHub Copilot)现在在按 Enter 时打开验证页并复制验证码。Provider 可以用 openBrowserOnConfirm: false 或 copyCodeOnConfirm: false 关掉其中一项(#9282、#9301)。
  • pi update 可以通过包装脚本或其他包管理器更新 Pi。设置 PI_SELF_UPDATE_COMMAND(例如 mise use -g npm:{packageName}@{version})或全局 selfUpdateCommand;pi.dev 报告有更新的发布时,pi update 会运行它,并用该发布填充 {packageName}、{version} 和 {installSpec}。见 自定义更新命令(#7756、#5607)。
  • 扩展可以用工具渲染上下文,以及消息和条目渲染器选项里的 keyText() 和 keyHint() 格式化用户配置的快捷键。从 @earendil-works/pi-coding-agent 导入这些函数可能解析到扩展自己的那份包,它看不到 pi 的快捷键,因此 keyHint("app.tools.expand", "to expand") 这类提示会不带按键。文档现在推荐使用注入的函数(#4748)。
  • 为 MarkdownTransformContext 添加了持久化会话条目的 messageId 和 ISO timestamp。渲染已保存条目时可用,实时渲染时为 undefined(#7952 由 @vipentti 贡献)。
  • 为内联 ctx.ui.custom() 组件添加 blocked 选项,让审批提示和其他自定义对话框可以报告 pi 正在等待用户输入。Overlay 忽略该选项。见 自定义界面和 overlay(#11428)。
  • 为 SDK 和扩展用量数据添加 Usage.cost.totalFromProvider,用来区分账单总额和目录估算;只有每一部分都是 Provider 上报时,合并用量才标为 Provider 上报(#11178)。
  • 为来自 pi-messages Provider(如 Radius)的消息添加具体的 responseModel 元数据,包括请求的是虚拟模型的情况。见 AssistantMessage(#11265)。
  • 为 OpenAI、Azure OpenAI Responses 和 OpenAI Codex 添加 GPT-6.1 Terra,支持工具搜索和会话中途切换 thinking 级别。它支持 thinking off;Codex 提供 500K 上下文窗口。

变更

  • 扩展仍然从 @earendil-works/pi-ai 导入 Type、Static 和 TSchema:Pi 把该导入映射到 pi-ai 的兼容入口加上它捆绑的 TypeBox,因为 pi-ai 本身不再重新导出 TypeBox,那里的 StringEnum 仍是 TypeBox 的 TUnsafe<T>。内置工具工厂(createReadTool() 等)返回 TypeBoxAgentTool<typeof schema>,因此 params 对 TypeBox 保持有类型。
  • 收紧了系统 Prompt。
  • 从 pi.dev 安装器安装的 pi update 不再向 npm ci 传递 --min-release-age=0。发布 lockfile 已经固定每个包,该标志没有作用,而拦截它的安全扫描器会让更新停住(#11262)。
  • /model 和 /scoped-models 现在会在模型名称比 ID 多出词语时,在 ID 旁边显示名称,例如 models.json 里改名后的覆盖(#5916、#11347)。
  • MCP OAuth 登录现在默认使用 pi 的 Client ID Metadata Document(授权服务器对公共客户端支持它时),否则动态注册客户端,与 Codex、Claude Code 和 opencode 一样。此前注册的客户端在重定向 URI 匹配期间继续使用。新的默认值 oauth.clientRegistration: "auto" 在设置了 clientName 或非默认 callbackUrl 时注册;"dcr" 始终注册。pi mcp add --oauth-client-registration 设置该模式(#11426)。
  • 默认 OpenAI 模型从 gpt-5.5 改为 gpt-6.1-sol,包括 ChatGPT 登录后没有选定模型的情况(#11442)。
  • 内置模型目录更新为 models.dev v2。Realtime 和仅图片模型不再作为聊天模型提供;较新的 OpenAI 和 Google 聊天模型已加入。

修复

  • 更新了 glob 匹配,防止放大的 glob 模式造成拒绝服务。
  • 修复已保存的「Do not trust」决定在没有需要信任的资源的项目上被忽略的问题,例如只有 AGENTS.md 的文件夹。Pi 会自动信任这类项目,因此 ctx.isProjectTrusted() 返回 true,包命令也把它们当成已信任。trust.json 里已保存的决定现在优先;只有没有保存决定时才自动信任(#10947)。
  • 修复 Apple Terminal 发送 ESC + Return 时,Shift+Enter 把 follow-up 排队而不是插入换行的问题。Pi 现在对该序列检查本地 Shift 键状态,与对普通 Return 的做法一样;没有 Shift 的 Alt+Enter 仍然把 follow-up 排队(#11559)。
  • 修复常规 TUI 模式下,运行期间工作状态(OSC 7501)在 Rex 和 iTerm2 中消失的问题。渲染出的消息向终端写入了 OSC 133 Prompt 标记,终端把它当成新的 shell Prompt;常规模式不再写入它们(#11519)。
  • 修复 SDK 会话中的压缩、分支摘要和 bug 报告摘要把存储的 OAuth token 作为显式 API key 传回模型运行时的问题。把显式 key 和已存储 OAuth 区别对待的 Provider 认证,现在会看到 OAuth 登录,与普通 Prompt 一样(#11520)。
  • 修复扩展以不同顺序设置同一组活动工具时出现多余的系统 Prompt 更新(工具、规则)的问题,例如反转的 pi.setActiveTools() 列表。仍然活动的工具现在保持顺序,新激活的工具追加在后面(#11495)。
  • 修复命令打印的输出超过字符串能容纳的长度时,pi.exec() 以 RangeError: Invalid string length 让 pi 崩溃的问题。默认输出上限是 256 MiB 和运行时字符串上限中的较小者;超过上限时命令会被终止,结果带 truncated: true 和非零退出码(#11360)。
  • 修复命令在超时或中止后忽略 SIGTERM 时,pi.exec() 永不返回的问题。Pi 现在会在 5 秒后发送 SIGKILL,与原先的意图一致。
  • 修复 agent 目录经符号链接到达时(例如 ~/.pi 链到 dotfiles 仓库),pi install 和 pi remove 往 npm package-lock.json 里加入越来越深的嵌套条目的问题。Pi 现在把解析后的真实路径传给 npm(#11358)。
  • MCP 登录现在拒绝不是 http: 或 https: 的授权端点和其他 OAuth 元数据 URL。此前,恶意 MCP 服务器可以提供 file: 或自定义协议 URL,Pi 会把它交给平台 URL 处理器。
  • 自动下载 fd 和 rg 不再在 ARM32 和其他没有预构建发布的架构上获取 x86-64 二进制。Pi 现在会警告,并建议用系统包管理器安装该工具(#11209)。
  • 修复 /model 搜索把散落在条目前部的字母排在真正匹配之上的问题,例如 opus 把 gpt-oss-120b 和 claude-sonnet-4.5 排在 claude-opus-4.1 前面(#11220、#11296)。
  • 修复 /resume 搜索匹配会话消息和 ID 中任意位置散落字母的问题,例如 1024 匹配进会话 UUID。会话名和工作目录仍然模糊匹配;ID 和消息文本现在只作精确子串匹配(#11220、#11024、#11296)。
  • 修复含数千条条目的会话 HTML 导出显示空白页的问题(#11225、#11293)。
  • 修复 HTML 导出不显示系统消息的问题:系统 Prompt 和工具,以及之后的段落更新(例如 /reload 之后)。pi --export 现在也包含系统 Prompt 和工具(#11261、#3464、#11290)。
  • 修复在 macOS 上中止 bash 命令时,有时会运行列表中的下一条命令的问题,例如 long_step; next_step。Pi 现在先停止进程组再杀死它(#11252、#11289)。
  • 修复大型流式工具调用占用过多 CPU 时间和内存的问题,因为每个 delta 都重新解析累积的参数。Provider 和 agent proxy 流现在每个 delta 只解析一次,grammar 工具不再每个 delta 复制全部输入,交互式工具渲染器每帧最多运行一次(#9265)。
  • 修复登录对话框打开不是网页 URL 的登录地址,以及从登录、设备码和信息 URL 打印控制字符的问题。这些字符可能结束终端超链接,并向终端发送转义序列。
  • 修复 tui.select.pageUp 和 tui.select.pageDown 在斜杠命令和文件自动补全、/settings,以及模型、作用域模型、登录、fork、/mcp 和 llama.cpp 选择器中被忽略的问题。全屏模式下,PageUp/PageDown 现在移动打开的列表或自动补全菜单,而不是滚动记录;绑定到 Ctrl+V 的翻页键会翻动自动补全,而不是粘贴图片(#7629,基于 #7680 由 @muyiyr 贡献)。
  • 修复工具输出和 ! 命令输出把带 <、= 或 > 前缀的控制序列参数显示成文本的问题,例如鼠标报告 ESC[<35;59;1M 中的 35;59;1M,或终端应答 ESC[>0;276;0c 中的 0;276;0c。小键盘模式序列 ESC= 和 ESC> 之后的文本仍然保留(#11377)。
  • 修复 pi -e npm:<pkg> 停留在第一次下载的版本的问题。每次启动和 /reload 时,若注册表有更新的匹配版本,Pi 现在会重新安装没有精确版本的 -e npm 包。pi -e git:<repo>@<branch> 同样会停留在第一次检出,现在会 fetch 并重置到该分支;已经检出的 commit hash 引用不会再 fetch。离线模式和检查失败时保留缓存副本(#11375、#11590)。
  • 修复 Windows 路径按大小写敏感比较的问题。工作目录和主目录只在盘符大小写上不同时(c:\Users\me 与 C:\Users\me),~/.agents/skills 里的 Skill 会作为项目 Skill 和用户 Skill 加载两次,并被报告为名称冲突。同样的不一致还会再次询问已保存的项目信任、让自定义会话目录里的会话从 --continue 和 /resume 中消失,并让 pi remove 匹配不到已配置的本地包(#10488)。
  • 修复主目录旁边的路径被显示成损坏的 ~ 前缀的问题,例如主目录是 /home/me 时,/home/me2/project 显示为 ~2/project。
  • 修复 pi mcp login -l 和 pi mcp logout -l 报 Unknown option --local. 的问题,尽管 pi mcp add 和 pi mcp remove 接受 -l。加上 -l 时,它们现在要求服务器是项目服务器。未知选项现在按输入原样报告,拼错的服务器名会得到建议,例如 Did you mean "gurker"?。
  • 修复 pi update 把只存在于 PNPM_HOME 下的安装说成 pnpm 管理的问题,例如 $PNPM_HOME/global-nub/ 下的包装脚本。Pi 以前说「not managed by a global pnpm install」;现在只有该包管理器确实拥有这次安装时才点名它(#7756)。
  • 修复工作目录很深时,WSL 上图片粘贴、复制和打开浏览器登录静默失败的问题。powershell.exe 和 explorer.exe 等 Windows 程序无法从 \\wsl.localhost\... 路径超过 260 个字符的目录启动;Pi 现在从 / 启动这些辅助程序(#11592)。
  • 修复外部编辑器静默失败的问题,例如编辑器命令错误,或 Windows 编辑器无法从很深的 WSL 目录启动。Pi 现在显示状态消息,例如 External editor exited with code 1; prompt unchanged(#11592)。
  • 修复 tool_search 和 codemode searchTools() 把工具排在只在描述里提到其名称的工具之后的问题,例如 peekaboo app 把 mcp__peekaboo__app 排在第 14。匹配查询中更多词的工具现在排在匹配更少词的工具之上,工具名中的查询词比描述里任意多次提及得分更高,整个名称都在查询中的工具得到大额加分,服务器的长说明不再压低该服务器工具的分数(#11331)。
  • 修复 tool_search 和 codemode searchTools() 对中文、日文、泰文和其他非 ASCII 查询找不到结果的问题,因为分词器只保留 ASCII 字母和数字。任何文字的词现在都能匹配,搜索记录 这类词间没有空格的文本会被拆成词,café 和 cafe\u0301 这类规范等价文本也能匹配(#10816、#11037 由 @haoqixu 贡献)。
  • 修复另一个 pi 会话打开了 git 扩展的原生模块或可执行文件时,Windows 上 pi update 停在 git clean -fdx failed with code 1 的问题。Windows 无法删除这类文件,于是更新留下了新代码和旧依赖。Pi 现在会警告,仍然安装依赖,并在下次更新时重试清理(#11597)。
  • 修复工具行和流式回答在每次重绘时再次高亮同一段代码的问题。运行中的 codemode 行在每次进度更新和计时器滴答时高亮整个脚本,完成的 write 行在每次更新和展开切换时高亮整个文件,流式 write 在每个 delta 上高亮前 50 行,流式回答在每个 delta 上高亮之前的每个代码块。行现在复用上次的高亮,直到代码、主题或已加载的 grammar 改变,assistant 消息在流式输出期间保留已渲染的 Markdown 块(#10971)。
  • 修复调整尺寸后的照片即使 JPEG 小得多也以数 MB 的 PNG 发送,导致大请求失败或超时的问题。图片缩放现在先尝试更小的编码(#11551)。
  • 修复 npm 过期的注册表元数据让包停留在旧版本时,pi update --extensions 报告成功且不警告的问题。Pi 现在报告已安装版本和预期版本(#11536)。
  • 修复没有名称冲突时,Skill 校验警告仍被标为 [Skill conflicts] 的问题。它们现在显示在 [Skill warnings] 下(#11521)。
  • 修复 codemode 工具描述在每次请求中包含完整的联合类型和多行输出类型的问题。对象联合现在摘要其字段和判别字段;其他多行类型指向 describeTool() 以获取完整声明(#11501)。
  • 修复退出全屏模式后,模型作用域启动通知留在 shell 里的问题。它现在出现在 pi 的全屏标题内(#11508)。
  • 修复从已删除的工作目录启动时,以未捕获的 uv_cwd 堆栈跟踪崩溃的问题。Pi 现在请用户切换到存在的目录(#11509)。
  • 修复失败的会话写入在内存中留下磁盘上没有的条目,使之后的条目指向缺失的父条目,恢复的会话丢失更早的历史和工具的问题(#11460)。
  • 修复 /tree 分支摘要忽略会话 thinking 级别,可能让推理模型以不支持的 none effort 拒绝摘要请求的问题(#11444)。
  • 修复隐藏 thinking 的标签为空时,仍然在回答和工具调用前添加空白行的问题(#11402)。
  • 修复包安装和移除打印 npm audit 和 funding 建议的问题,其中包括可能把第二份 pi 安装进包目录的 npm audit fix 说明(#11409)。
  • 修复对话框打开时替换扩展编辑器会藏起对话框并让它无法回答的问题。新编辑器现在在对话框关闭后出现(#11431)。
  • 修复文件含单独的回车时,grep 上下文行相对 ripgrep 匹配行号发生偏移的问题(#11398)。
  • 修复 --model <provider>/<id> 对含斜杠的 Provider ID 失败的问题,例如由 URL 派生的 llama.cpp Provider ID(#11394)。
  • 修复在打开文件很贵的文件系统上会话 fork 很慢的问题,改为通过一个文件句柄写入 fork(#11253)。
  • 修复 pi.exec() 破坏跨 stdout 或 stderr 块拆开的 UTF-8 字符的问题(#11312)。
  • 修复命令无法启动时(例如可执行文件缺失)pi.exec() 返回空 stderr 的问题。它现在保留启动错误消息(#11257 由 @muyiyr 贡献)。
  • 修复已配置的包安装失败导致启动崩溃的问题。Pi 现在跳过该包,报告扩展警告,并在下次启动或 /reload 时重试;显式的安装和更新命令仍然以非零退出失败(#11304 由 @Lincoln504 贡献)。
  • 修复 todo 扩展示例在工具调用参数校验失败时让 TUI 崩溃的问题(#8057 由 @cyzlmh 贡献)。
  • 因安全公告将 undici 更新到 8.12.3,Gondolin 扩展示例更新到 0.14.0。
  • 修复 OpenRouter 费用总额对 Chat Completions 和 Anthropic Messages 使用目录估算而不是上报账单的问题。BYOK 总额同时包含 OpenRouter 收费和上报的上游成本;分项成本仍是目录估算(#9980)。
  • 修复 OpenCode Zen 和 OpenCode Go 请求使用共享端点,而不是各自协议专用的 OpenAI、Anthropic、Google 和 System One 端点的问题(#11434 由 @vimtor 贡献)。
  • 修复 Zhipu/Z.ai 用量上限错误(代码 1308)被当成瞬时 HTTP 429,从而自动重试,但在用量上限重置前不可能成功的问题(#11537)。
  • 修复 LiteLLM 的 ContextWindowExceededError 不被识别为上下文溢出的问题(#11492)。
  • 修复 Gemini 工具 schema 发送不支持的 const 关键字的问题。它们现在转成单值 enum schema,不改写 default、example 或 enum 值里的字面数据,也不丢失名为 __proto__ 的属性(#11308)。
  • 修复 faux Provider 把模拟的 cache-write Token 同时计为输入和 cache write 的问题。
  • 修复 Orca 终端对内联图片回退到文本的问题。Orca 现在被识别为支持 true color 和超链接,并在公布 ORCA_IMAGE_PROTOCOL=kitty 时支持 Kitty 图片(#9329 由 @XRX193 贡献)。
  • 修复裸 Markdown URL 吞掉后面的 CJK 标点和文本的问题;显式 Markdown 链接和尖括号自动链接不变(#10934 由 @haoqixu 贡献)。
  • 修复 Kitty 协议的 F1–F12 快捷键(包括带修饰键的功能键)不被识别,以及 F13+ 和其他功能键把不可见的私用区字符插入编辑器的问题(#11419、#11345)。
  • 修复带内边距或颜色的盒子里的 Kitty 图片在第一行滚出全屏视口后消失的问题。部分可见的图片现在会被正确裁剪,包括旁边有其他文本时。
  • 修复深层嵌套的 Markdown 引用产生指数级行数,边框耗尽可用宽度后挂起或让渲染崩溃的问题(#11272)。
  • 修复系统更新之后跟着空回复或仅含推理的 assistant 回复时,Claude 会话以 role 'system' must precede an 'assistant' message 失败的问题(#11091)。
  • 修复组织把 effort 上限设在 high 以下的账号上,Claude 会话中途切换 thinking 级别以 Invalid effort level 失败的问题(#10063)。
  • 修复 Kimi Coding、Moonshot 和 OpenCode Go 上的 Kimi K3.1 Pro 模型使用 Kimi K2 请求设置的问题。它们现在发送正确的 reasoning effort,保留更早的 thinking,接受会话中途添加的工具,并使用 K3 系列价格。
  • 修复 OpenCode DeepSeek V4.1 Flash 在长缓存保留发送不支持的 prompt_cache_retention 参数时请求失败的问题。
  • 修复从调用过工具的模型切换过来后,GPT-5.4 和 GPT-5.5 以 Missing namespace for function_call 失败的问题(#11415)。
  • 修复首选严格工具超过 Provider 严格工具限制时,Bedrock Claude 请求失败的问题。请求现在用非严格的首选工具重试一次,同时保持必需的严格工具为严格(#11416)。
  • 修复 OpenRouter 的 ~anthropic/claude-*-latest 别名在工具调用后丢失更早 thinking 的问题,改为使用 Anthropic Messages API(#9534)。
  • 修复终端标题中的控制字符可能注入终端转义序列的问题,以及 pi-messages 流接受无效内容块索引的问题。
  • 修复全屏双击选择在 ~、.、\ 和 + 处拆开路径和 Token 的问题;单词字符现在与 iTerm2 的默认值一致(#10980)。
  • 修复宽于内容区域的显示数学被换行拆开的问题;现在回退到原始 LaTeX(#11483)。
  • 修复带样式的词正好在换行宽度结束时,下一行开头多一个空格,以及删除线漏进换行内边距的问题(#10925)。
  • 修复 /tree 分支摘要包含失败的 assistant 回复,以及上下文编辑已经隐藏或替换的原始内容的问题。摘要现在遵循与实时请求和压缩相同的上下文编辑(#11602)。

移除

Pi AI

不兼容变更

  • 主入口不再重新导出 TypeBox(Type、Static、TSchema),typebox 也不再是依赖。Tool.parameters 是任意 JSON Schema 对象(Tool<TParameters extends object>):@earendil-works/pi-schema 的 builder(参数类型也来自 pi-schema 的 Static)、TypeBox schema,或普通对象。validateToolCall() / validateToolArguments() 用 pi-schema 校验(compile(schema, { coerce: true }).parse()):每个 schema 都得到相同的强制转换,即 TypeBox 的 Value.Convert 规则(以前只作用于 TypeBox 构建的 schema)和 pi-ai 自己的规则的超集。因此普通 JSON Schema 工具(MCP 工具)现在也会得到例如把 null 转成必需字符串的 "null"、把 "3.5" 转成整数 3,以及把单个值包进数组。错误文本列出 pi-schema 的消息(- edits.0.oldText: missing、- limit: expected number, got string),而不再是 TypeBox 的。StringEnum() 返回 JSON 相同的 pi-schema Schema<T>({ type: "string", enum })。模型和兼容 schema(providers/model-schema、providers/compat-schema)用 pi-schema 构建,JSON Schema 相同,类型来自 pi-schema 的 Static;导出 ProviderCompat。迁移:

    // Before
    import { Type, type Static, StringEnum } from '@earendil-works/pi-ai';
    const params = Type.Object({ path: Type.String(), mode: StringEnum(['a', 'b']) });
    type Params = Static<typeof params>;
    
    // After: pi-schema builders (closed objects; pass { open: true } to allow other properties)
    import { StringEnum } from '@earendil-works/pi-ai';
    import { obj, type Static, str } from '@earendil-works/pi-schema';
    const params = obj({ path: str(), mode: StringEnum(['a', 'b']) });
    type Params = Static<typeof params>;
    
    // Or keep TypeBox, imported from typebox itself (its schemas are JSON Schema)
    import { Type, type Static } from 'typebox';
  • 工具参数只按 JSON Schema 校验;不再经过 TypeBox 自己的校验器,因此 JSON Schema 之外的 TypeBox 特性不再作用于工具参数:

    • 不运行 Type.Refine() 的细化约束:它们本会拒绝的参数会被接受。
    • Type.BigInt()、Type.Undefined() 和 Type.Void() 拒绝每一个 JSON 参数(TypeBox 以前会转换到它们)。
    • Codec(Type.Codec())不解码:工具收到的是编码后的 JSON 值。
    • 用 TypeBox 的 Format.Set() 注册的格式不会被检查;标准格式加上 url 和 json-pointer-uri-fragment 会检查。
    • 属性名是名称,不是正则表达式:"a.b" 不再同时转换参数 axb。
    • additionalProperties 只转换未声明的属性;对象有多于一个属性时,TypeBox 以前也会用它转换已声明的属性。
  • 指向不存在目标的 $ref(缺失的定义、外部文档)只拒绝它所在位置的参数(- t: unresolved reference #/definitions/Missing),而不再像以前 TypeBox 那样让该工具的每次调用都失败。

  • appendGrammarToolInputJsonDelta()(api/constrained-sampling)接收输入 delta,而不是到目前为止的全部输入,并且不再关闭输入;用新的 closeGrammarToolInputJson() 关闭它(#9265)。

新增

  • 为 device_code 认证事件和 OAuthDeviceCodeInfo 添加可选的 openBrowserOnConfirm 和 copyCodeOnConfirm。两者默认 true;设为 false 可阻止客户端提供打开验证页或复制验证码(#9282、#9301)。
  • 添加 StreamingJsonParser,一个对分片到达的 JSON 文本做增量、宽容解析的解析器(每片只读一次;部分值的快照一旦返回就不再改变),以及 ToolCallArgumentsStream。每个 Provider 现在都用它解析流式工具调用参数;它的 append() 也返回每片造成的变更(JsonChange:某路径上设置的值,或追加到字符串的文本),供自己保留副本的写入方使用(#9265)。
  • 为 OpenAI、Azure OpenAI Responses 和 OpenAI Codex Provider 添加 GPT-6.1 Terra,官方价格为输入 $1、缓存输入 $0.05、缓存写入 $1.25、输出 $5,272k 以上为长上下文档位,支持工具搜索和会话中途切换 effort。与 GPT-6.1 Sol 不同,它支持 off(reasoning effort none);Codex 以 500K 上下文窗口提供它。
  • 添加 Usage.cost.totalFromProvider,用来区分 Provider 上报的账单总额和目录估算。缺失或 false 表示估算;只有每一部分都是 Provider 上报时,合并用量才标为 Provider 上报(#11178)。
  • 为 pi-messages 终端事件添加 responseModel,在请求虚拟模型时保留 Radius 等 Provider 上报的具体模型(#11265)。

变更

  • faux Provider 现在流式输出部分工具调用参数,因此 toolcall_delta 的部分值会像真实 Provider 一样显示增长中的参数(#9265)。
  • 内置模型目录由 models.dev 的 v2 目录生成,每个 Provider 的规则从 scripts/generate-models.ts 移到 catalog/ 下每个 Provider 一个 TypeScript 定义。models.dev 标为 realtime 或图片模型的模型(gpt-realtime-2.1、gemini-3.1-flash-live-preview、gemini-3.1-flash-lite-image)不再作为聊天模型提供,models.dev 较新的 OpenAI 和 Google 聊天模型(chat-latest、gpt-5.6-cyber、gemini-robotics-er-2-preview)现在包含在内。

修复

  • 修复接受会话中途系统消息的 Claude 模型,在系统更新之后跟着一条没有内容可发给 Anthropic 的 assistant 回复(例如空回复或另一个模型的仅推理回复)时,以 400(role 'system' must precede an 'assistant' message)拒绝会话的问题(#11091)。
  • 修复带会话中途 effort 的 Claude 模型,在组织把 effort 上限设在 high 以下的账号上以 Invalid effort level 失败的问题,即使 thinking 是 low 或 medium;现在发送固定的顶层 effort low(#10063)。
  • 修复流式工具调用参数在每个 delta 上被完整重新解析,使 CPU 时间和内存随工具调用大小二次增长的问题(Anthropic 上 90 KB 的 write 堆峰值约 140 MB;500 KB 的要几分钟)。每个 Provider 和 pi-messages 客户端现在每个 delta 只读一次,并把原始参数文本和其他流状态(partialJson、partialArgs、index、customInput、streamIndex、Bedrock 的加密推理字节)留在内容块之外,因此它们不再进入部分消息或失败流的记录(#9265)。
  • 修复 grammar(自定义)工具输入流在每个 delta 上复制到目前为止的全部输入的问题(#9265)。
  • 修复有界错误文本(telemetry span 消息、截断的 Provider 错误体、pi-messages 诊断、Radius 网关错误)让被截断的整段文本一直存活的问题(#9265)。
  • 修复 Kimi Coding、Moonshot 和 OpenCode Go 上的 Kimi K3.1 Pro 和 K3.1 Pro Highspeed 使用 Kimi K2 请求设置的问题。它们现在发送 reasoning_effort(low/high/max),返回更早的推理,接受会话中途添加的工具,并在 Kimi Coding 上报 Moonshot 费率。Kimi Coding 的 k3-256k 现在上报 Kimi K3 费率。
  • 修复 OAuth 登录打开不是 http: 或 https: 的服务器提供 URL 的问题。Radius 现在检查浏览器授权端点和设备验证 URI,GitHub Copilot、Kimi Coding 和 Meta 共用一次检查。
  • 修复 pi-messages 流接受不是下一个或已有内容块的 contentIndex 的问题,例如 __proto__ 或巨大的索引。
  • 修复 pi-ai CLI 认证文件可被其他用户读取的问题。它现在以模式 0600 写入。
  • 修复 OpenCode DeepSeek V4.1 Flash 发送 prompt_cache_retention,被 OpenCode 网关拒绝,并带长缓存保留的问题。
  • 修复从调用过工具的另一个模型切换过来后,GPT-5.4 和 GPT-5.5 以 Missing namespace for function_call 失败的问题。在 OpenAI 和 OpenCode Provider 上,它们现在把工具声明在顶层工具列表中,而不是通过 additional_tools 或工具搜索加载(#11415)。
  • 修复 strict: "prefer" 工具超过 Claude 严格工具限制时(例如所有严格工具合计超过 16 个可选参数),Bedrock 请求失败的问题;请求现在用非严格的首选工具重试一次,同时保持 strict: "require" 工具为严格,与 Anthropic Provider 已有的做法一样(#11416)。
  • 修复 OpenRouter 的 ~anthropic/claude-*-latest 别名在每次工具调用后丢失 Claude 更早 thinking 的问题。它们使用 Chat Completions API,pi 在那里丢掉了 thinking 签名,OpenRouter 随后忽略未签名的 thinking。它们现在使用带 adaptive thinking 的 Anthropic Messages API,与带版本号的 Claude 模型一样(#9534)。
  • 修复 OpenRouter 费用总额对 Chat Completions 和 Anthropic Messages 使用目录估算而不是上报账单的问题。BYOK 总额同时包含 OpenRouter 收费和上报的上游成本;分项成本仍是目录估算(#9980)。
  • 修复 OpenCode Zen 和 OpenCode Go 请求使用共享端点,而不是各自协议专用的 OpenAI、Anthropic、Google 和 System One 端点的问题(#11434 由 @vimtor 贡献)。
  • 修复 Zhipu/Z.ai 用量上限错误(代码 1308)被当成瞬时 HTTP 429,从而自动重试,但在用量上限重置前不可能成功的问题(#11537)。
  • 修复 LiteLLM 的 ContextWindowExceededError 不被识别为上下文溢出的问题(#11492)。
  • 修复 Gemini 工具 schema 发送不支持的 const 关键字的问题。它们现在转成单值 enum schema,不改写 default、example 或 enum 值里的字面数据,也不丢失名为 __proto__ 的属性(#11308)。
  • 修复 faux Provider 把模拟的 cache-write Token 同时计为输入和 cache write 的问题。
Pi Agent

不兼容变更

  • AgentTool 的 parameters 接受任意 JSON Schema 对象(AgentTool<TParameters extends object>),并通过 @earendil-works/pi-schema 给 params 和 prepareArguments 定类型(AgentToolParams<TParameters>):pi-schema 的 builder 给出静态类型,TypeBox schema 对常见种类给出 TypeBox 静态类型(String、Number、Integer、Boolean、Null、Literal、Array、带可选和只读属性的 Object、Union、Record、Unsafe、Unknown、Any;Enum、Tuple、Intersect 等其他种类给出 unknown),其他 schema 给出 unknown,AgentTool<any> 仍是 any。outputSchema 是任意 JSON Schema 对象。typebox 不再是依赖。迁移:用 pi-schema 构建参数(obj({ path: str() }) 代替 Type.Object({ path: Type.String() })),或继续使用 TypeBox schema(只有用到其他种类时才需要自己收窄 params)。

修复

  • 修复 streamProxy() 在每个 delta 上重新解析累积的工具调用参数,并把原始文本留在部分内容块上的问题(#9265)。
Pi TUI

新增

  • 添加 replaceControlCharacters(),把连续的 C0 和 C1 控制字符替换成空格。
  • 添加 Component.capturesViewportInput。设置了它的组件拥有焦点时,TuiAltScreen 把 PageUp/PageDown 等视口键发给它,而不是滚动记录,与已有焦点的 overlay 一样。SelectList、SettingsList 和打开了自动补全的 Editor 会设置它(#7629,基于 #7680 由 @muyiyr 贡献)。
  • 添加 getSelectPageIndex(),用于计算 tui.select.pageUp 或 tui.select.pageDown 按键之后的选中项(#7629,基于 #7680 由 @muyiyr 贡献)。

修复

  • 修复 Apple Terminal 发送 ESC + Return 时,Shift+Enter 把 follow-up 排队的问题。本地原生 Shift 检测可用时(Apple Terminal、原生 Windows),ProcessTerminal 现在把按住 Shift 的 ESC + Return 当成 Shift+Enter;没有 Shift 时仍是 Alt+Enter(#11559)。
  • 修复常规模式 TUI 把渲染行中的 OSC 133 Prompt 标记写到终端的问题。终端把 133;A 当成新的 shell Prompt,并丢掉 OSC 7501 程序状态,因此运行期间工作指示消失。全屏仍然用这些标记做 Prompt 导航,并且已经剥掉它们(#11519)。
  • 修复全屏双击选择在 ~、.、\ 和 + 处拆开路径和 Token 的问题。单词字符现在与 iTerm2 的默认值一致(#10980)。
  • 修复 fuzzyMatch() 把散落在文本前部的查询排在后面的连续匹配之上的问题。它现在也对查询的每次连续出现计分,并保留最佳对齐(#11220、#11296)。
  • 修复 ProcessTerminal.setTitle() 把标题中的控制字符写出去,从而可能结束标题序列并把其余部分作为转义序列发给终端的问题。
  • 修复宽于内容宽度的显示数学被逐行换行、把分式和求和拆开的问题。现在回退到原始 LaTeX 源(#11483)。
  • 修复 SelectList、SettingsList 和编辑器自动补全忽略 tui.select.pageUp 和 tui.select.pageDown 的问题(#7629,基于 #7680 由 @muyiyr 贡献)。
  • 修复带样式的词正好在换行宽度结束时,wrapTextWithAnsi() 让下一行以空格开头,以及删除线延续进换行右侧内边距的问题(#10925)。
  • 修复 Markdown 在每次渲染时都对每个块做样式、高亮和换行的问题。它现在复用上次渲染的顶层块,因此流式消息只渲染改变的最后一块,resize 复用已高亮的代码。复用的块被弱引用持有,并由 invalidate() 丢掉;主题变化必须调用它,因为在此之前会复用 MarkdownTheme.highlightCode 的结果(#10971)。
  • 修复 Text.setText() 在文本未变时丢掉已换行的行,使每次更新都设置相同文本的渲染器再次换行的问题(#10971)。
  • 修复 Orca 终端对内联图片回退到文本的问题。Orca 现在被识别为支持 true color 和超链接,并在公布 ORCA_IMAGE_PROTOCOL=kitty 时支持 Kitty 图片(#9329 由 @XRX193 贡献)。
  • 修复裸 Markdown URL 吞掉后面的 CJK 标点和文本的问题;显式 Markdown 链接和尖括号自动链接不变(#10934 由 @haoqixu 贡献)。
  • 修复 Kitty 协议的 F1–F12 快捷键(包括带修饰键的功能键)不被识别,以及 F13+ 和其他功能键把不可见的私用区字符插入编辑器的问题(#11419、#11345)。
  • 修复带内边距或颜色的盒子里的 Kitty 图片在第一行滚出全屏视口后消失的问题。部分可见的图片现在会被正确裁剪,包括旁边有其他文本时。
  • 修复深层嵌套的 Markdown 引用产生指数级行数,边框耗尽可用宽度后挂起或让渲染崩溃的问题(#11272)。

v1.4.0(2026-10-21)

Pi Coding Agent

新功能

  • 分类器的图片输入 – codemode 的 models.classify() 接受 images,用于 typesafe、cloudflare-workers-ai 和 OpenRouter 上 TypeSafe 的 Jev 与 Cloudflare 的 Clef 模型。详见 使用分类器模型 和 Codemode。
  • 模型配置参考 – 列出 models.json 的每个 Provider、模型、模型覆盖和兼容性字段,由 schema 生成。详见 模型配置。
  • 摘要不再使用固定输出上限 – 压缩和分支摘要使用模型的输出上限,长推理不再导致失败。详见 压缩。
  • Codemode 等待空闲 worker – 并行脚本和进程内子代理会排队而不是失败,PI_CODEMODE_MAX_WORKERS 可提高上限。详见 Codemode 限制。
  • Rex 终端支持 – OSC 8 超链接、truecolor 和内联图片。

新增

  • 添加由 models.json schema 生成的模型配置参考,列出所有 Provider、模型、模型覆盖和兼容性字段(#10790)。
  • Codemode 的 models.classify() 现在接受 images,用于 typesafe、cloudflare-workers-ai 和 OpenRouter 上 TypeSafe 的 Jev 与 Cloudflare 的 Clef 模型,并在 Workers AI 上列出 Clef Omni 和 Jev 1.14。
  • models.json 中 Provider 级的 compat 现在也适用于分类器模型,System One 字段 imageInput 和 sendImageOptInHeader 用于代理其他服务分类器的场景。扩展的分类器模型也接受 compat。
  • 为 minimax 和 minimax-cn Provider 添加 MiniMax-M3.1-Flash,thinking 级别从 low 到 max(#11121)。
  • 添加 Rex 终端支持:OSC 8 超链接、truecolor 和内联图片(#11131、#11150 由 @petrroll 贡献、#11183 由 @nihaals 贡献)。

变更

  • Provider 归属请求头现在来自 pi-ai 的客户端身份。扩展的 before_provider_headers 处理器不再看到 OpenRouter、NVIDIA NIM 和 OpenCode 的归属请求头;对其中一个返回 null 仍会移除它。Cloudflare 请求发送 Pi 的详细 User-Agent,而不是 pi-coding-agent,工具下载的 GitHub release 检查也是如此。只要启用了归属,OpenCode 请求就会发送 x-opencode-client,而不只是在有会话时。
  • generateSummary() 和 generateSummaryWithUsage() 现在忽略 reserveTokens 参数。摘要请求改用模型的输出上限。
  • GitHub Copilot 默认模型从已退役的 gpt-5.4 改为 gpt-6.1-sol。
  • NVIDIA 默认模型改为 nvidia/nemotron-3.5-super-vl-120b-a12b(#10910 由 @cv 贡献)。
  • xiaomi 和 Xiaomi Token Plan Provider 的默认模型改为 mimo-v2.6-pro,因为 mimo-v2.5-pro 已离开目录。
  • xai Provider 上的 Grok 4.3 和 Grok 4.5 现在提供 xhigh thinking 级别。
  • 使用 ChatGPT 登录:ChatGPT Business 工作区用量上限错误不再重试,并告诉用户去让工作区管理员提高上限。

修复

  • 修复推理占满固定摘要输出上限时,压缩和分支摘要以 "generation hit the token cap" 失败的问题。摘要现在使用模型的输出上限,compaction.reserveTokens 只控制压缩何时开始(#9512、#9075)。
  • 修复 models.schema.json 缺少 Provider 和模型字段的描述,导致编辑器不显示提示的问题(#10790)。
  • 修复 managed-install.json 以 UTF-8 BOM 开头时 pi update 报 "Managed install marker is missing or invalid" 的问题。Windows PowerShell 5.1 重写该文件时会加上 BOM。
  • 修复 HTML 导出里,紧挨 CJK 标点的 Markdown 粗体和斜体显示成字面星号的问题(#3353、#10154)。
  • 修复 Pi 未经正常终端清理就退出时,终端停留在鼠标跟踪、焦点上报、Kitty 键盘和备用屏幕模式,导致 shell 提示符被转义序列淹没的问题(#11170)。
  • 修复交互模式下并发的扩展 select/confirm/input/editor 对话框和内联 custom() 组件:第二个对话框会替换第一个,且第一个 Promise 永不 settle;关闭可见对话框现在会再次显示上一个(#11166、#9909)。
  • 修复在 Linux 上于 Pi 中复制文本后用 Ctrl+Z 挂起,再在 shell 中粘贴会卡住的问题:保持剪贴板服务的后台 wl-copy/xclip/xsel 进程被一起挂起了(#11179)。
  • 修复两个 codemode worker 都忙时脚本立即失败的问题,例如并行 codemode 调用或进程内子代理。脚本现在最多等待 60 秒以获得空闲 worker,PI_CODEMODE_MAX_WORKERS 可提高两个 worker 的上限(#11184)。
  • 修复扩展导入 @earendil-works/pi-ai/models(例如为了 clampThinkingLevel)时加载失败的问题,扩展加载器别名和虚拟模块现在暴露该子路径(#11156)。
  • 修复以 UTF-8 BOM 开头的 mcp.json 无法解析的问题,这会跳过其中全部 MCP 服务器,并使 pi mcp add/pi mcp remove 失败(#11191)。
  • 修复 /compact <instructions> 在摘要被压缩拆开的轮次开头时忽略指令的问题。当被拆开的轮次是上次压缩以来唯一的新内容时,指令会被完全忽略(#11058)。
  • 修复恢复的会话和 /tree 导航在分支记录工具早于注册时,把扩展工具留在非活动状态的问题,例如会话开始后才安装的扩展所提供的工具。分支从未添加或移除的扩展工具现在是活动的,除非注册时设置了 defaultActive: false(#11062、#11075)。
  • 修复从输出上限截断的响应中恢复后会话损坏的问题:被截断的 tool call 被省略,但其工具结果被保留,于是 Provider 拒绝之后的每个请求(#11227、#11233 由 @petrroll 贡献)。
  • 修复 grep 工具遵循 RIPGREP_CONFIG_PATH 的问题,其中 --fixed-strings 等选项会把正则搜索静默改成字面搜索。该工具现在运行 rg --no-config(#11203、#11230 由 @petrroll 贡献)。
  • 修复 Windows shell 检测拒绝可运行的 Microsoft Store shell 别名的问题(#9504 由 @petrroll 贡献)。
  • 修复 Windows shell 检测漏掉 PATH 之外的 PowerShell,以及 Windows 未安装在 C:\Windows 时的旧版 WSL bash.exe 启动器的问题。Pi 现在会检查 %ProgramFiles%\PowerShell\7、%SystemRoot%\System32\WindowsPowerShell\v1.0 和 %SystemRoot%(#9501 由 @petrroll 贡献)。
  • 修复请求体很大的 GitHub Copilot 会话(例如含很多图片)以 HTTP 413 failed to parse request 失败,而不是压缩后重试的问题(#11016 由 @petrroll 贡献)。
  • 修复 openai-codex Provider 提供总会对 ChatGPT 账号失败的 gpt-5.5 和 gpt-5.3-codex-spark 的问题(#11173 由 @lucasmeijer 贡献)。
  • 修复仅含空白的工具输出(例如 bash 返回的单独 \r\n)使 OpenAI Completions、OpenAI Responses 和 Google 请求以 400 失败的问题(#8720)。
  • 修复更多网关上游失败、Codex CLI 代理转发的 stream disconnected before completion 错误,以及短暂的 Google Vertex OAuth Token 刷新失败不触发自动重试的问题,并修复因请求 ID 或字节数中的数字而重试错误的问题(#10920、#11057、#10996)。
  • 修复 OpenAI Responses 模型在移除工具后,每次延迟加载工具都会丢失 Prompt 缓存的问题(#10940)。
  • 修复 Cloudflare Workers AI 分类器定价:Clef Flash 为每百万输入 Token $0.038,Jev 为 $0.042,而不是把 Jev 列为免费。
  • 修复未闭合的 $$ 显示数学块吞掉或破坏它之后每个 Markdown 表格的问题(#11159)。
  • 修复紧挨 CJK 标点的 Markdown 粗体和斜体不渲染的问题(#10730 由 @theBucky 贡献)。
  • 修复 @ 文件自动补全对含 [ 或 ( 等正则元字符的查询不返回结果的问题(#10972)。
Pi AI

不兼容变更

  • Provider 请求选项 telemetryContext 重命名为 telemetry?: TelemetrySpan,没有兼容别名。传入父 span,而不是 adapter。
  • 默认 User-Agent 现在是 pi/<version> (<platform>; <runtime>; <arch>),不再是 pi (<platform> <release>; <arch>)。@earendil-works/pi-ai/utils/pi-user-agent(getPiUserAgent())已移除;改用 formatUserAgent()。
  • resolveTranscriptTools() 现在接受 TranscriptToolSupport("none"、"additions" 或 "changes"),而不是布尔值。TranscriptTools.anchorsAdditions 替换为 foldedSystemMessages,即折入 requestTools 的前导系统消息数量(#10940)。

新增

  • 添加客户端身份配置:请求选项 identity 和 createModels({ identity }) 的默认值用来选择 User-Agent(带版本的 "detailed"、"short" 或自定义),以及 OpenRouter、NVIDIA NIM 和 OpenCode 的 Provider 归属请求头,来源是 attribution: { name, url, categories? }。withClientIdentity() 把身份应用到库从宿主收到的 Models 或 MutableModels。导出 formatUserAgent()、getIdentityHeaders()、getOpenCodeSessionHeaders()、mergeClientIdentity()、PI_ATTRIBUTION 和 PI_AI_VERSION。
  • Bedrock、OpenRouter 图片生成、pi-messages 和分类器请求现在也发送 Pi 的 User-Agent。
  • 带 sessionId、且自定义 Provider 指向 OpenCode(opencode.ai)的 Models 请求现在也发送 x-opencode-session 头,与内置 OpenCode Provider 一样。
  • 添加 AI_TELEMETRY_SCHEMA,以及围绕 Models 请求的可选 pi.ai.request/pi.ai.poll 追踪,带不含内容的首事件、块大小和最终用量属性,并通过 telemetry.metrics 提供时长、Token 和美元费用指标。
  • 失败的模型请求 span 以 provider_error 状态上报,错误信息最多 500 个字符;取消的请求保持 ok 状态,并带 stop: "aborted"。
  • 为 minimax 和 minimax-cn Provider 添加 MiniMax-M3.1-Flash,thinking 级别从 low 到 max,以 output_config.effort 发送。该模型不能关闭 thinking。来自 models.dev 的新 MiniMax 模型现在无需手动加入允许列表就会出现;只有较旧的 M2、M2.1、M2.5 和 M2.5-highspeed 仍被隐藏(#11121)。
  • 使用 ChatGPT 登录:ChatGPT Business 工作区用量上限错误不再重试,并告诉用户去让工作区管理员提高上限。
  • 为 System One 分类器添加图片输入:ClassifierContext.images 现在可用于 typesafe 上的 Jev(在那里是实验性的,需用 TypeSafe-Danger-Zone-Images 头选择加入)和 cloudflare-workers-ai,可用于 cloudflare-workers-ai 上的 Clef,也可用于目录列出图片输入的 OpenRouter 决策模型。每个服务有自己的线上格式:TypeSafe 的 assets、Clef 的 images data URL,或 OpenRouter 在 state 中的 image_url 部分。
  • 为 System One 分类器模型添加 compat(SystemOneCompat,含 imageInput 和 sendImageOptInHeader)。内置目录条目会显式设置它;没有它的模型根据 Provider、baseUrl 和模型 ID 检测格式。
  • 为 cloudflare-workers-ai 添加 @cf/cloudflare/clef-omni 和 typesafe/jev-1.14.0 分类器模型。

变更

  • xai Provider 上的 Grok 4.3 和 Grok 4.5 现在提供 xhigh thinking 级别,与 xAI 为这些模型支持的推理力度一致。

修复

  • 修复 Cloudflare Workers AI 分类器目录数据:Clef Flash 现在是每百万输入 Token $0.038,上下文窗口 24,576 Token;Jev 是每百万输入 Token $0.042,而不是被列为免费。
  • 修复仅含空白的工具输出(例如 bash 返回的单独 \r\n)被原样发给 OpenAI Completions、OpenAI Responses 和 Google Provider 的问题;现在与空输出使用相同的占位符,因为有些 Provider 会以 400 拒绝仅含空白的工具内容(#8720)。
  • 修复 upstream_error: Upstream request failed、upstream_stream_read_error 和 Upstream HTTP/2 stream failed 等网关上游失败不触发自动重试的问题(#10920)。
  • 修复 Google Vertex OAuth Token 刷新因短暂网络错误失败时不触发自动重试的问题,例如 request to https://oauth2.googleapis.com/token failed, reason:(#10996)。
  • 修复包装 Codex CLI 的代理转发的 stream disconnected before completion 错误不触发自动重试的问题(#11057)。
  • 修复自动重试把请求 ID 或其他数字中的数字(例如 req_011CU503xyz 或 5242880 bytes)当成可重试 HTTP 状态码的问题(#11057)。
  • 修复 OpenAI Responses 延迟工具加载在移除工具后的每次加载都改写顶层工具列表并丢失 Prompt 缓存的问题。带 additional_tools 的模型现在把全部工具声明在 additional_tools 项中,并从输入开头的一项开始,因此移除(以文本宣布)和重新定义不再改写前缀。工具搜索和 Kimi 工具消息在每次移除或重新声明时改写一次顶层工具,并让之后的加载保持锚定(#10940)。
  • 修复请求体超过 Copilot 大小上限的 GitHub Copilot 请求(HTTP 413 failed to parse request,例如含很多大图片的会话)失败,而不是被检测为上下文溢出的问题。任何 HTTP 413 现在都算上下文溢出,调用方可以压缩后重试(#11016 由 @petrroll 贡献)。
  • 修复 openai-codex Provider 列出 Codex 后端会对 ChatGPT 账号拒绝的 gpt-5.5 和 gpt-5.3-codex-spark 的问题。两个模型都已移除(#11173 由 @lucasmeijer 贡献)。
Pi Agent

新增

  • 添加 AgentOptions.identity 和 Agent.identity(pi-ai 的 ClientIdentity),用于设置 agent loop 请求的 User-Agent 和 Provider 归属。
Pi TUI

新增

  • 添加 Rex 终端检测(TERM_PROGRAM=rex),支持 OSC 8 超链接、truecolor 和 Kitty 图片。链接此前会回退到 text (url) 格式(#11131、#11150 由 @petrroll 贡献、#11183 由 @nihaals 贡献)。

修复

  • 修复未闭合的 $$ 显示数学块吞掉或破坏它之后每个 Markdown 表格的问题。块级数学 Token 不再跨越 GFM 表格,流式待定数学的回退也不再把后面的表格当成待定数学(#11159)。
  • 修复紧挨 CJK 标点的 Markdown 粗体和斜体不渲染的问题(#10730 由 @theBucky 贡献)。
  • 修复进程未调用 stop() 就退出时,终端模式(鼠标跟踪、焦点上报、Kitty 键盘协议、括号粘贴、备用屏幕)保持开启的问题。进程 exit 处理器现在会同步恢复它们(#11170)。
  • 修复 @ 文件自动补全对含 [ 或 ( 等正则元字符的查询不返回结果的问题(#10972)。

v1.3.0(2026-10-15)

Pi Coding Agent

新功能

  • 选择 /share 的上传位置 – sessionShareDestination 可选 auto、gist 或 radius。详见 会话与上下文 和 导出或分享会话。
  • 在 OpenAI GPT-6 上保留缓存的 thinking 级别切换 – 使用 API key 时,会话中途切换 thinking 级别会保留 Prompt 缓存。
  • 通过 Chat Completions 使用 Kimi Code – 会话中途添加的工具不再使 Prompt 缓存失效。models.json 的基础 URL 覆盖现在必须包含 /v1。详见 Provider。
  • 干净的模型切换 – 前一个模型的 thinking 会被丢弃,而不是作为文本展示给新模型。
  • 恢复的会话保留其活动工具 – --tools +name/-name 在它们之上生效。详见 工具。

新增

  • 在 OpenAI GPT-6 模型(API key)上会话中途切换 thinking 级别现在会保留 Prompt 缓存(#10853)。
  • 添加 sessionShareDestination 设置,用于为 /share 选择自动、GitHub gist 或 Radius 上传(#10870 由 @vegarsti 贡献)。

变更

  • kimi-coding Provider 改为在 https://api.kimi.com/coding/v1 使用 OpenAI Chat Completions,即官方 Kimi Code 客户端所用的协议。K3、K3-256K 和 Kimi For Coding 现在接受会话中途添加的工具,而不使 Prompt 缓存失效。models.json 中对 kimi-coding 基础 URL 的覆盖现在必须包含 /v1(#10720)。
  • 模型切换改为丢弃来自不同模型的较早 assistant 消息中的 thinking 块,而不是把它们作为纯文本发送。新模型此前会把旧模型的推理当作其回复的一部分,并可能开始把自己的推理写进可见答案(#10995)。

修复

  • 把内部 Pi 依赖固定到确切的发布版本,避免全新安装混合不兼容的包(#10865)。
  • 修复恢复的会话丢弃会话期间激活的工具的问题。现在恢复会还原会话的活动工具,并对其应用 --tools +name/-name 条目,除非 --tools 指定了工具名、--no-tools 或 --no-builtin-tools 显式选择工具(#10785)。
  • 修复在 Bun 上停止 codemode 脚本或到达其期限时,等待不可中断的内置工具返回的问题(#10748)。
  • 修复重复的 codemode 超时或中止累积残留 worker 的问题;准入现在把跨会话的存活 worker 限制为两个,取消的 worker 计入其中直到真正退出(#10748)。
  • 修复当多个 Provider 都提供匹配项时 --model 按目录顺序选择 Provider 的问题;Pi 现在优先选择有凭据的 Provider,否则报告歧义。--models 和 enabledModels 会为每个提供该模型的 Provider 添加它,并提示歧义(#10160)。
  • 修复 TUI、会话树、HTML 导出和示例中数字字符串或 null 参数的 read 行范围标签(#9887)。
  • 修复 Provider 切换 API 时 Nix flake 构建失败的问题:当模型目录的模型 API 分组不同时,现在会从最新发布的目录刷新锁定,并且发布会在打 tag 前锁定最新目录并用它构建(#10985)。
  • 修复 Nix 包把它的 Node.js 放在 PATH 最前,导致 bash 工具 shell 使用 Pi 的 Node 而不是用户的 node/npm 的问题。Pi 的 Node 现在只是回退项(#10519)。
  • 修复 Prompt 模板丢弃空的引号参数("" 或 '')的问题,这曾使之后的位置参数偏移,并让位置默认值无法生效(#10867)。
  • 修复 Nix 包在安装检查中失败的问题,因为它仍预期 chord 和 esbuild,而 Pi 已不再依赖它们。
  • 修复当字符串含有无效 \\u 转义(如 \\usepackage)时 tool call 参数解析丢字段的问题(#10868)。
  • 修复错误 tool result 含图片时 Anthropic 和 Bedrock Claude 请求以 400 失败的问题;图片现在在该轮的 tool result 之后发送,因此模型仍能看到它们(#10794)。
  • 修复 OpenCode Go Gemini 模型因把 OpenCode Zen 和 OpenCode Go 迁移到 opencode.ai/inference 端点而报 404 的问题,并为 OpenCode Go Provider 添加 Google Generative AI 支持。
  • 修复 OpenCode Go MiniMax M2.7 改用 Anthropic Messages API 后报 "Model does not support this protocol" 的问题。
  • 修复网关 Unable to forward upstream stream 错误不触发自动重试的问题(#10920)。
  • 修复 The service is temporarily unavailable 错误不触发自动重试的问题,这也曾让压缩在第一次尝试时就失败(#10965)。
  • 修复当代理(如 LiteLLM)在同一流分块中发送推理和内容时,OpenAI 兼容响应在答案之后显示 thinking 的问题(#10926)。
  • 修复 Google Vertex 上 Gemini 4 Argon 请求报 "Thinking budget is not supported"、以及其 thinking 级别在 Gemini API 上被忽略的问题(#10890)。
  • 修复小米 MiMo 模型在 minimal thinking 级别报 400 的问题;它们现在只暴露 off 和 high 级别(#10818)。
  • 修复 openai-codex/gpt-6.1-sol 使用 272K 上下文窗口而不是 Codex 现在提供的 500K 窗口的问题(#10840)。
  • 修复最后参数是畸形 JSON 的 tool call 只带着错误前解析出的字段静默运行的问题;它们现在校验失败,并把模型发送的原始参数展示给模型(#10897)。
  • 修复 Claude Haiku 5.5 和 Claude Opus 5 不支持 off thinking 级别的问题(#10753)。
  • 修复扩展的 ctx.ui.custom({ overlay: true }) 的 done() 关闭最顶层浮层而不是它自己的浮层的问题,这曾让已完成的浮层留在屏幕上,另一个扩展的对话框也无法 resolve(#10648、#10999 由 @masonc15 贡献)。
Pi AI

不兼容变更

  • 移除 AssistantMessageFrame、AssistantMessageFrameEncoder 和 reduceAssistantMessageFrames()。它们只被已移除的实验性 agent harness 使用。

新增

  • 为 openai Provider 上的 GPT-6 模型添加保留缓存的 thinking 级别切换:使用 API key 时,级别作为 configuration_update 输入项发送,而不是改变 reasoning.effort,由 compat.supportsMidConvoEffort 控制(#10853)。

变更

  • kimi-coding Provider 改为在 https://api.kimi.com/coding/v1 使用 OpenAI Chat Completions,即官方 Kimi Code 客户端所用的协议。K3、K3-256K 和 Kimi For Coding 现在接受会话中途添加的工具,而不使 Prompt 缓存失效。models.json 中对 kimi-coding 基础 URL 的覆盖现在必须包含 /v1(#10720)。
  • 模型切换改为丢弃来自不同模型的较早 assistant 消息中的 thinking 块,而不是把它们作为纯文本发送。新模型此前会把旧模型的推理当作其回复的一部分,并可能开始把自己的推理写进可见答案(#10995)。

修复

  • 修复当字符串含有无效 \\u 转义(如 \\usepackage)时 tool call 参数解析丢字段的问题(#10868)。
  • 修复错误 tool result 含图片时 Anthropic 和 Bedrock Claude 请求以 400 失败的问题;图片现在在该轮的 tool result 之后发送,因此模型仍能看到它们(#10794)。
  • 修复 OpenCode Go Gemini 模型因把 OpenCode Zen 和 OpenCode Go 迁移到 opencode.ai/inference 端点而报 404 的问题,并为 OpenCode Go Provider 添加 Google Generative AI 支持。
  • 修复 OpenCode Go MiniMax M2.7 改用 Anthropic Messages API 后报 "Model does not support this protocol" 的问题。
  • 修复网关 Unable to forward upstream stream 错误不触发自动重试的问题(#10920)。
  • 修复 The service is temporarily unavailable 错误不触发自动重试的问题,这也曾让压缩在第一次尝试时就失败(#10965)。
  • 修复 Google Vertex OAuth Token 刷新因瞬时网络错误(如 request to https://oauth2.googleapis.com/token failed, reason:)失败时不触发自动重试的问题(#10996)。
  • 修复当代理(如 LiteLLM)在同一流分块中发送推理和内容时,OpenAI 兼容响应在答案之后显示 thinking 的问题(#10926)。
  • 修复 Google Vertex 上 Gemini 4 Argon 请求报 "Thinking budget is not supported"、以及其 thinking 级别在 Gemini API 上被忽略的问题,做法是对 Gemini 4 及之后的模型发送 thinkingLevel(#10890)。
  • 修复小米 MiMo 模型在 minimal thinking 级别报 400 的问题,做法是只发送文档化的 thinking 开关,并只暴露 off 和 high 级别(#10818)。
  • 修复 openai-codex/gpt-6.1-sol 使用 272K 上下文窗口而不是 Codex 现在提供的 500K 窗口的问题(#10840)。
  • 修复最后参数是畸形 JSON 的 tool call 只带着错误前解析出的字段静默运行的问题;这类调用现在带有 argumentsError,并带着原始参数文本校验失败,因此模型能看到它发送了什么(#10897)。
  • 修复 Claude Haiku 5.5 和 Claude Opus 5 不支持 off thinking 级别的问题;off 现在发送 thinking: {type: "disabled"} 而不带 effort 设置(#10753)。

v1.2.0(2026-10-12)

Pi Coding Agent

新功能

  • 按 key 的 OpenRouter 模型列表 – 使用 OpenRouter key 时,Pi 只列出该 key 可用的模型,附带该 key 的上下文大小、最大输出和价格,包括 models.json 中设置的区域端点。详见 OpenRouter。
  • 发布的配置 schema – 在 settings.json、models.json、快捷键和主题中添加 $schema,用于编辑器校验和补全。详见 设置、模型、快捷键 和 主题。
  • 剪贴板跨远程会话复制 – PI_CLIPBOARD_OSC52=1 在 Pi 无法检测到远程会话(例如从另一台机器接入的多路复用器)时,把复制的文本发送到远程客户端的剪贴板。详见 Pi 进程配置。
  • codemode 改进 – 工具声明显示输入约束,例如 integer、minimum/maximum 和 default,codemode 行显示已用时间和总时间。详见 Codemode。
  • 为扩展触发的运行提供 before_agent_start – 由 pi.sendMessage(..., { triggerTurn: true }) 启动的运行经历与 Prompt 相同的设置。详见 事件与并发。

不兼容变更

  • 在 https://pi.dev/schemas/*.schema.json 发布模型、设置、快捷键和主题的生成配置 schema。主题 schema 移到 https://pi.dev/schemas/theme.schema.json;启动时加载的主题现在与之后的重新加载接受相同的 schema 校验。请更新主题的 $schema 引用,在 vars 下定义可复用颜色,并移除不支持的元数据(#9880、#10751 由 @christianklotz 贡献)。
  • before_agent_start 现在也会在空闲时对由 pi.sendMessage(..., { triggerTurn: true }) 启动的运行触发。BeforeAgentStartEvent 现在是基于 messageType 的联合类型:"user" 事件携带 prompt 和 images,"custom" 事件携带起始的 message 且没有 prompt。处理程序返回的消息会加入两种运行,待处理的 deliverAs: "nextTurn" 消息随自定义消息运行一起投递。只应对用户 Prompt 生效的处理程序必须检查 event.messageType === "user"(#10267、#5581、#10739 由 @davidbrai 贡献)。
  • 会话在运行启动期间(包括 before_agent_start 处理程序执行期间)计为忙:ctx.isIdle() 为 false,pi.sendMessage() 排队到启动中的运行,而不是启动第二个以 "Agent is already processing" 失败的新运行,pi.sendUserMessage() 需要 deliverAs,在此期间请求的中止会在运行启动后中止它(#10739 由 @davidbrai 贡献)。
  • pi mcp list --json 现在对提供资源的服务器报告 resources: true,而不是 resources 和 resourceTemplates 计数;Pi 在连接时不再列出资源(#10526)。

新增

  • 添加 sessionShareDestination 设置,用于为 /share 选择自动、GitHub gist 或 Radius 上传(#10870)。
  • 为工具定义添加 reachesTools,让能触及其他工具的工具(如 codemode 和 tool_search)声明一次调用可能触达哪些工具;MCP 扩展用它等待调用所需的服务器,并判断替换的 codemode 或 tool_search 工具能否触达 MCP 工具。
  • 为工具命名空间添加 aliases;codemode 的 describeNamespace() 和 searchTools() 的 namespace 选项会匹配它们,MCP 命名空间使用服务器名称。
  • 添加按 key 的 OpenRouter 模型列表:使用 OpenRouter key 时,Pi 只列出该 key 可用的聊天模型,附带该 key 的上下文大小、最大输出和价格,包括在 models.json 中作为基础 URL 设置的 guardrails 和区域端点。列表会被保存并离线使用(#10353、#10672 由 @davidbrai 贡献)。
  • 添加 PI_CLIPBOARD_OSC52=1,在写入本地剪贴板后通过 OSC 52 把复制的文本发送到终端,因此在 Pi 无法检测到远程会话时(例如从另一台机器接入的多路复用器或远程 IDE 守护进程),复制能到达远程客户端的剪贴板(#10826、#10835、#10114)。
  • 为 codemode 工具行添加脚本运行期间的已用时间和完成后的总时间,与 bash 行类似(#10708)。

变更

  • showHardwareCursor 设置改为只使用终端光标,不再同时绘制 Pi 的反色光标。
  • codemode 工具声明改为在属性注释上用 @ 标签显示输入约束,例如 integer、minimum/maximum、length、pattern 和 default,让脚本无需工具在描述中重复也能看到它们(#10707)。
  • codemode 对 MCP 工具的声明改为写出结果类型(content、structuredContent、isError),而不是引用 CallToolResult<T>——describeTool()、searchTools() 和 ALL_TOOLS 展示它时并未定义它;codemode 描述不再包含共享的 MCP 类型。
  • serializeConversation()(压缩、分支摘要、bug 报告)改为省略 thinking 块;重放的 thinking 通常不在实时上下文中,所以包含它可能让摘要请求比它所摘要的上下文更大并失败。

修复

  • 修复 codemode 忽略不是脚本第一行的 // @options: 行,从而在没有请求的 timeout_ms 下运行脚本的问题;调用现在会在脚本运行前报错失败(#10631)。
  • 修复 Mistral 流在请求超时后于生成中途(例如长 thinking 期间)被中止的问题;超时现在只适用于等待响应头(#10609)。
  • 修复嵌套在主仓库内的 git worktree 中符号链接的 AGENTS.md 导致不加载任何项目上下文文件的问题(#10681)。
  • 修复 code mode 工具描述声称每个失败的工具调用都会被 reject 的问题;声明了输出模式的工具在失败时也会以其值 resolve(例如非零退出的 bash)。
  • 修复由 pi.sendMessage(..., { triggerTurn: true }) 启动的运行在第一次工具调用后移除 before_agent_start 中添加的系统 Prompt 段,从而在运行中途改变 Prompt 并每次运行两次破坏 Provider Prompt 缓存的问题(#10267、#10739 由 @davidbrai 贡献)。
  • 修复 codemode 在有许多 text() 调用的脚本后阻塞进程数秒到数分钟的问题;连接输出项是二次复杂度(#10678)。
  • 修复打印模式(-p)在最终响应因模型输出 Token 上限被截断时以 0 退出且没有警告的问题;它现在打印部分文本、向 stderr 写入警告并以 1 退出(#10799)。
  • 修复 pi mcp login --help 和 CLI 文档把 --timeout 描述为只等待浏览器的问题;它限制整个登录过程(#10636)。
  • 修复 extensions、skills、prompts 和 themes 设置的 !pattern、+path 和 -path 条目中 ~ 不展开,导致 !~/skills/pdf 之类的条目匹配不到任何内容的问题(#10765)。
  • 修复带有资源的 MCP 服务器在列出所有资源前不注册任何工具的问题;Pi 连接时不再列出资源,因此 /mcp 和 pi mcp list 显示服务器提供资源,而不是计数(#10526)。
  • 修复当服务器返回非对象的结构化内容(数组、null 或基元,MCP 2026-07-28 允许)时 MCP 工具调用失败的问题;没有输出模式的 MCP 工具的 codemode 声明现在把 structuredContent 类型标为 unknown 而不是对象(#10416)。
  • 修复在 Windows 上上一个锁文件夹仍在删除时读写 auth.json 报 EPERM 的问题;Pi 现在会短暂重试后再报告错误(#10801)。
  • 修复像 openrouter/auto 这样的 OpenRouter 路由模型显示每 1M Token -$1,000,000 成本的问题;OpenRouter 的负数占位价格现在为 0(#10672 由 @davidbrai 贡献)。
  • 修复当 Provider 因语法大小、工具数量或联合限制拒绝严格工具集时 Anthropic 请求失败的问题;Pi 现在用非严格的首选工具重试一次(#10409)。
  • 修复 "The upstream provider returned an error" 不被作为瞬时 Provider 错误重试的问题(#10842)。
  • 修复获得焦点的全屏浮层阻塞转录的鼠标滚轮滚动的问题(#10769)。
  • 修复碎片化的终端颜色回复把十六进制值泄漏到 Prompt 并打开外部编辑器的问题(相关报告:#10256、#10657)。
  • 修复内联图片自 1.1.0 起在 Herdr 中不渲染的问题(#10774 由 @ogulcancelik 贡献)。
  • 修复命名移位符号的快捷键(如 + 或 ctrl++)在 Kitty 键盘协议或 modifyOtherKeys 下不匹配的问题(#9880 由 @christianklotz 贡献)。
  • 修复自定义编辑器中的压缩状态指示器使用默认弱化颜色,而不是编辑器边框或 thinking 级别颜色的问题,工作指示器则不然(#10809、#10810 由 @Jay-Madden 贡献)。
  • 修复在等待 OAuth 刷新时被取消或超时的 MCP 工具调用在刷新完成后仍被发送到服务器的问题(#10598)。
  • 修复 MCP OAuth 登录接受带有无法校验的 iss 参数的授权响应的问题(因为没有发现授权服务器元数据);登录现在以 issuer 不匹配失败。由 @AizenvoltPrime 报告。
  • 修复 Pi 在 Node 24 或 26 上运行于 node --watch 时 codemode 报 broken bridge 错误的问题(#10725)。

移除

  • 移除未发布的实验性服务器、客户端和插件栈(src/experimental、src/cli/experimental)及其仅供源码使用的 ./client 和 ./experimental/plugin 导出;它们都不属于已发布的包。它使用的 @earendil-works/pi-client、@earendil-works/pi-protocol 和 @earendil-works/pi-server 包已移除,不再发布。
  • 移除对 @earendil-works/chord 的依赖。
Pi AI

新增

  • 添加 personalizeOpenRouterCatalog()(@earendil-works/pi-ai/providers/openrouter),它把 OpenRouter 目录收窄到该 key 可用的聊天模型,并带上来自 GET /models/user 的该 key 的上下文大小、最大输出和价格(#10353、#10672 由 @davidbrai 贡献)。
  • 添加 RefreshModelsContext.baseUrl,即注册 Provider 的基础 URL(包括包装器应用过的配置覆盖),让动态目录可以跟随 models.json 中设置的基础 URL(#10353、#10672 由 @davidbrai 贡献)。

修复

  • 修复 Mistral 流在请求超时后于生成中途(例如长 thinking 期间)被中止的问题;超时现在只适用于等待响应头(#10609)。
  • 修复像 openrouter/auto 这样的 OpenRouter 路由模型显示每 1M Token -$1,000,000 成本的问题;OpenRouter 的负数占位价格现在为 0(#10672 由 @davidbrai 贡献)。
  • 修复当 Provider 因语法大小、工具数量或联合限制拒绝严格工具集时 Anthropic strict: "prefer" 工具失败的问题;请求现在会用非严格的首选工具重试一次,同时保持 strict: "require" 工具严格(#10409)。
  • 修复 "The upstream provider returned an error" 不被作为瞬时 Provider 错误重试的问题(#10842)。
Pi TUI

不兼容变更

  • Editor.render() 和 Input.render() 现在把绘制的光标包在零宽 APC 标记中,而不是直接发出 \x1b[7m。TUI 渲染器会解析它们;在 TUI 之外渲染这些组件的代码必须移除它们,例如用 stripTerminalSequences()。

新增

  • 添加 renderFakeCursor()。组件用它包裹绘制的光标,TUI 以反色渲染它,或者在启用 showHardwareCursor 时在 CURSOR_MARKER 之后省略它。

变更

  • showHardwareCursor 改为只显示终端光标:启用时,获得焦点的 Editor 和 Input 组件不再绘制反色光标。这避免了把边缘单元颜色扩展到窗口内边距的终端在首列或末列拉伸绘制的光标。

修复

  • 修复浮层合成在浮层紧挨光标左侧结束时丢弃 CURSOR_MARKER,从而丢失硬件光标位置的问题。
  • 修复获得焦点的全屏浮层阻塞转录的鼠标滚轮滚动的问题。没有组件处理的滚轮事件现在滚动转录,而不是作为原始输入送到获得焦点的浮层的 handleInput;用滚轮滚动的浮层必须实现 handleMouse(#10769)。
  • 修复碎片化的终端颜色回复把十六进制值泄漏到 Prompt 并通过其 BEL 终止符触发外部编辑器的问题(相关报告:#10256、#10657)。
  • 修复内联图片自 1.1.0 起在 Herdr 中不渲染的问题;Herdr 现在使用 Kitty 图形协议(#10774 由 @ogulcancelik 贡献)。
  • 修复命名移位符号的快捷键(如 + 或 ctrl++)在 Kitty 键盘协议或 modifyOtherKeys 把该键报告为 Shift 加未移位键时不匹配的问题。parseKey() 现在返回产生的符号(+ 而不是 shift+=);物理 shift+= 拼写仍然匹配,ctrl++ 等 key id 也能正确解析(#9880 由 @christianklotz 贡献)。

v1.1.0(2026-10-07)

Pi Coding Agent

新功能

  • 程序状态上报 – 支持 OSC 7501 的终端和 agent 仪表盘可以看到 Pi 正在工作、被对话框或登录阻塞、已完成还是失败。详见 程序状态。
  • Claude Haiku 5.5 – anthropic/claude-haiku-5-5,支持最高 xhigh/max effort 的自适应 thinking。
  • 用 +name/-name 调整默认工具 – --tools 条目如 pi -t +codemode,-write 会调整默认选择,而不是替换它。详见 工具。
  • GPT-6 Luna 与图片分类 – OpenAI 的 GPT-6 Luna 可通过 Decisions API 作为分类器模型使用,codemode 的 models.classify() 接受图片(前提是分类器支持)。详见 使用分类器模型。
  • 原生 llama.cpp 决策模型 – 由 llama.cpp 0.6.0 或更高版本提供的 Julia-1、Laya、Kev、lev 和 OpenJev 通过 /v1/systemone 原生作为分类器运行。详见 分类。

新增

  • 为 --tools 添加 +name 和 -name 条目,它们会调整默认工具选择而不是替换它,例如 pi -t +codemode。
  • 为工具渲染上下文和 tool_execution_end 扩展事件添加 durationMs:最终工具结果的记录执行时间(#10549)。
  • 为工具渲染上下文添加 outputPad(#10557 由 @rwachtler 贡献)。
  • 添加 OpenAI 的 GPT-6 Luna 作为通过 Decisions API 使用的分类器模型,需要 OPENAI_API_KEY(详见 使用分类器模型)。
  • 为 codemode 的 models.classify() 上下文添加 images,因此接受图片的分类器(如 GPT-6 Luna)可以判断图片。
  • 添加 OSC 7501 程序状态上报:支持它的终端和 agent 仪表盘可以看到 Pi 正在工作、被对话框或登录阻塞、已完成还是失败。PI_PROGRAM_STATUS=1|0 可覆盖检测(详见 终端设置)(#10607)。
  • 为 agent_settled 会话、扩展和 JSON 事件添加 aborted,因此集成可以区分被取消的运行和已完成的运行(#10607)。
  • 添加 Claude Haiku 5.5(anthropic/claude-haiku-5-5),支持最高 xhigh/max effort 的自适应 thinking,以及在 Bedrock 上的 Prompt 缓存。
  • 添加原生 llama.cpp 决策模型:由 llama.cpp 0.6.0 或更高版本提供的 Julia-1、Laya、Kev、lev 和 OpenJev 只作为分类器通过 /v1/systemone 列出,而不再作为聊天模型(详见 分类)(#10382)。

变更

  • outputPad 现在也适用于 ! 命令输出、工具输出和摘要块(#9946、#10557 由 @rwachtler 贡献)。
  • pi mcp login --timeout 现在限制整个登录过程(包括对授权服务器的请求),而不只是等待浏览器(#10565)。

修复

  • 修复重新加载会话后 bash 和 PowerShell 结果丢失 Took,以及实时 Took 包含墙钟步骤的问题;两者现在都显示记录的执行时间(#10549)。
  • 修复托管安装保留每个旧版本的问题;pi update 现在只保留新版本和它所更新的那个版本(#10392、#10511 由 @davidbrai 贡献)。
  • 修复独立二进制文件从启动目录加载 .env、.env.local 和 .env.development 到 Pi 环境的问题(#10473)。
  • 修复 !! 命令标题在有输出后丢失暗色的问题(#10557 由 @rwachtler 贡献)。
  • 修复 codemode 描述没有把 searchTools()、describeTool() 和 describeNamespace() 标记为 async,导致模型把未 await 的 promise 序列化为 {} 的问题(#10555)。
  • 修复 codemode 输出项连在一起,导致模型无法分辨一个 text() 或 console.log() 输出的结束和下一个的开始的问题。有多个文本项时,每项现在以一行 ==> text N/M <== 开头,console 调用跟随其他输出放在一个 <console_output> 块中,每次调用一行。
  • 修复 /mcp 在打开前等待所有服务器连接的问题;管理器现在实时更新,在启用、重连或禁用服务器期间保持可用(#10562)。
  • 修复在 Node 24.19+ 和 26.x 上使用 node --watch 运行时,图片因 "could not be resized" 被丢弃的问题:此时 Node 会在图片缩放 worker 通道上发布自己的消息(#10527)。
  • 修复在 Termux 中剪贴板粘贴无反应,以及那里复制失败时缺少 Termux:API 安装提示的问题(#10391)。
  • 修复当颜色码被拆分到不同输出块时,! 和 RPC bash 输出残留颜色码片段(例如一个孤立的 m)的问题(#10504)。
  • 修复 MCP OAuth 登录在等待授权服务器时无法取消,并在会话结束后继续运行的问题。登录界面现在每一步都可以用 Esc 取消,会话关闭会中止正在进行的登录,每个对授权服务器的请求在 15 秒后超时(#10565)。
  • 修复关闭时最多等待 15 秒去刷新即将过期的 MCP OAuth Token,结果只是关闭服务器的会话的问题(#10565)。
  • 修复全屏文本选择在切换会话和其他转录重建后仍然保留,从而在新转录中高亮无关文本的问题(#9311、#10567 由 @christianklotz 贡献)。
  • 修复 Bedrock 上的 OpenAI 模型忽略 thinking 级别、总是以 Bedrock 默认推理 effort 运行的问题(#9331、#10142 由 @jsanter27 贡献)。
  • 修复 models.json 中的模型 headers 不能覆盖 Codex 请求的 originator 和 User-Agent 头的问题(#10429 由 @lucasmeijer 贡献)。
  • 修复 server_busy 和 servers are currently busy Provider 错误结束回合而不是被重试的问题(#10543)。
  • 修复以 finish_reason: "error" 结束的 Mistral 响应不被重试的问题(#10487)。
  • 通过按每 Token 3.5 个字符(而不是 4 个)估算输入来计算输出限制,减少上下文限制导致的请求失败(#10497)。
  • 修复被组织所有者禁用的 Radius 模型仍被列出的问题。
  • 修复端口 53692 被保留或占用(例如 Windows 上 Hyper-V/WSL 的端口排除)时,Anthropic 浏览器登录报 "localhost refused to connect" 的问题:登录现在会回退到一个空闲的本地回环端口(#10571)。
  • 修复会话成本对具有 Prompt 长度定价档位的模型(如 Claude Haiku 5.5、Gemini 3.1 Pro 和 GPT-5.4)在长 Prompt 上少计的问题,涉及 OpenCode、OpenCode Go、OpenRouter、Vercel AI Gateway、Google、MiniMax 和其他 Provider。
  • 修复 Markdown 链接在 Herdr 中不可点击的问题(#10573)。
Pi AI

不兼容变更

  • stream 函数必须返回 AssistantMessageEventStream,例如来自 createAssistantMessageEventStream();手写的 EventStream<AssistantMessageEvent, AssistantMessage> 子类不再能作为替代通过类型检查。

新增

  • 为 AssistantMessage 添加 durationMs:AssistantMessageEventStream 对每个响应使用单调时钟测量从请求开始到最终消息的时间,适用于每个 API 实现,包括直接调用。稍后获取的延迟结果不计时(#10549)。
  • 为 ToolResultMessage 添加可选的 durationMs,表示工具的执行时间(#10549)。
  • 添加用于 OpenAI Decisions API 的 openai-decisions 分类器 API,gpt-6-luna 作为 openai Provider 的分类器模型。它需要 API key,因此当 openai 使用 Sign in with ChatGPT 时不会被列为可用。
  • 为 anthropic Provider 添加 Claude Haiku 5.5(claude-haiku-5-5),包含其 Prompt 长度定价档位、支持 xhigh/max effort 的自适应 thinking、每消息 effort,以及对话中途的系统消息和工具变更。Haiku 5.5 的 Bedrock 请求使用自适应 thinking、原生 xhigh 和 Prompt 缓存。
  • 添加 LoginOptions.agentName,用于替换 pi 在 Sign in with ChatGPT agent name 提示中的名称和 Codex 浏览器登录的 originator(#10433 由 @lucasmeijer 贡献)。
  • 为 ClassifierContext 添加可选的 images。input 包含 "image" 的模型会结合状态判断图片;classify() 对其他模型和无法发送图片的 API 返回错误结果。

变更

  • faux Provider 的 Prompt 缓存用量估算现在逐消息比较上一个和当前的 Prompt 消息,并只从第一条不同的消息开始比较字符;用量数字不变。

修复

  • 修复 server_busy 和 servers are currently busy Provider 错误结束回合而不是被重试的问题(#10543)。
  • 修复失败的惰性 API 设置(例如模块加载或认证失败)的错误消息使用其失败时间而不是请求开始时间作为 timestamp 的问题。
  • 通过按每 Token 3.5 个字符(而不是 4 个)估算输入来计算输出限制,减少上下文限制导致的请求失败(#10497)。
  • 修复被组织所有者禁用的 Radius 模型仍被列出的问题:现在获取或缓存的 Radius 目录会替换内置的默认目录,而不是合并进去。
  • 修复 openai Provider 在缓存目录不含分类器模型时的类型检查。
  • 修复端口 53692 被保留或占用(例如 Windows 上 Hyper-V/WSL 的端口排除)时,Anthropic 浏览器登录报 "localhost refused to connect" 的问题:登录现在会回退到一个空闲的本地回环端口(#10571)。
  • 修复内置模型成本缺少 OpenCode、OpenCode Go、OpenRouter、Vercel AI Gateway、Google、MiniMax 和其他 models.dev Provider 的 Prompt 长度定价档位,导致 Claude Haiku 5.5、Gemini 3.1 Pro 和 GPT-5.4 等模型的长 Prompt 成本少计的问题。OpenRouter 的分时定价未建模。
  • 修复以 finish_reason: "error" 结束的 Mistral 响应不被重试的问题(#10487)。
  • 修复 Bedrock Converse 不向 OpenAI 模型发送推理 effort 的问题:gpt-oss 的 reasoning_effort 被限制为 low/medium/high,其他 GPT 模型使用 reasoning.effort,其中 minimal 以 low 发送(#9331、#10142 由 @jsanter27 贡献)。
  • 修复模型和调用方 headers 不能覆盖 openai-codex-responses 请求的 originator 和 User-Agent 头的问题(#10429 由 @lucasmeijer 贡献)。
Pi Agent

新增

  • 为工具结果消息、AgentToolCallOutcome 和 tool_execution_end 事件添加 durationMs:execute() 花费的时间,用单调时钟测量并排除 hooks。未运行的调用没有该值(#10549)。

变更

  • streamProxy() 返回 AssistantMessageEventStream,因此代理的响应像直接响应一样获得 durationMs。
Pi TUI

不兼容变更

  • Terminal 实现必须提供 setProgramStatus(status);不支持 OSC 7501 的终端可以将其实现为空操作(#10607)。

新增

  • 添加 Box.setPaddingX(...) 和 Text.setPaddingX(...)(#10557 由 @rwachtler 贡献)。
  • 添加 Terminal.setProgramStatus() 和 formatProgramStatus() 用于程序状态协议(OSC 7501)。ProcessTerminal 在启动时询问终端是否支持,只在它应答时发送报告;PI_PROGRAM_STATUS=1|0 可覆盖检测(#10607)。
  • 添加 TuiAltScreen.resetTextSelection(),用于丢弃文本选择和多击状态,例如在宿主替换转录之前(#9311、#10567 由 @christianklotz 贡献)。

修复

  • 修复 Markdown 链接在 Herdr 中不可点击的问题:现在把 TERM_PROGRAM=herdr 检测为支持 OSC 8 超链接(#10573)。

v1.0.4(2026-10-05)

Pi Coding Agent

新功能

  • 工具模式与 --no-mcp – --tools 和 --exclude-tools 接受 * 模式,例如 --tools read,codemode,'mcp__radius__*' 只保留一个 MCP 服务器的工具。--tools 现在保留 MCP 工具,除非某个条目以 mcp__ 开头;--no-mcp 可以为单次运行关闭 MCP。详见 工具 和 MCP 工具。
  • Codemode 保留图片 – 对图片文件调用 tools.read() 现在返回 image() 能展示的图片块。详见 调用工具。

新增

  • 为 --tools 和 --exclude-tools 添加 * 模式,例如 --tools read,codemode,'mcp__radius__*'。
  • 添加 --no-mcp,为单次运行禁用内置 MCP 支持。

修复

  • 修复语法高亮在围栏代码块中,多行字符串和注释的第一行之后丢失颜色的问题(#10143)。
  • 修复 codemode 脚本收不到来自 read 的图片:tools.read() 现在对图片文件解析为图片块,image() 可以展示它(#10251)。
  • 修复 MCP OAuth 登录在 OpenID Connect 客户端注册的服务器(例如 mcp.modem.dev)上以 invalid_redirect_uri 失败的问题:pi 现在注册为原生客户端(#10493)。
  • 修复 --tools 移除 MCP 工具,导致 pi --tools codemode 没有任何 MCP 服务器的问题。--tools 现在保留 MCP 工具,除非某个条目以 mcp__ 开头。
  • 修复 MCP 会话关闭在服务器仍在连接时就返回,导致其传输保持打开,直到服务器应答或超时的问题(#10249)。
  • 修复系统 Prompt 规则和 skills 提示点名了被 prepareLoadout 隐藏的工具的问题。隐藏的工具会从规则中排除,文件读取工具被隐藏时 skills 提示不提任何工具,codemode 会在声明旁显示每个工具的 Prompt 指南;ToolLoadout 新增 getPromptGuidelines()(#10343)。
  • 修复停滞的 HTTP/2 连接之后以 The pending stream has been canceled 失败的 Bedrock 请求不会被自动重试的问题(#10379)。
  • 修复修改内置对象(例如 Array.prototype.toJSON = ...)的 codemode 脚本让 pi 崩溃、留下未结束的 tool call 的问题。现在会在脚本运行前冻结内置对象,因此这类修改不生效(#10444)。
Pi AI

修复

  • 修复停滞的 HTTP/2 连接之后以 The pending stream has been canceled 失败的 Bedrock 请求不会被自动重试的问题(#10379)。

v1.0.3(2026-10-05)

Pi Coding Agent

新功能

  • Azure Foundry Chat Completions – azure Provider(由 azure-openai-responses 更名而来)现在还提供 Foundry Chat Completions 部署,从 azure/deepseek-v4-pro 开始。详见 Azure OpenAI。
  • Codemode 图片保存到文件 – image() 还会把每张图片写入临时文件,并在结果中给出路径,因此之后的轮次可以复制或移动生成的图片。详见 生成图片。

不兼容变更

  • Azure Provider 由 azure-openai-responses 更名为 azure。请重命名 auth.json(或重新运行 /login)、models.json 和 settings.json 中的 Provider key(defaultProvider、enabledModels 模式和 modelThinkingLevels 键)。使用旧 Provider 的会话在恢复时回退到其他模型,且不会复用其 Prompt 缓存。AZURE_OPENAI_* 环境变量不变(#9714 由 @jsanter27 贡献)。

新增

  • 添加 Azure Foundry Chat Completions 部署,从 azure/deepseek-v4-pro 开始(#9645、#9714 由 @jsanter27 贡献)。

变更

  • Codemode 的 image() 现在还会把每张图片保存到临时文件,并在结果中给出路径,因此之后的轮次可以复制或移动生成的图片(#10310)。
  • 输出文件(截断工具输出的完整文本、二进制 MCP 资源、codemode 图片)现在只有用户可读。
  • Home/End 现在总是把编辑器光标移到行首/行尾;全屏转录的顶部/底部移到 Ctrl+Home/Ctrl+End,它们不再移动编辑器光标(#10314)。

修复

  • 修复在 OAuth Token 刷新期间请求被取消后,Sign in with ChatGPT 等订阅登录以 refresh_token_invalidated 失败的问题。
  • 修复 pnpm 全局更新删除正在运行的安装后,codemode 在会话剩余时间内失败的问题,并在 pi 于磁盘上被更新或删除后出错时添加重启提示(#10439)。
  • 修复终端消失(例如关闭窗口,或在已关闭的终端中恢复挂起的 pi)时,交互式会话报告 read EIO 或 setRawMode EIO 崩溃(并提示运行 /bug)的问题。
Pi AI

不兼容变更

  • Azure Provider 由 azure-openai-responses 更名为 azure,因为它现在还提供 Chat Completions 以及 Responses API。使用 getModel("azure", ...),并从 @earendil-works/pi-ai/providers/azure 导入 azureProvider 和 AZURE_MODELS,而不是从 providers/azure-openai-responses 导入 azureOpenAIResponsesProvider 和 AZURE_OPENAI_RESPONSES_MODELS。azure-openai-responses 的 API id 和 AZURE_OPENAI_* 环境变量不变(#9714 由 @jsanter27 贡献)。

新增

  • 为 Azure Provider 添加对 Foundry 部署的 Chat Completions 支持,内置目录中包含 DeepSeek V4 Pro。其他 Foundry 模型可以用 api: "openai-completions" 加到 azure Provider 下,AZURE_OPENAI_DEPLOYMENT_NAME_MAP 和 azureDeploymentName 对两个 API 都适用(#9645、#9714 由 @jsanter27 贡献)。

修复

  • 修复在 Token 刷新期间请求或模型刷新被取消或被取代时 OAuth 凭证失效的问题:已开始的 Token 刷新现在会完成并持久化轮换后的 refresh token。
Pi TUI

变更

  • Home/End 现在总是把编辑器光标移到行首/行尾;全屏转录的顶部/底部移到 Ctrl+Home/Ctrl+End,它们不再移动编辑器光标(#10314)。

v1.0.2(2026-10-04)

Pi Coding Agent

新功能

  • 按 thinking 层级设置采样参数 – models.json 中的 samplingParamsByThinkingLevel 可以为 OpenAI 兼容 API 的每个 thinking level 设置 temperature、top_p 等采样参数。详见 按 thinking 层级配置采样。

新增

Pi AI

新增

  • 为 openai-completions、openai-responses 和 azure-openai-responses 请求添加按 thinking level 覆盖采样参数(samplingParamsByThinkingLevel)(#9776 由 @mrexodia 贡献)。

v1.0.1(2026-10-03)

Pi Coding Agent

新功能

  • Nix flake – nix run github:earendil-works/pi/stable 运行最新发布版,nix profile add github:earendil-works/pi/stable 安装它。详见 安装 Pi。
  • MCP 服务器的项目级覆盖 – .pi/mcp.json 和 /mcp 可以为单个项目启用、禁用或修改用户级服务器的暴露方式。详见 配置服务器。
  • MCP Client ID Metadata Documents – oauth.clientRegistration: "cimd" 让授权服务器按文档 URL 识别 pi,而不走动态注册。详见 用 OAuth 认证。
  • 任意工具的渲染器 – pi.registerToolRenderer() 可以绘制尚未注册工具的调用,例如恢复会话中的 MCP 工具。详见 工具渲染。
  • Cloudflare Clef 分类器 – @cf/cloudflare/clef 和 @cf/cloudflare/clef-flash 可以在 codemode 脚本和扩展中使用。详见 使用分类器模型。

新增

  • 为 /login、/mcp 和 /mcp login 的 OAuth 登录界面添加复制快捷键(app.message.copy,默认 ctrl+x):浏览器打不开,或换行后的链接无法选中时,用它复制登录 URL。
  • 为 MCP 服务器添加 oauth.clientRegistration: "cimd",它在 pi.dev 上用 Client ID Metadata Document 标识 pi,而不走动态客户端注册,这样授权服务器可以按 URL 允许 pi(#10302)。
  • 为用户级 MCP 服务器添加项目级覆盖:.pi/mcp.json 中不带 command 或 url 的条目只设置用户级服务器的 enabled、exposure 和 toolExposure,/mcp 可以为当前项目启用或禁用某个服务器(#10277)。
  • 在 cloudflare-workers-ai 中添加 Cloudflare 的 Clef 和 Clef Flash 分类器模型,可在 codemode 脚本和扩展中使用(#10316 由 @ndisidore 贡献、#10322 由 @RealAlexandreAI 贡献)。
  • 添加 pi.registerToolRenderer(),用于决定工具的调用如何绘制,包括尚未注册的工具(#10285)。
  • 为 macOS 和 Linux 添加 Nix flake:nix run github:earendil-works/pi/stable 运行最新发布版,nix profile add github:earendil-works/pi/stable 安装它。详见 安装 Pi(#9137)。

变更

  • 全局 npm 安装下的 pi update 现在建议迁移到 pi.dev 安装器的托管安装,它固定所有依赖。
  • Anthropic 工具在对话中途新增或重新定义时,现在内联定义在对话中,因此用同名重新定义工具会保留 Prompt 缓存,而不再重发完整工具列表。

修复

  • 修复安装解析到有漏洞的 brace-expansion 5.0.9 的问题,把 brace-expansion 5.0.12 固定为直接依赖(GHSA-q2hr-2g5m-vwhr、GHSA-qhr7-859c-m2p7、GHSA-6j4f-fj2g-mc7p)(#10288)。
  • 修复 --models 中的尾随逗号会向模型循环多加一个模型的问题(#10334)。
  • 修复 codemode 脚本在循环中打印导致 pi 内存耗尽而崩溃的问题:脚本输出超过 16 Mi 字符或 100000 项后会失败(#10283)。
  • 修复扩展通过 Image 渲染的 JPEG、GIF 和 WebP 图片在 Kitty、Ghostty、WezTerm 和 Warp 中不显示的问题(#10292)。
  • 修复恢复的会话和 HTML 导出中的 MCP tool call 在服务器连接前一直完全展开,或服务器始终未连接时永久展开的问题(#10285)。
  • 修复全屏 Kitty 图片在 WezTerm 中滚动后缩成一行条带的问题(#10319)。
  • 修复 "Selected model is at capacity" Provider 错误直接结束回合而不重试的问题(#10278)。
  • 修复 Cloudflare AI Gateway 的 Claude 模型因使用带点的模型 ID 而返回 404 的问题;现在改用带连字符的模型 ID(claude-opus-5-5 而不是 claude-opus-5.5)。
  • 修复 Sign in with ChatGPT 在回调端口被另一个登录占用时仍然继续、导致浏览器显示 "OAuth state mismatch" 的问题;现在会以端口占用错误失败(#10265)。
  • 修复 Amazon Bedrock OpenAI 模型把超过 272k 输入 Token 的请求按短上下文费率计费的问题;Bedrock 模型现在包含 models.dev 列出的定价层级(#10326)。
  • 修复系统 Prompt 或工具变更后 Amazon Bedrock Claude 请求失败并报 "Invalid signature in thinking block" 的问题(#10324)。
  • 修复 Together DeepSeek V4 Pro 在 Together 将其更名为 deepseek-ai/DeepSeek-V4-Pro-0813 后丢失 thinking level 控制的问题(#10336 由 @cv 贡献)。
  • 修复默认 NVIDIA 模型指向 NVIDIA 已不再提供的 nvidia/nemotron-3-super-120b-a12b 的问题;默认模型现在是 nvidia/nemotron-3-ultra-550b-a55b。

移除

  • 从发布的包中移除 npm-shrinkwrap.json。npm 安装不再固定传递依赖,库使用者现在可以覆盖它们。需要固定安装请使用 pi.dev 安装器(#5653)。
Pi AI

新增

  • 在 cloudflare-workers-ai Provider 中添加 Cloudflare 的 Clef 和 Clef Flash 分类器模型(@cf/cloudflare/clef、@cf/cloudflare/clef-flash)(#10316 由 @ndisidore 贡献、#10322 由 @RealAlexandreAI 贡献)。

变更

  • 带原生对话中途工具变更的 Anthropic 模型现在使用 inline-tools-2026-09-15 beta:后续工具在 tool_addition 块中按值定义,而不再追加到顶层工具列表;用同名重新定义工具也不再回退为重发完整工具列表,因此 Prompt 缓存得以保留。将 @anthropic-ai/sdk 升级到 0.129.0。
  • 弃用 hasToolRedefinitions();已没有内置传输层需要它。

修复

  • 修复 "Selected model is at capacity" Provider 错误直接结束回合而不重试的问题(#10278)。
  • 修复 Cloudflare AI Gateway 的 Claude 模型因使用带点的模型 ID 而返回 404 的问题,Anthropic 要求带连字符(claude-opus-5-5 而不是 claude-opus-5.5)。
  • 修复 Sign in with ChatGPT 在回调端口被另一个登录占用时仍然继续、导致浏览器显示 "OAuth state mismatch" 的问题;现在会以端口占用错误失败(#10265)。
  • 修复 Amazon Bedrock OpenAI 模型把超过 272k 输入 Token 的请求按短上下文费率计费的问题;Bedrock 模型现在包含 models.dev 列出的定价层级(#10326)。
  • 修复系统 Prompt 或工具变更后 Amazon Bedrock Claude 请求失败并报 "Invalid signature in thinking block" 的问题;Claude Opus 4.7+、Sonnet 5+ 和 Fable 5 现在会像 Anthropic Provider 一样丢弃过期的 thinking 块(#10324)。
  • 修复 Together DeepSeek V4 Pro 在 Together 将其更名为 deepseek-ai/DeepSeek-V4-Pro-0813 后丢失 thinking level 控制的问题(#10336 由 @cv 贡献)。
Pi TUI

新增

  • 添加 setImageTranscoder(),让 Image 可以为 Kitty 图形协议把 JPEG、GIF 和 WebP 图片转成 PNG(#10292)。

修复

  • 修复非 PNG 图片在 Kitty 协议终端上渲染为空白的问题:没有注册转码器或转换失败时,Image 现在显示文本回退(#10292)。
  • 修复全屏 Kitty 图片在 WezTerm 中滚动后缩成一行条带的问题(#10319)。

v1.0.0(2026-10-01)

Pi Coding Agent

新功能

  • 默认全屏 – TUI 现在默认全屏运行。将 tuiMode 设为 "regular" 可保留终端的正常回滚。详见 终端与显示。
  • 更精简的 codemode – Prompt Token 大约减少 40%,错误信息会告诉模型如何恢复。详见 Codemode。
  • codemode 中生成图片 – 脚本用会话凭证调用 models.generateImages()。详见 生成图片 和 使用图片模型。
  • /login 支持 Radius – 用 Radius 登录,并一步配置其 MCP 服务器。详见 Radius。
  • Anthropic 复制验证码登录 – 浏览器在另一台机器上时也能登录。详见 交互式认证。
  • MCP OAuth 加固 – oauth.authServerMetadataUrl、RFC 9207 iss 校验、按服务器存储凭证,以及保留已授权 scope 的升级登录。详见 用 OAuth 认证。
  • 只保留页头的安静启动 – quietStartup: "header" 保留版本和快捷键提示,隐藏其余内容。详见 终端与显示。

新增

  • 为声明了错误 OAuth 授权服务器或未声明授权服务器的 MCP 服务器添加 oauth.authServerMetadataUrl 设置。Pi 使用配置的 metadata 文档,而不走发现(#10172)。
  • 添加 quietStartup: "header",保留带版本和快捷键提示的启动页头,但隐藏模型范围行和已加载资源列表。
  • 为 codemode 脚本添加 models.generateImages()。它用会话凭证运行 OpenRouter 等图片模型,返回 image() 可附加到结果的 base64 图片块;用量像 models.classify() 一样计入会话费用。扩展可调用 ctx.modelRegistry.generateImages()。详见 使用图片模型。
  • 为 Anthropic /login 添加复制验证码登录方式,适用于浏览器在另一台机器上的无头环境(#10194 由 @lucasmeijer 贡献)。

变更

  • 将默认 TUI 模式改为全屏。将 tuiMode 设为 "regular" 或传入 --tui-mode regular 可保留终端的正常回滚。
  • /login 现在在顶级菜单末尾提供「用 Radius 登录」,并显示状态。Radius 登录后,/login 会提议在全局 mcp.json 中配置 Radius MCP 服务器("auth": { "provider": "radius" })并重新加载。取消登录会回到启动它的菜单。
  • Provider 文档页更名为 Providers,「Cloud Providers」一节改为「Provider Specific Config」,并首先介绍 Radius。
  • MCP OAuth 凭证现在按服务器名和 URL 存储,同一 URL 的 MCP 服务器可以用不同账号登录。仅按 URL 存储的凭证会迁移到第一个使用它们的服务器(#10252)。
  • Codemode 消耗的 Prompt Token 大幅减少:默认工具且 codemode 开启时,一次 GPT-5.6 请求从大约 5,300 Token 降到 3,300。codemode 描述用一行列出每个脚本全局变量,并指向新的 Codemode 参考文档中的 models API,模型需要时再去读。已声明工具用一行说明脚本如何调用、调用解析成什么,而不再重复完整声明;系统 Prompt 中的 codemode 指南和 MCP 服务器分区也更短。
  • Codemode 错误现在会说明如何恢复:读取不存在的工具或 models 成员时会给出相近匹配(tools.Bash 会建议 tools.bash);models.classify() 和 models.generateImages() 会拒绝畸形参数并给出期望形状;未知模型会指向 models.getAvailableOfType();过大的 store() 值会解释 store 的用途;生成了图片却没展示的脚本会收到提示。用 typeof tools.name 探测工具的脚本必须改用 "name" in tools。
  • /login 和 /logout 现在把没有凭证的 Provider 标为 "not configured",而不再是 "unconfigured"。
  • OAuth 浏览器页面现在显示彩色 Pi logo。

修复

  • 修复 MCP OAuth 登录会接受 iss 参数指向另一授权服务器的授权响应;现在在兑换前就会拒绝该 code(RFC 9207)。
  • 修复 Token 响应包含 "scope": "" 时 MCP OAuth 登录失败并报 Invalid scope,以及其他空或 null 可选 OAuth 字段的类似失败(#10266)。
  • 修复 /mcp login 打印的登录 URL 换行时无法点击的问题(#10186)。
  • 修复只传 --provider 不传 --model 时被静默忽略、改用另一 Provider 默认模型的问题;现在会报错退出(#10236)。
  • 修复请求更多 scope(insufficient_scope)的 MCP 服务器反复要求登录的问题。新登录只请求缺失的 scope,导致新 Token 丢失旧 Token 已有的权限;现在会保留已授权的 scope。
  • 修复 transcript 中用户消息为每行渲染结果保留两份全宽副本的问题;现在只保留一份,输出相同。
  • 修复 /login 和 /logout 把包括 Radius 在内的所有 OAuth 登录都标成 subscription;只有订阅制 Provider 才写 "subscription",其他 OAuth 登录写 "account"。
  • 修复启动页头 logo 在 Apple Terminal 中出现空隙的问题;现在显示带版本号的彩色 "Pi"。
  • 修复 tool_search 加载的 deferred MCP 工具在 resume 和 /reload 时被丢掉的问题,即使服务器在下一次 Prompt 前已重连;原因是会话在 MCP 服务器重连前就恢复了工具。
  • 修复系统主题让 Catppuccin Frappe 等粉彩色板变得过艳;色板颜色现在保留原有色度(#10255、#10293 由 @dgtlntv 贡献)。
  • 修复输入以空白开头时斜杠命令自动补全不触发的问题(#10218 由 @haoqixu 贡献)。
  • 修复全屏模式下,带样式的 Token 刚好结束在高亮边界时,颜色会渗出鼠标选区和搜索高亮的问题(#10169)。
  • 修复 transcript 中每条已渲染消息占用的内存;一条长 assistant 消息现在大约只保留原来五分之一的堆。
Pi AI

新增

  • 为 Anthropic OAuth 添加复制验证码登录。登录时询问浏览器登录(默认)或复制验证码登录:Anthropic 页面会显示授权码,粘贴到 pi 即可,适用于浏览器在另一台机器上的场景(#10194 由 @lucasmeijer 贡献)。

变更

  • OAuth 浏览器页面改用彩色 Pi logo。

修复

  • 修复从另一 Provider 或 Radius 等网关重放 grammar 工具调用(如 codemode)时,OpenAI Responses 请求失败并报 Expected an ID that begins with 'ctc' 的问题。
Pi Agent

不兼容变更

  • 从 @earendil-works/pi-agent-core 移除实验性 harness:AgentHarness、会话和会话存储、durable runtime、pico3、harness 工具、压缩、Skill、Prompt 模板、系统 Prompt 辅助函数、telemetry schema、search service 类型,以及 uuidv7 和 pi-telemetry 的再导出。./node、./harness/* 和 ./experimental/pico3 子路径导出已移除。该包现在只包含 Agent、agent loop、proxy stream 及其类型。持久会话请使用 @earendil-works/pi-durable。
Pi TUI

新增

  • 添加 TuiAltScreen.getScreenLines(),返回上一帧已渲染的行。

修复

  • 修复全屏模式下,带样式的 Token 刚好结束在高亮边界时,颜色会渗出鼠标选区和搜索高亮的问题(#10169)。
  • 修复每条已渲染消息占用的内存:Markdown 弱引用已解析 Token,Markdown、Text 和 Box 展平缓存行。一条长 assistant 消息现在大约只保留原来五分之一的堆。
  • 修复输入以空白开头时斜杠命令自动补全不触发的问题(#10218 由 @haoqixu 贡献)。

v0.99.2(2026-09-30)

Pi Coding Agent

新功能

  • MCP 服务器不再挡路 – 默认 codemode 暴露的服务器不再出现在 codemode 描述中,也不再阻塞第一次 Prompt。它们出现在一段简短的系统 Prompt 分区里,脚本通过 searchTools() 和 describeNamespace() 查找工具。详见 控制工具暴露。
  • 更多 MCP 认证选项 – oauth.clientName 用于只接受已知 OAuth 客户端的服务器;"auth": { "provider": "<provider>" } 用 Provider 的 /login Token 认证 HTTP 服务器。详见 用 OAuth 认证。
  • Anthropic 工作负载身份联合 – 从 Anthropic SDK 环境变量读取。详见 从环境读取 API key。
  • /reload 启用新加入的工具 – 会启用 defaultTools 设置里新加入的工具。详见 工具。

新增

  • 为 MCP 服务器添加 description 字段(pi mcp add --description),随服务器出现在系统 Prompt 中,并用于 tool search 的工具排序;同时添加 describeNamespace(name) codemode 辅助函数,返回命名空间的说明和工具名。describeNamespace() 和 searchTools() 接受 mcp__dev-radius、mcp__dev_radius、dev-radius 或 dev_radius 作为命名空间。
  • 为 MCP 服务器添加 oauth.clientName 设置(pi mcp add --oauth-client-name),用于在 OAuth 客户端注册时发送的客户端名称,面向只接受已知客户端的服务器(#10226)。
  • 为 HTTP MCP 服务器添加 "auth": { "provider": "<provider>" },把 Provider 当前的 /login Token 作为 bearer Token 发送,而不走 MCP OAuth。每次请求都会读取 Token,因此 Provider 刷新会生效。仅允许出现在全局 mcp.json 和扩展中,除回环主机外必须使用 https。
  • 从 ANTHROPIC_FEDERATION_RULE_ID、ANTHROPIC_ORGANIZATION_ID 和 ANTHROPIC_IDENTITY_TOKEN_FILE 环境变量添加 Anthropic 工作负载身份联合(见 Provider)(#10177、#10242 由 @philfreo 贡献)。
  • /reload 现在会启用 defaultTools 设置里新加入的工具。从中移除的工具保持启用,会话中关掉的工具除非新加入否则保持关闭,--tools、--no-tools 和 --no-builtin-tools 仍然覆盖该设置(#10245)。

变更

  • 默认 codemode 暴露的 MCP 服务器不再出现在 codemode 描述中;脚本通过 searchTools() 查找它们。codemode-deferred 现在是 codemode 的别名。需要模型不经搜索就能看到的工具,请用 direct 暴露(#10212)。
  • codemode 描述不再包含 deferred 工具、工具数量或 MCP 服务器说明,因此 MCP 服务器连接或工具变化时描述不会变。tool_search 描述同样不再列出它能加载工具的服务器。服务器改为出现在 mcp_servers 系统 Prompt 分区,带一行摘要,每次 Prompt 开始时更新;分区有变化时会追加到对话。脚本通过 describeNamespace() 读取服务器说明(#10212)。
  • 第一次 Prompt 不再等待没有 direct 工具的 MCP 服务器。它们在后台连接,当 codemode 脚本点名它们、脚本搜索工具,或 tool_search 运行时再等待(#10212)。

修复

  • 修复新会话间歇性忽略已保存的默认模型,或在该模型属于带已存储凭证的扩展注册原生 Provider 时警告没有可用模型的问题(#9962、#10190 由 @davidbrai 贡献)。
  • 修复 /mcp 登录 URL 换行时无法点击的问题:改为像 /login 一样发出终端超链接,并附带 Cmd/Ctrl+click to open 一行(#10186)。
  • 修复 codemode image() 接受畸形 base64 数据或不支持的图片类型,导致无效图片块被持久化、之后每次 Provider 请求都 HTTP 400 失败的问题(#10215)。
  • 修复独立 Windows 可执行文件中 codemode 无法启动脚本 worker 的问题(#10204)。
  • 修复 Prompt 提交随会话变长而变慢的问题:解析会话模型选择时,曾对每条 assistant 消息查找一次模型目录(#10198)。
  • 修复带已刷新 pi.dev 目录的 Provider 模型查找变慢的问题:合并远程目录模型曾是二次时间。
  • 修复 built-in-tool-renderer.ts 和 minimal-mode.ts 扩展示例从系统 Prompt 移除内置工具摘要和指南的问题(#10072、#10193 由 @christianklotz 贡献)。
  • 修复 Z.AI 国内端点 Prompt exceeds max length 错误的上下文溢出检测(#10208)。
  • 修复工具 schema 使用 Anthropic strict tool use 拒绝的关键字(如 minimum/maximum)时 Anthropic 请求失败的问题;这类工具现在以非 strict 方式发送(#9953)。
  • 修复 Retry-After 头包含无法解析的日期时 Provider 重试立即触发的问题;现在改用指数退避(#9571)。
  • 修复扩展命令未注册字符串名称或 handler 时,输入 / 会让 pi 崩溃的问题;现在扩展会加载失败并报错(#10054)。
  • 修复折叠的 codemode 和 MCP 工具结果在输出是一行很长(例如压缩 JSON)时占满屏幕的问题。预览现在像 bash 输出一样按换行后的行数限制,而不是按逻辑行。
  • 修复 codemode.mode: "only" 在系统 Prompt 的工具列表中列出 read、bash、edit 和 write,但请求只声明 codemode 的问题(#10192)。
  • 修复两个 MCP 工具名仅 - 和 _ 不同时(如 read-file 和 read_file),codemode 脚本会调用错误工具的问题。与 Codex 一样,MCP 工具和命名空间名现在把 - 替换为 _(mcp__my-server__x 变为 mcp__my_server__x),同一服务器冲突的工具都会加哈希后缀,仅 - 和 _ 不同的服务器名会被拒绝(#10239)。
Pi AI

新增

  • 添加轻量入口 @earendil-works/pi-ai/models,用于模型集合和 Provider 构造,不加载 TypeBox、内置目录或 Provider SDK。
  • 从 Anthropic SDK 环境变量 ANTHROPIC_FEDERATION_RULE_ID、ANTHROPIC_ORGANIZATION_ID 和 ANTHROPIC_IDENTITY_TOKEN_FILE(以及可选的 ANTHROPIC_SERVICE_ACCOUNT_ID 和 ANTHROPIC_WORKSPACE_ID)添加 Anthropic 工作负载身份联合。API key 和 ANTHROPIC_AUTH_TOKEN 优先(#10177、#10242 由 @philfreo 贡献)。

修复

  • 修复 Z.AI 国内端点 Prompt exceeds max length 错误的上下文溢出检测(#10208)。
  • 修复 strict: "prefer" 工具 schema 使用 Anthropic strict tool use 拒绝的关键字(如 minimum/maximum)时 Anthropic 请求失败的问题;这类工具现在以非 strict 方式发送(#9953)。
  • 修复 Retry-After 头包含无法解析的日期时 Provider 重试立即触发的问题;现在改用指数退避(#9571)。

v0.99.1(2026-09-29)

Pi Coding Agent

新功能

  • GPT-6.1 Sol – 可在 OpenAI、Azure OpenAI 和 OpenAI Codex 上使用,现为 OpenAI Codex 的默认模型。详见 选择模型。

新增

  • 为 OpenAI、Azure OpenAI Responses 和 OpenAI Codex Provider 添加 GPT-6.1 Sol(gpt-6.1-sol)。

变更

  • 把 OpenAI Codex 默认模型改为 GPT-6.1 Sol(gpt-6.1-sol)。

修复

  • 修复打包发行版中 /login 登录 OpenAI 因缺少 openai-chatgpt.js 模块而失败的问题。
Pi AI

新增

  • 为 OpenAI、Azure OpenAI Responses 和 OpenAI Codex Provider 添加 GPT-6.1 Sol(gpt-6.1-sol)。

v0.99.0(2026-09-29)

Pi Coding Agent

新功能

  • Codemode 与 MCP – 连接 MCP 服务器,让模型运行可并行调用工具的 JavaScript。详见 MCP 服务器 和 启用 codemode。
  • System 主题 – Pi 的颜色默认来自终端自身的调色板。详见 使用终端颜色。
  • 用 ChatGPT 登录 – 通过 /login openai 用 ChatGPT 订阅使用 OpenAI Provider。详见 交互式认证。
  • 虚拟模型 – 扩展可以把每次请求路由到不同的物理模型。详见 虚拟模型。
  • Classifier 模型 – 从 codemode 脚本运行 Jev classifier,或把任意 llama.cpp 模型当 classifier 用。详见 codemode 如何工作 和 分类。

新增

  • 以内置扩展的形式添加 codemode、tool search 和 MCP 支持。codemode 工具在 QuickJS 沙箱中运行模型编写的 JavaScript 来调用 pi 的工具;用 defaultTools 或 --tools 启用,用 codemode.mode 和 codemode.inlineBudget 配置。tool_search 查找未向模型声明的工具并声明它们。stdio 或 streamable HTTP 的 MCP 服务器(支持 OAuth)来自 mcp.json(全局,或项目受信任后按项目)或 pi.registerMcpServer(),用 /mcp 和 pi mcp add|remove|list|login|logout 管理。详见 MCP 服务器 和 启用 codemode(#10040)。
  • 为扩展工具添加编排 API:exposure(direct、model-only、codemode、deferred 或 hidden)、namespace、annotations、带 structuredContent 的 outputSchema、isError 结果、prepareLoadout(),以及用于嵌套工具调用的 ctx.executeTool();嵌套调用会发出带 parentToolCallId 的事件,并作为有界 nestedCalls 记在调用方工具的结果上。详见 工具暴露。
  • 当扩展注册了与内置扩展相同的工具、命令或 flag 并替换内置扩展时,发出警告(#10174 由 @cristinaponcela 贡献)。
  • 添加实验性虚拟模型:扩展用 pi.registerVirtualModel() 注册,并为每次请求选择物理模型和 thinking 级别。页脚显示路由后的模型,/session 按物理模型列出费用,examples/extensions/jev-router.ts 用 Jev classifier 做路由。详见 虚拟模型。
  • 为 OpenAI Provider 的 /login 添加用 ChatGPT 登录,通过 ChatGPT 订阅使用 OpenAI API。Pi 在全局设置中存储稳定的 deviceId 用于此次登录,并在 bug report 中省略它。
  • 添加 system 主题(现为默认),根据终端报告的前景色、背景色和 ANSI 调色板推导 pi 的颜色,并在终端切换亮/暗时重建。详见 使用终端颜色。
  • 为主题文件添加 #rgb、oklch() 和 okhsl() 颜色以及可选的 appearance 字段,并为扩展添加 theme.style()、theme.colors 和 theme.appearance。详见 主题 和 TUI。
  • 为每个 llama.cpp chat 模型添加 classifier 模型,用 next-token 标签概率作答。详见 分类。
  • 在 OpenRouter、Cloudflare Workers AI、Vercel AI Gateway 和 OpenCode Zen 上添加 Jev classifier 模型(来自 @earendil-works/pi-ai)。
  • 添加 fullscreenWheelScrollLines 设置和 /settings 条目,用于全屏鼠标滚轮滚动。默认 "auto" 会在非本地 macOS 终端上加速快速滚轮(#9758)。
  • 为成功的 RPC prompt、steer 和 follow_up 响应添加按输入的 disposition,以及 AgentSession.steer()/followUp() 和 RpcClient.prompt()/steer()/followUp();RpcClient.prompt() 还接受 streamingBehavior(#9098、#9803)。
  • 为 ModelRuntime 添加图片生成:generateImages() 带运行时解析的认证(已存储凭证、OAuth、运行时 API key、models.json headers),以及 getModelsOfType()、getModelOfType()、getAvailableOfType()、getAllModels() 和 getAllAvailable()。OpenRouter 图片模型列在 openrouter Provider 下并共享其凭证;同一个上游 ID 可以有独立的 chat 和 image 条目。没有模型列表的 models.json Provider 和扩展注册会保留内置图片生成。扩展模型列表可以包含带判别的 chat、image 和 classifier 条目及操作实现;提供时,它们会替换该 Provider 在所有操作上的目录。面向 chat 的读取(getModels()、getAvailableSnapshot()、模型选择器)不变。
  • 为 ModelRuntime 添加 classifier 支持,包括 classify()、classifier 模型访问器、运行时解析的认证,以及内置 TypeSafe jev-latest 模型。
  • 为 pi.dev 模型目录请求添加 types=chat,image,classifier,使远程刷新覆盖所有支持的模型类型;未知类型的条目会被忽略。
  • 添加 provider_stream_event 扩展事件,用于在规范化之前观察已解析的 Provider 事件,并提供可选的 /debug-provider 示例查看器(#9784、#9901 由 @davidbrai 贡献)。
  • 在 HTML 导出中为标记为 display: false 的自定义消息添加显示/隐藏切换(H)。消息默认保持隐藏,也可以从侧边栏显示(#8896、#10020 由 @rwachtler 贡献)。
  • 为 Anthropic 添加 Claude Sonnet 5.5 支持,带自适应 thinking 和 1M 上下文窗口(来自 @earendil-works/pi-ai)。
  • 在 pi config 中添加「内置」分区,用于全局或按项目禁用内置的 mcp、llama.cpp、codemode 和 tool-search 扩展,以 -builtin:<name> 的形式存入 extensions 设置。SDK 内联扩展用 builtin: true 选择加入。
  • 为 defaultTools 设置添加 +name 和 -name 条目,无需重复默认列表即可添加或移除工具,例如 "defaultTools": ["+codemode"]。项目中的这种条目会叠加在用户设置之上。文档说明了如何在不启用 MCP 的情况下启用 codemode,以及如何从 codemode 脚本使用 Jev 等 classifier 模型。
  • 把 codemode models.classify() 调用的 Token 用量和费用计入 codemode 工具结果,从而计入会话费用;codemode 结果会显示每次调用的费用。

变更

  • 构建从 TypeScript native preview 切换到 TypeScript 7.0(ES2024 目标),并用 Node 内置的 type stripping 替代 tsx 来从源码运行(#9965)。
  • 从启动 banner 移除 [Themes] 分区。自定义主题仍可在 /settings 中使用,主题冲突仍会报告。
  • 启动 header 改为显示 pi logo 和版本,而不再显示应用名。
  • 把内置 dark 和 light 主题改为修订后的 pi 颜色,用 OKHSL 编写。
  • 亮/暗终端检测改为优先使用报告的背景色,然后是终端的亮/暗报告,最后是 COLORFGBG。首次设置不再显示检测到的外观。
  • 把 OpenAI Codex Provider 改名为 "OpenAI Codex (legacy)";OpenAI Provider 上的用 ChatGPT 登录取代它(来自 @earendil-works/pi-ai)。
  • 把 TERM=*-direct 视为 truecolor(来自 @earendil-works/pi-tui)。
  • 内置扩展和工具在错误、诊断、RPC 源信息和 bug report 中命名为 builtin:<name>(例如 builtin:mcp 和 builtin:read),不再使用 <inline:name> 和 <builtin:name>。它们的斜杠命令不再带 [t] 自动补全标签。
  • --no-extensions 也会禁用内置扩展,包括 llama.cpp Provider。用 -e builtin:<name> 显式加载其中一个,例如 pi -ne -e builtin:mcp。
  • 没有自定义 call renderer 的工具调用(包括直接 MCP 工具调用)现在会显示参数:折叠时在标题行以 key=value 显示,展开时每个参数一行 key: value。MCP 调用标题为 server/tool,结果折叠为 5 行。
  • bash 和 powershell 结构化结果(codemode 脚本会收到)现在最多保留 1 MiB 输出,而不是面向模型的 2000 行或 50KB,并添加 truncated 和 full_output_path。更长的输出保留首尾各 512 KiB。空输出是 "" 而不是 (no output)。

修复

  • 修复 X11 剪贴板文本在剪贴板所有者接受未声明的图片目标时被误识别为图片的问题(#9786)。
  • 阻止托管 git 包自动安装 Pi peer 依赖,并为在 dependencies 中列出宿主提供模块的扩展包添加警告(#9863)。
  • 修复用 -e 加载的 pinned git 扩展在 ref 变更后仍使用首次下载的 commit 的问题(#9982)。
  • 修复 RpcClient 在监听器处理事件时取消订阅会跳过下一个事件监听器的问题,这可能导致 collectEvents() 之后 waitForIdle() 超时(#9990)。
  • 修复模型对省略的 offset 和 limit 发送 null 时,整文件 read 调用渲染为 :1 的问题(#9996)。
  • 修复 pi 在首次 assistant 响应前退出时新会话丢失的问题。现在在发送第一条用户消息时创建会话文件(#10000)。
  • 修复未加载的 llama.cpp 自动加载预设用 GGUF 训练上下文覆盖缓存的运行时上下文窗口的问题(#10077、#10158 由 @cristinaponcela 贡献)。
  • 修复自定义主题忽略 terminal.trueColor 及其他终端能力覆盖、以 256 色渲染的问题(#9973、#10039 由 @christianklotz 贡献)。
  • 修复粘贴 Finder 中复制的文件时插入文件图标图片而不是文件路径的问题;bash 模式下路径会加引号(#9999、#10136 由 @christianklotz 贡献)。
  • 修复主题切换后启动 header、已加载资源和聊天通知仍保留旧颜色的问题。
  • 修复 Fireworks 默认模型指向已移除的 Kimi K2.6;现在默认使用 Kimi K3。
  • 修复 OpenCode Go 默认模型指向已移除的 Kimi K2.6;现在默认使用 Kimi K3。
  • 修复 Together 默认模型指向已移除的 Kimi K2.6;现在默认使用 Kimi K3。
  • 降低长会话流式输出和预览主题时的 CPU 占用:页脚缓存会话用量合计,折叠的 bash 结果缓存预览,sanitizeBinaryOutput() 不再把输出拆成逐字符数组。
  • 修复通过 ctx.executeTool() 调用的工具(例如来自 codemode 脚本)用量从会话费用中丢失的问题;现在会加到调用方工具的结果用量上。
  • 修复已加载 Skill 名称不含 skill 中字母时 /skill 自动补全显示为空的问题(来自 @earendil-works/pi-tui)(#9944)。
  • 修复在 (、[、{、< 或反引号等开括号后路径和 @ 自动补全不工作的问题(来自 @earendil-works/pi-tui)。
  • 修复使用 Kitty 图形协议的终端中图片被拉伸的问题(来自 @earendil-works/pi-tui)(#8938、#9957 由 @rwachtler 贡献)。
  • 修复扩展在关闭时关闭 overlay 后,退出时 shell 光标仍保持隐藏的问题(来自 @earendil-works/pi-tui)(#10026)。
  • 修复在 /settings 子菜单中鼠标点击关闭后键盘输入丢失的问题(来自 @earendil-works/pi-tui)。
  • 修复通过 Vercel AI Gateway 的 1 小时 Anthropic 缓存写入按 5 分钟费率计价的问题(来自 @earendil-works/pi-ai)(#9210)。
  • 修复直接对 OpenAI 兼容 API 调用 stream()/complete() 时丢弃模型级 samplingParams 的问题(来自 @earendil-works/pi-ai)(#9506)。
  • 修复 Mistral GLM 请求在空内容 delta 后因 "Expected at most one leading ThinkChunk" 失败的问题(来自 @earendil-works/pi-ai)(#9674)。
  • 修复 OpenAI Fast 模式请求按标准费率计价的问题(来自 @earendil-works/pi-ai)(#10034)。
  • 修复 Mistral reasoning 模型忽略请求的 thinking 级别的问题(来自 @earendil-works/pi-ai)(#9678)。
  • 修复 OpenCode Zen 和 OpenCode Go 的 qwen3.8-flash thinking 在后续轮次被重放为纯文本的问题(来自 @earendil-works/pi-ai)(#10047)。
  • 修复省略 output_index 的服务器(例如 llama.cpp)上 OpenAI Responses 流运行错乱工具调用的问题;此类流现在以错误结束(来自 @earendil-works/pi-ai)(#9974)。
  • 修复 Anthropic 和 OpenAI Codex 浏览器登录在 Provider 以授权错误重定向后无限等待,以及 Anthropic 登录在回调端口被占用时失败的问题(来自 @earendil-works/pi-ai)。
  • 修复上游模型元数据不完整时 GitHub Copilot Claude Opus 5.5 提供不支持的 thinking 级别的问题(来自 @earendil-works/pi-ai)。
Pi AI

不兼容变更

  • 把图片模型并入常规 Provider/Models 表面。独立的 ImagesModels 集合已移除:createImagesModels()、createImagesProvider()、ImagesProvider、openrouterImagesProvider()、builtinImagesProviders() 和 builtinImagesModels() 不再存在。改用 builtinModels()、models.getModelOfType("image", ...)、models.generateImages() 和 createProvider({ models, images })。现有的无限定读取仍只返回 chat 模型。
  • 图片模型现在是带必需 type: "image" 的 ImageModel,并与 chat 模型共享 BaseModel。旧的复数图片类型名(ImagesModel、ImagesApi、KnownImagesApi、KnownImagesProvider 和 ImagesProviderId)已移除。generateImages() 只接受图片模型。输出模态(output)仍只存在于图片模型上。
  • 生成的模型数据 schema 现在是版本 6:每条条目带 type,按操作划分的目录包含 chat、image 和 classifier 模型,同一个上游 ID 可以按类型有独立条目。OpenRouter 图片模型位于 openrouter.json 的 openrouter-images api 组;image-models.generated.ts 和 scripts/generate-image-models.ts 已移除。运行 npm run hydrate:model-data。

新增

  • 添加 Models.generateImages()(带 Provider 解析的认证)、Provider.generateImages?,以及按 model.api 索引的 createProvider({ images })。createProvider() 的 models 和 fetchModels 接受所有类型的模型;给定 images 或 classifiers 时 api 可选。
  • 添加可选的模型 type("chat"、"image" 或 "classifier")。Chat 模型可以省略它,因此现有 chat 模型、Provider 和 store 无需改动。用新的 isModelType() 守卫收窄混合列表,或用 getModelType() 读取有效类型。
  • 在 Models 上添加 getModelsOfType()、getModelOfType()、getAvailableOfType()、getAllModels() 和 getAllAvailable();可选的 Provider.getAllModels() 和 Provider.filterAllModels();对应的生成目录访问器;以及 AnyModel 和 ModelTypeMap 类型。hasApi()、calculateCost() 和 modelsAreEqual() 接受 AnyModel。
  • 在 ModelsStoreEntry.models 中支持所有类型的模型。存储和拉取的未知类型模型会被丢弃,而不是让刷新失败。
  • 添加 classifier 模型和 Models.classify(),采用与 Provider 无关的 JEV 风格 choice/score/bool 约定。内置 TypeSafe Provider 通过 System One API 暴露 models.dev 的 jev-latest,并把公开的 bool 问题翻译成 TypeSafe 的 noul 线格式。
  • 通过 TypeSafe 兼容的 System One 端点,在 OpenRouter 上添加 Jev classifier 模型(typesafe/jev-1.13、~typesafe/jev-latest),并在 Cloudflare Workers AI 上通过新的 cloudflare-workers-ai-system-one classifier API 添加 typesafe/jev。
  • 通过 TypeSafe 兼容的 System One 端点,在 Vercel AI Gateway 上添加 Jev classifier 模型(typesafe-ai/jev,从其评估模型目录生成)和 OpenCode Zen(jev-1.13、jev-1.13-free)。
  • 为 ClassifierResult 添加 usage:System One 分类会报告 Token 数,按模型目录像 chat 用量一样计价。
  • 为 Models 流式入口添加运行时 chat 模型检查,非 chat 模型会以明确的 ModelsError 失败,而不是缺失 api 的流错误。
  • 为生成和发布的 JSON 目录添加基于数组的 models.all.json 和 providers/{id}.all.json 变体,允许同一个上游 ID 每种模型类型出现一次;现有的键值形式 models.json 和 providers/{id}.json 对已发布客户端仍只含 chat。
  • 添加 onProviderStreamEvent,用于在规范化之前观察已解析的 Provider 流事件,包括 assistant 消息中未保留的 Provider 特定字段(#9784、#9901 由 @davidbrai 贡献)。
  • 把 Claude Sonnet 5.5 加入内置 Anthropic 模型目录,带自适应 thinking、对话中途 effort、1M 上下文和官方定价元数据。
  • 为 openai Provider 添加用 ChatGPT 登录:通过 OAuth 用 ChatGPT 订阅使用 OpenAI API。Models.login() 接受带 getDeviceId() 的 LoginOptions,为需要稳定安装 ID 的登录流程提供该 ID。订阅用量限制错误不会重试,并链接到 ChatGPT 用量页面;临时用量错误会重试。
  • 添加 llama-cpp-classify classifier API,根据 llama-server 对单 token 答案标签的 next-token 概率回答 classifier 问题。
  • 添加可选的 AssistantMessage.thinkingLevel,记录 agent loop 为该响应请求的 thinking 级别。

变更

  • 把 OpenAI Codex Provider 改名为 "OpenAI Codex (legacy)";openai Provider 上的用 ChatGPT 登录取代它。
  • 把 Anthropic、OpenAI Codex、OpenRouter 和 Radius 的浏览器登录回调服务器统一为同一套实现和相同的浏览器页面。OAuth 页面辅助函数现在可通过 @earendil-works/pi-ai/utils/oauth-page 使用。
  • Radius 浏览器登录改为在显示浏览器页面之前交换授权码,以便在浏览器中显示 token 交换失败。

修复

  • 修复 Vercel AI Gateway 在流式 delta 中报告的 1 小时 Anthropic 缓存写入按 5 分钟费率计价的问题(#9210)。
  • 修复直接对 OpenAI 兼容 API 调用 stream()/complete() 时丢弃模型级 samplingParams 的问题(#9506)。
  • 修复 Mistral GLM 模型因空内容 delta 产生空文本块和拆分 thinking 块,导致后续请求以 "Expected at most one leading ThinkChunk" 失败的问题(#9674)。
  • 修复 OpenAI Fast 模式请求在响应报告 service_tier: "fast"(GPT-6 模型会这样)时按标准费率计价的问题(#10034)。
  • 修复 Mistral reasoning 模型忽略请求的 thinking 级别的问题:GLM 5.3 现在使用 reasoning_effort 而不是 prompt_mode,GLM 5.2 接受 max,Mistral 模型只提供 API 支持的 effort 级别(#9678)。
  • 修复 OpenCode Zen 和 OpenCode Go 的 qwen3.8-flash thinking 因端点返回空 thinking 签名而在后续轮次被重放为纯文本的问题(#10047)。
  • 修复 OpenAI Responses 流把未完成的工具调用返回为可运行,导致省略 output_index 的服务器(例如 llama.cpp)运行错乱命令的问题;此类流现在以错误结束(#9974)。
  • 修复 Anthropic 和 OpenAI Codex 浏览器登录在 Provider 以授权错误重定向后无限等待的问题;现在会以 Provider 的错误描述失败。
  • 修复 Anthropic 浏览器登录在回调端口被占用时失败的问题;现在会回退到粘贴重定向 URL。
  • 修复上游模型元数据不完整时 GitHub Copilot Claude Opus 5.5 提供不支持的 thinking 级别的问题;现在提供 low 到 max。
Pi Agent

新增

  • 添加 onProviderStreamEvent agent 选项,会传给 Provider 流,用于在规范化之前观察已解析的 Provider 事件(#9784、#9901 由 @davidbrai 贡献)。
  • agent loop 现在把请求的 thinking 级别记录为每条 assistant 消息上的 thinkingLevel。
Pi TUI

不兼容变更

  • 用 TUI.queryTerminalColors() 替换 TUI.queryTerminalColorScheme() 和 TUI.queryTerminalBackgroundColor(),一次往返查询默认前景色、背景色和 16 色 ANSI(OSC 10、11 和 4),返回 TerminalColors。移除 parseOsc11BackgroundColor()。

新增

  • 为 TuiAltScreenOptions.wheelScrollLines 添加 "auto",在每次刻度发送一个事件的终端上加速快速滚轮,并添加 TuiAltScreen.setWheelScrollLines() 用于运行时更新(#9758)。
  • 添加颜色值和样式:Color 类型(索引 ANSI、sRGB 或 OKLCH),parseColor() 解析 #rgb、#rrggbb、oklch() 和 okhsl() 值,以及 indexedColor()、rgbColor()、oklchColor()、okhslColor()、mixColors()、colorToHex()、colorToRgb()、colorToOklch()、colorToOkhsl()、styleText()、getTerminalColorMode() 和相关辅助函数。
  • 添加 NativeClipboard.getFilePaths(),从 macOS 剪贴板读取文件 URL(#9999、#10136 由 @christianklotz 贡献)。

变更

  • TERM=*-direct 的终端现在检测为 truecolor。

修复

  • 修复已加载 Skill 名称不含 skill 中字母时 /skill 自动补全显示为空的问题(#9944)。
  • 修复在 (、[、{、< 或反引号等开括号后路径和 @ 自动补全不工作的问题,例如 (~/Dev<Tab>。
  • 降低使用 Kitty 图形协议的终端中图片被拉伸的程度(#8938、#9957 由 @rwachtler 贡献)。
  • 修复把鼠标事件转发给子组件的组件(例如打开了子菜单的 SettingsList)移除该子组件后键盘输入丢失的问题。
  • 修复扩展在关闭时关闭 overlay 后,退出时 shell 光标仍保持隐藏的问题(#10026)。
  • 提升带样式文本的渲染性能:visibleWidth() 对带 ANSI 样式的 ASCII 不再做 grapheme 分段,Box 检查渲染缓存时不再给每行重新 padding,Markdown 在主题和宽度变化时复用已解析的 token。

v0.87.1(2026-09-22)

Pi Coding Agent

新功能

  • 最新前沿模型 – 在支持的 Provider(包括 GitHub Copilot)上使用 Claude Opus 5.5、GPT-6 Sol 和 GPT-6 Luna。详见 选择模型。
  • xAI 默认使用 Grok 4.7 – 新建的 xAI 会话现在默认使用 Grok 4.7。详见 Provider 认证。

新增

  • 为 GitHub Copilot 添加 Claude Opus 5.5、GPT-6 Sol 和 GPT-6 Luna 支持(来自 @earendil-works/pi-ai)。
  • 为 OpenAI API key 和 OpenAI Codex 订阅添加 GPT-6 Sol 和 GPT-6 Luna 支持(来自 @earendil-works/pi-ai)。
  • 为 Anthropic 添加 Claude Opus 5.5 支持,带自适应 thinking 和 1M 上下文窗口(来自 @earendil-works/pi-ai)。

变更

  • 把 xAI 默认模型改为 Grok 4.7。

修复

  • 修复分轮压缩摘要被 Claude Fable 5.1 拒绝的问题:明确分隔对话,并使用面向续写的指令(#9908 由 @davidbrai 贡献)。
  • 修复缺失或无效的 --mode 值被静默忽略、而不是报错并以非零状态退出的问题(#9045)。
  • 修复仅含图片的用户消息因为带有空文本部分而被部分 OpenAI 兼容 Provider 拒绝的问题(来自 @earendil-works/pi-ai)(#9797)。
  • 修复 Anthropic OAuth 请求上报过期的 Claude Code 版本的问题(来自 @earendil-works/pi-ai)。
Pi AI

新增

  • 把 Claude Opus 5.5、GPT-6 Sol 和 GPT-6 Luna 加入 GitHub Copilot 目录。
  • 为 OpenAI API key 和 OpenAI Codex 订阅添加 GPT-6 Sol 和 GPT-6 Luna,带完整的 reasoning effort、Prompt 缓存、工具搜索、长上下文定价和官方成本元数据。
  • 把 Claude Opus 5.5 加入内置 Anthropic 模型目录,带自适应 thinking、1M 上下文和官方定价元数据。
  • 把 Grok 4.7 加入内置 xAI 模型目录,带长上下文定价元数据。

修复

  • 修复仅含图片的用户消息因为带有空文本部分而被部分 OpenAI 兼容 Provider 拒绝的问题(#9797)。
  • 修复 Anthropic OAuth 请求上报过期的 Claude Code 版本的问题。

v0.87.0(2026-09-21)

Pi Coding Agent

新功能

  • 规范的会话上下文与扩展边界 – 无需重写历史即可编辑模型上下文,并添加可操作的 lifecycle hook。详见 ContextEditEntry 和 扩展事件。
  • 全转录上下文扩展 – 用 context_with_system 对每次请求做系统消息转换。详见 context_with_system。
  • 按模型的图片输入限制 – 按模型为附件、read 和工具结果图片配置缓存安全的图片缩放。详见 图片输入限制。

不兼容变更

  • 移除来自 @earendil-works/pi-agent-core 的 shouldStopAfterTurn agent 选项。改用 finishTurn 并返回 { action: "end" }。finishTurn 在 turn_end 之前运行,但决策在之后生效,并且也会收到 error 和 aborted 响应;迁移时让这些硬退出返回 undefined,可保留原选项只对正常响应生效的行为。完整的迁移前后示例见 @earendil-works/pi-agent-core 的 changelog。
  • 在导出的 SessionEntry 联合类型中添加 ContextEditEntry。对条目做穷尽 switch 的 TypeScript 使用方必须处理 context_edit;省略用 replacement: null,否则传入内容替换。
  • 让 SessionManager 成为 AgentSession Provider 上下文的唯一来源。给 session.agent.state.messages 赋值不再替换后续请求历史;请用 SessionManager.inMemory(cwd, { id }, entries) 恢复、用 session.navigateTree() 导航,或通过 session.sessionManager 追加后调用 session.refreshContext()。
  • 为 TurnEndEvent 扩展必需的边界字段,并把 AgentBeforeSettleEvent 加入导出的 ExtensionEvent 联合类型。构造事件或对 ExtensionEvent 做穷尽 switch 的使用方必须处理新结构。ExtensionRunner.emit() 不再接受 turn_end;宿主集成用 emitBoundary(baseEvent, buildContext) 分发可操作的边界。
  • 把 agent_settled 处理器请求的运行推迟到所有 settled 处理器执行完。处理器仍会看到 ctx.isIdle() === true,但在同一次通知分发中不再看到可重入的 agent_start。

新增

  • 添加仅追加的模型上下文编辑。例如 sessionManager.appendContextEdit(entryId, null) 会在后续 Provider 上下文中省略一条消息,而不改动原始历史、用量或 UI 历史。
  • 添加可操作的 turn_end 和 agent_before_settle 扩展边界。返回 { entries: [...event.entries, draft], continue: true } 可按顺序持久化结构条目,并确保发出一次后续 Provider 请求,同时不改变 steering 或 follow-up 调度。
  • 添加不保留任何内容的压缩输入:sessionManager.appendCompaction(summary, null, tokensBefore) 会把压缩自身的 ID 记为保留边界。
  • 添加 context_with_system 扩展事件,它在 context 处理器之后对包含系统消息的完整转录运行,并原样发送其结果。详见 context_with_system。
  • 通过 models.json 中的 inputLimits.images.resize 添加按模型的图片缩放配置,应用于文件附件、图片读取和工具结果图片(#9631)。

修复

  • 修复字符串形式的上下文编辑替换产生无效的 assistant 与工具结果消息内容,而不是文本块的问题。
  • 修复上下文不可见的边界元数据和替换编辑导致新追加或替换的输入在首次 Provider 请求前就被摘要的问题。
  • 修复编辑后上下文的用量统计既丢弃最近一次上下文编辑之后捕获的有效 assistant 用量,又在后续压缩使其过期后复用该用量的问题。
  • 修复选定的错误重试和最终的长度/溢出恢复在后续 Provider 上下文中保留已放弃的模型尝试的问题;运行后恢复的省略现在会被持久化,同时不隐藏原始转录历史、不改变队列调度。
  • 修复过滤或截取消息的 context 处理器丢失提示与工具声明的问题,这会在扩展驱动的压缩后让请求缺少内置工具,或让 Codex 输出原始 tool-call 文本。处理器不再看到系统消息;Pi 在它们运行后恢复提示与工具状态。详见 context(#9789、#9822)。
  • 修复 /bug 在离线模式下仍允许上传的问题,同时保留本地 zip 导出(#9841 由 @christianklotz 贡献)。
  • 修复空闲 Prompt 缓存预热在定时器或扩展决策延迟时重建已过期缓存的问题。
  • 改进崩溃诊断,添加提示以识别出现在堆栈跟踪中的已加载扩展。
  • 修复以 GIF 开头的文本文件被误判为图片并从 read 和 CLI @file 输入中省略的问题(#9755)。
  • 修复格式错误的 Prompt 模板 frontmatter 被静默忽略、而不是作为资源警告上报的问题(#9830 由 @christianklotz 贡献)。
  • 修复来自 @earendil-works/pi-ai 的未知 OpenAI 兼容 Chat Completions 端点收到严格工具 Schema 的问题,除非它们明确声明支持(#9816)。
Pi AI

新增

  • 在生成的目录中添加模型图片输入限制和缓存安全的缩放元数据(#9631)。

修复

  • 修复未知 OpenAI 兼容 Chat Completions 端点收到严格工具 Schema 的问题,除非它们明确声明支持,同时为支持的内置模型保留严格工具(#9816)。
Pi Agent

不兼容变更

  • 移除 AgentOptions.shouldStopAfterTurn 和 AgentLoopConfig.shouldStopAfterTurn。改用 finishTurn 并返回 { action: "end" },在完成的 turn 之后停止。finishTurn 在 assistant 与所有工具结果定稿之后、turn_end 之前运行,其决策在 turn_end 之后生效,并且也会对 error 和 aborted 响应运行——这些响应的决策会被忽略,因为它们仍是硬退出。原选项只对正常响应调用,迁移时给硬退出返回 undefined 可保留该行为。返回 { action: "end" } 不会改动 steering 与 follow-up 队列,并跳过 prepareNextTurn。

新增

  • 添加 prepareRequest,它在每次 Provider 请求(包括第一次)之前运行。例如返回 { context: { ...context, messages: persistedMessages } },可在已选定的输入发出后安装规范上下文,而不引入额外的队列轮询。
  • 添加 finishTurn,它在 assistant 与工具结果定稿之后、turn_end 之前运行,适用于正常、error 和 aborted 响应。返回 { action: "end" } 可在 turn_end 后结束正常运行,返回 undefined 保持常规调度。{ action: "continue" } 确保发出一次后续 Provider 请求:已有的工具结果、steering 或 follow-up 调度可以满足该请求而不额外增加一次;否则循环会发出一次仅上下文的请求。error 和 aborted 响应仍是硬退出。
  • 添加 Agent.peekQueuedMessages(),可在不消费的情况下预览下一次队列选中的批次。

修复

  • 修复 harness 读取把以 GIF 开头的文本文件误判为图片的问题(#9755)。

v0.86.1(2026-09-20)

Pi Coding Agent

新功能

  • Meta Muse Provider – 用 /login meta 以 Meta 账号登录,或使用 META_API_KEY 访问 Muse Spark 模型。详见 Meta(Muse 订阅)。

新增

  • 添加通过 /login meta 的 Meta(Muse 订阅)登录,Model API Key 自动刷新,并支持 META_API_KEY(#9096 由 @xl0 贡献)。

变更

  • 在加载打包的 CLI 运行时之前启用 Node 的持久编译缓存,缩短重复启动时间。

修复

  • 修复 /bug 的描述丢失粘贴诊断信息中换行的问题。
  • 修复用户取消和可重试的 Provider 故障(如服务不可用)时仍显示 /bug 提示的问题。
  • 修复没有 WSLg 的容器和 WSL 中剪贴板复制失败的问题:在没有可用显示时恢复 OSC 52 回退,并为 WSL 添加经过验证的 Windows 剪贴板 backend(#9688)。
  • 修复来自 @earendil-works/pi-ai 的 z.ai Prompt too long 错误未被识别为上下文溢出的问题(#9805)。
  • 修复来自 @earendil-works/pi-ai 的 Cerebras 模型声明不受支持的严格工具 Schema,导致严格与非严格工具混用时出现 HTTP 400 错误的问题(#9804 由 @EdenGottlieb 贡献)。
Pi AI

新增

  • 添加 Meta Provider(Model API Key 和 Muse 订阅 OAuth),带 Muse Spark 模型(#9096 由 @xl0 贡献)。

修复

  • 修复 z.ai Prompt too long 错误未被识别为上下文溢出的问题(#9805)。
  • 修复 Cerebras 模型声明不受支持的严格工具 Schema,导致严格与非严格工具混用时出现 HTTP 400 错误的问题(#9804 由 @EdenGottlieb 贡献)。

v0.86.0(2026-09-19)

Pi Coding Agent

新功能

  • Prompt 缓存预热 – 用成本感知的刷新在长时间工具运行期间保持有价值的 Prompt 缓存存活,也可选择在空闲时保持。详见 缓存预热。
  • Bug 上报 – 用 /bug 上报问题,可附带脱敏诊断信息、可选的转录或导出的 ZIP 归档。详见 上报 Bug。
  • 感知转录的 Prompt 与工具更新 – 在恢复会话和分支导航后保留指令与工具的变更,同时保留缓存前缀。详见 before_agent_start。
  • 离线 Radius 模型目录 – 可立即选择 Radius 模型,并在可用时叠加缓存的与实时的目录。详见 Radius。
  • 按模型的压缩预算 – 按模型配置保留 Token 与近期 Token 预算。详见 按模型覆盖。

不兼容变更

  • 将来自 @earendil-works/pi-ai 的 Provider 流输入从 Context 改为规范化的 TranscriptContext 值。自定义 Provider 必须通过 getCurrentSystemPrompt() 和 getCurrentTools() 从 context.messages 读取系统提示和工具声明。详见 自定义流式 API。
  • 将来自 @earendil-works/pi-ai 的 ToolCall.arguments 和 ToolResultMessage.details 限制为 JSON 兼容值,把 ToolResultMessage 改为条件类型,并使 JsonValue 数组只读。
  • user_bash 现在失败即关闭:出错或定义的结果无效时会中止命令,不再调用后续处理器或在本地执行。返回 undefined 继续传播;否则返回 { operations } 或 { result }(#9068)。

新增

  • 添加基于转录的会话中途系统提示与工具变更,使指令和工具的更新在恢复会话和分支导航后仍然生效,并在支持的模型上保留缓存前缀。详见 before_agent_start 和 条目类型(#9548)。
  • 为 Fireworks Messages 模型添加来自 @earendil-works/pi-ai 的原生延迟工具加载。使用 ToolSearch 或 tool_search 作为加载器名称来延迟 Prompt 前缀(#9323)。
  • 为分支摘要、压缩摘要和 Skill 调用条目添加点击展开/收起。
  • 添加公开的 Radius 模型目录,用于即时和离线的模型选择,并在可用时叠加缓存的与实时的网关目录。
  • 添加 ctx.modelRegistry.stream() 和 streamSimple(),让扩展能通过已配置的 Provider 发起模型调用,并完成认证解析(#8964)。
  • 通过 compaction.modelOverrides 添加按模型的 reserveTokens 和 keepRecentTokens 设置,并以常规压缩设置作为回退(#8133)。
  • 添加 compat.allowedFallbackModels 配置,用于覆盖或禁用 Anthropic 服务端回退模型(#9294)。
  • pi.on() 现在返回取消订阅函数,扩展可以移除事件处理器。分发期间添加或移除的处理器对后续分发生效,不影响当前分发(#8967)。
  • 导出此前从包入口点遗漏的扩展 hook 事件与结果类型(#9642)。
  • 添加 /bug [description],用于向 Pi 开发者上报 bug。报告会打包环境、模型、Provider、扩展和设置元数据(密钥已脱敏)、会话中的助手消息诊断信息,以及可选的会话转录;若不上传转录,则改为由模型撰写一段问题摘要。报告会上传到 Radius(无需登录;登录后会归属到你的账号),也可以导出为 zip 归档,报告 id 会作为 pi.bug-report 条目记入会话。崩溃会记录到 ~/.pi/agent/crashes.json,下次启动时提示一次,并附加到下一次报告;无法解释的错误和重试次数耗尽每会话会提示一次 /bug。
  • 添加成本感知的 Prompt 缓存预热,在长时间工具运行期间进行,可选在空闲时也进行,支持可配置模式、模型缓存生命周期元数据、/session 诊断、转录提示和 cache_warming_decision 扩展事件。详见 缓存预热(#9668)。

变更

  • 让 --resume 的会话结果逐步显示:用文件修改时间优先加载所有目录,并在选择后取消尚未完成的转录读取。
  • 通过按修改时间顺序检查候选会话头部、找到最新匹配会话后停止,缩短 --continue 的启动时间。
  • 用内置的 macOS、Windows 和 X11 异步辅助程序替换外部原生剪贴板依赖,同时保留平台命令和 OSC 52 回退(#9163)。
  • 用原生子串搜索代替在 JavaScript 中逐字符扫描,降低模糊搜索在长文本上的延迟(来自 pi-tui)(#9267)。
  • 将压缩、分支摘要和重试的 spinner 移入编辑器边框,与工作指示器并列。自定义编辑器对所有状态 spinner 使用相同的嵌入选项。
  • 内置 read、bash、powershell、edit 和 write 工具默认启用 strict-prefer JSON-schema 采样,不再需要 PI_EXPERIMENTAL。扩展可以用 constrainedSampling: false 重新注册工具定义。
  • Bash 和 PowerShell 工具耗时达到一分钟以上时改用「分:秒」格式,必要时显示小时(#9628)。
  • 将扩展编译器和内置虚拟模块推迟到加载文件系统扩展时,降低 SDK 的基线导入开销(#9540)。

修复

  • 修复 GitHub Copilot GPT 模型(包括 GPT-6 Astra)使用 Chat Completions 适配器而非所需的 Responses 适配器的问题(#9253 由 @petrroll 贡献)。
  • 修复来自 @earendil-works/pi-ai 的 OpenRouter 和 OpenCode Go 上 DeepSeek V4.1 thinking 等级丢失 Provider effort 元数据的问题(#9485)。
  • 修复来自 @earendil-works/pi-ai 的无正文 HTTP 400/413 错误(非 Cerebras Provider)被误判为上下文溢出的问题(#9482)。
  • 修复来自 @earendil-works/pi-ai 的 Vercel AI Gateway 将未签名 thinking 作为助手文本重放的问题(#9676)。
  • 修复来自 @earendil-works/pi-ai 的 Google Generative AI 和 Vertex AI 在省略 reasoning 或同一 Gemini 系列内模型能力不同时使用不支持的 thinking 等级的问题(#9455)。
  • 修复来自 @earendil-works/pi-ai 的 Anthropic 兼容中继在返回模型不同时破坏签名 thinking 重放的问题,同时保留回退计价(#9188)。
  • 修复来自 @earendil-works/pi-ai 的 Amazon Bedrock 一小时缓存写入按五分钟费率计价的问题(#9457)。
  • 修复来自 @earendil-works/pi-ai 的排空缓冲 EventStream 事件时的二次方 CPU 占用(#9055)。
  • 修复来自 @earendil-works/pi-ai 的 Mistral Medium reasoning 请求对所有支持 reasoning 的 mistral-medium-* 模型 ID 使用 reasoning_effort,而不是不受支持的 prompt_mode(#8700)。
  • 修复来自 @earendil-works/pi-ai 的 OpenCode 和 OpenCode Go 请求在所有支持的 API 适配器上从 sessionId 发送 x-opencode-session(#9326)。
  • 修复来自 @earendil-works/pi-ai 的 OpenAI Codex 请求发送模型的 Off reasoning 等级而不是省略它,同时遵守不支持 Off 映射的情况(#9191)。
  • 修复来自 @earendil-works/pi-ai 的 Fireworks 未签名 thinking 重放和 reasoning 等级选择,改用目录元数据,并验证了 DeepSeek V4 和 Qwen3.8 的回退、移除了冗余的 GLM 5.2 和 Kimi K3 effort 别名(#9323)。
  • 修复来自 @earendil-works/pi-ai 的 OpenRouter 请求在启用 Prompt 缓存时,为 Chat Completions 和 Anthropic Messages 模型从 sessionId 发送 x-session-id(#9102)。
  • 修复来自 @earendil-works/pi-ai 的 DeepSeek 目录:为 DeepSeek V4.1 Flash 声明 deepseek-flash 以替代已停用的 Flash 别名,并刷新 DeepSeek 定价元数据(#9423)。
  • 修复来自 @earendil-works/pi-ai 的 Mistral 托管的 GLM-5.2 reasoning 请求改用 reasoning_effort,而不是被忽略的 prompt_mode(#9375)。
  • 修复来自 @earendil-works/pi-ai 的 OpenAI 兼容 Responses 错误识别实际 Provider,而不是一律标记为 OpenAI 错误(#9298)。
  • 修复来自 @earendil-works/pi-ai 的 Baseten 请求从 sessionId 发送会话亲和性请求头,以支持自动 Prompt 缓存路由(#9629)。
  • 修复来自 @earendil-works/pi-ai 的 Cloudflare 520 响应的重试分类(#9627)。
  • 修复来自 @earendil-works/pi-ai 的 Azure 峰值负载临时容量错误的重试分类(#9669)。
  • 修复会话树导航与进行中的压缩竞争并替换其进度 UI 的问题(#9179 由 @acmerfight 贡献)。
  • 修复精确会话 ID 查找扫描完整转录正文而不是读取会话头部的问题(#9601 由 @metaist 贡献)。
  • 修复对同一批被丢弃的块重复显示 Anthropic thinking 丢弃提示的问题,并缩短提示,同时把详情保留在会话中(#9391)。
  • 修复运行中途的阈值压缩静默跳过超大尾部工具结果的问题(#9740)。
  • 修复被信号终止的本地 shell 命令被报告为成功并带部分输出的问题(#9577 由 @BrendanJMurphy 贡献)。
  • 修复终端忽略 OSC 52 回退写入时本地剪贴板失败仍报告成功的问题,并在没有可用剪贴板 backend 时添加平台相关的设置指引(#9618)。
  • 将 agent 级重试退避上限设为 retry.maxAgentDelayMs(默认 60 秒),使长时间的持续瞬时故障期间重试仍保持响应(#8826)。
  • 修复直接 RPC steer 和 follow_up 命令绕过扩展 input 处理器的问题(#8718)。
  • 修复登录后因未等待目录发现而过早报模型缺失的问题。Radius 现在默认使用 balanced,必要时回退到第一个可用的 Radius 模型。
  • 修复全屏模式下为渲染零行的自定义 footer 预留空行的问题(#8919)。
  • 修复没有参数 Schema 的扩展工具在注册时才被拒绝,而不是破坏 Provider 请求(#9300)。
  • 修复在带会话中途系统消息的模型上,before_agent_start 处理器返回 systemPrompt(以及 forceSystemPrompt)的行为:强制提示现在作为 Provider 的前置系统提示发送,而不是在原始提示之后追加为区块补丁。
  • 修复加载的 llama.cpp 模型在 enable_thinking 对话模板下忽略 Pi thinking 等级的问题(#9528)。
  • 修复取消竞态可能启动自动压缩、留下过期重试状态,或在等待摘要认证时错过取消的问题(#9340、#9777)。
  • 修复异步 Kitty 图片转换替换较新的部分工具输出图片的问题(#8743 由 @wutongyuonce 贡献)。
  • 修复来自 pi-tui 的 Skill 斜杠命令自动补全按 skill: 前缀而不是裸 Skill 名排序的问题(#9120 由 @yearth 贡献)。
  • 修复来自 pi-tui 的文件自动补全边界和 CJK 标点附近的路径引用问题(#9746 由 @haoqixu 贡献)。
  • 修复来自 pi-tui 的 LaTeX 旧式字体切换回退为原始源码、cases 布局未围绕周围公式居中,以及不支持的和嵌套的显示脚标竖直排布的问题(#8827、#9564、#7929)。
  • 修复来自 pi-tui 的全屏 Kitty 图片在 WezTerm 中被后续行清除擦除的问题(#9169)。

移除

  • 在 GPT-5.4 和 GPT-5.4 mini 不可用后,从 OpenAI Codex 选择中移除这两个模型(来自 @earendil-works/pi-ai)(#9394)。
Pi AI

不兼容变更

  • 将面向 Provider 的 ProviderStreams 和 StreamFunction 输入从 Context 改为规范化的 TranscriptContext 值。系统提示和工具声明现在位于转录系统消息中;自定义 Provider 必须用 getCurrentSystemPrompt() 和 getCurrentTools() 读取它们。详见 系统消息。
  • 将 ToolCall.arguments 和 ToolResultMessage.details 限制为 JSON 兼容值,把 ToolResultMessage 改为条件类型,并使 JsonValue 数组只读。

新增

  • 添加基于转录的会话中途系统提示与工具变更,在支持的模型上原生重放,其他 Provider 则自动折叠。详见 系统消息(#9548)。
  • 添加生成的公开 Radius 模型目录,用于同步 API 查询,并在运行时叠加缓存的与实时的网关目录。
  • 为 Fireworks Messages 模型启用原生延迟工具加载。使用 ToolSearch 或 tool_search 作为加载器名称来延迟 Prompt 前缀(#9323)。
  • 添加 RetryPolicy.maxAgentDelayMs 支持,用于限制摘要调用的共享助手重试退避(#8826)。
  • 添加 Model.promptCache 生命周期元数据,用于短期和长期保留档位,以支持 Prompt 缓存预热的决策(#9668)。

修复

  • 修复 GitHub Copilot GPT 模型(包括 GPT-6 Astra)使用 Chat Completions 适配器而非所需的 Responses 适配器的问题(#9253 由 @petrroll 贡献)。
  • 修复 OpenRouter 和 OpenCode Go 上 DeepSeek V4.1 thinking 等级丢失 Provider effort 元数据的问题(#9485)。
  • 修复无正文 HTTP 400/413 错误(非 Cerebras Provider)被误判为上下文溢出的问题(#9482)。
  • 修复 Vercel AI Gateway 将未签名 thinking 作为助手文本重放的问题(#9676)。
  • 修复 Google Generative AI 和 Vertex AI 在省略 reasoning 或同一 Gemini 系列内模型能力不同时使用不支持的 thinking 等级的问题(#9455)。
  • 修复 Anthropic 兼容中继在返回模型不同时破坏签名 thinking 重放的问题,同时保留回退计价(#9188)。
  • 修复 Amazon Bedrock 一小时缓存写入按五分钟费率计价的问题(#9457)。
  • 修复排空缓冲 EventStream 事件时的二次方 CPU 占用(#9055)。
  • 修复 Mistral Medium reasoning 请求对所有支持 reasoning 的 mistral-medium-* 模型 ID 使用 reasoning_effort,而不是不受支持的 prompt_mode(#8700)。
  • 修复 OpenCode 和 OpenCode Go 请求在所有支持的 API 适配器上从 sessionId 发送 x-opencode-session(#9326)。
  • 修复 OpenAI Codex 请求发送模型的 Off reasoning 等级而不是省略它,同时遵守不支持 Off 映射的情况(#9191)。
  • 修复 Fireworks 未签名 thinking 重放和 reasoning 等级选择,改用目录元数据,并验证了 DeepSeek V4 和 Qwen3.8 的回退、移除了冗余的 GLM 5.2 和 Kimi K3 effort 别名(#9323)。
  • 修复 OpenRouter 请求在启用 Prompt 缓存时,为 Chat Completions 和 Anthropic Messages 模型从 sessionId 发送 x-session-id(#9102)。
  • 修复 DeepSeek 目录:为 DeepSeek V4.1 Flash 声明 deepseek-flash 以替代已停用的 Flash 别名,并刷新 DeepSeek 定价元数据(#9423)。
  • 修复 Mistral 托管的 GLM-5.2 reasoning 请求改用 reasoning_effort,而不是被忽略的 prompt_mode(#9375)。
  • 修复 OpenAI 兼容 Responses 错误识别实际 Provider,而不是一律标记为 OpenAI 错误(#9298)。
  • 修复 Baseten 请求从 sessionId 发送会话亲和性请求头,以支持自动 Prompt 缓存路由(#9629)。
  • 修复 Cloudflare 520 响应的重试分类(#9627)。
  • 修复 Azure 峰值负载临时容量错误的重试分类(#9669)。

移除

  • 在 GPT-5.4 和 GPT-5.4 mini 对 ChatGPT 账号不可用后,从 OpenAI Codex 目录中移除这两个模型(#9394)。
Pi TUI

新增

  • 通过导出的 getNativeClipboard() API 添加内置的 macOS、Windows 和 X11 异步原生剪贴板读取器,替换消费方使用的外部原生剪贴板依赖(#9163)。

变更

  • 用原生子串搜索代替在 JavaScript 中逐字符扫描,降低模糊搜索在长文本上的延迟(#9267)。

修复

  • 修复 LaTeX 旧式字体切换回退为原始源码、cases 布局未围绕周围公式居中,以及不支持的和嵌套的显示脚标竖直排布的问题(#8827、#9564、#7929)。
  • 修复全屏剪贴板失败时把可操作的 backend 错误信息藏在通用提示之后的问题,并把失败提示延长到五秒(#9618)。
  • 修复全屏 Kitty 图片在 WezTerm 中被后续行清除擦除的问题(#9169)。
  • 修复 Skill 斜杠命令自动补全按 skill: 前缀而不是裸 Skill 名排序的问题(#9120 由 @yearth 贡献)。
  • 修复文件自动补全边界和 CJK 标点附近的路径引用问题(#9746 由 @haoqixu 贡献)。

v0.85.1(2026-09-05)

Pi Coding Agent

新功能

  • GPT-6 Astra – 可通过 OpenAI API Key 和 OpenAI Codex 订阅使用。详见 API Key 和 OpenAI Codex。

新增

  • 添加 GPT-6 Astra 支持,适用于 OpenAI API Key 和 OpenAI Codex 订阅。
  • 在全屏模式下按住 Alt 时提供 5 倍速滚轮滚动(#9166 由 @xl0 贡献)。

修复

  • 修复模型和 thinking 选择器中可配置的保存快捷键(#9149 由 @rwachtler 贡献)。
  • 修复因 0.85.0 意外发布内部实验性代码和依赖项导致的 SDK 导入失败。实验性的 client 和 experimental/plugin 子路径以及 server/client 命令现仅可通过 pi-test.sh 从源码运行;受支持的本地 SDK 和 stdio RPC API 保持不变(#9132)。
  • 修复鼠标悬停改变选中项并重新居中自动补全和设置列表,导致点击命中不同条目的问题。
  • 修复 GPT-5.6+ Responses 模型的长 Prompt 缓存请求,改用 prompt_cache_options.ttl: "30m" 而非 prompt_cache_retention: "24h"。
Pi AI

新增

  • 添加 GPT-6 Astra 支持,适用于 OpenAI API Key 和 OpenAI Codex 订阅。

修复

  • 修复 GPT-5.6+ Responses 模型的长 Prompt 缓存请求,改用 prompt_cache_options.ttl: "30m" 而非 prompt_cache_retention: "24h"。
Pi TUI

新增

  • 在全屏模式下按住 Alt 时提供 5 倍速滚轮滚动(#9166 由 @xl0 贡献)。

修复

  • 修复鼠标悬停改变选中项并重新居中自动补全和设置列表,导致点击命中不同条目的问题。

v0.85.0(2026-09-04)

Pi Coding Agent

新功能

  • 持久化 Claude thinking 强度 – 受支持的 Anthropic 传输会保留每轮 effort,并能从签名 thinking 不匹配中安全恢复。详见 模型配置。
  • 全屏转录控制 – 从已滚动的转录直接跳转到最新消息,并使用内置的工作指示器。详见 TUI 全屏视口。
  • 可恢复的内存会话 – 通过 SDK 恢复保存在外部存储的会话条目。详见 会话管理。

新增

  • 添加 SessionManager.inMemory() 支持恢复外部管理的会话条目(#8980 由 @y-nk 贡献)。
  • 添加 OpenAI 兼容的 vllmPriority 和 supportsMaxOutputTokens 模型设置,用于 vLLM 调度器优先级和 OpenAI Responses 输出 Token 限制(#9004 由 @AppleDannyClegg 贡献,#8941 由 @scturtle 贡献)。
  • 添加用于关系代数连接符号的 LaTeX 渲染(来自 pi-tui)(#9050 由 @haoqixu 贡献)。
  • 在全屏转录向上滚动时,添加带有 tui.altScreen.bottom 快捷键提示的可点击「Jump to latest message」标签(#9080 由 @rwachtler 贡献)。

变更

  • 将流式工作指示器移入默认编辑器边框,并使其默认 spinner 和标签匹配 thinking 级别的边框颜色。自定义编辑器默认保留独立指示器行,除非选择嵌入(#8799 由 @cristinaponcela 贡献)。
  • 通过缓存未变更的搜索结果、索引 ASCII 连续片段并将高亮计算限制在可见匹配项,降低大转录上全屏转录搜索的延迟(来自 pi-tui)(#8800 由 @cristinaponcela 贡献)。

修复

  • 修复 Linux musl 系统上托管的 fd 和 ripgrep 下载(#9070 由 @Charlie0113-T 贡献)。
  • 从 /model 中移除不可用的 Grok Build 0.1 模型(来自 @earendil-works/pi-ai)(#9093 由 @Jaaneek 贡献)。
  • 修复 Provider 流发出不兼容事件序列和自定义 tool-call 增量的问题(来自 @earendil-works/pi-ai)。
  • 恢复 @earendil-works/pi-coding-agent/client 兼容性入口点。
  • 修复千问 Token Plan 个人目录以包含 Qwen3.8 Flash(来自 @earendil-works/pi-ai)(#9021)。
  • 修复 OpenAI Codex SSE 解析以处理未跟随空行的终端事件(来自 @earendil-works/pi-ai)(#9047)。
  • 修复 GitHub Copilot Claude Fable 5 请求以发送所选 reasoning 级别(来自 @earendil-works/pi-ai)(#8961)。
  • 修复 Baseten GLM-5.2 模型错误声明图片输入支持的问题(来自 @earendil-works/pi-ai)(#8293 由 @Panoplos 贡献)。
  • 修复当 Bash 是唯一启用的工具时 Skill 不可用的问题(#8552 由 @xl0 贡献)。
  • 修复并发会话共享互相覆盖的问题(#8613 由 @wutongyuonce 贡献)。
  • 修复图片方向检测在非 EXIF APP1 段后跳过 EXIF 数据的问题(#8616 由 @wutongyuonce 贡献)。
  • 修复导入会话覆盖同文件名现有会话的问题(#8985 由 @wutongyuonce 贡献)。
  • 修复会话分支丢失压缩边界的问题(#8990 由 @acmerfight 贡献)。
  • 修复活跃轮次结算前内存会话分支的问题(#8937 由 @acmerfight 贡献)。
  • 修复 Fireworks GLM 模型使用错误 API 适配器的问题(来自 @earendil-works/pi-ai)。
  • 修复根域名和子域名的 NO_PROXY 匹配(来自 @earendil-works/pi-ai)(#8737 由 @MeiSiristhebest 贡献)。
  • 修复 bash、edit、find、grep、ls、read 和 write 工具忽略 ctx.cwd 的问题(#8627 由 @vmizg 贡献)。
  • 修复在拒绝 SIGWINCH 自身信号的受限 seccomp 策略下的终端启动问题(来自 pi-tui)(#8898 由 @bartlomiejkida 贡献)。
  • 修复 Zed 终端图片能力检测(来自 pi-tui)(#8828 由 @Perlence 贡献)。
  • 修复拖拽选择跨越全屏编辑器继续选中的问题。
  • 修复托管的 fd 和 ripgrep 下载依赖 GitHub Releases API 的问题(#8708 由 @Terminator666666 贡献)。
  • 修复当 reasoning 耗尽此前 2048 Token 输出上限时分支摘要失败的问题(#8845)。
  • 修复 write 工具将 UTF-16 code unit 计数报告为字节计数的问题,移除了该误导性计数(#8979)。
  • 修复代理明文 HTTP Provider 请求在 tool call 后挂起的问题,改为使用 CONNECT 隧道代理(#8134)。
  • 修复 RPC abort 在未取消正在进行的手动压缩时就报告成功的问题(#8920)。
Pi AI

不兼容变更

  • 针对 Cloudflare Workers AI 绑定,将 createGatewayBindingFetch() 替换为 createAiBindingFetch()。直接配置模型的 Workers AI Gateway 透传 baseUrl;请求现在不经修改直接穿过绑定(#8287 由 @Maximo-Guk 贡献)。

新增

  • 通过 AssistantMessageFrameEncoder 和 reduceAssistantMessageFrames() 添加了紧凑、可持久化的助手消息帧。
  • 添加 OpenAI 兼容模型设置 vllmPriority,用于将调度优先级转发给 vLLM(#9004 由 @AppleDannyClegg 贡献)。
  • 添加 supportsMaxOutputTokens OpenAI Responses 兼容性设置(#8941 由 @scturtle 贡献)。
  • 为 uuidv7() 添加可选的时间戳参数以用于 follower ID。
  • 添加 api、providers 和 utils 窄化子路径导出,支持直接导入而无需加载顶层 package barrel。
  • 为 Anthropic Messages 传输(包括 OpenRouter)下受支持的 Claude 模型添加 Anthropic 每轮 effort 持久化、确定性历史 effort 标记和签名 thinking 不匹配恢复。

修复

  • 从内置 xAI 目录中移除不可用的 Grok Build 0.1 模型(#9093 由 @Jaaneek 贡献)。
  • 修复助手消息帧保留 Provider 原生 thinking 级别的问题。
  • 修复简单 Provider 流以一致发出标准流事件和自定义 tool-call 增量。
  • 修复千问 Token Plan 个人目录以包含 Qwen3.8 Flash(#9021)。
  • 修复 Baseten GLM-5.2 模型错误声明图片输入支持的问题(#8293 由 @Panoplos 贡献)。
  • 修复 Fireworks GLM 模型使用错误 API 适配器的问题。
  • 通过直接定义导出的 JsonValue 类型,移除了 pi-ai 对 Chord 的不必要依赖。
  • 修复 GitHub Copilot Claude Fable 5 请求使用 Anthropic Messages 适配器以发送所选 reasoning 级别(#8961)。
  • 修复 OpenAI Codex SSE 解析以处理未跟随空行的终端事件(#9047)。
  • 修复根域名和子域名的 NO_PROXY 匹配(#8737 由 @MeiSiristhebest 贡献)。
Pi Agent

修复

  • 修复代理助手响应丢失持久化 Provider 原生 thinking 级别的问题。
  • 修复 write 工具将 UTF-16 code unit 计数报告为字节计数的问题,移除了该误导性计数(#8979)。
Pi TUI

不兼容变更

  • 从 pi-tui 中移除了 coding-agent 环境变量默认值。应用程序必须通过渲染器构造函数和 setClearOnShrink() 配置硬件光标和缩小时清屏行为。PI_DEBUG_REDRAW 现更名为 PI_TUI_DEBUG_REDRAW;调试和崩溃日志文件名现在使用 pi-tui- 前缀。未提供日志目录时,重绘日志记录被禁用,崩溃转储写入操作系统临时目录(#8699 由 @geraschenko 贡献)。

新增

  • 添加 TuiAltScreen scrollToEndIndicator 选项,当 follow-end 主滚动视图离开末尾滚动时在其上渲染可点击的跳转到末尾标签(#9080 由 @rwachtler 贡献)。
  • 添加用于关系代数连接符号的 LaTeX 渲染(#9050 由 @haoqixu 贡献)。

变更

  • 变更 Loader 动画和编辑器集成以支持嵌入式工作指示器(#8799 由 @cristinaponcela 贡献)。
  • 通过缓存未变更的搜索结果、索引 ASCII 连续片段并将高亮计算限制在可见匹配项,降低大转录上全屏转录搜索的延迟(#8800 由 @cristinaponcela 贡献)。

修复

  • 修复拖拽选择跨越编辑器继续选中的问题。
  • 修复在拒绝 SIGWINCH 自身信号的受限 seccomp 策略下的终端启动问题(#8898 由 @bartlomiejkida 贡献)。
  • 修复 Zed 终端图片能力检测(#8828 由 @Perlence 贡献)。

v0.84.4(2026-08-28)

Pi Coding Agent

新功能

  • 终端能力覆盖 – 覆盖自动检测的终端超链接、图片和 truecolor 支持。详见 能力覆盖。
  • 扩展 UI prompt 事件 – 集成可以区分活动 agent 工作与等待 ctx.ui prompts 的时间。详见 扩展 UI prompt 事件。
  • RPC 队列清空 – 使用 clear_queue 检索并清空排队的 steering 和 follow-up 消息。详见 RPC clear_queue。
  • 全屏选择复制控制 – 在全屏模式下禁用自动选择复制,并使用 Ctrl+X 复制活动选择。详见 UI 与显示。
  • DeepSeek V4 Flash Vision(实验性) – 通过内置的 DeepSeek provider 使用视觉能力模型。详见 API Keys。

新增

  • 添加了 ui_prompt_start 和 ui_prompt_end 扩展事件,使宿主集成能够区分活动 agent 工作与等待用户端 ctx.ui prompts(#8355 由 @cristinaponcela 贡献)。
  • 添加 detectSupportedImageMimeTypeFromFile() 到公共库导出(#8600 由 @xl0 贡献)。
  • 添加实验性视觉能力 deepseek-v4-flash-vision-exp 模型支持(来自 @earendil-works/pi-ai)。
  • 在启用缓存未命中通知时,为压缩和分支摘要添加转录用量通知。
  • 添加 RPC clear_queue 来检索并移除排队的 steering 和 follow-up 消息(#8432)。
  • 添加环境变量和高级设置,用于覆盖自动检测的终端超链接、图片和 truecolor 能力(#8665)。
  • 添加 fullscreenCopyOnSelect 来禁用自动全屏选择复制;禁用时,Ctrl+X 复制活动文本选择(先于回退到最后一条助手消息),而 /tree 仍复制所选消息(#7720)。

修复

  • 修复切换 thinking 可见性清除正在运行的 Bash 工具的 partial 输出(#8611)。
  • 修复 Windows shell 在 PATH 上不可用 taskkill.exe 时中止导致 Pi 崩溃(#6596)。
  • 修复恢复的会话在其 JSONL 文件缺少末尾换行时损坏下一个追加条目(#8345)。
  • 修复 agent 运行时发送的 triggerTurn: false 扩展消息被插入到 tool call 与其结果之间,导致验证消息顺序的 provider 拒绝重放历史;现在会在本轮 tool 结果就绪后追加(#8537)。
  • 修复压缩和分支摘要强制设置 toolChoice: "none"(#8649、#8638)。
  • 修复超过自动压缩阈值的大 tool 结果在压缩前就发给 provider 的问题;Pi 现在会在同一轮中于 tool 执行和下一次助手响应之间压缩,并在运行恢复时恢复交互进度(#6879)。
  • 修复 Google Vertex 请求在打包的 Node.js 运行时使用 HTTP(S) 代理时失败 HttpsProxyAgent is not a constructor(#8610)。
  • 修复从非空模型范围保存默认模型,使其在该范围内保持可用。
  • 修复 @ 文件自动补全排名偏好直接和更浅的匹配,而非等级相近的嵌套路径(来自 pi-tui)(#8669)。
  • 修复 OpenAI 兼容流在流式传输期间重复序列化 thinking 签名(来自 @earendil-works/pi-ai)(#8671)。
  • 修复主屏渲染在图片密集输出超过 V8 字符串长度限制时崩溃(来自 pi-tui)(#8028)。
  • 修复全屏双击单词选择在 / 和 - 上拆分路径和 kebab-case token(来自 pi-tui)。
  • 修复 Cloudflare AI Gateway 目录省略支持的 workers-ai/* 透传模型(来自 @earendil-works/pi-ai)。
  • 修复 OpenAI 兼容 reasoning 重放合并连续流式文本和摘要 reasoning_details 增量(来自 @earendil-works/pi-ai)。
  • 修复 OpenRouter reasoning 控制,使 reasoning-mandatory 模型不接收 effort: "none"(来自 @earendil-works/pi-ai)(#8614 由 @davidbrai 贡献)。
  • 修复 OpenAI 兼容 Chat Completions 在没有定义工具时忽略显式请求的 toolChoice(来自 @earendil-works/pi-ai)。
  • 修复分段 Mistral tool call 在 continuation 块省略 tool-call ID 时拆分(来自 @earendil-works/pi-ai)(#8387)。
Pi AI

新增

  • 添加实验性视觉能力 deepseek-v4-flash-vision-exp 模型到 DeepSeek 目录。

修复

  • 修复 OpenAI 兼容 Chat Completions 在没有定义工具时忽略显式请求的 toolChoice。
  • 修复 thinking 签名序列化在签名完成后只运行一次(#8671)。
  • 修复分段 Mistral tool call 在 continuation 块省略 tool-call ID 时拆分(#8387)。
  • 修复 OpenAI 兼容 reasoning 重放合并连续流式文本和摘要 reasoning_details 增量。
  • 修复 Cloudflare AI Gateway 目录包含 models.dev 省略的受支持 workers-ai/* 透传模型。
  • 修复 OpenRouter reasoning 控制,通过从 OpenRouter 的模型元数据推导 off 支持和可用 effort 等级,防止 reasoning-mandatory 模型接收 effort: "none"(#8614 由 @davidbrai 贡献)。
Pi Agent

不兼容变更

  • 变更 prepareNextTurn 和 prepareNextTurnWithContext 仅在 shouldStopAfterTurn 和排队消息检查确定 agent loop 将启动另一轮助手 turn 后运行;它们不再在 final 或 terminating turn 后运行;请将 end-of-run 工作移到 agent_end 处理(#6879)。

修复

  • 修复 Windows NodeExecutionEnv 在 PATH 上不可用 taskkill.exe 时中止导致崩溃(#6596)。
Pi TUI

新增

  • 添加 OSC 8 超链接、inline 图片协议和 truecolor 终端能力的环境和程序化覆盖(#8665)。
  • 添加 TuiAltScreen copyOnSelect 选项,以及用于检测和程序化复制活动全屏文本选择的辅助函数(#7720)。

修复

  • 修复主屏渲染在图片密集输出超过 V8 字符串长度限制时崩溃(#8028)。
  • 修复嵌套结果的自动补全排序(#8669)。
  • 修复全屏双击单词选择在 / 和 - 上拆分路径和 kebab-case token(#7746)。

v0.84.3(2026-08-24)

Pi Coding Agent

新功能

  • PowerShell 工具 – 在 Windows 上使用可选的原生 PowerShell 命令执行。详见 PowerShell 工具。
  • 更安全的管理更新 – 为安装程序管理的安装暂存、验证并原子激活更新。详见 安装与管理。
  • 模型与 thinking 控制 – 使用 /thinking 选择 thinking 等级、搜索默认值、保持会话级选择,并通过 Ctrl+S 显式持久化。详见 模型与 thinking。

不兼容变更

  • 将来自 @earendil-works/pi-ai 的 GoogleThinkingLevel 类型重命名为 GoogleApiThinkingLevel,并添加 ResolvedGoogleThinkingLevel 用于规范化的适配器等级。

新增

  • 添加可选的 powershell 工具,用于 Windows,可通过 defaultTools 和 SDK 配置。详见 PowerShell 工具。
  • 为模型和 thinking 选择器添加 /thinking 选择器和可搜索的默认选项;Ctrl+S 将所选模型保存为全局默认。详见 模型与 thinking。
  • 为导出的压缩摘要辅助函数添加可选的路由会话 ID,使调用方无需启用 Prompt 缓存写入即可保留 Provider 路由。
  • 在启用缓存未命中通知时,为压缩和分支摘要添加转录用量通知。
  • 添加 session_compact_failed 扩展事件,使压缩失败和中止向处理器暴露其原因、重试状态、来源和错误消息(#8175)。
  • 为简单流式请求添加 Provider 无关的 toolChoice 支持(来自 @earendil-works/pi-ai)。
  • 为受支持的第一方模型添加 Anthropic 服务端拒绝自动回退,包括返回模型的用量计价(来自 @earendil-works/pi-ai)(#8017)。
  • 为 vLLM、Qwen/SGLang 和 llama.cpp 服务器添加可配置的 OpenAI 兼容 thinking-token 预算字段。详见 OpenAI 兼容性(来自 @earendil-works/pi-ai)(#8275 由 @bnsd55 贡献)。
  • 添加中国区专属的 ZAI Coding Plan 模型,包括 GLM-4.6V 视觉支持和 API 等效用量成本估算(来自 @earendil-works/pi-ai)(#8220)。
  • 为 Qwen Token Plan Individual 目录添加 deepseek-v4-pro-0813 支持(来自 @earendil-works/pi-ai)(#8194)。

变更

  • 变更实验性安装程序管理的安装,使 pi update 就地暂存、验证并原子激活所选版本。详见 安装与管理。
  • 将内置 xAI 模型改用 Responses API 并使用加密 reasoning 重放,并使 Grok 4.6 成为默认 xAI 模型(来自 @earendil-works/pi-ai)(#8124 由 @Jaaneek 贡献)。
  • 变更 Anthropic、Azure OpenAI、Google、Mistral 和 OpenAI 适配器,使其发送 Pi 的默认 User-Agent,除非被覆盖(来自 @earendil-works/pi-ai)(#8305)。
  • 变更 Windows 和 WSL 快捷键默认值,避免终端预留的快捷键冲突:图片粘贴、模型切换、编辑器撤销、全屏转录导航和搜索、消息队列(#8372)。
  • 变更 Bun 发布归档,仅在内层 wrapper 包中包含原生剪贴板二进制,从每个归档中移除重复的平台包。
  • 变更包资源 glob 展开,使用 Node.js 内置实现和确定性的可见路径匹配,减少已安装的运行时依赖树。
  • 变更打包的 Node.js 运行时,仅在导入扩展时加载 jiti,仅当未缓存源码需要转换时加载 Babel,减少 CLI 启动时间和打包体积。
  • 变更语法高亮,仅急切初始化二十种常见语言,并将其余语法推迟到初始 TUI 渲染之后,减少 CLI 启动时间。
  • 变更 Node.js CLI 和 RPC 入口,加载打包的运行时,减少启动时文件系统读取,同时为正常的依赖身份将公共库和遗留模块路径保留在模块化运行时上。
  • 变更会话分享,渲染可点击的终端链接,仅显示规范的 Radius artifact URL,并在 Radius 会话分享中包含当前系统 Prompt 和活动工具定义。

修复

  • 修复失败的扩展工厂仍留下事件订阅、Provider 注册和默认标志状态的问题(#8424 由 @acmerfight 贡献)。
  • 修复 models.json 类型省略已记录的 OpenAI 兼容 compat.supportsFinishReason Provider 和模型覆盖的问题(#8487 由 @petrroll 贡献)。
  • 修复 /model 和 /thinking 选择被持久化为全局,除非用 Ctrl+S 显式保存的问题(#5263)。
  • 修复 JSON 和 RPC toolcall_start 事件省略 tool call id 和名称的问题(#7953 由 @christianklotz 贡献)。
  • 修复 Node.js CLI 作为单一可执行应用运行时扩展加载失败的问题(#8237)。
  • 修复 .agents/skills/ 分组目录内的嵌套 Markdown Skill 未被发现的问题。
  • 修复压缩和分支摘要请求向 Provider 暴露工具的问题。
  • 修复单对象 edit 工具输入无法通过校验的问题,在 coding-agent 和 harness 编辑工具中将其接受为单编辑数组(#7835)。
  • 修复 Skill 目录中的 README.md、AGENTS.md 等根 Markdown 文件被报告为损坏的 Skill,除非声明了有效的 Skill frontmatter(#7805)。
  • 修复默认 Cerebras 模型引用不可用的 Z.AI 模型。
  • 修复 OpenAI 兼容 Chat Completions reasoning 重放,保留并原样、按顺序重发助手级 reasoning_details(来自 @earendil-works/pi-ai)(#7994)。
  • 修复 Anthropic 服务端回退响应按请求模型而非返回的回退模型计价的问题(来自 @earendil-works/pi-ai)(#8285)。
  • 修复 GitHub Copilot 登录触发模型策略速率限制,通过限制策略更新、重试一次模型发现并遵循服务端重试延迟(来自 @earendil-works/pi-ai)(#7850)。
  • 修复 Amazon Bedrock 丢弃并无法重放非 Anthropic 模型的不透明脱敏 reasoning(来自 @earendil-works/pi-ai)(#8314 由 @seiji 贡献)。
  • 修复 Z.AI Coding Plan 模型推导出不完整的 reasoning-effort 元数据,包括缺失 GLM-5.3 的 low、high 和 max 等级(来自 @earendil-works/pi-ai)(#8336)。
  • 修复 OpenCode 和 OpenCode Go 上的 DeepSeek V4 Flash 省略其支持的 low thinking 等级(来自 @earendil-works/pi-ai)(#8181 由 @tianshuang 贡献)。
  • 修复 Azure OpenAI Responses 在 Provider 特定流式请求中忽略 toolChoice(来自 @earendil-works/pi-ai)。
  • 修复 Amazon Bedrock 响应钩子仅接收合成的请求 id 而非原始响应头(来自 @earendil-works/pi-ai)(#8234)。
  • 修复 Kimi 用量报告,使顶层 cached_tokens 计为缓存读取而非普通输入 Token(来自 @earendil-works/pi-ai)(#8075)。
  • 修复 Google 自定义模型忽略 thinkingLevelMap,丢弃扩展 thinking 控制(来自 @earendil-works/pi-ai)(#8135)。
  • 修复对 auth.json 和 models-store.json 的写入覆盖管理员管理的文件权限和 ACL(#7779)。
  • 修复 UTF-8 BOM 标记阻止 frontmatter 和用户配置文件加载(#8337)。
  • 修复交互式启动时通过 TUI 内渲染带文件路径的警告,使无效设置文件容易被忽略(#7829)。
  • 修复 subagent 示例在受信任仓库中反复提示运行项目本地代理的问题(#8261)。
  • 修复生成达到输出 Token 上限时持久化截断的压缩和分支摘要(#7048)。
  • 修复 npm 包更新检查将较旧的注册表版本视为可用更新,阻止 pi update 降级已更新的已安装包(#8226)。
  • 修复 PI_OFFLINE 下 /llama 刷新已配置服务器后内置 llama.cpp 模型从 /model 消失,并将空闲休眠的 sleeping 路由模型和可自动加载的未加载预设纳入可选择的目录(#8167)。
  • 修复 pi.registerFlag() 接受与声明标志类型不匹配的默认值(#8064)。
  • 修复 Z.AI Coding Plan 默认值引用已移除的 GLM-5.1 模型(#8096)。
  • 修复重复的模糊截断响应恢复被误标为上下文溢出(#8130)。
  • 修复 Windows 上基于 VS Code 的终端中重复的全屏右键粘贴(来自 pi-tui)(#8186)。
  • 修复填充文本超出窄终端宽度的问题(来自 pi-tui)(#8252)。
  • 修复包裹的 Markdown 表格链接将颜色泄漏到边框和相邻单元格,包括块引用内的表格(来自 pi-tui)(#8335)。
  • 修复 llama.cpp 登录指引在未加载本地模型时引导用户使用 /llama 而非 /model(#8203)。
  • 修复挂起的 pi.dev 模型目录请求在重试前消耗整个刷新期限(#8198)。
  • 修复 Xiaomi 模型目录在 /model 和 --list-models 中列出已停用的 MiMo V2 模型(来自 @earendil-works/pi-ai)(#8187)。
  • 修复分支摘要条目在 fromId 中记录导航目标而不是导航前的源叶节点。
  • 修复当 Provider 省略流式用量数据时跳过阈值自动压缩的问题(#8328)。
  • 修复以连字符开头(dash-prefixed)的 Prompt 被解析为选项,通过支持 -- 作为选项结束分隔符(#7269)。
Pi AI

不兼容变更

  • 将 GoogleThinkingLevel 重命名为 GoogleApiThinkingLevel,并添加 ResolvedGoogleThinkingLevel 用于规范化的适配器等级。

新增

  • 为简单流式请求添加 Provider 无关的 toolChoice 支持。
  • 为受支持的第一方模型添加 Anthropic 服务端拒绝自动回退,包括返回模型的用量计价(#8017)。
  • 为 vLLM、Qwen/SGLang 和 llama.cpp 服务器添加可配置的 OpenAI 兼容 thinking-token 预算字段(#8275 由 @bnsd55 贡献)。
  • 添加中国区专属的 ZAI Coding Plan 模型,包括 GLM-4.6V 视觉支持和已公布 PAYG 价格的 API 等效用量成本估算(#8220)。
  • 为 Qwen Token Plan Individual 目录添加 deepseek-v4-pro-0813(#8194)。

变更

  • 将内置 xAI 模型改用 Responses API 并使用加密 reasoning 重放,并使 Grok 4.6 成为默认 xAI 模型(#8124 由 @Jaaneek 贡献)。
  • 变更 Anthropic、Azure OpenAI、Google Generative AI、Google Vertex、Mistral、OpenAI Chat Completions 和 OpenAI Responses 适配器,使其发送 Pi 的默认 User-Agent,除非被覆盖(#8305)。

修复

  • 修复 OpenAI 兼容 Chat Completions reasoning 重放,保留并原样、按顺序重发助手级 reasoning_details(reasoning.text、reasoning.summary 和 reasoning.encrypted)(#7994)。
  • 修复 Anthropic 服务端回退响应按请求模型而非返回的回退模型计价的问题(#8285)。
  • 修复 GitHub Copilot 登录触发模型策略速率限制,通过限制策略更新、重试一次模型发现并遵循服务端重试延迟(#7850)。
  • 修复 Amazon Bedrock 丢弃并无法重放非 Anthropic 模型的不透明脱敏 reasoning(#8314 由 @seiji 贡献)。
  • 修复 Z.AI Coding Plan 模型推导出不完整的 reasoning-effort 元数据,包括缺失 GLM-5.3 的 low、high 和 max 等级(#8336)。
  • 修复 OpenCode 和 OpenCode Go 上的 DeepSeek V4 Flash 省略其支持的 low thinking 等级(#8181 由 @tianshuang 贡献)。
  • 修复 Azure OpenAI Responses 在 Provider 特定流式请求中忽略 toolChoice。
  • 修复 Amazon Bedrock after_provider_response/onResponse 转发原始响应头而非仅合成的请求 id 头(#8234)。
  • 修复 Kimi OpenAI 兼容用量报告,使顶层 cached_tokens 计为缓存读取而非普通输入 Token(#8075)。
  • 修复 Google Generative AI 和 Vertex AI 自定义模型忽略 thinkingLevelMap,丢弃扩展 thinking 控制(#8135)。
  • 修复 Xiaomi 模型目录生成在 models.dev 将 MiMo V2 标记为弃用后仍保留已停用的 MiMo V2 模型名(#8187)。
Pi Agent

修复

  • 修复单对象 edit 工具输入无法通过校验的问题,将其接受为单编辑数组(#7835)。
  • 修复 Skill 目录中的 README.md、AGENTS.md 等根 Markdown 文件被报告为损坏的 Skill,除非声明了有效的 Skill frontmatter(#7805)。
Pi TUI

修复

  • 修复 Windows 上基于 VS Code 的终端中重复的全屏右键粘贴(#8186)。
  • 修复填充文本超出窄终端宽度的问题(#8252)。
  • 修复包裹的 Markdown 表格链接将颜色泄漏到边框和相邻单元格,包括块引用内的表格(#8335)。

v0.84.2(2026-08-14)

Pi Coding Agent

新功能

  • 全屏转录搜索 – 在全屏模式中搜索并跳转到匹配项。详见 TUI 全屏视口。
  • 可配置的默认工具 – 在全局或项目级选择启动时启用的内置工具。详见 工具。
  • 可配置的全屏退出输出 – 退出时打印转录,或仅打印恢复提示。详见 交互模式。

新增

  • 添加全屏转录搜索,支持 Ctrl+Shift+F、增量匹配高亮、可配置的搜索匹配主题颜色,以及使用 Enter/Ctrl+G 和 Shift+Enter/Ctrl+Shift+G 跳转到下一个或上一个匹配项。
  • 在 PI_EXPERIMENTAL=1 下为默认的 read、bash、edit 和 write 工具添加实验性严格 JSON Schema 约束采样。
  • 添加全屏退出输出设置,可选择打印最终转录或仅打印会话恢复提示。
  • 添加 defaultTools 设置,用于在全局或项目级配置初始内置工具。
  • 添加 --use-theme <name[/name]>,可为单次交互运行选择初始主题,且不修改已保存的设置(#7722 由 @rwachtler 贡献)。
  • 为扩展的 pi.sendUserMessage() 选项添加 expandPromptTemplates,用于显式分派命令并展开 Skill 和 Prompt 模板。详见 pi.sendUserMessage()(#7857 由 @mrexodia 贡献)。
  • 添加 createGatewayBindingFetch(),无需 API Token 即可通过 Workers AI binding 路由 Cloudflare AI Gateway 请求(来自 @earendil-works/pi-ai)(#7901 由 @Maximo-Guk 贡献)。
  • 添加 AssistantMessage.endTurn,保留 OpenAI Codex 最终的 end_turn 信号以供诊断(来自 @earendil-works/pi-ai)(#7766)。
  • 添加全屏模式中未绑定的单行转录滚动操作。详见 TUI 全屏视口(来自 pi-tui)(#7903 由 @midastruth 贡献)。

变更

  • Kimi Coding 请求改用 Pi 运行时的 User-Agent 请求头(来自 @earendil-works/pi-ai)。
  • 将 Mistral SDK 传输替换为原生 Chat Completions HTTP 流,移除其生成式客户端和 Schema 运行时开销(来自 @earendil-works/pi-ai)。
  • 记录通用的 AI_AGENT=pi 进程标记,并说明它与 PI_CODING_AGENT=true 的区别(#7747)。
  • OpenAI Responses 的延迟工具加载现在优先使用支持的、以消息为锚点的 additional_tools,同时保留工具搜索和顶层回退(来自 @earendil-works/pi-ai)(#7709)。
  • 通过直接绘制全宽布局行而非每帧重新组合,减少全屏渲染的内存分配(来自 pi-tui)。

修复

  • 修复受管理工具下载延迟 TUI 启动且隐藏全屏模式诊断的问题。现在会先挂载 TUI,并在其中显示下载进度和警告。
  • 修复启动后立即打开模型选择器时,会取消并重新启动正在进行的模型目录刷新。
  • 修复 GitHub Copilot 登录在启用模型策略时因并发更新策略而触发 API 速率限制的问题(来自 @earendil-works/pi-ai)(#6187)。
  • 修复手动滚动时全屏转录搜索跳回当前匹配项,以及分段鼠标输入泄漏到搜索查询的问题。
  • 修复必需的 LaTeX 参数从新行开始时被解析为空的问题(来自 pi-tui)(#7760)。
  • 更新间接开发依赖 nanoid,修复拒绝服务漏洞。
  • 修复扩展工具结果的回退渲染,使其折叠过长输出并遵循工具展开状态(#7979)。
  • 修复 JSON 和 RPC 的 message_update 事件在流式传输期间丢失累计用量的问题。详见 JSON 事件模式 和 RPC message_update(#7982 由 @christianklotz 贡献)。
  • 修复 pi.sendMessage(..., { triggerTurn: false }) 在活动运行中进行 steering,而非仅记录自定义消息的问题(#8022 由 @cristinaponcela 贡献)。
  • 修复通过 defaultTools 选择内置默认工具时丢弃扩展和 SDK 自定义工具的问题。
  • 修复 subagent 示例拒绝 tools frontmatter 字段的 YAML 数组语法(#7598 由 @alexsavio 贡献)。
  • 修复 subagent 示例丢弃父会话的模型、thinking 和工具配置(#7897 由 @virtuald 贡献)。
  • 修复自定义系统 Prompt 将当前工作目录与后续追加的 Prompt 内容拼接在一起的问题(#7887 由 @distributedlock 贡献)。
  • 修复 OpenAI Responses 函数和自定义 tool call 在流式传输、代理转发和重放期间丢失命名空间的问题(来自 @earendil-works/pi-ai)(#7709)。
  • 修复上游请求缓冲区错误不会触发自动助手重试的问题(来自 @earendil-works/pi-ai)。
  • 修复内置和自定义 DeepSeek API 模型通过不受支持的字段发送输出限制的问题(来自 @earendil-works/pi-ai)。
  • 修复 Amazon Bedrock 重放拒绝包含空对象键的工具参数的问题,同时保留所有有效的嵌套值(来自 @earendil-works/pi-ai)(#7882 由 @muyiyr 贡献)。
  • 修复 DeepSeek 兼容性检测无法识别主机名含大写字母的 base URL(来自 @earendil-works/pi-ai)(#7933 由 @yearth 贡献)。
  • 修复 Google Generative AI 和 Vertex AI 响应包含 tool call 时,将输出限制或 Provider 错误导致的停止误判为正常工具使用的问题(来自 @earendil-works/pi-ai)(#8059)。
  • 修复终端报告通用 SGR 鼠标释放按钮代码时,全屏鼠标拖选和 OSC 8 链接激活的问题(来自 pi-tui)(#7963)。
  • 修复获得焦点的全屏浮层无法接收鼠标滚轮或 PageUp、PageDown 等视口滚动键的问题(来自 pi-tui)(#7894)。
  • 修复 LaTeX 控制空格被换行拆分时,整个表达式回退为原始源码的问题(来自 pi-tui)。
  • 修复通过 SSH 传入的分段 Alt+Enter 被误判为 Escape 的问题;添加用于高延迟终端的 PI_TUI_ESC_TIMEOUT,且该超时仅适用于单独的 Escape 输入(#7899 由 @powerfooI 贡献)。
  • 修复终端失去焦点时,空闲的全屏会话重绘并清除文本选择的问题(来自 pi-tui)(#7892 由 @terrorobe 贡献)。
  • 修复 OSC 52 不受支持时,全屏选择复制改用主机剪贴板并报告失败,而非错误提示复制成功(#8110 由 @Panoplos 贡献)。
Pi AI

新增

  • 添加 createGatewayBindingFetch(),无需 API Token 即可通过 Workers AI binding 路由 Cloudflare AI Gateway 请求(#7901 由 @Maximo-Guk 贡献)。
  • 添加 AssistantMessage.endTurn,保留 OpenAI Codex 最终的 end_turn 信号以供诊断(#7766)。

变更

  • Kimi Coding 请求改用 Pi 运行时的 User-Agent 请求头。
  • 自动将受支持的严格工具 Schema 转换为 Provider 兼容的封闭对象,要求可空的可选字段为必填,同时保留原始工具定义;将可选但不可空的工具参数中的 null 视为省略。
  • OpenAI Responses 的延迟工具加载现在优先使用支持的、以消息为锚点的 additional_tools,同时保留工具搜索和顶层回退(#7709)。
  • 将 Mistral SDK 传输替换为原生 Chat Completions HTTP 流,移除其生成式客户端和 Schema 运行时开销。

修复

  • 修复 GitHub Copilot 登录在启用模型策略时因并发更新策略而触发 API 速率限制的问题(#6187)。
  • 修复上游请求缓冲区限制错误不会触发自动助手重试的问题。
  • 修复 OpenAI Responses 函数和自定义 tool call 在流式传输、代理转发和重放期间丢失命名空间的问题(#7709)。
  • 修复内置和自定义 DeepSeek API 模型未通过受支持的 max_tokens 字段发送输出限制的问题。
  • 修复 Google Generative AI 和 Vertex AI 响应包含 tool call 时,将输出限制或 Provider 错误导致的停止误判为正常工具使用的问题(#8059)。
  • 修复 Amazon Bedrock 重放拒绝包含空对象键的工具参数的问题,同时保留所有有效的嵌套值(#7882 由 @muyiyr 贡献)。
  • 修复 DeepSeek 兼容性检测无法识别主机名含大写字母的 base URL(#7933 由 @yearth 贡献)。
Pi Agent

修复

  • 修复 streamProxy() 丢失最终 tool call 元数据的问题,例如 OpenAI Responses 命名空间(#7709)。
Pi TUI

新增

  • 添加未绑定的单行转录滚动操作 tui.altScreen.lineUp 和 tui.altScreen.lineDown,用于全屏 TUI 快捷键(#7903 由 @midastruth 贡献)。
  • 为全屏 TUI 添加主滚动视图增量搜索,支持可配置的匹配样式、Ctrl+Shift+F,以及使用 Enter/Ctrl+G 和 Shift+Enter/Ctrl+Shift+G 跳转到下一个或上一个匹配项。

变更

  • 直接绘制全宽布局行,避免每帧通过 ANSI/字素分段重新组合所有可见行,将备屏每帧内存分配减少约 9–18 倍。

修复

  • 修复终端报告通用 SGR 鼠标释放按钮代码时,全屏鼠标拖选和 OSC 8 链接激活的问题(#7963)。
  • 修复手动滚动时全屏转录搜索跳回当前匹配项,以及分段 SGR 鼠标输入泄漏到搜索查询的问题。
  • 修复必需的 LaTeX 参数从新行开始时被解析为空的问题(#7760)。
  • 修复 LaTeX 控制空格被换行拆分时,整个表达式回退为原始源码的问题。
  • 修复获得焦点的全屏浮层无法接收鼠标滚轮或 PageUp、PageDown 等视口滚动键的问题(#7894)。
  • 修复通过 SSH 传入的分段 Alt+Enter 被误判为 Escape 的问题;添加用于高延迟终端的 PI_TUI_ESC_TIMEOUT,且该超时仅适用于单独的 Escape 输入(#7899 由 @powerfooI 贡献)。
  • 修复终端失去焦点时,空闲的全屏会话重绘并清除文本选择的问题(#7892 由 @terrorobe 贡献)。
  • 修复 OSC 52 不受支持时,全屏选择复制错误提示成功的问题;现在可使用主机剪贴板集成,并报告已确认的失败(#8110 由 @Panoplos 贡献)。

v0.84.1(2026-08-07)

Pi Coding Agent

新功能

  • Qwen Token Plan Individual — 为文档中标注 Individual 订阅的模型使用内置 Provider。详见 API Keys。
  • 认证就绪检查 — 使用 pi auth check 验证 Provider 或模型凭据,可选地输出解析后的凭据。
  • 改进的全屏交互 — 多次点击选择单词和段落,配置半页转录滚动。详见 TUI 全屏视口。
  • 终止被阻塞的 tool call — 扩展 tool_call 处理器可以在不再次调用模型的情况下停止全部终止批次。详见 Tool Events。

新增

  • 将 Qwen Token Plan Individual 添加为内置 Provider,带其文档化的订阅模型目录和共享的国际 QWEN_TOKEN_PLAN_API_KEY。详见 API Keys(#7659 由 @arasovic 贡献)。
  • 添加 pi auth check Provider/模型认证预检,支持可选的凭据输出(#7152)。
  • 为被阻塞的扩展 tool_call 事件添加 terminate 支持,使全部终止批次可以跳过自动的 follow-up 模型调用。详见 Tool Events(#7715 由 @muyiyr 贡献)。
  • 添加全屏模式中的双击单词和空白选择、粒度感知的拖拽选择,以及三击段落选择(来自 pi-tui)(#7725、#7733 由 @volsa 贡献)。
  • 添加全屏模式中未绑定的半页转录滚动操作。详见 TUI 全屏视口(#7735)。

变更

  • 软化了 bash 工具的 PI_* 环境变量指南,以减少不必要的检查命令(#7128)。
  • 通过并发探测配色方案和背景支持,将最坏情况下的自动终端主题检测延迟从 200 ms 减少到 100 ms。

修复

  • 通过使用 --no-compile-autoload-bunfig 编译,修复 cwd 包含带 preload 的 bunfig.toml 时 Bun 独立二进制在启动时崩溃的问题(#7685 由 @geril07 贡献)。
  • 修复扩展 TUI 方法包装器在委托给原始方法时无限递归的问题(#7731)。
  • 修复 Windows 上全屏模式右键不粘贴剪贴板文本的问题。
  • 修复 Agent.reset() 在活动运行期间清除转录和运行时状态的问题;现在它会在 agent 空闲前拒绝(#7717 由 @wesleyzhangwq 贡献)。
  • 修复 LaTeX 关系、乘法和命名运算符间距,以及带堆叠分数、运算符限制和相邻矩阵的矩阵组合(来自 pi-tui)。
  • 通过使用按钮移动跟踪而非全量移动跟踪,减少 tmux、Zellij 和 GNU Screen 下的全屏鼠标事件量(来自 pi-tui)。
Pi AI

新增

  • 将 Qwen Token Plan Individual 添加为内置 Provider,带其文档化的订阅模型目录和共享的国际 QWEN_TOKEN_PLAN_API_KEY(#7659 由 @arasovic 贡献)。
Pi Agent

新增

  • 添加 BeforeToolCallResult.terminate,使被阻塞的 tool call 可以参与现有的批次提前终止规则(#7715 由 @muyiyr 贡献)。

修复

  • 修复 Agent.reset() 在活动运行期间清除转录和运行时状态的问题;现在它会在 agent 空闲前拒绝(#7717 由 @wesleyzhangwq 贡献)。
Pi TUI

新增

  • 添加未绑定的半页转录滚动操作 tui.altScreen.halfPageUp 和 tui.altScreen.halfPageDown,用于全屏 TUI 快捷键(#7735)。
  • 添加全屏 TUI 中的双击单词和空白选择、粒度感知的拖拽选择,以及三击段落选择(#7725、#7733 由 @volsa 贡献)。
  • 为备屏 TUI 添加可选的右键粘贴处理器,目前仅在 Windows 上启用。

修复

  • 修复 LaTeX 关系、乘法和命名运算符间距,以及带堆叠分数、运算符限制和相邻矩阵的矩阵组合。
  • 通过使用按钮移动跟踪而非全量移动跟踪,减少 tmux、Zellij 和 GNU Screen 下的全屏鼠标事件量。

v0.84.0(2026-08-06)

Pi Coding Agent

新功能

  • 全屏 TUI 模式 — 在运行时于常规与全屏模式间切换,带粘性编辑器和 footer、可独立滚动的转录,以及可拖动的滚动条。详见 UI 与显示。
  • Mermaid 与 LaTeX 渲染 — 在交互式转录中渲染 Mermaid 图表和终端友好的 Unicode 数学。详见 Markdown 设置 和 TUI Markdown。
  • 按目录的上下文覆盖 — 使用 AGENTS.override.md 为特定目录替换上下文文件。详见 上下文文件。
  • 高级自定义模型采样 — 配置任意 OpenAI 兼容的 samplingParams 和可选的 vLLM thinking_token_budget 值。详见 采样参数。
  • Baseten Provider — 使用内置的 Baseten 认证和模型支持。详见 API Keys。

不兼容变更

  • 将 pi-ai ModelsStreamTransforms 接口重命名为 ModelsRequestTransforms,因为其请求头转换现在适用于所有经过认证的 Provider 请求。

  • 变更 JSON 和 RPC 的 message_update 事件,仅发送 assistantMessageEvent 增量,移除导致输出二次增长的累计 message 和 assistantMessageEvent.partial 字段。需要部分消息的客户端必须在 message_start 与 message_end 之间组装增量;后者仍是权威值(#7290)。

  • ModelRegistry.getApiKeyAndHeaders() 现在返回带 string | null 值的 ProviderHeaders,并保留 null 请求头删除标记。检查返回请求头的扩展必须处理 null;将其转发给 pi-ai 流的扩展应原样透传。这可以防止占位 OpenAI 凭据通过 Cloudflare AI Gateway 发送(#7030)。

  • 变更 ModelRegistry.refresh(),使其接受 ModelsRefreshOptions 并返回 ModelsRefreshResult,而非丢弃取消和 Provider 错误。

  • 变更 ModelRuntime.setRuntimeApiKey(),使其接受认证取消选项而非目录刷新选项。需要远程新鲜度时,请单独调用 refresh({ providers: [providerId], signal })。

  • 要求配置形式的扩展 OAuth refreshToken(credentials, signal) 回调接受并遵循具体的中止信号。

  • 用只读的 context.stored 快照和带世代检查的 context.publish() 事务替换动态 Provider 刷新上下文对 store 的直接访问。

    使用 createProvider({ fetchModels }) 构建的 Provider:无需迁移目录发布。前后都要返回获取的模型并注册得到的 Provider;createProvider() 负责恢复、持久化和内存发布。

    // 之前
    const beforeProvider = createProvider({
      // ...
      fetchModels: async ({ signal }) => {
        const response = await fetch(catalogUrl, { signal });
        return parseModels(await response.json());
      },
    });
    pi.registerProvider(beforeProvider);
    
    // 之后:保持不变
    const afterProvider = createProvider({
      // ...
      fetchModels: async ({ signal }) => {
        const response = await fetch(catalogUrl, { signal });
        return parseModels(await response.json());
      },
    });
    pi.registerProvider(afterProvider);

    手写的原生 Provider.refreshModels():用带世代保护的发布替换直接访问 store 和发布前变更。

    // 之前
    refreshModels: async (context) => {
      const stored = await context.store.read();
      if (stored) currentModels = stored.models;
      if (!context.allowNetwork) return;
    
      const refreshed = await fetchModels(context.signal);
      currentModels = refreshed;
      await context.store.write({ models: refreshed, checkedAt: Date.now() });
    },
    
    // 之后
    refreshModels: async (context) => {
      if (context.stored) {
        const restored = context.stored.models;
        if (!(await context.publish({
          update: () => { currentModels = restored; },
        }))) return;
      }
      if (!context.allowNetwork) return;
    
      const refreshed = await fetchModels(context.signal);
      if (context.signal.aborted) return;
      await context.publish({
        persist: { models: refreshed, checkedAt: Date.now() },
        update: () => { currentModels = refreshed; },
      });
    },

    对于配置形式的 pi.registerProvider(name, { refreshModels }),只返回模型的回调保持不变;pi 会发布返回的列表。如果此类回调之前使用 context.store 做自定义持久化,请读取 context.stored 并调用 context.publish({ persist: entry })。在 publish() 中,省略 persist 保持存储不变,传入 ModelsStoreEntry 写入它,或传 persist: null 删除它。

  • 用基于 v4 lane 的 Session、SessionStorage 和 SessionRepo API 替换 pi-agent-core harness 会话模型,包括持久化操作记录、全局事实、共享序列号和树作用域的 lane 视图。

  • 将 v2 session 和 AgentHarness API 从 pi-agent-core 的实验性入口提升为其默认导出,并移除实验性子路径。

  • 移除旧版 JSONL 和内存仓库 API。请改用 pi-agent-core 的 v4 JsonlSessionRepo 或 InMemorySessionRepo,两者都实现新的 SessionRepo 契约。

  • 新增 pi-agent-core 必需的 FileSystem.renameFile() 操作,用于原子 JSONL 发布;自定义 harness 文件系统实现必须提供同文件系统的替换语义(#7707 由 @davidbrai 贡献)。

  • 用持久化的 SessionMetadata 替换实验性远程会话列表摘要;RemoteSession.sessions 不再暴露运行时阶段、模型、thinking、附件或锁状态,这些可从获取的 SessionSnapshot 值中获取(#7708)。

新增

  • 新增内置 Baseten Provider 支持,使用 BASETEN_API_KEY 认证,默认模型为 zai-org/GLM-5.2。
  • 新增实验性远程会话客户端 API:传输中立的 PiClient、CBOR 协议、Unix-socket 传输,以及带转录 reducer 的 @earendil-works/pi-coding-agent/client RemoteSession 控制器。详见 Pi Client 和 Remote Protocol(#7344、#7348、#7371、#7409)。
  • 新增 CredentialSynchronizationError,用于凭据变更成功提交但同步本地模型状态失败的情况。
  • 新增可链式调用的 pi.registerMarkdownTransformer() 钩子,用于对用户和助手的 Markdown 进行仅显示转换。详见 pi.registerMarkdownTransformer()(#7231 由 @xl0 贡献)。
  • 新增实验性全屏 TUI 模式,可通过 --tui-mode fullscreen 或 /settings 选择(#7304)。
  • 新增通过 /settings 在运行时切换常规和全屏 TUI 模式。
  • 在全屏模式中新增粘性编辑器、状态、widget 和 footer 停靠,同时保持转录可独立滚动。
  • 新增全屏模式中可拖动的转录滚动条,可通过 /settings 配置 auto、always 和 hidden 模式;always 会保留最右侧一列。
  • 新增全屏模式中的翻页滚动和标记消息导航快捷键。
  • 新增可选的 scrollbarThumb 主题颜色,用于全屏滚动条滑块,回退到 selectedBg。
  • 新增支持 Mermaid 图表的可配置主题 Unicode 渲染,用于交互式消息,包括流式渲染时可选渲染。详见 Markdown 设置(#7624 由 @xl0 贡献)。
  • 新增可选的 Ctrl+P/Ctrl+N prompt 历史导航,编辑器聚焦时显式历史绑定优先于应用快捷键。
  • 新增按目录的 AGENTS.override.md 上下文文件,替换同目录中的 AGENTS.md 或 CLAUDE.md,同时保留其他目录的上下文。详见 上下文文件(#7681 由 @Marvae 贡献)。
  • 新增在 CLI 和 RPC 子进程环境中设置 AI_AGENT=pi,用于通用 agent 归属。详见 环境变量(#7493 由 @renaudhartert-db 贡献)。
  • 新增 Markdown 中 LaTeX 表达式的终端友好 Unicode 渲染。详见 TUI Markdown。
  • 新增全屏模式中的堆叠式瞬时通知。
  • 新增通过 models.json、模型覆盖、扩展 Provider 和流选项中的 samplingParams 配置任意 OpenAI 兼容模型采样参数。详见 采样参数(#7568 由 @mrexodia 贡献)。
  • 新增可选 vLLM thinking_token_budget 支持,用于 OpenAI 兼容模型,为最终答案预留输出 token(#7638 由 @bnsd55 贡献)。
  • 新增对省略 finish_reason 的 OpenAI 兼容流支持,使用 compat.supportsFinishReason 在流结束时推断正常和工具使用停止。详见 OpenAI 兼容性。
  • 新增延迟 Provider 请求契约、持久化响应句柄、认证 fetch/cancel 分发,以及 pending、ready、failed 和 cancelled 响应的 faux-provider 支持(#7339 由 @davidbrai 贡献)。
  • 新增厂商中立 telemetry 契约,以及 agent 拥有的类型化 AI-request 和 harness 模式、组合 span 启动器和回调辅助函数。详见 agent telemetry 模式参考。
  • 新增结构化 Amazon Bedrock 失败诊断,包含 HTTP 状态、建模错误码,以及可用时的 AWS request id(#7286 由 @brianstanley 贡献)。
  • 新增 AgentOptions.shouldStopAfterTurn,用于在完成一轮、处理排队消息或另一次模型调用之前优雅停止。详见 Agent Options(#7367 由 @acmerfight 贡献)。
  • 新增 v4 JsonlSessionRepo 对追加式 JSONL harness 会话的支持(#7611 由 @davidbrai 贡献)。
  • 新增有界分支条目和索引开放操作恢复查询到 v4 会话 API(#7448、#7646)。
  • 新增编译完整的 AgentHarness v2 脚手架;未完成的操作路径在实现持久化执行前以 HarnessNotImplemented 拒绝。

变更

  • 新增可选取消到 pi-ai ModelsStore 的读取、写入和删除;目录编排将这些等待绑定到 Provider 刷新信号。
  • 将默认全屏鼠标滚轮步长从三行减少到一行,实现更精细的滚动。

修复

  • 修复 footer 在没有已知订阅的通用 OAuth/OpenID 登录时显示 (sub);扩展 OAuth Provider 可以用 isSubscription 选择加入。
  • 修复 OAuth token 刷新,使停滞的请求释放凭据存储锁(#7508)。
  • 修复工具参数验证,在强制转换前保留已匹配 anyOf/oneOf union 分支的值,避免可空 union 将 null 转换为另一个原始值(#7328)。
  • 修复 Fireworks GLM 5.2 请求在启用长缓存保留时发送不支持的 prompt_cache_retention 字段,并为自动 prompt 缓存启用会话亲和(#7676)。
  • 修复 JsonlSessionRepo 在全局范围内强制会话 ID 的问题;ID 现在在每个工作目录内唯一。
  • 修复 JSONL 会话 fork 和 torn-tail 修复的原子发布,避免中断写入后产生部分写入或损坏的会话(#7707 由 @davidbrai 贡献)。
  • 修复包含路径的 find glob 在 Windows 上返回空结果的问题(#6817)。
  • 修复手动 /compact 期间排队的消息失败而非在压缩完成后发送的问题。
  • 修复传给内置文件工具的 Git Bash、MSYS、Cygwin 和 WSL 驱动器路径解析到当前 Windows 驱动器而非其原生驱动器的问题(#7064、#7547)。
  • 修复项目级嵌套 Provider 重试设置替换未修改的全局 Provider 重试设置的问题(#7572)。
  • 修复 GitHub Copilot Grok 4.5 请求使用受支持的 Responses API(#7560)。
  • 修复全屏关闭将终端能力查询回复泄漏到父 shell prompt 的问题。
  • 修复多个 Provider 共享的裸精确 --model ID 选择第一个目录条目而非唯一认证 Provider 或明确歧义错误的问题(#7327)。
  • 修复独立 x64 二进制需要 Haswell 时代 AVX2/BMI2 指令的问题,改为针对 Bun 基线运行时编译发布可执行文件(#7390 由 @davidbrai 贡献)。
  • 修复全屏模式中 Ctrl+X 复制确认添加转录状态行,而非显示瞬时的 Copied! 标记。
  • 修复全屏模式中 Kitty 图片预览在滚动时与粘性编辑器和 footer 停靠重叠的问题。
  • 修复图片密集的全屏会话在布局变更重传可见 Kitty 图片载荷并每帧渲染两次转录时延迟的问题。
  • 修复 /settings 搜索中的空格在输入多词查询(如 TUI mode 或 Quiet startup)时切换高亮设置的问题。
  • 修复自定义编辑器不继承默认编辑器自动补全下拉项限制的问题(#7333)。
  • 修复包清单中的畸形资源数组导致会话启动崩溃的问题(#7187)。
  • 修复 DOOM overlay 示例从失效 URL 下载其 shareware WAD 的问题。
  • 修复 setToolsExpanded(false) 在工具输出已折叠时为 no-op,避免扩展产生冗余的 Tool output: collapsed 启动通知(#7292)。
  • 修复自定义压缩、handoff 和 Q&A 示例中的扩展驱动模型调用,改为通过 coding-agent 模型运行时分发,以保留自定义 Provider 和已解析的认证选项(#7325)。
  • 修复长时间运行的会话在另一个进程更新 auth.json 时使用过期凭据的问题,通过序列化并发凭据读取并延迟启动(#7319)。
  • 修复并发的 models-store.json 读取形成文件锁 convoy 并延迟启动的问题。
  • 将打包的 brace-expansion 依赖更新到 5.0.8,以解决 GHSA-mh99-v99m-4gvg(#7316)。
  • 修复强制模型可用性刷新仍被停滞的早期刷新阻塞的问题(#7301、#7421 由 @a-yeyang 贡献)。
  • 修复 /model 目录刷新失败无法识别每个失败的目录的问题。
  • 修复模型目录刷新停滞时保存凭据后 Provider 登录仍卡住的问题,通过将本地凭据一致性从有界后台新鲜度分离(#7027、#7113、#7418)。
  • 修复 /scoped-models 在渲染前等待远程目录,而非显示缓存模型并在关闭时取消刷新(#7153)。
  • 修复 /model <name> 在检查缓存模型匹配前等待目录刷新(#7443)。
  • 修复较新可用性通过后仍发布过期可用性快照和错误的问题。
  • 修复较新 Provider 刷新后仍发布过期的 pi.dev、Radius、llama.cpp 和扩展目录刷新的问题。
  • 修复等待文件支持的凭据或模型目录锁时的取消,防止已取消的变更稍后运行或提交。
  • 修复并发内存凭据变更丢失无关 Provider 更新的问题,通过序列化其读-改-写段。
  • 将 undici 更新到 8.9.0,打包的 brace-expansion 更新到 5.0.9,以解决 GHSA-8xcm-r25x-g524、GHSA-4cwx-7wf7-3272、GHSA-m8rv-5g2x-5cg5、GHSA-jr45-8vmc-qm54、GHSA-v3r7-h72x-cjcm 和 GHSA-rgw5-rvv9-x895。
  • 修复 GitHub Copilot 压缩和分支摘要使用 Individual 端点,而非凭据解析的 Business 或 Enterprise 端点(#6768)。
  • 修复扩展模型调用在转发请求认证时丢弃凭据解析端点的问题,包括自定义压缩与 GitHub Copilot Business 和 Enterprise 账户(#7579)。
  • 修复全屏转录导航无编辑器可访问的 Home、End、PageUp 或 PageDown 变体的问题,通过添加 Ctrl 修改的编辑器绑定(#7574)。
  • 修复扩展事件总线监听器在会话重载和销毁后仍存活的问题(#7656 由 @tudoroancea 贡献)。
  • 修复 Wayland 上没有 X11 剪贴板时 /copy 无法读取剪贴板文本的问题(#7387)。
  • 修复慢连接在初始连接尝试期间失败的问题,通过增加连接超时(#7435 由 @muyiyr 贡献)。
  • 修复扩展和内置工具返回的超大图片绕过自动图片缩放的问题。详见 图片设置(#7330 由 @tizmagik 贡献)。
  • 修复会话发现遗漏通过符号链接目录存储的会话的问题(#7552 由 @muyiyr 贡献)。
  • 修复手动压缩与阈值自动压缩竞争的问题(#7370 由 @davidbrai 贡献)。
  • 修复响应被截断低于其预期输出限制时结束运行而非压缩并重试一次的问题(#7540 由 @davidbrai 贡献)。
  • 修复 Git 包更新在 git clean 无法移除忽略的依赖目录时留下缺失依赖的问题(#7570 由 @mrexodia 贡献)。
  • 修复 POSIX 和 Windows 文件系统根部的 find 结果丢失第一路径段或产生重复尾部分隔符的问题(#7569 由 @petrroll 贡献)。
  • 修复瞬时版本检查、目录、托管工具和包管理 HTTP 失败未被重试的问题(#7632 由 @petrroll 贡献)。
  • 修复交互式错误忽略配置的输出内边距的问题。
  • 修复 OpenCode Go Provider 显示名。
  • 修复 Provider 错误规范化将数组和类实例视为结构化响应体,而非保留其原始错误的问题(#7205 由 @erikogenvik 贡献)。
  • 修复 Anthropic 流丢弃初始 content-block 事件中包含的文本或 thinking 的问题(#7358 由 @davidbrai 贡献)。
  • 修复 Google 历史转换丢弃重放所需的签名空文本和 thinking 块的问题(#7362 由 @jingtao-wisdomgraph 贡献)。
  • 修复 OpenAI Codex 缓存 WebSocket 会话在不同账户凭据间共享的问题(#7364)。
  • 修复瞬时 Google Generative AI 和 Vertex AI Provider 错误绕过自动重试的问题(#7471 由 @vish-pr 贡献)。
  • 修复 Gemini 3 tool call id 在历史转换期间被丢弃,破坏签名多轮重放的问题(#7494 由 @muyiyr 贡献)。
  • 恢复 GitHub Copilot 模型通过账户特定策略响应返回(#7672 由 @muyiyr 贡献)。
  • 用 qwen3.8-max 替换退役 Qwen Token Plan qwen3.8-max-preview 模型(#7670 由 @QuintinShaw 贡献)。
  • 修复终端宽度对 Indic 辅音连接字素簇的计数(#6987 由 @petrroll 贡献)。
  • 修复嵌套全屏堆叠布局忽略子元素最小尺寸的问题。
  • 修复批量终端配色方案报告被解析为一个畸形响应的问题(#7550)。
  • 修复终端进度清除未发出完整 OSC 9;4 序列的问题(#7581)。
  • 修复 iTerm2 图片载荷省略 xterm.js 图片 addon 所需的大小元数据的问题(#7612)。
  • 修复宽度截断使 OSC 8 超链接未终止的问题(#7657 由 @xXJSONDeruloXx 贡献)。
  • 更新 GPT-5.6 Terra 和 Luna 定价,覆盖 OpenAI 和 passthrough 模型目录。
  • 修复 Fireworks Kimi K3 模型使用 OpenAI 兼容 API、原生 reasoning-effort 级别和延迟工具(#7199、#7230 由 @XBeg9 贡献)。
  • 更新 Groq Qwen reasoning 覆盖,用于替换的 qwen/qwen3.6-27b 模型。
  • 修复 Windows Shift+Enter 检测,通过从原生 Win32 辅助函数读取修饰键状态。
  • 修复 pi-tui npm 包省略重建其 Windows 和 Darwin 原生 addon 所需的源码和构建脚本的问题。
  • 修复 Windows 控制台 truecolor 检测,当 Windows Terminal 未向子 shell 提供 WT_SESSION 时的问题。
  • 修复幻影全屏文本选择,在更改终端窗格焦点时未匹配的鼠标事件导致的问题。
  • 修复 Windows 键盘输入渲染延迟,通过让输入抢占限速渲染定时器。
  • 修复 agent harness 在 Windows 上处理路径的问题,涉及文件 basename、递归 skill 加载和 prompt 模板名称。
Pi AI

不兼容变更

  • 将导出的 ModelsStreamTransforms 接口重命名为 ModelsRequestTransforms,因为其请求头转换现在适用于所有经过认证的 Provider 请求。

  • 要求动态模型 Provider 接受具体的 RefreshModelsContext.signal;调用方省略其可选 signal 时,Models.refresh() 保持无界。

  • 要求 Provider 登录、API-key 检查/解析和 OAuth 刷新实现接受具体的中止信号;调用方省略其可选 signal 时,公开的 auth 和凭据操作保持无界。

  • 用只读的 context.stored 快照和带世代检查的 context.publish() 事务替换对原始 RefreshModelsContext.store 的访问。

    createProvider({ fetchModels }): 无需迁移目录发布。前后都要返回获取的列表;createProvider() 自己恢复存储的模型并发布、持久化刷新后的模型。现在保证 signal 存在。

    // 之前
    const beforeProvider = createProvider({
      // ...
      fetchModels: async ({ signal }) => {
        const response = await fetch(catalogUrl, { signal });
        return parseModels(await response.json());
      },
    });
    
    // 之后:保持不变
    const afterProvider = createProvider({
      // ...
      fetchModels: async ({ signal }) => {
        const response = await fetch(catalogUrl, { signal });
        return parseModels(await response.json());
      },
    });

    手写 Provider.refreshModels(): 用带世代保护的发布替换直接访问 store 和发布前变更。

    // 之前
    refreshModels: async (context) => {
      const stored = await context.store.read();
      if (stored) currentModels = stored.models;
      if (!context.allowNetwork) return;
    
      const refreshed = await fetchModels(context.signal);
      currentModels = refreshed;
      await context.store.write({ models: refreshed, checkedAt: Date.now() });
    },
    
    // 之后
    refreshModels: async (context) => {
      if (context.stored) {
        const restored = context.stored.models;
        if (!(await context.publish({
          update: () => { currentModels = restored; },
        }))) return;
      }
      if (!context.allowNetwork) return;
    
      const refreshed = await fetchModels(context.signal);
      if (context.signal.aborted) return;
      await context.publish({
        persist: { models: refreshed, checkedAt: Date.now() },
        update: () => { currentModels = refreshed; },
      });
    },

    在 publish() 中,省略 persist 保持存储不变,传入 ModelsStoreEntry 写入它,或传 persist: null 删除它。省略 update 做仅元数据的持久化;省略 persist 做临时内存发布。

新增

  • 新增可选的 OAuthAuth.isSubscription 元数据,用于区分基于订阅的认证和通用 OAuth 登录。
  • 使用厂商中立的 @earendil-works/pi-telemetry 契约,在流、延迟和图片请求选项中新增显式的 TelemetryContext 传播。
  • 新增延迟 Provider 请求契约、持久化响应句柄、认证 fetch/cancel 分发,以及 pending、ready、failed 和 cancelled 响应的 faux-provider 支持(#7339 由 @davidbrai 贡献)。
  • 新增 Baseten 作为内置 OpenAI 兼容 Provider,带 models.dev 目录生成和原生 chat_template_args reasoning 控制。
  • 新增通过 Model.samplingParams 和 StreamOptions.samplingParams 配置任意 OpenAI 兼容采样参数,包括 per-request 覆盖(#7568 由 @mrexodia 贡献)。
  • 新增 OpenAI 兼容模型的可选 vLLM thinking_token_budget 支持,为最终答案预留输出 token(#7638 由 @bnsd55 贡献)。
  • 新增 OpenAICompletionsCompat.supportsFinishReason,用于省略流式 finish_reason 值的 Provider,在流结束时推断正常和工具使用停止。
  • 新增结构化的 Amazon Bedrock 失败诊断,包含 HTTP 状态、建模错误码,以及可用时的 AWS request id(#7286 由 @brianstanley 贡献)。

变更

  • 新增 ModelsStore 读取、写入和删除的可选取消;目录编排将这些等待绑定到 Provider 刷新信号。

修复

  • 修复 GitHub Copilot Grok 4.5 请求使用受支持的 Responses API(#7560)。
  • 限制 OAuth token 刷新,使停滞的请求释放凭据存储锁(#7508)。
  • 修复工具参数验证,在尝试强制转换前保留已匹配 anyOf/oneOf union 分支的值,避免可空 union 将 null 转换为另一个原始值(#7328)。
  • 修复模型目录刷新的取消,即使自定义 Provider 忽略其 abort signal,调用方也停止等待(#7027)。
  • 修复 auth 解析、可用性检查、OAuth 刷新、Provider 登录和内存凭据队列等待遵循调用方取消的问题。
  • 修复较新 Provider 刷新被较旧停滞世代阻塞或覆盖的问题,包括持久化目录发布。
  • 更新 GPT-5.6 Terra 和 Luna 定价,覆盖 OpenAI 和 passthrough 模型目录。
  • 修复 Fireworks Kimi K3 模型使用 OpenAI 兼容 API、原生 reasoning-effort 级别和延迟工具(#7199、#7230 由 @XBeg9 贡献)。
  • 修复 Fireworks GLM 5.2 模型在启用长缓存保留时发送不支持的 prompt_cache_retention 字段,并为自动 prompt 缓存启用会话亲和(#7676)。
  • 更新 Groq 的 Qwen reasoning 覆盖,用于替换的 qwen/qwen3.6-27b 模型。
  • 修复 OpenCode Go Provider 显示名。
  • 修复 Provider 错误规范化将数组和类实例视为结构化响应体,而非保留其原始错误的问题(#7205 由 @erikogenvik 贡献)。
  • 修复 Anthropic 流丢弃初始 content-block 事件中包含的文本或 thinking 的问题(#7358 由 @davidbrai 贡献)。
  • 修复 Google 历史转换丢弃重放所需的签名空文本和 thinking 块的问题(#7362 由 @jingtao-wisdomgraph 贡献)。
  • 修复 OpenAI Codex 缓存 WebSocket 会话在不同账户凭据间共享的问题(#7364)。
  • 修复瞬时 Google Generative AI 和 Vertex AI Provider 错误绕过自动重试的问题(#7471 由 @vish-pr 贡献)。
  • 修复 Gemini 3 tool call id 在历史转换期间被丢弃,破坏签名多轮重放的问题(#7494 由 @muyiyr 贡献)。
  • 修复 OpenAI Responses 不完整原因,仅将 max_output_tokens 视为长度停止,并暴露被截断低于预期输出限制的响应的有界恢复检测(#7540 由 @davidbrai 贡献)。
  • 恢复 GitHub Copilot 模型通过账户特定策略响应返回(#7672 由 @muyiyr 贡献)。
  • 用 qwen3.8-max 替换退役的 Qwen Token Plan qwen3.8-max-preview 模型(#7670 由 @QuintinShaw 贡献)。
Pi Agent

不兼容变更

  • 用基于 v4 lane 的 Session、SessionStorage 和 SessionRepo API 替换旧版 harness 会话模型,包括持久化操作记录、全局事实、共享序列号和树作用域的 lane 视图。
  • 将 v2 session 和 AgentHarness API 从实验性入口提升为默认包导出,并移除实验性子路径。
  • 移除旧版 JSONL 和内存仓库 API。请使用 v4 JsonlSessionRepo 或 InMemorySessionRepo,两者都实现新的 SessionRepo 契约。
  • 为 harness 执行环境新增必需的 FileSystem.renameFile() 操作,用于原子 JSONL 发布;自定义文件系统实现必须提供同文件系统的替换语义(#7707 由 @davidbrai 贡献)。

新增

  • 新增类型化 AI-request 和 harness telemetry 模式、组合模式元组、回调辅助函数和生成的模式参考。
  • 新增有界 Session.findEntriesOnBranch() 和 findEntryOnBranch() 查询,带显式遍历、过滤、排序和限制选项。
  • 新增编译完整的 AgentHarness v2 脚手架;未完成的操作路径在实现持久化执行前以 HarnessNotImplemented 拒绝。
  • 新增 JsonlSessionRepo,一个带元数据验证和共享存储语义的 v4 追加式 JSONL 会话仓库(#7611 由 @davidbrai 贡献)。
  • 新增索引的 Session.findOpenOperations() 恢复查询和 RecordQuery.operationKind 过滤(#7646)。
  • 新增 AgentOptions.shouldStopAfterTurn,用于在完成一轮、处理排队消息或另一次模型调用之前优雅停止。详见 Agent Options(#7367 由 @acmerfight 贡献)。
  • 新增任意 OpenAI 兼容 samplingParams 的代理转发(#7568 由 @mrexodia 贡献)。

修复

  • 修复 NodeExecutionEnv 文件 basename、递归 skill 加载和 prompt 模板名称的 Windows 路径处理。
  • 修复 JsonlSessionRepo 在全局范围内强制会话 ID 的问题;ID 现在在每个工作目录内唯一。
  • 修复 JSONL 会话 fork 和 torn-tail 修复的原子发布,避免中断写入后产生部分写入或损坏的会话(#7707 由 @davidbrai 贡献)。
Pi TUI

新增

  • 新增 Markdown 中 LaTeX 表达式的终端友好 Unicode 渲染,包括行内和显示数学、分数、脚本、常见符号、对齐方程、cases 和矩阵。
  • 新增共享的 TuiMode 类型和主屏、备屏 TUI 渲染器上的 mode 判别符。
  • 新增 TUI 生命周期和渲染状态交接 API,用于替换渲染器而不重放主屏内容。
  • 导出捆绑的 Marked 解析器和 token 类型。
  • 新增 Markdown 组件的宽度感知源转换。
  • 新增接口兼容的主屏和备屏 TUI 渲染器,带应用拥有的滚动(#7304)。
  • 新增备屏 VStack、HStack 和嵌套 ScrollView 布局,带受限尺寸、粘性区域和指针目标滚动。
  • 新增备屏拖拽选择跨屏外滚动视图内容的边缘自动滚动。
  • 新增带鼠标拖动的比例滚动条、Home/End 文档导航、瞬时 auto 模式和保留最右侧一列的 always 模式;滚动条模式可在运行时更改。
  • 新增备屏视口的翻页滚动和 OSC 133 语义 prompt 导航。
  • 新增与垂直光标移动无关的可配置上一/下一 prompt 历史操作。
  • 新增备屏渲染器的堆叠式瞬时通知(#7361)。

变更

  • 将默认备屏鼠标滚轮步长从三行减少到一行,实现更精细的滚动。

修复

  • 通过扩展原生 Win32 辅助函数报告修饰键状态,修复 Windows Shift+Enter 检测。
  • 修复 npm 包省略重建 Windows 原生 addon 所需的源码和构建脚本的问题。
  • 修复 npm 包省略重建 Darwin 原生 addon 所需的源码和构建脚本的问题。
  • 修复 Windows Terminal 未向子 shell 提供 WT_SESSION 时 Windows 控制台 truecolor 检测的问题。
  • 修复终端宽度对 Indic 辅音连接字素簇的计数(#6987 由 @petrroll 贡献)。
  • 修复未匹配鼠标事件在更改终端窗格焦点时产生幻影备屏文本选择的问题。
  • 修复可搜索设置查询中的空格更改所选值,而非过滤多词标签的问题。
  • 修复备屏 Kitty 图片在滚动时跨垂直布局裁剪边界并与粘性区域重叠的问题。
  • 修复备屏重绘在放置移动或近期离屏图片返回时重传 Kitty 图片数据、复用放置时丢弃相邻行内容、每帧渲染两次固定基准滚动内容,以及在绘制时扫描裁剪的转录行的问题。
  • 修复全屏转录导航无编辑器可访问的 Home、End、PageUp 或 PageDown 变体的问题,通过添加 Ctrl 修改的编辑器绑定(#7574)。
  • 修复 Windows 键盘输入渲染延迟,通过让输入抢占限速渲染定时器。
  • 修复嵌套堆叠布局忽略子元素最小尺寸的问题。
  • 修复批量终端配色方案报告被解析为一个畸形响应的问题(#7550)。
  • 修复终端进度清除未发出完整 OSC 9;4 序列的问题(#7581)。
  • 修复 iTerm2 图片载荷省略 xterm.js 图片 addon 所需的大小元数据的问题(#7612)。
  • 修复宽度截断使 OSC 8 超链接未终止的问题(#7657 由 @xXJSONDeruloXx 贡献)。

v0.83.0(2026-07-29)

Pi Coding Agent

新功能

  • 外部客户端凭据导出 — pi auth print-api-key 和 pi auth print-bearer-token 可导出已配置的凭据,支持自动 OAuth 刷新和最低有效性强制检查。
  • Headless OpenRouter 登录 — 通过粘贴重定向 URL 或授权码,在 SSH 环境下完成 /login。详见 OpenRouter。
  • GitHub Copilot 上的 Claude Opus 5 — 通过 GitHub Copilot 使用 Claude Opus 5,支持 adaptive thinking 和 1M 上下文窗口。详见 GitHub Copilot。

不兼容变更

  • 升级捆绑的 TypeBox 别名至 1.3.7,移除 Type.Base、Type.Awaited、Type.Promise、Type.AsyncIterator、Type.Iterator、Type.Options 和 Value.Mutate 等已弃用 API,同时修复了可空数组工具参数的编译验证。详见 包依赖(#7243 由 @petrroll 贡献)。

新增

  • 添加 pi auth print-api-key 和 pi auth print-bearer-token 命令,用于向外部客户端导出已配置凭据,包括自动 OAuth 刷新和可配置的最低 token 有效期(#7168)。
  • 向扩展暴露会话的已解析模型作用域 ctx.scopedModels。详见 扩展上下文(#7191 由 @pungggi 贡献,#7215)。
  • 为受支持的 text 和 image Provider 传输添加 per-request fetch 注入。
  • 添加 "pending" 停止原因,用于部分流式消息。详见 自定义 Provider 流模式(#7151 由 @lucasmeijer 贡献)。
  • 添加原始 Provider 停止原因,覆盖 Google、Anthropic、Amazon Bedrock、Mistral 和 OpenAI 流;未映射的终止原因现在表现为 Provider 错误而非成功停止(#7272)。
  • 为远程和 headless 环境的 OpenRouter 登录添加手动重定向 URL 和授权码输入。详见 OpenRouter(#7114 由 @rgarcia 贡献)。
  • 为 GitHub Copilot 添加 Claude Opus 5 支持,包括 adaptive thinking 和 1M 上下文窗口。详见 GitHub Copilot(#7158 由 @jay-aye-see-kay 贡献)。

变更

  • OAuth 凭据解析改为在剩余有效期不足五分钟时刷新 token,而非等到过期(#7168)。

修复

  • 切换工具输出展开时添加状态行提示(#7180)。
  • 修复文件形式的 SYSTEM.md 和 APPEND_SYSTEM.md prompt 在 interactive 启动上下文列表中缺失的问题。详见 系统 Prompt 文件(#7096)。
  • 修复链接的 Git worktree 嵌套在主仓库下时上下文文件加载两次的问题。详见 上下文文件(#7221 由 @arajkumar 贡献)。
  • 修复 llama.cpp 流式响应报告零 token 用量、导致会话上下文统计为空的问题。详见 llama.cpp(#7258 由 @SteveImmanuel 贡献)。
  • 修复响应进行中时替换会话和提交树导航会中止并持久化待发送轮次,而非留下悬空 tool call。详见 会话(#7022 由 @tmustier 贡献)。
  • 修复 Git 包安装失败留下不完整目录导致干净重试被阻止的问题。详见 安装和管理(#7210 由 @haoqixu 贡献)。
  • 修复 /model 选择器在过滤时保留过期选择而非高亮首个匹配项的问题(#7211 由 @christianbasch 贡献)。
  • 修复直接 RPC bash 命令绕过扩展 user_bash 处理器的问题。详见 用户 Bash 事件(#7214)。
  • 修复扩展重载资源后 skills、prompts 和 themes 丢失包源元数据的问题。详见 资源事件(#6968)。
  • 修复并发运行的用户 bash 命令取消问题,确保每个活跃命令都被中止(#7103 由 @yzhg1983 贡献)。
  • 修复扩展在 interactive 启动期间切换会话导致重复消息的问题(#7110 由 @yzhg1983 贡献)。
  • 修复 Qwen Token Plan reasoning 模型,发送其服务特定的 thinking 控制和受支持的 reasoning-effort 级别(#6951、#6998)。
  • 修复 Z.AI 输出限制通过不支持的参数发送的问题。详见 Providers(#7174 由 @HyeokjaeLee 贡献)。
  • 修复显式配置的 Amazon Bedrock profiles 被 ambient AWS 访问密钥覆盖的问题。详见 Amazon Bedrock(#7176 由 @christianbasch 贡献)。
  • 修复图片回退路径在窄终端中溢出、缩短 home 目录路径、并使绝对路径在终端支持超链接时可点击(#7262)。
  • 修复 OpenAI 兼容 tool call 在格式错误的 delta 同时包含空 custom 对象时丢失函数参数的问题(#7288 由 @sunnyyoung 贡献)。
Pi AI

不兼容变更

  • 升级导出的 TypeBox 依赖至 1.3.7,移除 Type.Base、Type.Awaited、Type.Promise、Type.AsyncIterator、Type.Iterator、Type.Options 和 Value.Mutate 等已弃用 API,同时修复了可空数组工具参数的编译验证。使用已移除 API 的消费者需迁移至受支持的 TypeBox API(#7243 由 @petrroll 贡献)。

新增

  • 为受支持的 text 和 image Provider 传输添加 per-request fetch 注入;Google 适配器拒绝非全局实现而非静默绕过。
  • 为 GitHub Copilot Provider 添加 Claude Opus 5 支持,通过 Anthropic Messages API 路由,支持 adaptive thinking、1M 上下文和 Copilot minimal thinking-level 覆盖(#7158 由 @jay-aye-see-kay 贡献)。
  • 为部分流式消息添加 "pending" 停止原因。详见 停止原因(#7151 由 @lucasmeijer 贡献)。
  • 添加 AssistantMessage.rawStopReason,并填入 Google、Anthropic、Amazon Bedrock、Mistral 和 OpenAI 流;未映射的终止原因现在表现为 Provider 错误而非成功停止(#7272)。
  • 为远程和 headless 环境的 OpenRouter OAuth 登录添加手动重定向 URL 和授权码输入(#7114 由 @rgarcia 贡献)。
  • 添加 AuthResolutionOverrides.minOAuthValidityMs,允许调用方要求 OAuth 凭据具有最低剩余有效期并据此刷新(#7168)。

变更

  • 存储的 OAuth 凭据改为在剩余有效期不足五分钟时刷新,而非等到过期(#7168)。

修复

  • 修复 Qwen Token Plan reasoning 模型,发送其服务特定的 thinking 控制和受支持的 reasoning-effort 级别(#6951、#6998)。
  • 修复 Z.AI Provider 和兼容自定义端点,通过 max_tokens 发送输出限制(#7174 由 @HyeokjaeLee 贡献)。
  • 修复显式配置的 Amazon Bedrock profiles 被 ambient AWS 访问密钥覆盖的问题(#7176 由 @christianbasch 贡献)。
  • 修复格式错误的 OpenAI 兼容 tool-call 增量同时包含有效 function 载荷和空 custom 对象时丢弃函数参数的问题(#7288 由 @sunnyyoung 贡献)。
Pi TUI

修复

  • 修复长图片回退路径在窄终端中溢出、缩短 home 目录路径、并使绝对路径在终端支持超链接时可点击(#7262)。

v0.82.1(2026-07-25)

Pi Coding Agent

新功能

  • Claude Opus 5 – 在 Anthropic 和 Amazon Bedrock 上可用,支持 adaptive thinking(包括 xhigh)、推理配置文件和 prompt 缓存。详见 API Keys。
  • Anthropic 网关 Bearer 认证 – ANTHROPIC_AUTH_TOKEN 可对要求 Authorization: Bearer 的 Anthropic 兼容网关进行认证,包括压缩和分支摘要。详见 Environment Variables or Auth File。
  • 更快、更具弹性的模型目录 – pi.dev 目录通过 If-None-Match 重新验证,未变更的 Provider 返回空 304 响应,llama.cpp 模型在重启后仍保留列出。详见 llama.cpp。

新增

  • 向自定义消息渲染器公开 outputPad 设置。详见 Extensions(#7045 由 @xl0 贡献)。
  • 为 Anthropic 兼容网关添加 ANTHROPIC_AUTH_TOKEN Bearer 认证。详见 Providers(#5871)。
  • 为 Anthropic 和 Amazon Bedrock 添加 Claude Opus 5 支持,包括 adaptive thinking、推理配置文件、prompt 缓存并保留 AWS 验证消息(#7081 由 @unexge 贡献,#7083 由 @davidbrai 贡献)。

变更

  • pi.dev 模型目录刷新改为通过 If-None-Match 重新验证,未变更 Provider 目录返回空 304 而非完整下载。
  • Radius OAuth 设备授权、token 交换和刷新请求改为直接使用配置的网关。
  • 模型加载错误改为追加底层原因,因此类似 OAuth refresh failed for openai-codex 的认证失败会报告 Provider 响应,而不是空包装消息。

修复

  • 修复认证完全解析为请求头的 Provider 的压缩和分支摘要(#5871)。
  • 修复 /models 中不可用作用域模型被隐藏的问题,使其可在不手动编辑设置的情况下移除(#6949,#7032 由 @christianklotz 贡献)。
  • 修复启动上下文文件发现,跳过与上下文文件同名的目录(如 AGENTS.md),避免 EISDIR 警告(#7106 由 @mrexodia 贡献)。
  • 修复 llama.cpp 扩展以持久化其模型目录,使 llama.cpp 模型在首次成功刷新前仍保持列出。详见 llama.cpp(#7072 由 @davidbrai 贡献)。
Pi AI

新增

  • 添加 ModelsStoreEntry.etag,使持久化的 Provider 目录可携带用于条件刷新的远程 ETag 校验器。
  • 为 Anthropic 兼容网关添加 ANTHROPIC_AUTH_TOKEN Bearer 认证(#5871)。
  • 为 Anthropic 和 Amazon Bedrock 添加 Claude Opus 5 支持,包括 adaptive thinking、推理配置文件、prompt 缓存并保留 AWS 验证消息(#7081 由 @unexge 贡献,#7083 由 @davidbrai 贡献)。

变更

  • Radius OAuth 设备授权、token 交换和刷新请求改为直接使用配置的网关。
  • ModelsError 消息改为追加底层原因,因此类似 OAuth refresh failed for openai-codex 的认证失败会报告 Provider 响应,而不是空包装消息。

v0.82.0(2026-07-24)

Pi Coding Agent

新功能

  • 约束工具采样 — 工具可以偏好或要求严格的 JSON Schema 采样,或使用 OpenAI Lark/regex 语法,模型能力元数据会阻止不支持的请求。详见 工具的约束采样。
  • OpenRouter 和 Kimi Code 登录 — 使用 /login 授权 OpenRouter 或 Kimi Code 订阅,无需手动配置 API key。详见 OpenRouter。
  • 会话感知的流式 bash 集成 — Bash 工具接收当前会话/模型元数据,而直接 RPC bash 命令流式输出关联的输出。详见 Bash 工具会话环境 和 RPC bash 事件。

新增

  • 添加了 Tool.constrainedSampling,支持严格 JSON Schema(prefer/require)和 OpenAI Lark/regex 语法变体,覆盖 OpenAI、Anthropic、Amazon Bedrock、Google Gemini 和 Mistral。详见 工具的约束采样。
  • 添加了 supportsGrammarTools 和 supportsStrictTools 兼容性标志,扩展了 supportsStrictMode 覆盖范围,并生成模型能力元数据以控制约束采样。
  • 添加了 Kimi Code 订阅 OAuth 登录,支持 Kimi For Coding Provider,包括设备授权和自动 token 刷新(#6935 由 @zaycruz 贡献)。
  • 添加了 OpenRouter OAuth PKCE 登录,通过 /login 创建用户控制的 API key。详见 OpenRouter(#6927 由 @rsaryev 贡献)。
  • 向内置和工厂创建的 bash 工具运行的命令暴露 PI_SESSION_ID、PI_SESSION_FILE、PI_PROVIDER、PI_MODEL 和 PI_REASONING_LEVEL。详见 Bash 工具会话环境。
  • 为直接 RPC bash 命令添加流式 bash_execution_update 事件,与请求 ID 关联。详见 RPC bash 事件(#6971 由 @ananthakumaran 贡献)。

变更

  • 变更生成模型目录,仅暴露 models.dev 上经过 Provider 验证的 reasoning effort 级别(#6928 由 @davidbrai 贡献)。

修复

  • 修复 DNS 查找失败(如 getaddrinfo、ENOTFOUND 和 EAI_AGAIN),触发自动 assistant 重试(#6946 由 @christianklotz 贡献)。
  • 修复 OpenRouter Anthropic 缓存断点,使其在 tool result 之后推进,并为 ~anthropic/*-latest 别名启用缓存控制(#6941 由 @mteam88 贡献)。
  • 修复 OpenAI Codex WebSocket 会话,在 previous_response_not_found 错误后重试一次,不带缺失的 previous-response 续接(#6955 由 @davidbrai 贡献)。
  • 修复 TUI 调试和崩溃日志,使其遵循自定义 agent 目录,而非始终写入 ~/.pi/agent(#6958 由 @davidbrai 贡献)。
  • 修复系统临时目录条目过多时 Ctrl+G 外部编辑器启动缓慢的问题(#6903 由 @christianklotz 贡献)。
  • 修复启动资源显示,保留包加载的同级 npm 扩展的相对路径(#6964 由 @davidbrai 贡献)。
  • 修复压缩和分支摘要请求,使用新的路由会话 ID,并在支持的情况下禁用 prompt 缓存(#6618 由 @tmustier 贡献)。
  • 修复设置 PI_SKIP_VERSION_CHECK 时的显式自更新(#6977)。
  • 修复包含方括号的作用域模型 ID,先作为字面精确匹配再作为 glob 匹配(#6210)。
  • 修复 OpenAI 和 Anthropic Provider 重试等待,使其遵循 abort 信号和配置的延迟限制(#6980 由 @petrroll 贡献)。
  • 修复全新安装时因包文件 mtime 较新而优先使用捆绑模型目录而非较新的远程目录的问题(#7016 由 @davidbrai 贡献)。
  • 修复编辑器滚动指示器在窄终端中溢出的问题(#7015 由 @christianklotz 贡献)。
  • 修复 llama.cpp 模型,使用加载的上下文窗口作为输出 token 限制,而非限制在 16K(#7034 由 @christianklotz 贡献)。
  • 修复发布源码归档,包含构建独立二进制所需的生成 Provider 模型数据。
  • 更新打包的 protobufjs 依赖至 7.6.5,解决 GHSA-j3f2-48v5-ccww(#7005)。
  • 修复 Wayland 上 /copy 在 wl-copy 失败时回退到 X11 或 OSC 52(#7009 由 @rkfshakti 贡献)。
  • 修复 /model 在打开模型选择器时重新加载更新后的 models.json 配置(#6999)。
  • 修复压缩和分支摘要,使认证完全解析为请求头的 Provider 正常工作(#5871)。
Pi AI

不兼容变更

  • 将 getBuiltinModelDataUrl(provider) 替换为 getBuiltinModelDataGeneratedAt(),使内置目录的新鲜度使用其记录的生成时间而非依赖安装的文件元数据(#7016 由 @davidbrai 贡献)。

新增

  • 添加了 Kimi Code 订阅 OAuth 登录,支持 kimi-coding Provider,包括设备授权、token 刷新和 OAuth 主机覆盖(#6935 由 @zaycruz 贡献)。
  • 添加了 OpenRouter OAuth PKCE 登录,为用户创建 API key,适用于 chat 和 image Provider(#6927 由 @rsaryev 贡献)。
  • 添加了 Tool.constrainedSampling,支持严格 JSON Schema(prefer/require)和 OpenAI Lark/regex 语法变体,在 OpenAI、Anthropic、Amazon Bedrock、Google Gemini 和 Mistral 上强制执行 Provider 端约束工具采样。详见 工具的约束采样。
  • 添加了 supportsGrammarTools 和 supportsStrictTools 兼容性标志,扩展了 supportsStrictMode 至 Responses 和 Bedrock 模型,并生成模型能力元数据以控制约束采样。

变更

  • 变更生成的模型目录,仅暴露 models.dev 上经过 Provider 验证的 reasoning effort 级别(#6928 由 @davidbrai 贡献)。

修复

  • 修复 OpenAI Codex 缓存的 WebSocket 续接,在 grammar tool call 之后仅发送真实的 tool-result delta。
  • 修复 Google、Amazon Bedrock、Mistral 和 Azure OpenAI Responses 适配器的约束工具采样,包括模型感知的 strict-tool 能力、语法配置验证和畸形 grammar-call 重放错误。
  • 修复 cacheRetention: "none",对支持的 OpenAI 模型禁用隐式 prompt 缓存写入,对 OpenAI Codex 禁用基于会话的缓存(#6618 由 @tmustier 贡献)。
  • 修复 DNS 查找失败(如 getaddrinfo、ENOTFOUND 和 EAI_AGAIN),触发自动 assistant 重试(#6946 由 @christianklotz 贡献)。
  • 修复 OpenAI Codex WebSocket 会话,在 previous_response_not_found 错误后重试一次,不带缺失的 previous-response 续接(#6955 由 @davidbrai 贡献)。
  • 修复 OpenAI 和 Anthropic Provider 重试等待,使其遵循 abort 信号和配置的延迟限制(#6980 由 @petrroll 贡献)。
  • 修复 OpenRouter Anthropic 缓存断点,使其在 tool result 之后推进,并为 ~anthropic/*-latest 别名启用缓存控制(#6941 由 @mteam88 贡献)。
Pi Agent

不兼容变更

  • 将 AgentHarness 的 ExecutionEnv 依赖和上下文无关的 AgentTool 输入替换为应用定义的 toolContext 值和上下文感知的 AgentHarnessTool 定义。

新增

  • 添加了上下文感知的 read、write、edit 和 bash harness 工具,由 ExecutionEnv 支持,包括异步 bash 执行准备。

变更

  • 对齐了 harness 工具路径处理、编辑序列化、shell 输出捕获、显式非继承环境和跨平台进程清理,与 coding-agent 行为一致。

修复

  • 修复压缩和分支摘要请求,使用新的路由会话 ID,并在支持的情况下禁用 prompt 缓存(#6618 由 @tmustier 贡献)。
Pi TUI

修复

  • 修复调试和崩溃日志,使用配置的 TUI 日志目录(包括 PI_CODING_AGENT_DIR),而非始终写入 ~/.pi/agent(#6958 由 @davidbrai 贡献)。
  • 修复窄终端中编辑器底部滚动指示器超出终端宽度导致崩溃的问题(#7015 由 @christianklotz 贡献)。

v0.81.1(2026-07-21)

Pi Coding Agent

新功能

  • 可验证的发布源码归档 — GitHub Releases 现在包含确定性、带校验和的源码归档,并附有独立二进制构建说明。详见 从发布源码构建独立二进制。
  • 弹性压缩与分支摘要 — 临时 Provider 故障现在遵循配置的重试策略,重试生命周期事件可供 interactive、JSON、RPC 和 SDK 消费者使用。详见 压缩与分支摘要 和 RPC 重试事件。

新增

  • 在 GitHub Releases 中添加确定性、带校验和的源码归档,并附有独立二进制重建文档(#6913 由 @christianklotz 贡献)。

修复

  • 修复压缩和分支摘要,使用配置的重试策略重试临时 Provider 故障,重试生命周期事件暴露给 interactive、JSON、RPC 和 SDK 消费者(#6901 由 @davidbrai 贡献)。
  • 修复 interactive 启动时等待后台模型目录刷新导致 footer Provider 计数计算阻塞的问题。
  • 恢复使用 0.81 之前 agent-core API 的扩展的默认流回退(#6915)。
  • 修复 Kimi K3 模型(来自 Moonshot AI 和 Moonshot AI China),使用 OpenAI thinking 格式并暴露 reasoning effort 支持。
Pi AI

新增

  • 新增 retryAssistantCall(),支持对临时 assistant 故障进行有界重试,提供生命周期回调和 abort 处理(#6901 由 @davidbrai 贡献)。

修复

  • 修复 Kimi K3 模型(来自 Moonshot AI 和 Moonshot AI China),使用 OpenAI thinking 格式并暴露 reasoning effort 支持。
Pi Agent

新增

  • 在 AgentHarness 中为压缩和分支摘要操作添加重试策略支持和生命周期事件(#6901 由 @davidbrai 贡献)。

修复

  • 恢复 Agent 的 streamFn 选项和主机可配置的省略 agent-loop stream 函数的回退,同时避免重新引入 pi-ai/compat 依赖(#6915)。

v0.81.0(2026-07-21)

Pi Coding Agent

新功能

  • 本地 llama.cpp 模型管理 — 连接 llama.cpp 路由器,搜索和下载 Hugging Face 模型,并显式加载或卸载模型,提供实时进度。详见 llama.cpp。
  • 完整 Provider 扩展 — 扩展可以注册完整的 pi-ai Provider,包括认证、模型刷新、过滤和自定义流式处理。详见 注册新 Provider。
  • Qwen Token Plan Provider — 使用内置的国际和中国订阅 Provider,支持区域端点和 API-key 认证。详见 API Keys。
  • 扩展用量统计 — 工具、压缩和分支摘要的用量被持久化并计入会话总计。详见 压缩与分支摘要。

新增

  • 将 Qwen Token Plan 和 Qwen Token Plan China 添加到内置 Provider 设置、默认模型解析和 Provider 文档中(#6858 由 @QuintinShaw 贡献)。
  • 新增 get_available_thinking_levels RPC 命令和 RpcClient.getAvailableThinkingLevels() 方法(#6865 由 @cristinaponcela 贡献)。
  • 从包根导出消息和工具执行生命周期事件类型(#6772 由 @davidbrai 贡献)。
  • 新增内置 llama.cpp 路由器支持,包括 /login 连接设置和 /llama Hugging Face 模型搜索与下载、显式加载、卸载和实时进度。详见 llama.cpp。
  • 新增扩展注册完整 pi-ai Provider 的能力,包括原生认证、模型刷新、过滤和流式行为。
  • 新增工具、压缩和分支摘要的用量统计,在持久化会话、footer 总计和会话统计中体现(#6671 由 @davidbrai 贡献)。

修复

  • 更新打包的 brace-expansion 依赖至 5.0.7(#6896 由 @davidbrai 贡献)。
  • 修复持久化的远程模型目录在升级后覆盖较新捆绑目录的问题。
  • 修复已存储 API-key 凭据,使其应用 Provider 作用域的 env 值,包括 Amazon Bedrock profiles(#6864 由 @cristinaponcela 贡献)。
  • 修复 OpenAI 兼容跨 Provider 重放,当多个 tool call 共享一个 Provider call ID 时保持 tool call ID 唯一(#6854 由 @cristinaponcela 贡献)。
  • 修复 Kimi K3 thinking 级别,暴露 low、high 和 max,并将 k2p7 别名规范化为 kimi-for-coding。
  • 修复 OpenCode Go 模型通过 OpenAI Responses API 路由的问题。
  • 修复 pi-ai 包元数据,避免消费者 lockfile 重复变更(#6812 由 @jmfederico 贡献)。
  • 修复终端关闭时先清除编辑器反转软件光标再恢复硬件光标的问题(#6790 由 @dam9000 贡献)。
  • 修复 ANSI 感知文本换行,识别 CRLF 和 CR 行尾同时保留样式(#6764 由 @xz-dev 贡献)。
  • 修复编辑器粘贴注册表在删除和撤销粘贴标记后损坏,防止提交的 prompt 中出现字面或错配的粘贴标记(#6844)。
  • 修复无会话 OpenAI Codex WebSocket 请求使用 UUIDv7 请求 ID(#6834 由 @xl0 贡献)。
  • 修复 GPT-5.6 Codex 模型默认使用 272K 上下文窗口,避免自动长上下文定价(#6853 由 @aadishv 贡献)。
  • 修复压缩期间排队的消息保留 steering 和 follow-up 投递行为(#6730 由 @dannote 贡献)。
  • 修复 read 工具错误被语法高亮为文件内容的问题(#6731 由 @dannote 贡献)。
  • 修复 llama.cpp 路由器下载进度更新,并移除模型操作确认中的冗余措辞。
  • 将自动模型目录网络刷新从启动初始化移至运行中的 interactive 和 RPC 模式。
  • 修复持久化会话被读取和解析两次的问题,减少大型会话的启动延迟(#6793)。
  • 修复 prompt 模板中所有参数的默认值(${@:-default} 和 ${ARGUMENTS:-default})(#6695)。
Pi AI

新增

  • 新增 Qwen Token Plan 和 Qwen Token Plan China 作为内置 Provider,支持区域端点、API-key 认证和生成的模型目录(#6858 由 @QuintinShaw 贡献)。
  • 新增 contentText,用于从消息内容中提取拼接文本(#6840 由 @xl0 贡献)。
  • 新增共享的 uuidv7 工具,用于时间排序标识符(#6834 由 @xl0 贡献)。
  • 新增可选的用量元数据到工具结果消息中(#6671 由 @davidbrai 贡献)。

变更

  • 变更生成的模型目录,将 TypeScript 模型形状与忽略的 JSON 模型值分离,减少生成源码的变动(#6765 由 @mitsuhiko 贡献)。
  • 变更模型生成,在编译前验证忽略的 Provider 数据;npm run build 照常刷新模型数据,npm run build:offline 复用已有数据无需网络访问。

修复

  • 修复已存储 API-key 凭据在认证解析期间应用 Provider 作用域的 env 值,包括 Amazon Bedrock profiles(#6864 由 @cristinaponcela 贡献)。
  • 修复 OpenAI 兼容跨 Provider 重放,当多个 tool call 共享一个 Provider call ID 时保持 tool call ID 唯一(#6854 由 @cristinaponcela 贡献)。
  • 修复 Kimi K3 暴露其支持的 low、high 和 max thinking 级别,并将 k2p7 别名规范化为 kimi-for-coding 模型。
  • 修复 OpenCode Go Provider 支持通过 OpenAI Responses API 路由的模型。
  • 修复 pi-ai 可执行路径与 npm registry 元数据匹配,避免消费者 lockfile 重复变更(#6812 由 @jmfederico 贡献)。
  • 修复无会话 OpenAI Codex WebSocket 请求使用 UUIDv7 请求 ID,使拒绝 UUIDv4 ID 的模型可用(#6834 由 @xl0 贡献)。
  • 修复 GitHub Copilot 长上下文定价层级在生成的模型元数据中的问题(#6668)。
  • 修复 Kimi Coding 订阅模型在 models.dev 报告零定价时报告 API 等效隐含成本。
  • 修复 OpenAI Responses 提前结束流被归类为可重试的 Provider 错误(#6727)。
  • 修复 GPT-5.6 Codex 模型默认使用 272K 上下文窗口,避免自动长上下文定价(#6853 由 @aadishv 贡献)。
Pi Agent

不兼容变更

  • 变更 SessionStorage,使用 getPathToRootOrCompaction(),要求会话名称和统计方法,支持基于游标的条目读取,并将保留的压缩尾部存储为自包含检查点(#6594 由 @cristinaponcela 贡献)。
  • 将 uuidv7 导出移至 @earendil-works/pi-ai(#6834 由 @xl0 贡献)。
  • 将可选的 Agent streamFn 回退替换为必需的 streamFunction,并使低级循环 stream 函数为必需,防止 @earendil-works/pi-ai/compat 和所有内置 Provider 进入选择性 Provider 包(#6851)。

新增

  • 在 agent harness 中为工具结果、压缩条目和分支摘要添加用量元数据(#6671 由 @davidbrai 贡献)。
Pi TUI

修复

  • 修复终端关闭时先清除编辑器的反转软件光标再恢复硬件光标,避免重复光标残留(#6790 由 @dam9000 贡献)。
  • 修复 ANSI 感知文本换行,识别 CRLF 和 CR 行尾同时跨行保留样式(#6764 由 @xz-dev 贡献)。
  • 修复编辑器粘贴注册表在删除粘贴标记时损坏:撤销现在将粘贴注册表与文本一起恢复,标记重新编号按升序 ID 移动注册表条目,因此提交的 prompt 不再包含字面 [paste #N ...] 标记或错误粘贴内容(#6844)。

v0.80.10(2026-07-16)

Pi Coding Agent

新功能

  • Kimi Coding thinking 兼容 — Kimi Coding 模型现在正确使用自适应 thinking;K3 暴露其支持的 max 级别,并支持回放空签名 thinking blocks。详见 Kimi For Coding 设置 和模型选项。

修复

  • 修复 Kimi Coding 请求,使用 Anthropic 自适应 thinking effort 而不带 token 预算,并为 K3 和 kimi-for-coding 启用空 thinking 签名。
  • 修复 Kimi K3 定价元数据,适用于 Moonshot AI 和 Moonshot AI China。
  • 修复 Kimi Coding K3 thinking 级别元数据,仅暴露支持的 max 级别(#6737)。
  • 修复目录生成,恢复在 0.80.9 中移除的 xAI 模型(#6736)。
Pi AI

修复

  • 修复 Kimi Coding 请求,使用 Anthropic 自适应 thinking effort 而不带 token 预算,并为 K3 和 kimi-for-coding 启用空 thinking 签名。
  • 修复 Kimi K3 定价元数据,适用于 Moonshot AI 和 Moonshot AI China。
  • 修复 Kimi Coding K3 thinking 级别元数据,仅暴露支持的 max 级别(#6737)。
  • 修复目录生成,恢复在 0.80.9 中移除的 xAI 模型(#6736)。

v0.80.9(2026-07-16)

Pi Coding Agent

新功能

新增

变更

  • 将 xAI 登录改为使用预填充的设备授权链接,标签为 "使用 SuperGrok 或 X Premium 登录 ",并将默认 xAI 模型改为 Grok 4.5(#6734,感谢 @Jaaneek)。

修复

  • 修复 Kimi K3 输出限制,适用于 Vercel AI Gateway 和 OpenRouter 模型。
  • 修复在首次助手响应之前克隆或 fork 会话时,提示会话必须先保存。

移除

  • 从内置 xAI 模型目录中移除 Grok 3、Grok 3 Fast、Grok 4.20 变体和 Grok Code Fast 1(#6734,感谢 @Jaaneek)。
Pi AI

新增

  • 为 Kimi Coding、Moonshot AI、Moonshot AI China、OpenRouter 和 Vercel AI Gateway 添加 Kimi K3 支持。
  • 通过 compat.deferredToolsMode 为 OpenAI 兼容 Chat Completions 添加 Kimi 延迟工具加载。

变更

  • 将 xAI 设备 OAuth 改为打开预填充的授权链接,并添加 Provider 特定的 OAuth 登录标签(#6734,感谢 @Jaaneek)。

修复

  • 修复 Kimi K3 输出限制,适用于 Vercel AI Gateway 和 OpenRouter 模型。

移除

  • 从内置 xAI 模型目录中移除 Grok 3、Grok 3 Fast、Grok 4.20 变体和 Grok Code Fast 1(#6734,感谢 @Jaaneek)。

v0.80.8(2026-07-16)

Pi Coding Agent

不兼容变更

  • 将 SDK 的 CreateAgentSessionOptions.authStorage 和 modelRegistry 选项替换为异步 modelRuntime 选项。AuthStorage 及其存储后端不再导出;请使用 ModelRuntime(或自定义 pi-ai CredentialStore),或 readStoredCredential() 进行一次性读取。
  • 移除了冗余的 ModelRuntime.getAll()、find()、getSnapshot() 和 getAuthOptions() 投影。请直接使用 pi-ai Models 的 getModels()、getModel()、getProviders() 和 checkAuth() 方法。
  • 将 SDK 通过 ModelRegistry.getApiKeyAndHeaders() 组装的请求认证替换为 ModelRuntime.getAuth()。传入 Provider ID 返回 Provider 作用域认证;传入模型还会解析内置、models.json 和扩展模型请求头。
  • 面向扩展的 ModelRegistry.refresh() 从同步 void 改为 Promise<void>,因为 models.json 加载是异步的。扩展必须在同步读取注册表之前 await 它。
  • 将规范的动态目录刷新迁移到异步 ModelRuntime.refresh() / pi-ai Models.refresh()。旧版扩展 OAuth modifyModels 在凭据初始化后仍作为同步兼容投影保留。

新功能

  • 统一的模型运行时与 Provider 认证 — ModelRuntime 集中管理模型配置、Provider 自有的 /login 和动态 Provider 目录。详见 Providers。
  • 实时模型目录刷新 — /model 在后台刷新已配置的 Provider,pi update --models 可强制立即刷新。详见安装和管理。
  • xAI 设备码 OAuth 与 Grok 4.5 Responses 支持 — 使用设备码登录 xAI,并以低、中、高 thinking 级别使用 Grok 4.5。详见 xAI。

新增

  • 新增 ModelRuntime 作为规范的异步 SDK 和内部模型/认证门面,同时保留面向扩展的同步 ModelRegistry API。ModelRuntime.create() 可通过 credentials 选项接受任何 pi-ai CredentialStore。
  • 新增 Provider 自有的 /login 发现,直接从注册的 pi-ai Provider 获取,包括 ambient 认证状态和信息链接。
  • 新增基于文件的动态目录 models-store.json、按 Provider 的 pi.dev 目录覆盖,以及 Radius 网关支持(包括从旧版凭据缓存目录离线迁移)。
  • 新增扩展 Provider refreshModels(context) 支持动态模型发现,并可选地由 Provider 控制持久化。
  • 新增 pi update --models,用于在不更新 Pi 或扩展的情况下强制立即刷新模型目录。
  • 新增 xAI 设备码 OAuth 登录,以及 Grok 4.5 OpenAI Responses 支持,提供低、中、高 thinking 级别(#6651,感谢 @Jaaneek)。

变更

  • ModelRuntime 改为通过临时 pi-ai Provider 方法组合内置 Provider、不可变的 models.json 配置和扩展覆盖。
  • ModelRuntime 改为拥有最终请求组装:getAuth(model) 包含已配置模型请求头;流方法只解析一次认证;before_provider_headers 作为仅 Models 的请求头转换在 Provider 分发前运行。
  • /model 改为立即渲染当前模型快照、在后台刷新已配置 Provider,并用部分结果或超时错误更新打开的选择器。

修复

  • 修复已配置 Provider 目录刷新,使其能解析 pi.dev 以模型 ID 为键的响应、将检查频率限制为每 4 小时一次、发送带版本的 Pi user agent、将未实现路由视为不可用覆盖,并在 /model 中显示简洁刷新状态。
  • 修复相邻的助手 thinking blocks,使其渲染为一个 thinking 区域。
  • 修复 OpenAI Codex 会话 ID 超过 64 字符的问题,以符合 API 限制(#6630)。
  • 修复终端输出,统一规范化 tab 字符(#6697,感谢 @xz-dev)。
  • 修复检查 npm 包后的 Windows 终端标题(#6629)。
  • 修复 Bun 独立二进制文件打包 OAuth 适配器以支持交互式登录。
Pi AI

不兼容变更

  • 将运行时认证改为 Provider 作用域的 Models.checkAuth()、getAuth()、login() 和 logout() API。checkAuth() 现在返回 AuthCheck | undefined,API key 认证解析器不再接收模型。
  • 移除了旧版内置 OAuth Provider 对象、全局 OAuth 注册表 API 和公开的低层内置 login/refresh 函数。请改用规范的 Provider.auth.oauth 方法;oauth 子路径现在仅保留扩展兼容类型。
  • 将规范登录交互接口从 AuthLoginCallbacks 重命名为 AuthInteraction;它暴露了 API key 和 OAuth 流程共用的 Provider 中立 prompt() / notify() 协议。
  • 更改 Models 请求契约:getAuth(model) 现在包含模型请求头,getAuth(providerId) 仍为 Provider 作用域,Models 流选项可包含 transformHeaders。自定义 Models 实现必须在合并 auth/模型和显式请求头后执行该转换,然后在 Provider 分发前移除它。
  • 将动态模型刷新改为 Models.refresh(options),刷新每个已配置的动态 Provider 并返回按 Provider 的错误/取消状态。Provider.refreshModels(context) 现在接收有效凭据、作用域模型存储、网络策略和 abort 信号。

新增

  • 为 Models 新增 Provider 自有的认证与可用性解析,包括存储的 OAuth 刷新和通过 CredentialStore 的交互式登录支持。
  • 新增 CredentialStore.list() 异步枚举非机密凭据,以及支持凭据感知的 Provider.filterModels() 可用性策略。
  • 新增中立的认证流程信息/链接事件,以及 Provider 自有的 Amazon Bedrock 和 Google Vertex AI 凭据选择流程。
  • 新增 ModelsStore,使用内存默认实现来恢复和持久化动态 Provider 目录。
  • 新增动态 Radius pi-messages 网关 Provider,支持 OAuth 和凭据特定的目录刷新。
  • 新增 Models.refresh({ force: true }),让 Provider 绕过新鲜度检查执行显式刷新。
  • 新增 xAI 设备码 OAuth 登录,并将 Grok 4.5 路由到 OpenAI Responses,支持低、中、高 thinking(#6651,感谢 @Jaaneek)。

变更

  • Models.getAuth(model) 改为包含模型请求头,并新增仅作用于 Models 的 transformHeaders 流选项,在 auth 和显式请求头组装之后、Provider 分发之前运行。

修复

  • 修复 Cloudflare Workers AI 和 AI Gateway 流,使其在认证解析后对账户和网关端点占位符实例化,包括使用自定义模型对象的兼容流。
  • 修复懒加载 Provider 流,使其在转发内部流时保留最终助手消息。
  • 修复 OpenAI Codex 会话 ID 超过 64 字符的问题,以符合 API 限制(#6630)。
Pi TUI

修复

  • 修复终端输出,统一规范化 tab 字符(#6697,感谢 @xz-dev)。

v0.80.7(2026-07-14)

Pi Coding Agent

不兼容变更

  • 移除了 openai-responses 的 compat.sendSessionIdHeader 标志。会话亲和行为现在由 compat.sessionAffinityFormat("openai"、"openai-nosession" 或 "openrouter")控制。将 sendSessionIdHeader: false 替换为 sessionAffinityFormat: "openai-nosession"(#6496,感谢 @petrroll)。

新功能

  • 缓存友好的动态工具加载 — 扩展可以在执行期间添加工具,同时受支持的 Anthropic 和 OpenAI Responses 模型保留 prompt 缓存前缀。详见动态工具加载。
  • 消息复制快捷键 — Ctrl+X 复制转录中最后一条助手消息或 /tree 中选中的消息,使旧消息和分支消息可直接复制。详见显示和消息队列。
  • Fable 5 xhigh 和 max thinking — 在生成的 Provider 目录中提供原生的 xhigh 和 max thinking 级别。详见模型选项。

新增

  • 为扩展工具添加了缓存友好的动态工具加载,由 tool result 触发。受支持的 Anthropic 和 OpenAI Responses 模型在工具定义可用时加载定义,保留缓存的 prompt 前缀。详见动态工具加载(#6474)。
  • 在所有生成的 Provider 目录中为 Claude Fable 5 添加了原生 xhigh 和 max thinking 级别(#6490,感谢 @davidbrai)。
  • 添加了 Ctrl+X 复制最后一条助手消息或 /tree 中选中的消息。
  • 为 OpenAI 和 Codex Responses 添加了 toolChoice 支持,包括 required 和 named 工具选择(#6588,感谢 @xl0)。

修复

  • 修复了 OpenRouter 模型上下文窗口,使用 top provider 的实际上下文长度(#6481,感谢 @davidbrai)。
  • 修复了 OpenRouter OpenAI 兼容会话 ID,使用 x-session-id 请求头代替 OpenAI 特定的会话亲和字段(#6496,感谢 @petrroll)。
  • 修复了 Ctrl+V 在剪贴板不含图片时粘贴文本的行为。
  • 修复了 /login amazon-bedrock 提示并保存 Bedrock API key,而非仅显示 ambient AWS 凭据设置说明。
  • 修复了 Amazon Bedrock ambient AWS 凭据,继续使用 SigV4 认证,包括自定义模型 ID(#6532,感谢 @ribelo)。
  • 修复了 Cloudflare Workers AI 和 AI Gateway 认证,在存储的凭据仅包含 API key 时使用 ambient 账户和网关 ID(#6292,感谢 @markphelps)。
  • 修复了旧终端解码中 Alt+, 和 Alt+. 等 Alt+符号组合键(#6523,感谢 @ribelo)。
  • 修复了 GitHub Copilot mai-code-1-flash-picker 模型路由,使其通过 /responses 端点(#6544,感谢 @petrroll)。
  • 修复了分支摘要,使其在使用 ambient 认证而非 API key 的 Provider 上正常工作(#6595,感谢 @davidbrai)。
Pi AI

不兼容变更

  • 移除了 OpenAIResponsesCompat.sendSessionIdHeader 标志。会话亲和行为现在由 compat.sessionAffinityFormat("openai"、"openai-nosession" 或 "openrouter")控制。将 sendSessionIdHeader: false 替换为 sessionAffinityFormat: "openai-nosession"(#6496,感谢 @petrroll)。

新增

  • 添加了缓存友好的动态工具加载。ToolResultMessage.addedToolNames 标记 Context.tools 中工具可用的位置;Anthropic 和 OpenAI Responses 使用原生延迟加载,使后加载的工具不进入缓存前缀,其他 Provider 继续正常使用 Context.tools(#6474)。
  • 在所有生成的 Provider 目录中为 Claude Fable 5 添加了原生 xhigh 和 max thinking 级别(#6490,感谢 @davidbrai)。
  • 为 OpenAI 和 Codex Responses 添加了 toolChoice 支持,包括 required 和 named 工具选择(#6588,感谢 @xl0)。

修复

  • 修复了 OpenRouter 模型上下文窗口,使用 top provider 的实际上下文长度(#6481,感谢 @davidbrai)。
  • 修复了 GitHub Copilot mai-code-1-flash-picker 模型路由,使其通过 /responses 端点(#6544,感谢 @petrroll)。
  • 修复了 Amazon Bedrock 请求,使用通用 apiKey 流选项作为 Bedrock bearer token。
  • 修复了 OpenRouter OpenAI 兼容会话 ID,使用 x-session-id 请求头代替 OpenAI 特定的会话亲和字段(#6496,感谢 @petrroll)。
  • 修复了 Amazon Bedrock ambient AWS 凭据,继续使用 SigV4 认证,包括自定义模型 ID(#6532,感谢 @ribelo)。
  • 修复了 Cloudflare Workers AI 和 AI Gateway 认证,在存储的凭据仅包含 API key 时使用 ambient 账户和网关 ID(#6292,感谢 @markphelps)。
  • 修复了 Amazon Bedrock 错误,报告未处理的 provider stop reason,而非仅显示 An unknown error occurred(#6598,感谢 @davidbrai)。
  • 修复了 Azure OpenAI Responses reasoning replay,当 encrypted_content 仅出现在终端 response event 中时(#6608,感谢 @davidbrai)。
  • 修复了省略 message_delta 事件中 usage 的 Anthropic 兼容代理(#6611,感谢 @davidbrai)。
  • 修复了 OpenCode OpenAI Responses 模型,省略不支持的 session-id 请求头,同时保留其他缓存亲和数据(#6645,感谢 @davidbrai)。
Pi Agent

新增

  • 添加了 AgentToolResult.addedToolNames 向 ToolResultMessage 的传播,使 result 引入的工具可从该转录点起加载(#6474)。
Pi TUI

修复

  • 修复了旧终端解码中 Alt+, 和 Alt+. 等 Alt+符号组合键(#6523,感谢 @ribelo)。

v0.80.6(2026-07-09)

Pi Coding Agent

新功能

  • max thinking 级别 — 全新的可选 thinking 级别,位于 xhigh 之上,在 GPT-5.6 和 adaptive Claude 模型上原生支持,可通过 CLI(--thinking max)、SDK、RPC 和模型选择使用。自定义主题可定义 thinkingMax。详见 CLI 参考。
  • 基于输入量的定价阶梯 — 请求级输入 token 定价阶梯,用于精确的长上下文成本核算(如 GPT-5.4/5.5/5.6 长上下文费率),也可在 models.json 和 modelOverrides 中为自定义模型配置。详见 模型配置。

新增

  • 在 CLI、SDK、RPC、模型选择和主题中添加了可选的 max thinking 级别。自定义主题可定义 thinkingMax;已有主题回退到 thinkingXhigh。
  • 在 models.json、modelOverrides 和扩展注册的 Provider 中为自定义模型成本添加了请求级输入 token 定价阶梯。
  • 为 shellPath 设置添加了 ~(home 目录)展开(#6470,感谢 @aaronkyriesenbach)。

修复

  • 修复了 compact 后输出 token 预算,使其忽略 compact 边界之前的过期助手使用量(#6464)。
  • 修复了 GPT-5.4 和 GPT-5.5 长上下文成本核算,同时保留了需要显式覆盖的模型的 272K 默认上下文限制。
  • 修复了 GPT-5.6 元数据,使直接 OpenAI 请求保持在 272K 短上下文阶梯,同时暴露 Codex 后端的 372K 上下文窗口及长上下文定价,并移除了不存在的裸 gpt-5.6 别名。
  • 修复了 Anthropic 消息转换,保留 thinking text 为空但有有效签名的 thinking blocks,而非丢弃它们,避免新版 Claude 模型出现 thinking-block 错误(#6457,感谢 @davidbrai)。
Pi AI

新增

  • 添加了独立的可选 max thinking 级别,包括 GPT-5.6 和 Anthropic adaptive-thinking effort 的原生 xhigh 和 max 支持,匹配 Anthropic 文档:所有 adaptive Claude 模型支持 max,Opus 4.7/4.8、Sonnet 5 和 Fable 5 支持原生 xhigh。
  • 在模型成本元数据和使用量成本计算中添加了请求级输入 token 定价阶梯。

修复

  • 修复了 compact 后输出 token 预算,使其忽略 compact 边界之前的过期助手使用量(#6464)。
  • 修复了 GPT-5.4 和 GPT-5.5 长上下文成本核算,同时保留需要显式覆盖的模型的 272K 默认上下文限制。
  • 修复了 GPT-5.6 元数据,使直接 OpenAI 请求保持在 272K 短上下文阶梯,同时暴露 Codex 后端的 372K 上下文窗口及长上下文定价,并从 OpenAI 和 Azure OpenAI Responses 目录中移除了不存在的裸 gpt-5.6 别名。
  • 修复了 Anthropic 消息转换,保留 thinking text 为空但有有效签名的 thinking blocks,而非丢弃它们,避免新版 Claude 模型出现 thinking-block 错误(#6457,感谢 @davidbrai)。
Pi Agent

新增

  • 在 xhigh 之后添加了 max 模型 thinking 级别。

v0.80.5(2026-07-09)

此版本无面向用户的功能变更,所有包均为内部改进。

v0.80.4(2026-07-09)

Pi Coding Agent

新功能

新增

  • 添加了 OpenAI GPT-5.6 模型元数据,支持 gpt-5.6、gpt-5.6-sol、gpt-5.6-terra 和 gpt-5.6-luna,并验证了 openai-codex 对 gpt-5.6-sol、gpt-5.6-terra 和 gpt-5.6-luna 的支持。
  • 在 GitHub Copilot 模型目录中添加了 Claude Sonnet 5(#6200)。
  • 为 OpenAI Codex Responses SSE 传输添加了 zstd 请求体压缩。
  • 添加了 /login <provider> 支持,含 Provider 自动补全。
  • 添加了 CLI 等效模型和作用域模型解析的公共 SDK 导出(#6201)。
  • 添加了扩展和 RPC agent_settled 事件,以及完全 settled 的 agent 运行的会话级空闲等待(#6363)。
  • 添加了 before_provider_headers 扩展钩子,用于注入 Provider 请求头(#6350,感谢 @pmateusz)。
  • 添加了 InlineExtension 类型,用于命名的内联扩展工厂(#6267,感谢 @any-victor)。
  • 添加了扩展条目渲染器,用于持久化的仅显示会话条目,在交互模式下渲染而不发送到模型上下文。
  • 添加了 pi config 的项目级资源覆盖管理,包括通过 pi config -l 启动项目模式,以及全局和项目作用域之间的 Tab 切换(#6309)。
  • 从 agent harness 中添加了 InMemorySessionStorage 和 JsonlSessionStorage 导出(#6435)。
  • 在 JSONL 会话头中添加了自定义元数据支持(#6417,感谢 @ArcadiaLin)。
  • 添加了 showCacheMissNotices 设置和 /settings 开关,用于显著的 Prompt 缓存未命中转录通知。

修复

  • 修复了 gRPC ResourceExhausted Provider 错误(如 NVIDIA NIM 瞬时耗尽响应)的重试分类(#6449,感谢 @davidbrai)。
  • 修复了 Cloudflare 524 超时响应的重试分类(#6239)。
  • 修复了 GitHub Copilot 设备码登录轮询,在首次 token 轮询前等待,并遵循服务器提供的 slow_down 间隔,避免浏览器授权后的错误失败或挂起(#6187)。
  • 修复了 OpenAI Codex WebSocket 会话,在后端 60 分钟限制之前轮换缓存连接,避免长会话出现连接限制失败(#6268)。
  • 修复了 DS4 服务器对 Prompt has ... tokens, but the configured context size is ... tokens 错误的上下文溢出检测(#6262)。
  • 修复了 Fireworks GLM 5.2 Fast,使其使用 OpenAI 兼容端点和 thinkingLevelMap,与 GLM 5.2 对齐(#6195)。
  • 修复了 fork 菜单对同一选项重复选择的忽略问题(#6430,感谢 @davidbrai)。
Pi AI

新增

  • 添加了 OpenAI GPT-5.6 模型元数据,支持 gpt-5.6、gpt-5.6-sol、gpt-5.6-terra 和 gpt-5.6-luna,并验证了 openai-codex 对 gpt-5.6-sol、gpt-5.6-terra 和 gpt-5.6-luna 的支持。
  • 从 models.dev 刷新了生成的模型目录,新增了 Kimi K2.7 Code(GitHub Copilot)和多个 Provider 的 Fable 5 等模型(#6256)。
  • 在 GitHub Copilot 模型目录中添加了 Claude Sonnet 5(#6200)。
  • 为 OpenAI Codex Responses SSE 传输添加了 zstd 请求体压缩。请求在 Node/Bun 支持 zstd 时发送 Content-Encoding: zstd;WebSocket 传输不变。

修复

  • 修复了 gRPC ResourceExhausted Provider 错误(如 NVIDIA NIM 瞬时耗尽响应)的重试分类(#6449,感谢 @davidbrai)。
  • 修复了底层消息转换,在 Provider 转换前规范化 null 消息内容,避免松散导入转录的崩溃(#6343)。
  • 修复了 Xiaomi Token Plan 模型元数据,使其遵循上游 models.dev token-plan 目录,移除不支持的 mimo-v2-omni 变体(#6204)。
  • 修复了 GitHub Copilot 设备码登录轮询,在首次 token 轮询前等待,避免部分用户在浏览器授权后出现设备码错误(#6187)。
  • 修复了 OAuth 设备码轮询,遵循服务器提供的 slow_down 间隔,而不仅应用 RFC 8628 的 5 秒增量,使提前到达的轮询(如 WSL/VM 时钟漂移)时 GitHub Copilot 登录恢复而非挂起(#6187)。
  • 修复了 OpenAI Codex user-agent 构建,同步加载 Node OS 元数据,避免在 Node/Bun 中报告 pi (browser) 的启动竞态。
  • 修复了 Fireworks GLM 5.2 Fast,使其使用 OpenAI 兼容端点和 thinkingLevelMap,与 GLM 5.2 对齐(#6195)。
  • 修复了 Amazon Bedrock Claude Fable 5 和 Claude Sonnet 5 的 Prompt 缓存点数(#6235)。
  • 修复了 Amazon Bedrock Claude 5 Prompt 缓存定价元数据,移除了过期的回退覆盖。
  • 修复了 DS4 服务器对 Prompt has ... tokens, but the configured context size is ... tokens 错误的上下文溢出检测(#6262)。
  • 修复了 OpenAI Codex WebSocket 会话,在后端 60 分钟限制之前轮换缓存连接,避免长会话出现连接限制失败(#6268)。
  • 修复了 OpenAI Completions 和 Responses Provider,在工具结果文本为空且无图片内容时发送 (no tool output) 而非 (see attached image),防止模型虚构图片附件。
  • 修复了 OpenAI Responses 和 Azure OpenAI Responses 请求,避免发送低于 Provider 最小值的 max_output_tokens(#6265)。
  • 修复了 Cloudflare 524 超时响应的重试分类(#6239)。
  • 修复了 Bun fetch socket-drop 错误(如 socket connection was closed)的重试分类,使瞬时流断开自动重试(#6431)。
  • 修复了 GitHub Copilot 扩展上下文窗口模型(Claude Opus 4.7/4.8、Claude Opus 4.6、Claude Sonnet 4.6/5、Claude Fable 5、GPT-5.3 Codex、GPT-5.4、GPT-5.5),使其使用 contextWindow: 1000000,防止过早压缩和预算不足(#6439)。
Pi Agent

新增

  • 添加了可配置的 harness 会话上下文条目变换和自定义条目消息投射器。
  • 在 JSONL 会话头中添加了自定义元数据支持(#6417,感谢 @ArcadiaLin)。
  • 导出了 InMemorySessionStorage 和 JsonlSessionStorage(#6435)。

修复

  • 修复了 harness 分轮压缩,使摘要请求串行化,避免单并发 Provider 被要求运行重叠的生成请求(#5536)。
  • 修复了 harness 工具调用,使被长度截断的助手消息中的工具调用失败,而非等待缺失的工具结果(#6285)。
  • 修复了 harness 会话导入,在上下文投射前规范化 null 消息内容,避免松散导入转录的崩溃(#6343)。
  • 修复了非正数或过大的 harness shell 执行超时,使其以明确的验证错误失败,而非被压缩为即时超时(#6181)。
  • 修复了 harness 会话存储的短条目 ID,使用生成的 uuidv7 的随机尾部而非时间戳前缀(后者在调用之间近乎恒定)(#6242)。
Pi TUI

修复

  • 修复了编辑器粘贴标记处理,当粘贴标记被删除或终端状态被清除时防止过期的粘贴状态残留(#6397,感谢 @affanali2k3)。

v0.80.3(2026-06-30)

Pi Coding Agent

新功能

  • Anthropic Claude Sonnet 5 支持 — Claude Sonnet 5 通过 Anthropic 兼容和 Bedrock Provider 目录可用,并启用了自适应 thinking。详见 Providers 和 Model Options。
  • 可配置的输出间距 — outputPad 可控制用户消息、助手消息和 thinking 块的水平内边距。详见 Settings。
  • 外部编辑器配置 — externalEditor 允许 Ctrl+G 使用配置的编辑器,再回退到 $VISUAL/$EDITOR。详见 Settings 和 Keybindings。
  • 更丰富的 RPC 会话树访问 — RPC 客户端可以通过 get_entries 和 get_tree 检查会话条目和树快照。详见 get_entries 和 get_tree。
  • 扩展会话元数据更新 — 扩展可以通过 session_info_changed 观察会话名称变化。详见 session_info_changed。
  • 现代 Azure Foundry 端点支持 — Azure OpenAI Responses Provider 设置支持当前的 Microsoft Foundry 端点 URL。详见 Azure OpenAI。

新增

  • 添加了 Anthropic Claude Sonnet 5 模型支持。
  • 添加了 get_entries 和 get_tree RPC 命令,用于通过 RPC 读取会话条目和树快照(#6078)。
  • 添加了 ./rpc-entry 包导出,用于直接以 RPC 模式启动 Pi。
  • 添加了扩展的会话名称变更事件(#6175)。
  • 添加了 Azure OpenAI Responses 支持,用于现代 Microsoft Foundry 端点 URL(#6004)。
  • 添加了 Usage.reasoning token 计数,用于报告 reasoning/thinking token 使用情况的 Provider(#6057)。
  • 添加了 externalEditor settings.json 覆盖项,用于 Ctrl+G 外部编辑器命令,默认回退到 Windows 上的 Notepad 和其他平台上的 nano(#6122)。
  • 添加了 outputPad 设置,用于用户消息、助手消息和 thinking 的水平内边距(#6168)。

变更

  • 将默认 OpenAI 模型更改为 gpt-5.5。
  • 将 OpenAI Codex Responses SSE 响应头等待时间更改为使用配置的 HTTP 超时,而非之前的固定 20 秒超时,减少慢连接上的假超时(#4945)。

修复

  • 修复了 Claude Sonnet 5 元数据,使其对 Anthropic 兼容和 Bedrock 请求使用自适应 thinking 负载。
  • 修复了生成式 Xiaomi MiMo 模型定价,使其与 models.dev 当前的按量付费定价一致(#6138)。
  • 修复了 Provider HTTP 错误,使其包含响应体而非不透明的 SDK 消息(#5832)。
  • 修复了 streamSimple() max-token 上限,使那些将输入和输出计入同一上下文窗口的 Provider 不会拒绝长请求(#5595)。
  • 修复了 OpenAI Responses 流,使其在输出项乱序完成时保留 reasoning 回放状态(#6009)。
  • 修复了 Z.AI preserved thinking 请求,使其在启用 thinking 时发送 thinking.clear_thinking: false,允许回放的 reasoning_content 参与 Provider 缓存(#6083)。
  • 修复了前导 Prompt 压缩,使其在压缩后停止而非立即继续(#6074)。
  • 修复了恢复会话时资源通知保持在消息之前的问题(#6048)。
  • 修复了启动基准计时输出,使其在 TUI 关闭后打印、保留扩展计时,并在停止基准模式前耗尽终端查询回复(#6030、#6063)。
  • 修复了扩展工具变更,使其在同一 agent 运行中的下一次 Provider 请求前应用,而不丢失 before_agent_start 系统提示覆盖(#6162)。
  • 修复了 undici 在终止流中 HTTP 响应时发出内部客户端错误导致的崩溃(#6133)。
  • 修复了压缩事件回归测试,以覆盖状态指示器清理并保持 CI 通过。
  • 修复了交互式状态指示器,使结束工作、重试、压缩或分支摘要指示器在启用 clear-on-shrink 时不再缩小 TUI(#6026)。
  • 修复了 --session 和 SessionManager.open(),使其拒绝非空无效的会话文件而不覆盖它们(#6002)。
  • 修复了用户消息转译渲染,使 Markdown 转义序列(如 \")中的可见反斜杠得以保留(#6105)。
  • 修复了因输出长度而停止的助手消息,使其显示可见的不完整响应错误(#4290)。
  • 修复了 --no-session --session-id,使临时 CLI 运行可以使用确定性会话 ID 以获得 Provider 缓存亲和性(#6070)。
  • 修复了磁盘 BMP 图像文件,使其被检测、转换为 PNG,并通过 read 和 CLI @file 输入附加(#6047)。
  • 修复了针对明确告知调用者重试请求的 Provider 流错误的自动重试(#6019)。
Pi AI

新增

  • 为 Anthropic 兼容、Bedrock、OpenRouter 和 Vercel AI Gateway Provider 添加了 Anthropic Claude Sonnet 5 模型元数据。
  • 添加了 Azure OpenAI Responses 对现代 Microsoft Foundry 端点 URL 的支持(#6004)。
  • 在 Usage 中添加了可选的 reasoning 字段,报告 reasoning/thinking token 计数作为 output 的子集。Anthropic(output_tokens_details.thinking_tokens)、OpenAI Responses/Codex/Azure(output_tokens_details.reasoning_tokens)、OpenAI Completions(completion_tokens_details.reasoning_tokens)以及 Google Generative AI / Vertex(thoughtsTokenCount)均已填充。Bedrock Converse 和 Mistral 未填充,因为这些 API 不返回 reasoning token 细分(#6057)。

变更

  • 将 OpenAI Codex Responses SSE 响应头等待时间更改为使用配置的 HTTP 超时,而非之前的固定 20 秒超时,减少慢连接上的假超时(#4945)。

修复

  • 修复了 Claude Sonnet 5 元数据,使其对 Anthropic 兼容和 Bedrock 请求使用自适应 thinking 负载。
  • 修复了生成的 Xiaomi MiMo 模型定价,使其与 models.dev 当前的按量付费定价一致(#6138)。
  • 修复了 Provider HTTP 错误,使其包含响应体而非不透明的 SDK 消息(#5832)。
  • 修复了 streamSimple() 发送上下文感知的 max-token 上限,使那些将输入和输出计入同一上下文窗口的 Provider 不会拒绝长请求(#5595)。
  • 修复了 OpenAI Responses 流,使其在输出项乱序完成时保留 reasoning 回放状态(#6009)。
  • 修复了针对明确告知调用者重试请求的 Provider 错误的重试分类(#6019)。
  • 修复了 Z.AI preserved thinking 请求,使其在启用 thinking 时发送 thinking.clear_thinking: false,允许回放的 reasoning_content 参与 Provider 缓存(#6083)。
Pi Agent

新增

  • 为需要下一轮循环上下文的 Agent 用户添加了 prepareNextTurnWithContext。

修复

  • 修复了 Agent.prepareNextTurn,使其持续接收运行中止信号而非下一轮上下文。
Pi TUI

新增

  • 添加了可选的 Markdown 渲染器选项,用于保留转译渲染中的源反斜杠转义(#6105)。

v0.80.2(2026-06-23)

Pi Coding Agent

变更

  • 将 pi-ai ApiKeyCredential 更改为使用与 auth.json 兼容的鉴别器 type: "api_key" 和 Provider 作用域内的 env 值,而非 type: "api-key" 和元数据。
  • 将 agent-core 公共 harness shell 执行选项类型从 ExecutionEnvExecOptions 重命名为 ShellExecOptions。

修复

  • 修复 Anthropic 兼容自定义模型,使其使用显式兼容性元数据,而非用于会话亲和性头部和不支持的工具字段省略的 Provider 名称启发式方法。
  • 修复请求作用域内的 apiKey 和 env 值,使其参与 Provider 身份验证解析,以便 Cloudflare 等 Provider 可以从显式调用选项中派生请求特定的基础 URL(#6021)。
  • 恢复 pi-ai compat 入口点上临时传统逐 API 流别名,如 streamSimpleOpenAICompletions(#6016、#6017)。
  • 恢复 openai-completions 中运行时 detectCompat 回退,用于没有显式兼容性元数据的模型(#6020)。
Pi AI

变更

  • 将 ApiKeyCredential 更改为使用与 auth.json 兼容的鉴别器 type: "api_key" 和 Provider 作用域内的 env 值,而非 type: "api-key" 和元数据。

修复

  • 修复 Anthropic 兼容自定义模型,使其使用显式兼容性元数据,而非用于会话亲和性头部和不支持的工具字段省略的 Provider 名称启发式方法。
  • 修复请求作用域内的 apiKey 和 env 值,使其参与 Provider 身份验证解析,以便 Cloudflare 等 Provider 可以从显式调用选项中派生请求特定的基础 URL(#6021)。
  • 恢复 compat 入口点上的临时传统逐 API 流别名,如 streamSimpleOpenAICompletions(#6016、#6017)。
  • 恢复 openai-completions 中的运行时 detectCompat 回退,用于没有显式兼容性元数据的模型(#6020)。
Pi Agent

变更

  • 将公共 harness shell 执行选项类型从 ExecutionEnvExecOptions 重命名为 ShellExecOptions。

v0.80.1(2026-06-23)

Pi Coding Agent

修复

  • 修复 Amazon Bedrock 作用域内 AWS_PROFILE 端点解析,适用于内置推理配置文件端点。
  • 修复 Fireworks Anthropic 兼容请求,为自定义 Fireworks 模型应用会话亲和性和不支持的工具字段默认值。
  • 修复 Together MiniMax M2.7 元数据,以避免不支持的 Together 推理切换。
Pi AI

修复

  • 修复 Amazon Bedrock 作用域内 AWS_PROFILE 端点解析的回归问题,适用于内置推理配置文件端点。
  • 修复 Fireworks Anthropic 兼容请求,为自定义 Fireworks 模型应用会话亲和性和不支持的工具字段默认值。
  • 修复 Together MiniMax M2.7 元数据,以避免不支持的 Together 推理切换。

v0.80.0(2026-06-23)

Pi Coding Agent

变更

  • 添加 Ctrl+J 作为默认换行快捷键,与 Shift+Enter 并列。
  • 将显示的 zai Provider 标签重命名为 ZAI Coding Plan (Global) 以提高清晰度(#5965)。
  • pi-ai 的旧全局 API(stream/complete/completeSimple、getModel/getModels/getProviders、registerApiProvider、getEnvApiKey 等)已从 @earendil-works/pi-ai 根入口点移至 @earendil-works/pi-ai/compat。扩展在运行时不受影响:扩展加载器会将 pi-ai 根解析为 compat 入口点(严格超集),因此现有扩展可继续正常工作。对 pi-ai 已发布类型进行类型检查的扩展应将这些导入切换为 @earendil-works/pi-ai/compat(或迁移到新的 createModels()/Provider-factory API)。compat 入口点和加载器别名将在未来版本中通过迁移指南移除。

修复

  • 修复会话名称,在存储或显示标签前规范化换行符(#5999,感谢 @haoqixu)。
  • 修复会话选择器,按每个子树中最新活动对线程化会话树排序(#5784,感谢 @Perlence)。
  • 修复与扩展相关的崩溃和启动失败报告,建议使用 pi -ne 重启。
  • 修复 OpenAI Responses 流,使其在缺失终端事件前失败,并修复上下文使用和压缩估算,在截断响应后忽略格式错误的全零助手使用情况(#5526,感谢 @dmmulroy)。
  • 修复 OpenAI Codex Responses WebSocket 会话,在输出开始前达到 OpenAI 连接限制时重新连接一次(#5973)。
  • 修复 Amazon Bedrock 端点解析,使其遵循作用域内的 AWS_PROFILE 值。
  • 修复 Cloudflare Providers,要求账户/网关配置并通过 Provider 身份验证路由内置兼容调用。
  • 修复 Provider 作用域内的身份验证环境变量值,使其能够到达 Models/ImagesModels API 调用和兼容 API 密钥注入。
  • 修复 OpenCode Go GLM-5.2 元数据,以暴露 xhigh 推理并发送 Provider 的最大推理强度(#5967)。
  • 修复 pi --resume,使其加载用户包主题并解析自动亮/暗主题设置。
  • 修复 models.json 自定义 Providers,使存储的凭据无需冗余 Provider 级别 apiKey 即可满足身份验证要求(#5953)。

移除

  • 移除了选择性 Provider @earendil-works/pi-ai/base 和 @earendil-works/pi-agent-core/base 入口点;请改用带有显式 Models Provider 工厂的根包。
Pi AI

不兼容变更

  • 根入口点(@earendil-works/pi-ai)现在仅包含核心功能且无副作用。旧的全局 API 已移至临时的 @earendil-works/pi-ai/compat 入口点,这是根的严格超集:只需更改文件的导入路径即可完成迁移。被移动的符号包括 stream/complete/streamSimple/completeSimple、getModel/getModels/getProviders(现在是 @earendil-works/pi-ai/providers/all 中 getBuiltinModel/getBuiltinModels/getBuiltinProviders 的已弃用别名)、registerApiProvider/unregisterApiProviders/resetApiProviders/getApiProvider、getEnvApiKey/findEnvKeys、setBedrockProviderModule、每个 API 的惰性流包装器(anthropicMessagesApi 等)以及图像生成 API。
  • 将 Provider 类型重命名为 ProviderId。Provider 现在是运行时 Provider 接口的名称(id、name、auth、模型列表、流行为)。
  • API 实现模块已从 src/providers/ 移至 @earendil-works/pi-ai/api/*,按 API id 重命名(anthropic -> api/anthropic-messages、google -> api/google-generative-ai、mistral -> api/mistral-conversations、amazon-bedrock -> api/bedrock-converse-stream),每个模块恰好导出 stream 和 streamSimple。旧的按实现导出的名称(streamAnthropic、streamSimpleAnthropic 等)和旧的原始 API 子路径(./anthropic、./google、./openai-completions 等)已移除;请通过 @earendil-works/pi-ai/api/* 导入原始 API 实现。
  • 移除了 @earendil-works/pi-ai/base 选择性 Provider 入口点;请将根/核心 API 与显式的 createModels() 集合和 Provider 工厂一起使用,以实现隔离的 bundle。
Pi Agent

不兼容变更

  • AgentHarnessOptions.models 是必需的,且是唯一的身份验证路径:Harness 通过提供的 Models 实例(models.streamSimple()/completeSimple())流处理轮次、压缩和分支摘要,通过 Providers 解析身份验证。已移除 AgentHarnessOptions.getApiKeyAndHeaders — 按请求解析密钥的应用现在应将其表示为 Models 集合中 Providers 的身份验证(ApiKeyAuth/OAuthAuth)。使用 createModels() + Provider 工厂(或 @earendil-works/pi-ai/providers/all 中的 builtinModels())构建;测试使用 fauxProvider()。
  • compact()、generateSummary() 和 generateBranchSummary() 接受 Models 参数,不再接受显式的 apiKey/headers。
  • StreamFn 以结构形式定义((model, context, options?) => AssistantMessageEventStream | Promise<...>);Models.streamSimple 满足它。
  • 移除了 @earendil-works/pi-agent-core/base 选择性 Provider 入口点;请改用带有显式 Models 实例的根包。

修复

  • 修复 Harness 会话名称,在存储标签前规范化换行符(#5999,感谢 @haoqixu)。
  • 修复 Harness 压缩估算,在截断响应后忽略格式错误的全零助手使用情况(#5526,感谢 @dmmulroy)。
Pi TUI

变更

  • 添加 Ctrl+J 作为默认换行快捷键,与 Shift+Enter 并列。

v0.79.10(2026-06-22)

Pi Coding Agent

新功能

  • 扩展压缩事件上下文 — Extension session_before_compact 和 session_compact 事件现在包含 reason 和 willRetry,使扩展可以区分手动 /compact、阈值自动压缩和溢出重试流程。参见 session_before_compact / session_compact 和 通过扩展自定义摘要。
  • 更安全的更新流程 — pi update 会安装精确匹配的已检出 Pi 版本,更新通知会显示 changelog URL,使升级更可预期。参见 安装与管理。

新增

  • 为扩展 session_before_compact 和 session_compact 事件添加了 reason 和 willRetry 元数据,使扩展可以区分手动、阈值和溢出压缩流程(#5962,感谢 @PizzaMarinara)。

修复

  • 修复了 find 工具,使其在父 .gitignore 规则忽略嵌套仓库时仍能尊重嵌套 git 仓库边界(#5960)。
  • 修复了 usage 文档的斜杠命令表,补全 /trust 和 /import(#5959)。
  • 修复了 OpenAI 兼容流式传输,保留在匹配 tool call delta 之前到达的加密 reasoning_details(#5114)。
  • 修复了损坏的 TUI 文档链接,指向计划模式扩展示例(#5957)。
  • 修复了会话替换或重载期间发出的瞬时扩展 UI 和会话启动消息,使其保持可见,并在重载完成前保持重载输入阻塞(#5943)。
  • 修复了 plan-mode 示例,使其保留活跃自定义工具、未找到计划时跳过动作提示,并从 agent_end 正确排队细化/执行 follow-up(#5940)。
  • 修复了 pi update,使其安装 Pi 更新检查返回的确切版本,--force 重新安装该检查版本,无可用版本时失败而不是回退到无版本重装,并报告旧版本和更新后的版本。
  • 修复了更新通知,将实际 changelog URL 显示为超链接文本。
Pi AI

修复

  • 修复了 OpenAI 兼容流式传输,保留在匹配 tool call delta 之前到达的加密 reasoning_details(#5114)。

v0.79.9(2026-06-20)

Pi Coding Agent

新功能

  • Chat-template thinking 兼容 — OpenAI 兼容的自定义 Provider 可以将 Pi 的 thinking 等级映射到 chat_template_kwargs,使基于 vLLM/Hugging Face chat-template 的模型(如 DeepSeek)能够使用 Provider 原生的 thinking 控制。参见 Custom Provider API Types 和 OpenAI Compatibility。
  • GLM-5.2 Provider 改进 — GLM-5.2 现在修正了 Fireworks OpenAI 兼容路由,并支持 OpenRouter xhigh thinking,使 GLM-5.2 用户在 /model 行为和高强度推理方面体验更佳。参见 Model Options。

新增

  • 添加了可配置 chat-template thinking 支持,适用于使用 chat_template_kwargs 的 OpenAI 兼容 Provider,例如 vLLM 后端的 DeepSeek 模型(#5673)。

修复

  • 修复了 Fireworks GLM-5.2 元数据,使其使用支持 reasoning_effort 的 OpenAI 兼容 Chat Completions 端点(#5923)。
  • 修复了同目录会话切换,使其复用已导入的扩展模块,同时保持扩展实例的新鲜性和生命周期事件(#5905)。
  • 修复了深层会话分支构建上下文或分支路径时耗时呈平方级增长的问题(#5909)。
  • 修复了 OpenRouter GLM-5.2 元数据,使其暴露 xhigh 推理并发送 OpenRouter 原生的 xhigh effort(#5770)。
  • 修复了 Markdown 流式代码围栏渲染,部分闭合围栏不再导致代码块在内容流式输出过程中缩小或闪烁(#5846,感谢 @xl0)。
  • 修复了 fuzzy edit 匹配,使其保留未触及的行块,而不是通过归一化内容重写整个文件(#5899)。
  • 修复了通过旧版 WSL bash.exe 执行的 bash 命令,使其通过 stdin 传入脚本,shell 变量得以在目标 bash 中展开(#5893)。
  • 修复了 /model,使其隐藏当前已认证账号不可用的 GitHub Copilot 模型(#5897)。
  • 修复了 /model 选择器搜索,使精确的 Provider 前缀匹配排在代理 Provider 模型 ID 匹配之前(#5892)。
Pi AI

新增

  • 添加了可配置的 chat-template thinking 支持,适用于使用 chat_template_kwargs 的 OpenAI 兼容 Provider,例如 vLLM 后端的 DeepSeek 模型(#5673)。

修复

  • 修复了 Fireworks GLM-5.2 元数据,使其使用支持 reasoning_effort 的 OpenAI 兼容 Chat Completions 端点(#5923)。
  • 修复了 OpenRouter GLM-5.2 元数据,使其暴露 xhigh 推理并发送 OpenRouter 原生的 xhigh effort(#5770)。
  • 修复了 GitHub Copilot OAuth 模型可用性,使其使用已认证账号的模型选择器目录(#5897)。
Pi Agent

修复

  • 修复了 Node 执行环境通过旧版 WSL bash.exe 执行命令时,将脚本通过 stdin 传入,使 shell 变量在目标 bash 中得以展开(#5893)。
Pi TUI

修复

  • 修复了 Markdown 流式代码围栏渲染,部分闭合围栏不再导致代码块在内容流式输出过程中缩小或闪烁(#5846,感谢 @xl0)。

v0.79.8(2026-06-19)

Pi Coding Agent

新功能

  • 选择性 Provider 基础入口 — SDK 用户可以将 @earendil-works/pi-ai/base 和 @earendil-works/pi-agent-core/base 与显式 Provider 注册配合使用,避免打包应用包含未使用的 Provider 传输层。参见 pi-ai Base Entry Point 和 pi-agent-core Base Entry Point。
  • Mistral Prompt 缓存 — Mistral 会话现在使用 Provider 端的 Prompt 缓存,具备会话亲和性和缓存 Token 用量/成本核算。参见 API Keys 和 Environment Variables。
  • 压缩后 Token 估算 — 压缩结果和压缩事件现在包含压缩后 Token 估算数,使客户端可以展示近似的上下文缩减量。参见 RPC compact 和 compaction events。
  • OpenRouter Fusion 别名 — openrouter/fusion 现可作为内置 OpenRouter 模型别名使用。参见 API Keys。

新增

  • 添加了 @earendil-works/pi-ai/base 和 @earendil-works/pi-agent-core/base 入口点,用于打包应用中的选择性 Provider 注册(#5348,感谢 @FredKSchott)。
  • 添加了 Mistral Prompt 缓存,使用 pi 会话 ID 作为 prompt_cache_key,包含缓存 Token 用量和成本核算(#5854)。
  • 为压缩结果和压缩事件添加了压缩后 Token 估算数(#5877)。
  • 添加了 OpenRouter Fusion 别名 openrouter/fusion(#5866,感谢 @dannote)。

修复

  • 更新了存在漏洞的运行时依赖,包括 undici 和打包的 protobufjs 传递依赖。
  • 修复了压缩,使其拒绝没有合格消息的会话,而不是产生空摘要(#4811)。
  • 修复了成功的溢出触发自动压缩,避免重试已完成的助手响应(#5720)。
Pi AI

新增

  • 添加了 @earendil-works/pi-ai/base 和直接 Provider 注册导出,供希望在不进行根内置注册的情况下选择性使用 Provider 传输层的打包工具使用(#5348,感谢 @FredKSchott)。
  • 添加了 Mistral 请求的 Prompt 缓存,使用 pi 会话 ID 作为 prompt_cache_key,包含缓存 Token 用量和成本核算(#5854)。
  • 添加了 OpenRouter Fusion 别名 openrouter/fusion(#5866,感谢 @dannote)。
Pi Agent

新增

  • 添加了 @earendil-works/pi-agent-core/base,供希望将 agent core 与选择性 @earendil-works/pi-ai/base Provider 注册配合使用的打包工具使用(#5348,感谢 @FredKSchott)。

v0.79.7(2026-06-18)

Pi Coding Agent

新功能

  • 自动主题模式 — /settings 现在可以选择独立的亮色和暗色主题,并跟随终端配色方案的变化。参见 Selecting a Theme。
  • 默认仅更新自身 — pi update 现在仅更新 pi,使用 pi update --all 可同时更新 pi 和扩展包。参见 Install and Manage。
  • 扩展 API 辅助工具 — 扩展可以使用 CONFIG_DIR_NAME 获取项目配置路径,并导入编辑差异辅助工具生成编辑式差异。参见 ctx.cwd 和 SDK Exports。
  • Warp 内联图片 — Warp 终端现在通过 Kitty 图形检测获得内联图片渲染。参见 Image。

新增

  • 添加了自动主题模式,使 /settings 可以使用独立的亮色和暗色主题并跟随终端配色方案变化(#5874)。
  • 添加了 Warp 终端图片能力检测,使内联图片通过 Warp 的 Kitty 图形支持渲染(#5841,感谢 @dodiego)。
  • 从 coding-agent 公共 API 导出了 CONFIG_DIR_NAME,使扩展可以解析项目配置路径而无需硬编码 .pi(#5869,感谢 @xl0)。
  • 从公共 API 导出了编辑差异辅助工具(generateDiffString、generateUnifiedPatch 和 EditDiffResult),供需要编辑式差异的扩展使用(#5756,感谢 @xl0)。

变更

  • 将裸 pi update 改为仅更新 pi,添加 pi update --all 用于同时更新 pi 和扩展,并澄清了扩展更新提示。
  • 在主题名称中保留 / 用于自动亮/暗主题设置。
  • 更新了扩展文档、示例、运行时帮助、信任提示和配置标签,使用配置的项目配置目录而非硬编码 .pi 路径。

修复

  • 修复了 RPC 未知命令错误,使其包含请求 id,避免客户端挂起等待响应(#5868)。
  • 修复了 /model 自动补全和模型选择搜索,无论先输入 Provider 还是模型 token 都能匹配 Provider/模型查询。
  • 修复了树形导航器,对深层条目进行水平平移,使选中项保持可读(#5830)。
Pi AI

新增

  • 为 OpenCode Go 订阅模型目录添加了 GLM-5.2 模型(#5860)。
Pi TUI

新增

  • 添加了终端配色方案查询和通知支持,用于亮/暗外观检测(TUI.queryTerminalColorScheme()、TUI.onTerminalColorSchemeChange() 和 TUI.setTerminalColorSchemeNotifications())(#5874)。
  • 添加了 Warp 终端检测以支持 Kitty 图形内联图片(#5841,感谢 @dodiego)。
  • 导出了 sliceByColumn,用于感知 ANSI 的水平列切片。

v0.79.6(2026-06-16)

Pi Coding Agent

修复

  • 修复了 HTTP dispatcher 配置,保留调用者显式设置的 fetch 覆盖,而非在其上重新安装 undici 全局 fetch。
  • 修复了 OpenCode Go DeepSeek V4 关闭 thinking 的请求,发送 Provider 的 thinking: { type: "disabled" } 兼容参数。
Pi AI

修复

  • 修复了 OpenCode Go DeepSeek V4 关闭 thinking 的请求,发送 Provider 的 thinking: { type: "disabled" } 兼容参数。

v0.79.5(2026-06-16)

Pi Coding Agent

新功能

  • Provider 级别的 API 密钥环境变量 — auth.json 的 API 密钥条目现在可以包含 env 覆盖,用于特定 Provider 的 Cloudflare、Azure OpenAI、Google Vertex、Amazon Bedrock、缓存保留和代理设置,无需修改项目 shell。参见 Auth File。
  • 全局 HTTP 代理设置 — 在全局设置中配置 httpProxy 即可将 HTTP_PROXY 和 HTTPS_PROXY 应用于 Pi 管理的 HTTP 客户端。参见 网络。
  • Vercel AI Gateway 归属 — Vercel AI Gateway 请求现在默认包含 Pi 归属头部。参见 API Keys。

新增

  • 为 Vercel AI Gateway 模型添加了请求归属头部(http-referer 和 x-title)(#5798,感谢 @rwachtler)。
  • 在启用实验性功能时添加了 xp 页脚标记。
  • 添加了全局 httpProxy 设置,作为 HTTP_PROXY 和 HTTPS_PROXY 应用于 Pi 管理的 HTTP 客户端(#5790)。
  • 添加了 auth.json API 密钥 env 值,使特定 Provider 的环境覆盖可以限定在 Pi 范围内,并传播到 Provider 配置(#5728)。

变更

  • 将 HTML 会话导出使用的 Markdown 解析器更新为 marked 18.0.5。

修复

  • 修复了 OpenAI Responses 流式响应,在工具调用前容忍 OpenAI 兼容服务器返回的 null 消息内容(#5819)。
  • 修复了 OpenCode DeepSeek V4 thinking 请求,避免同时发送 thinking 和 reasoning_effort(#5818)。
  • 修复了设备码登录,不再自动打开浏览器。
  • 修复了编辑器 Cursor Up 处理,非空草稿在浏览输入历史前先跳转到行首(#5789,感谢 @4h9fbZ)。
  • 修复了 Z.AI GLM-5.2 thinking 请求,发送 reasoning_effort 时使用 Provider 的 high/max 努力映射(#5770)。
  • 修复了 Windows 上 pi update 成功后的退出,改为自然退出而非调用 process.exit(0),避免版本检查网络请求后的 Node.js/libuv 断言(#5805)。
  • 修复了 Google 和 google-vertex Gemini 模型元数据,将 latest 别名映射到当前模型,为 Vertex 添加 Gemini 3.5 Flash,修正 Gemini 2.5 Flash Vertex 缓存定价,并移除已关闭的 Vertex 预览模型(#5761)。
  • 修复了会话选择器,在当前文件夹和全部范围会话列表均为空时保持打开并显示空状态(#5747)。
  • 修复了 Moonshot AI China 模型元数据,包含 Kimi K2.7 Code,并针对 Kimi K2.7 Code 模型省略不支持的关闭 thinking 载荷(#5760)。
Pi AI

新增

  • 添加了 Provider 级别的 StreamOptions.env 覆盖,用于 Provider 配置,包括 Cloudflare 端点占位符、Azure OpenAI、Google Vertex、Amazon Bedrock、缓存保留和代理环境变量查找(#5728)。

修复

  • 修复了 OpenAI Responses 流式响应,在工具调用前容忍 OpenAI 兼容服务器返回的 null 消息内容(#5819)。
  • 修复了 OpenCode DeepSeek V4 thinking 请求,避免同时发送 thinking 和 reasoning_effort(#5818)。
  • 修复了 Z.AI GLM-5.2 thinking 请求,发送 reasoning_effort 时使用 Provider 的 high/max 努力映射(#5770)。
  • 修复了 Google 和 google-vertex Gemini 模型元数据,将 latest 别名映射到当前模型,为 Vertex 添加 Gemini 3.5 Flash,修正 Gemini 2.5 Flash Vertex 缓存定价,并移除已关闭的 Vertex 预览模型(#5761)。
  • 修复了 Moonshot AI China 模型元数据,包含 Kimi K2.7 Code,并针对 Kimi K2.7 Code 模型省略不支持的关闭 thinking 载荷(#5760)。
Pi TUI

变更

  • 将 Markdown 解析更新为 marked 18.0.5。

修复

  • 修复了编辑器 Cursor Up 处理,非空草稿在浏览输入历史前先跳转到行首(#5789,感谢 @4h9fbZ)。

v0.79.4(2026-06-15)

Pi Coding Agent

新功能

  • 首次运行自动主题选择 — pi 在首次运行时会检测终端背景,并默认使用 dark 或 light 主题。参见 选择主题。
  • 独立二进制完整性校验 — GitHub 发布资源现在包含 SHA256SUMS 文件,用于校验独立二进制下载。参见 快速开始安装。

新增

  • 为独立二进制 GitHub 发布资源添加了 SHA256SUMS 完整性文件(#5739)。
  • 添加了首次运行时通过终端背景检测进行交互式主题选择(#5385,感谢 @vegarsti)。

修复

  • 修复了 bash 工具输出收集,在子进程退出但后代仍在写入时继续排空 stdout/stderr,避免截断延迟输出(#5753,感谢 @Mearman)。
  • 修复了 /tree 帮助渲染,在窄终端上显示紧凑的换行控件而非截断(#5055)。
  • 修复了 SIGTERM/SIGHUP 交互式关闭,在终端清理完成前保持信号处理程序安装,防止 signal-exit 重新发送信号并导致终端停留在 raw/Kitty 键盘模式(#5724)。
  • 修复了扩展文档,澄清 pi.getActiveTools() 返回活跃工具名称,而 pi.getAllTools() 返回工具元数据(#5729)。
  • 修复了 question 和 questionnaire 扩展示例,对长 Prompt、选项和帮助文本进行换行而非截断(#5708,感谢 @xl0)。
  • 修复了 pi list、pi install 和 pi update 等包命令,在完成后即使扩展留下后台句柄也能正常终止(#5687)。
  • 修复了 pnpm 全局安装的 pi update,当其配置的 global-bin-dir 与活动的 pnpm home 不匹配时(#5689)。
  • 修复了使用范围或标签(如 @^1.2.7)的 npm 包规范,使已安装的包资源仍能加载,而不会被视为不匹配的确切固定版本(#5695)。
  • 修复了 Anthropic 1 小时 Prompt 缓存写入成本计算,将 1 小时缓存写入定价为 2 倍输入,而非 5 分钟缓存写入费率(#5738,感谢 @theBucky)。
  • 修复了 GitHub Copilot Claude adaptive thinking 元数据,以匹配手动检查的 Copilot 模型能力(#4637)。
  • 修复了 OpenCode/OpenCode Go 补全模型元数据,对拒绝 prompt_cache_retention 的路由省略长保留缓存字段(#5702)。
  • 修复了 overlay 在 CJK 宽字符上的合成,使 overlay 在全宽单元格内开始时边框保持对齐(#5297)。
  • 修复了 WezTerm 内联 Kitty 图片在全量重绘回退期间的渲染,在绘制之前预留图片填充行,且不回归高图放置(#5618、#4415)。
  • 修复了自定义 Provider 配置,使纯大写 API key 和 header 值保持为字面量而非被视为旧版环境变量引用;使用显式的 $ENV_VAR 语法表示环境变量(#5661)。
Pi AI

修复

  • 修复了 Anthropic 1 小时 Prompt 缓存写入成本计算,将 1 小时缓存写入定价为 2 倍输入,而非 5 分钟缓存写入费率(#5738,感谢 @theBucky)。
  • 修复了 GitHub Copilot Claude adaptive thinking 元数据,以匹配手动检查的 Copilot 模型能力(#4637)。
  • 修复了拒绝 prompt_cache_retention 的 OpenCode/OpenCode Go 补全模型,在 cacheRetention 为 long 时省略长保留缓存字段(#5702)。
Pi TUI

新增

  • 添加了终端背景色查询支持,用于 OSC 11 回复(#5385,感谢 @vegarsti)。

修复

  • 修复了 overlay 在 CJK 宽字符上的合成,使 overlay 在全宽单元格内开始时边框保持对齐(#5297)。
  • 修复了 WezTerm 内联 Kitty 图片在全量重绘回退期间的渲染,在绘制之前预留图片填充行,且不回归高图放置(#5618、#4415)。

v0.79.3(2026-06-13)

Pi Coding Agent

修复

  • 修复了压缩摘要系统 Prompt,对非编码 Agent 使用中性 AI 助手措辞(#5401)。
Pi AI

修复

  • 将 OpenAI GPT-5.4/GPT-5.5 和 OpenAI Codex GPT-5.4/GPT-5.4 mini/GPT-5.5 上下文窗口元数据恢复至实际观测的 272k Token Codex 后端限制,避免发送超出 Codex 接受限制的 Prompt 产生计费风险(感谢 @trethore 反馈)。

v0.79.2(2026-06-12)

Pi Coding Agent

新功能

  • 更清晰的 Bedrock 验证指引 — Amazon Bedrock 数据保留验证错误现在会链接到 AWS 数据保留文档。参见 Amazon Bedrock。

新增

  • 在 PI_EXPERIMENTAL=1 下添加了实验性首次设置流程,询问深浅色主题选择(预选检测到的外观)以及首次启动时选择加入的数据分析共享;选择加入会在 settings.json 中存储 trackingId(#5587,感谢 @vegarsti)。
  • 为 Amazon Bedrock 不支持的数据保留模式验证错误添加了 AWS 数据保留文档链接(#5561,感谢 @unexge)。

修复

  • 修复了项目信任检测,当从 $HOME 运行时忽略全局 ~/.pi/agent 状态,并让 pi update 仅使用已保存或显式的项目信任而不进行提示(#5619)。
  • 修复了实验性首次设置,使其跳过已分叉的会话而非重新运行设置提示(#5627,感谢 @vegarsti)。
  • 修复了 OpenAI 兼容上下文溢出检测,支持带括号的 maximum context length (N) 错误(#5677)。
  • 修复了 OpenAI GPT-5.4/GPT-5.5 和 OpenAI Codex GPT-5.4/GPT-5.4 mini/GPT-5.5 上下文窗口元数据,以匹配当前 OpenAI 限制(#5644)。
  • 修复了 Anthropic 拒绝终止行为,在错误消息中保留了 Provider 的 stop_details 说明(#5666,感谢 @rwachtler)。
  • 将 OpenAI Codex Responses SSE 响应头超时增加到 20 秒,以减少误报暂停,同时保留为零事件挂起引入的有界等待(#4945)。
  • 修复了 Claude Fable 5 关闭 thinking 请求,省略了 Anthropic 不支持的 thinking.type: "disabled" 负载(#5567,感谢 @tmustier)。
  • 修复了工具结算后延迟到达的 tool progress 回调被正确忽略的问题(而非发出陈旧的 tool_execution_update 事件)(#5573)。
  • 修复了用户消息转录渲染,使独立的 + 消息不再渲染为 -(#5657)。
  • 修复了斜杠分隔模糊查询,使 Provider/模型补全在插入后仍可匹配。
  • 修复了 WezTerm 内联 Kitty 图片渲染,使保留行清除不再擦除除顶部条带之外的所有工具图片预览(#5618)。
  • 修复了 CJK 编辑器换行,使其在字符边界处断行而非留下较大的尾部空白(#5585,感谢 @haoqixu)。
  • 修复了宽松 Markdown 列表渲染,保留了列表项之间的空行分隔(#5562,感谢 @Perlence)。
  • 修复了 --model 解析,对于斜杠前缀与未认证的内置 Provider 匹配的已认证自定义模型 ID(#5643)。
  • 修复了 /fork 在分叉路径包含标签时保持会话父链的连接(#5669)。
  • 修复了 /share 和 /export HTML 导出在配置的自定义主题不再存在时使用活动的回退主题(#5596)。
  • 修复了带有 :<thinking> 后缀的自定义回退模型 ID,在 Provider 模板模型未声明推理能力时保留请求的 thinking 级别(#5560,感谢 @haoqixu)。
Pi AI

新增

  • 为 Amazon Bedrock 不支持的数据保留模式验证错误添加了 AWS 数据保留文档链接(#5561,感谢 @unexge)。

修复

  • 修复了 OpenAI 兼容上下文溢出检测,支持带括号的 maximum context length (N) 错误(#5677)。
  • 修复了 OpenAI GPT-5.4/GPT-5.5 和 OpenAI Codex GPT-5.4/GPT-5.4 mini/GPT-5.5 上下文窗口元数据,以匹配当前 OpenAI 限制(#5644)。
  • 将 OpenAI Codex Responses SSE 响应头超时增加到 20 秒,以减少误报暂停,同时保留为零事件挂起引入的有界等待(#4945)。
  • 修复了 Anthropic 拒绝终止行为,在错误消息中保留了 Provider 的 stop_details 说明(#5666,感谢 @rwachtler)。
  • 修复了 Claude Fable 5 关闭 thinking 请求,省略了 Anthropic 不支持的 thinking.type: "disabled" 负载(#5567,感谢 @tmustier)。
Pi Agent

修复

  • 修复了工具结算后延迟到达的 tool progress 回调被正确忽略的问题(而非发出陈旧的 tool_execution_update 事件)(#5573)。
Pi TUI

修复

  • 修复了 Markdown 源码列表标记保留,使无序标记也能被保留,这样独立的 + 用户消息不再渲染为 -(#5657)。
  • 修复了斜杠分隔的模糊查询,使 Provider/模型补全在插入后仍可匹配。
  • 修复了 WezTerm 内联 Kitty 图片渲染,使保留行清除不再擦除除顶部条带之外的所有工具图片预览(#5618)。
  • 修复了 CJK 编辑器换行,使其在字符边界处断行而非留下较大的尾部空白(#5585,感谢 @haoqixu)。
  • 修复了宽松 Markdown 列表渲染,保留了列表项之间的空行分隔(#5562,感谢 @Perlence)。

v0.79.1(2026-06-09)

Pi Coding Agent

新功能

  • Claude Fable 5 — Claude Fable 5 现已在 Anthropic 和 Amazon Bedrock Provider 上可用,支持 adaptive thinking 与 xhigh 推理强度。
  • Prompt 模板默认值 — Prompt 模板可使用 ${1:-7} 这样的位置参数默认值。参见 Prompt 模板参数。
  • 可配置的项目信任默认值 — defaultProjectTrust 允许用户选择未解析的项目信任询问是默认通过、始终信任还是从不信任,扩展也可以检视生效的信任决策。参见 项目信任 和 ctx.isProjectTrusted()。
  • 扩展自动补全的触发字符 — 扩展的自动补全 Provider 可以声明 # 或 $ 这样的触发字符,让建议无需斜杠命令前缀即可弹出。参见 自动补全 Provider。

新增

  • 为 Prompt 模板位置参数添加了默认值展开,例如 ${1:-7}(#5553,感谢 @dannote)。
  • 添加了 areExperimentalFeaturesEnabled 特性开关,让用户能够选择启用实验性功能(#5547,感谢 @vegarsti)。
  • 添加了 ctx.isProjectTrusted(),使扩展能够观察生效的项目信任决策,包括临时信任决策(#5523)。
  • 添加了全局的 defaultProjectTrust 设置,用于选择未解析的项目信任询问是默认通过、始终信任还是从不信任。
  • 为 ctx.ui.addAutocompleteProvider() 包装器添加了扩展自动补全触发字符支持(#4703)。
  • 在 Anthropic 和 Amazon Bedrock Provider 上添加了 Claude Fable 5 模型支持,支持 adaptive thinking 与 xhigh 推理强度。

修复

  • 修复了来自 Amazon Bedrock 的推理配置文件 ARN 区域解析,优先使用 ARN 内嵌的区域而非 AWS_REGION(#5527,感谢 @AJM10565)。
  • 修复了 IME 硬件光标定位,在斜杠命令自动补全可见时正确显示(#5283,感谢 @smoosex)。
  • 修复了 z.ai 关闭 thinking 请求,使其发送 Provider 的 thinking: { type: "disabled" } 兼容性参数(#5330)。
  • 修复了 OpenCode completions 模型元数据,将显式的 maxTokens 作为 max_tokens 发送(#5331)。
  • 修复了 Moonshot Kimi 关闭 thinking 请求,使其发送 Provider 的 thinking: { type: "disabled" } 兼容性参数(#5531)。
  • 修复了 Azure OpenAI Responses 请求,禁用服务器端的响应存储(#5530)。
  • 修复了 Azure GPT-5.4 和 GPT-5.5 上下文窗口元数据为 1,050,000 Token,与 Azure Foundry 部署保持一致,而非 OpenAI 的 272k 上限(#5559)。
  • 修复了 OpenAI 和 Azure GPT-5 Pro maxTokens 元数据为 128,000,修正了上游错误地将 272,000 输入子限制复制为输出限制的值(#5559)。
  • 修复了 Prompt 历史导航,使浏览历史返回时能恢复当前草稿(#5494)。
  • 修复了混合拉丁文与 CJK 文本的换行行为,使无空格 CJK 序列能在字素边界处断行,避免留下过大的尾部空白(#5495)。
  • 修复了扩展 OAuth 登录提示,使先前提交的提示行保持稳定,而不再镜像当前输入值(#5433)。
  • 修复了 /reload 会将更新后的 steeringMode 和 followUpMode 设置应用到当前会话(#5377)。
  • 修复了 models.json 语法无效时跳过启动配置迁移并按文件路径感知的方式报告正常的 models 错误,而非抛出原始的 JSON 解析堆栈(#5418)。
  • 修复了 GitHub 发布说明和交互式 changelog 链接,使其能正确解析包相对文档 URL(#5516)。
  • 修复了 CLI 帮助与版本输出,包括纯重定向的 --help/--version 输出,并简化了 list/config 帮助文本。
  • 修复了临时会话的 /new 默认将新会话也保持为临时会话而非持久化(#5045)。
  • 澄清了自定义模型文档中 name 和 modelOverrides.name 不会替换页脚或主模型列表中的模型 ID(#4841)。
Pi AI

新增

  • 在 Anthropic 和 Amazon Bedrock 模型元数据中添加了 Claude Fable 5,支持 adaptive thinking 与 xhigh 推理强度。

修复

  • 修复了 Amazon Bedrock 推理配置文件 ARN 区域解析,优先使用 ARN 内嵌的区域而非 AWS_REGION(#5527,感谢 @AJM10565)。
  • 修复了 z.ai 关闭 thinking 请求,使其发送 Provider 的 thinking: { type: "disabled" } 兼容性参数(#5330)。
  • 修复了 OpenCode completions 模型元数据,将显式的 maxTokens 作为 max_tokens 发送(#5331)。
  • 修复了 Moonshot Kimi 关闭 thinking 请求,使其发送 Provider 的 thinking: { type: "disabled" } 兼容性参数(#5531)。
  • 修复了 Azure OpenAI Responses 请求,禁用了服务器端的响应存储(#5530)。
  • 修复了 Azure GPT-5.4 和 GPT-5.5 上下文窗口元数据为 1,050,000 Token,与 Azure Foundry 部署保持一致,而非 OpenAI 的 272k 上限(#5559)。
  • 修复了 OpenAI 和 Azure GPT-5 Pro maxTokens 元数据为 128,000,修正了上游错误地将 272,000 输入子限制复制为输出限制的值(#5559)。
Pi Agent

无变更。

Pi TUI

新增

  • 添加了 AutocompleteProvider.triggerCharacters,使编辑器自动补全能自然地在 Provider 定义的 Token 前缀上触发(#4703)。

修复

  • 修复了斜杠命令自动补全可见时的 IME 硬件光标定位(#5283,感谢 @smoosex)。
  • 修复了 Prompt 历史导航,使浏览历史返回时能恢复当前草稿(#5494)。
  • 修复了混合拉丁文与 CJK 文本的换行行为,使无空格 CJK 序列能在字素边界处断行,避免留下过大的尾部空白(#5495)。

v0.79.0(2026-06-08)

Pi Coding Agent

新功能

  • 项目信任保护本地输入 — Pi 现在在加载项目本地设置、资源、指令和包之前会请求确认,支持 --approve / --no-approve 非交互模式控制与保存决策。参见 项目信任。
  • 扩展控制的信任决策 — 全局和 CLI 扩展可处理 project_trust,在项目本地资源加载前决定、记住或推迟项目信任。参见 project_trust。
  • 页脚缓存命中率可见 — 交互式页脚现在显示最新的 Prompt 缓存命中率(CH)。参见 交互模式。
  • 更丰富的 SDK 和 RPC 扩展接口 — 公共导出现包含 RPC 扩展 UI 请求/响应类型与包资源路径助手。参见 扩展 UI 协议 和 SDK 导出。

新增

  • 添加了 project_trust 扩展事件,使全局和 CLI 扩展可在启动与运行时 cwd 切换期间决定或推迟项目信任。
  • 添加了项目信任门控,用于项目本地设置、资源、指令和包(#5332)。
  • 在交互式页脚中添加了最新 Prompt 缓存命中率。
  • 从公共 API 导出了 RPC 扩展 UI 请求与响应类型(#5455)。
  • 从公共 API 导出了 coding-agent 包资源路径助手(#5415)。

修复

  • 修复了包导出,移除指向不存在构建产物的过时 ./hooks 子路径。
  • 修复了 TUI 渲染在内容缩为零时清除过时行的问题。
  • 修复了自动补全建议在编辑器光标移动后刷新的问题(#5499,感谢 @Roman-Galeev)。
  • 修复了 /reload 在隐式信任会话创建项目 .pi 目录时持久化项目信任的问题。
  • 修复了项目信任输入发现以可移植方式遍历父目录的问题。
  • 修复了间歇性 Shift+Enter 处理,使 Kitty 键盘协议回退变为响应驱动而非超时驱动(#5188)。
  • 修复了压缩摘要系统 Prompt,为非 coding agent 使用中立的 AI 助手措辞(#5401)。
  • 修复了 models.json schema 支持与 OpenAI Responses 自定义 Provider 对 compat.supportsDeveloperRole: false 的处理(#5456)。
  • 修复了 Prompt 历史导航,使向上浏览时光标位于开头、向下浏览时光标位于末尾(#5454)。
  • 修复了 tmux 设置文档,要求 tmux 3.5 以使用 extended-keys-format csi-u,并记录 tmux 3.2-3.4 回退方案(#5432)。
  • 修复了 OpenRouter 路由偏好,使 OpenAI 兼容自定义 Provider 在 base URL 不直接指向 OpenRouter 时也能正常工作(#5347)。
  • 修复了内置工具展开提示中闭合括号样式不一致的问题(#5359)。
  • 修复了 Skill 包装的 Prompt 在 Skill 指令与用户消息之间插入间距的问题(#5371,感谢 @Perlence)。
Pi AI

修复

  • 修复了 OpenAI Responses 自定义 Provider 对推理模型 compat.supportsDeveloperRole: false 的处理(#5456)。
  • 修复了 OpenRouter 路由偏好,使 OpenAI 兼容自定义 Provider 在 baseUrl 不直接指向 OpenRouter 时也能发送 compat.openRouterRouting(#5347)。
Pi Agent

修复

  • 修复了压缩摘要系统 Prompt,为非 coding agent 使用中立的 AI 助手措辞(#5401)。
Pi TUI

修复

  • 修复了 Prompt 历史导航,使向上浏览时光标位于开头、向下浏览时光标位于末尾,确保重复按 Up/Down 能立即遍历多行 Prompt(#5454)。
  • 修复了间歇性 Shift+Enter 处理,使 Kitty 键盘协议回退变为响应驱动而非超时驱动(#5188)。
  • 修复了 TUI 渲染在内容缩为零时清除过时行的问题。
  • 修复了自动补全建议在编辑器光标移动后重新查询的问题(#5499,感谢 @Roman-Galeev)。

v0.78.1(2026-06-04)

Pi Coding Agent

新功能

  • 更广泛的内置 Provider 覆盖 — 新增 Ant Ling 和 NVIDIA NIM Provider 设置文档,以及 MiniMax-M3 对直接 MiniMax Provider 的支持。参见 Providers。
  • 更丰富的扩展上下文 — 扩展可使用 ctx.mode 和 ctx.getSystemPromptOptions() 在 TUI、RPC、JSON 和 print 模式间适配行为,并检查基础系统 Prompt 输入。参见 Extensions。

新增

  • 添加了容器化文档和 Gondolin 扩展示例,用于将内置工具路由到本地 micro-VM。
  • 添加了 Ant Ling Provider 选择和设置文档。
  • 添加了 MiniMax-M3 模型支持(来自 @earendil-works/pi-ai),适用于 minimax 和 minimax-cn 直接 Provider(#5313)。
  • 添加了 NVIDIA NIM Provider 选择、设置文档和直接 NIM 请求归属头。
  • 在扩展上下文中添加了 ctx.mode,使扩展能够区分 TUI、RPC、JSON 和 print 模式。
  • 为扩展命令添加了 ctx.getSystemPromptOptions(),用于检查当前基础系统 Prompt 输入(#5306,感谢 @xl0)。

修复

  • 修复了临时扩展包安装使用带 0700 权限的私有 ~/.pi/agent/tmp/extensions 目录,而非 os.tmpdir()/pi-extensions。
  • 修复了 git 包源处理,拒绝不安全的主机/路径组件,并将托管克隆路径保持在安装根目录内。
  • 修复了 HTML 会话导出中的存储型 XSS,通过剥离控制字符后使用方案白名单清理 Markdown 链接和图片 URL。
  • 修复了 SDK 嵌入在捆绑的 Node 应用中因缺少 package.json 而导致 ENOENT 失败的问题。包元数据读取器现在通过使用默认值优雅地处理缺失的 package.json,无需在运行时提供包相邻文件即可使用 createAgentSession()(#5226)。
  • 修复了 HTTP 超时设置未对非 Codex Provider(如通过 OpenAI 兼容 API 的 llama.cpp)生效的问题。httpIdleTimeoutMs 设置(通过 /settings HTTP 超时设置)现在作为所有支持 Provider 的默认 SDK 请求超时,而不仅仅是 OpenAI Codex Responses。禁用超时(HTTP 超时 = false)现在通过发送最大 int32 值(有效无限)而非 0 来正确禁用所有支持 Provider 的 SDK 超时,因为 SDK 将 timeout=0 视为立即超时(#5294)。
  • 修复了 Amazon Bedrock 请求,用占位符替换空白的必填 user/tool-result 文本,并跳过空白的重放文本块(#4975)。
  • 修复了 Anthropic Claude Opus 4.7+ 请求,抑制已弃用的 temperature 参数(#5251,感谢 @yzhg1983)。
  • 修复了 OpenAI GPT-5.5 生成元数据,省略不支持的 minimal thinking(#5243)。
  • 修复了 OpenRouter Kimi K2.6 thinking 重放和 developer-role 指令处理(#5309)。
  • 修复了 OpenRouter reasoning 指令请求,按需保留 system 角色(#5221,感谢 @PriNova)。
  • 修复了 overlay 焦点恢复,使非捕获 overlay 在 UI 重渲染和显式焦点释放后保持可交互(#5235,感谢 @nicobailon)。
  • 修复了列切片和 overlay 合成中的 tab 宽度计算,使包含 tab 的输出不会超过终端宽度(#5218)。
  • 修复了打开和列出超大 JSONL 会话文件,改为逐行读取会话条目而非将整个文件作为单个字符串实例化(#5231)。
  • 修复了 WSL /mnt/... 仓库中页脚分支显示在分支变更后刷新的问题(#5264,感谢 @psoukie)。
  • 修复了 renderShell: "self" 工具渲染器未输出组件行时留下空白聊天行的问题(#5299)。
  • 恢复了 NVIDIA Qwen 3.5 122B NIM 模型支持。
Pi AI

新增

  • 添加了 Ant Ling 作为内置 OpenAI 兼容 Provider,支持 Ling 2.6 和 Ring 2.6 模型。
  • 为 minimax 和 minimax-cn 直接 Provider 添加了 MiniMax-M3 模型,并移除了掩盖 models.dev 值的硬编码上下文窗口覆盖(#5313)。
  • 添加了 NVIDIA NIM 作为内置 OpenAI 兼容 Provider,公开支持 tool use 的公共 NIM 模型。

修复

  • 修复了 Amazon Bedrock 请求,用占位符替换空白的必填 user/tool-result 文本,并跳过空白的重放文本块(#4975)。
  • 修复了 Anthropic Claude Opus 4.7+ 请求,抑制已弃用的 temperature 参数(#5251,感谢 @yzhg1983)。
  • 修复了 OpenAI GPT-5.5 生成元数据,省略不支持的 minimal thinking(#5243)。
  • 修复了 OpenRouter Kimi K2.6 thinking 重放,并为 OpenRouter OpenAI 和 Anthropic 模型保留 developer-role 指令(#5309)。
  • 修复了 OpenRouter reasoning 指令请求,按需保留 system 角色(#5221,感谢 @PriNova)。
  • 恢复了 NVIDIA Qwen 3.5 122B NIM 模型。
Pi TUI

修复

  • 修复了 overlay 焦点恢复,使非捕获 overlay 在 UI 重渲染和显式焦点释放后保持可交互(#5235,感谢 @nicobailon)。
  • 修复了列切片和 overlay 合成中的 tab 宽度计算,使包含 tab 的输出不会超过终端宽度(#5218)。

v0.78.0(2026-05-29)

Pi Coding Agent

新功能

  • 命名启动会话 — --name / -n 可在交互、打印、JSON 和 RPC 模式下于启动前设置会话显示名称。参见 命名会话 和 会话选项。
  • 可点击的文件工具路径 — 内置文件工具的标题在终端支持时会渲染 OSC 8 file:// 超链接,包括支持的 tmux 客户端。

新增

  • 为扩展作者导出了 convertToPng(#5167,感谢 @xl0)。
  • 为扩展作者导出了 parseArgs 和类型 Args(#5202,感谢 @xl0)。
  • 添加了 --name / -n 以在启动时设置会话显示名称(#5153)。
  • 退出交互会话时添加了 resume 命令提示(#5176,感谢 @yzhg1983)。
  • 内置文件工具标题中的文件路径添加了 OSC 8 file:// 超链接(#5189,感谢 @mpazik)。
  • 添加了自定义 Amazon Bedrock 请求头支持(来自 @earendil-works/pi-ai)(#5178,感谢 @stephanmck)。

修复

  • 澄清了 WezTerm/WSL IME 硬件光标文档,说明光标可见性仍是可选的(#5200)。
  • 修复了 GitLab Duo 自定义 Provider 示例,使其对 Claude 模型使用 adaptive thinking、暴露 xhigh thinking 并包含更新的已验证模型 ID(#5201)。
  • 修复了 Bun 发布归档的创建流程,确保安装并复制匹配的 @mariozechner/clipboard 基础包和原生 sidecar(#5184)。
  • 修复了提示循环启动前输入的早期交互输入被丢弃的问题,现改为缓冲处理(#5195,感谢 @yzhg1983)。
  • 修复了 OpenRouter Moonshot Kimi K2.6 请求使用 system 而非不支持的 developer 消息(#5159)。
  • 修复了 OpenCode Go Kimi K2.6 thinking 请求发送 thinking 对象而非无效字符串值,并修复了 OpenCode Zen Grok Build thinking 请求省略不支持的 reasoning_effort(#5169)。
  • 修复了 OpenAI Codex Responses SSE 流,在终端事件后中止响应体读取。
  • 修复了 OpenCode Kimi K2.6 生成的元数据,使用 Anthropic 风格的 thinking 元数据而非无效的 reasoning-effort 参数。
  • 修复了 OSC 8 超链接在客户端支持时通过 tmux 传递(#5189,感谢 @mpazik)。
  • 修复了 ANSI 文本换行,避免超长换行时发生栈溢出(#5185)。
Pi AI

不兼容变更

  • 更改了直接 Provider 流函数,要求显式传入 options.apiKey;顶层 stream*/complete* 辅助函数仍保留内置环境认证。

新增

  • 通过 StreamOptions.headers 添加了自定义 Amazon Bedrock 请求头支持,排除了保留的 AWS 签名头(#5178,感谢 @stephanmck)。

修复

  • 修复了 OpenRouter Moonshot Kimi K2.6 请求使用 system 而非不支持的 developer 消息(#5159)。
  • 修复了 OpenCode Go Kimi K2.6 thinking 请求发送 thinking 对象而非无效字符串值,并修复了 OpenCode Zen Grok Build thinking 请求省略不支持的 reasoning_effort(#5169)。
  • 修复了 OpenAI Codex Responses SSE 流,在终端事件后中止响应体读取。
  • 修复了 OpenCode Kimi K2.6 生成的元数据,使用 Anthropic 风格的 thinking 元数据而非无效的 reasoning-effort 参数。
Pi TUI

修复

  • 修复了 ANSI 文本换行,避免超长换行时发生栈溢出(#5185)。
  • 澄清了 IME 硬件光标文档,说明光标可见性仍是可选的(#5200)。
  • 修复了 OSC 8 超链接在客户端支持时通过 tmux 传递(#5189,感谢 @mpazik)。

v0.77.0(2026-05-28)

Pi Coding Agent

新功能

  • Claude Opus 4.8 支持 — 新增 Anthropic Claude Opus 4.8 元数据,并更新 Opus adaptive-thinking 覆盖范围。
  • 选择性工具禁用 — --exclude-tools / -xt 可禁用指定的内置、扩展或自定义工具,其余工具保持可用。参见 工具选项。
  • 无头 Codex 订阅登录 — /login 可使用设备码认证登录 ChatGPT Plus/Pro Codex 订阅。参见 订阅 和 OpenAI Codex。
  • 感知流式行为的扩展输入 — 扩展可通过 InputEvent.streamingBehavior 区分空闲 Prompt、流中转向和排队的后续操作。参见 输入事件。

新增

  • 新增 --exclude-tools / -xt 参数,可禁用指定的内置、扩展或自定义工具,其余工具保持可用(#5109)。
  • 新增 OpenAI Codex 订阅设备码登录作为可选的无头替代方案,同时保留浏览器登录为默认方式(#4911,感谢 @vegarsti)。
  • 为扩展输入事件新增 streamingBehavior,使扩展能够区分空闲 Prompt、流中转向和排队的后续操作(#5107,感谢 @DanielThomas)。
  • 新增 Claude Opus 4.8 模型元数据(Anthropic),并更新 Opus adaptive-thinking 覆盖范围以使用它。

修复

  • 修复了启动时间输出,readPipedStdin 不再包含 createAgentSessionRuntime 的工作(#4829)。
  • 修复了 OpenRouter DeepSeek V4 xhigh reasoning 元数据,保留 OpenRouter 原生的 effort 而非发送 DeepSeek 的 max effort(#4801)。
  • 修复了自定义会话目录,使当前文件夹的 resume/continue 查找限定于当前 cwd,而 all-session 列表覆盖自定义目录。
  • 修复了 SIGTERM/SIGHUP 退出流程,运行扩展 session_shutdown 清理并恢复终端:信号触发的关闭现在在终端写入之前发出 session_shutdown,SIGHUP 不再硬退出,因此即使终端已消失,扩展资源(如 socket)也会被释放(#5080)。
  • 修复了键盘协议协商,忽略不匹配或延迟的终端响应,避免误检测 Kitty 键盘协议(#5091,感谢 @mitsuhiko)。
  • 修复了 MSYS2 ucrt64 Node.js 下 Windows 启动崩溃,通过更新原生剪贴板插件至 napi-rs 3.x(#5028)。
  • 修复了 API Key 和 Header 配置解析:将普通字符串视为字面量,支持 $ENV_VAR / ${ENV_VAR} 插值和 $! 转义,配置文件要求显式 env 语法,避免 Windows 大小写不敏感的 env 匹配破坏字面量 Key(#5095)。
  • 修复了会话销毁流程,中止进行中的 agent、compaction、branch summary、retry 和 bash 工作(#5029,感谢 @TerminallyChilI)。
  • 修复了 pi.getAllTools(),暴露每个工具的 promptGuidelines,供需要按工具归因 guideline 的扩展使用(#4879)。
  • 修复了从 Anthropic extended-thinking 会话切换到 OpenAI Codex Responses 后的回放问题,为转换的 thinking/text 块生成唯一的 fallback 消息项 ID(#5148)。
  • 修复了返回空 thinking signature 的 Provider 的 Anthropic 兼容回放,新增可选的 allowEmptySignature 兼容性标志(#4464)。
  • 修复了 OpenAI 和 OpenRouter GPT-5.5 Pro thinking level 元数据,仅暴露支持的 medium、high 和 xhigh efforts。
  • 修复了 OpenCode Go Kimi K2.6 thinking-off 请求,发送 thinking: "none"(#5078)。
  • 修复了 Xiaomi Token Plan 模型元数据,省略不支持的 mimo-v2-flash 变体(#5075)。
  • 修复了由 agent_end 扩展处理器排队的后续消息,确保在 agent 变为空闲之前排出(#5115,感谢 @DanielThomas)。
  • 修复了扩展输入事件,仅在流式处理期间实际排队的 Prompt 上报告 streamingBehavior(#5107,感谢 @DanielThomas)。
  • 修复了系统 Prompt 的工具选择指引,避免偏好不可用的文件探索工具(#5132)。
  • 修复了 fenced diff 代码块及其他 highlight.js 作用域,在 cli-highlight 替换后保持感知主题的语法高亮颜色(#5092)。
Pi AI

新增

  • 新增 OpenAI Codex 订阅设备码登录作为可选的无头替代方案,同时保留浏览器登录为默认方式(#4911,感谢 @vegarsti)。
  • 新增 Claude Opus 4.8 模型元数据(Anthropic),并更新 Opus adaptive-thinking 覆盖范围以使用它。

修复

  • 修复了 OpenRouter DeepSeek V4 xhigh reasoning 元数据,保留 OpenRouter 原生的 effort 而非发送 DeepSeek 的 max effort(#4801)。
  • 修复了从 Anthropic extended-thinking 会话切换到 OpenAI Codex Responses 后的回放问题,为转换的 thinking/text 块生成唯一的 fallback 消息项 ID(#5148)。
  • 修复了返回空 thinking signature 的 Provider 的 Anthropic 兼容回放,新增可选的 allowEmptySignature 兼容性标志(#4464)。
  • 修复了 OpenAI 和 OpenRouter GPT-5.5 Pro thinking level 元数据,仅暴露支持的 medium、high 和 xhigh efforts。
  • 修复了 OpenCode Go Kimi K2.6 thinking-off 请求,发送 thinking: "none"(#5078)。
  • 修复了 Xiaomi Token Plan 模型元数据,省略不支持的 mimo-v2-flash 变体(#5075)。
Pi Agent

不兼容变更

  • 将 agent harness 的 model_select 和 thinking_level_select 事件重命名为 model_update 和 thinking_level_update。

新增

  • 新增 agent harness 工具注册表 API、tools_update 事件、分支级活跃工具持久化和重复工具验证。
Pi TUI

修复

  • 修复了键盘协议协商,忽略不匹配或延迟的终端响应,避免误检测 Kitty 键盘协议(#5091,感谢 @mitsuhiko)。

v0.76.0(2026-05-27)

Pi Coding Agent

新功能

  • 自动化场景的显式会话 ID — --session-id <id> 允许脚本创建或恢复一个精确的项目本地会话。参见 Sessions。
  • RPC bash 输出可排除在模型上下文之外 — RPC 客户端可向 bash 传递 excludeFromContext,使指定命令的输出不会随下一次 Prompt 发送。参见 RPC 模式。
  • 更可预测的 Provider 重试与超时 — Codex WebSocket/SSE 等待已设上限,retry.provider.maxRetries 控制 Provider 重试,取代原先隐藏的 SDK 默认值。参见 重试设置。
  • 跨环境更好的终端编辑体验 — 修复了 Apple Terminal 的 Shift+Enter、Windows/JetBrains 的能力检测,以及支持 Unicode 的单词导航。参见 终端配置 和 快捷键。

新增

  • 新增 --session-id 参数,允许 CLI 调用者使用精确的项目本地会话 ID,不存在时自动创建(#4874)。
  • 为 bash RPC 命令新增 excludeFromContext 标志,与内部 executeBash API 对齐(#5039)。

修复

  • 修复了用户消息转录渲染,保留用户编写的有序列表标记(#5013)。
  • 修复了自更新命令,显式运行 pi update 时绕过 npm、pnpm 和 Bun 的最低发布年龄门槛(#4929)。
  • 修复了上下文 Token 估算,用户图片附件现在与工具结果图片一致计数(#4983)。
  • 修复了 httpIdleTimeoutMs 应用于 OpenAI Codex Responses WebSocket 空闲等待,新增 websocketConnectTimeoutMs 限制 WebSocket 连接等待时间,并为 Codex SSE 添加了 10 秒响应头超时(#4945)。
  • 修复了 RpcClient,当子进程意外退出时拒绝待处理请求并消费 stdin 管道错误(#4764)。
  • 修复了托管 npm 扩展更新,避免包管理器将 pi 宿主包作为 peer 依赖安装或解析(#4907)。
  • 修复了 RPC 模式原始 stdout 写入,重试瞬时背压错误并在关闭期间刷新排队的协议输出(#4897)。
  • 修复了 OpenAI Codex Responses 缓存亲和性头,发送 session-id 而非与代理不兼容的 session_id(#4967)。
  • 修复了 openai-codex/gpt-5.3-codex-spark 模型元数据,使用其 128k 上下文窗口(#4969)。
  • 修复了 OpenRouter/Poolside 上下文溢出检测,处理 maximum allowed input length 错误(#4943)。
  • 修复了 Provider 重试控制,retry.provider.maxRetries 现在被正确执行,SDK 重试默认为 0,配额/计费 429 错误不再被 Pi 的重试机制重试(#4991,感谢 @mitsuhiko)。
  • 修复了 Apple Terminal 的 Shift+Enter,当 Terminal.app 发送普通回车时检测本地 macOS 修饰键状态。
  • 修复了 Windows Terminal 能力检测,启用 OSC 8 超链接,使可点击的长 URL 在换行时保持有效(#4923)。
  • 修复了 JetBrains 终端能力检测,启用真彩色同时禁用不支持的 OSC 8 超链接(#5037,感谢 @Perlence)。
  • 修复了编辑器和输入的单词导航/删除,使用 Unicode 词边界同时保留 ASCII 标点符号边界(#5022,感谢 @haoqixu;#5067,感谢 @haoqixu;#5068,感谢 @haoqixu)。
  • 修复了开发文档中 AGENTS.md 链接,指向 pi-mono 指南(#5041)。
Pi AI

修复

  • 修复了 OpenAI Codex Responses 缓存亲和性头,发送 session-id 而非与代理不兼容的 session_id(#4967)。
  • 修复了 openai-codex/gpt-5.3-codex-spark 生成的元数据,使用其 128k 上下文窗口(#4969)。
  • 修复了 OpenRouter/Poolside 上下文溢出检测,处理 maximum allowed input length 错误(#4943)。
  • 修复了 OpenAI Codex Responses WebSocket 流和 SSE 响应头等待,应用有界超时而非无限等待(#4945)。
  • 修复了 Provider 重试控制,OpenAI Codex Responses 现在正确执行 maxRetries,SDK 重试默认为 0,配额/计费 429 错误不再被重试(#4991,感谢 @mitsuhiko)。
Pi Agent

修复

  • 修复了上下文 Token 估算,用户图片附件现在与工具结果图片一致计数(#4983)。
Pi TUI

新增

  • 新增可选的 Markdown 渲染器选项,保留源文件中的有序列表标记用于转录渲染(#5013)。

修复

  • 修复了 Apple Terminal 的 Shift+Enter,当 Terminal.app 发送普通回车时检测本地 macOS 修饰键状态。
  • 修复了 Windows Terminal 能力检测,启用 OSC 8 超链接,使可点击的长 URL 在换行时保持有效(#4923)。
  • 修复了 JetBrains 终端能力检测,启用真彩色同时禁用不支持的 OSC 8 超链接(#5037,感谢 @Perlence)。
  • 修复了编辑器和输入的单词导航/删除,使用 Unicode 词边界同时保留 ASCII 标点符号边界(#5022,感谢 @haoqixu;#5067,感谢 @haoqixu;#5068,感谢 @haoqixu)。

v0.75.5(2026-05-23)

Pi Coding Agent

新功能

  • 更清晰的 read 工具输出 — 折叠的 read 工具卡片现在默认只显示读取的行,按 Ctrl+O 仍可展开查看完整文件内容。
  • Windows 上更快的文件工具 — 内置文件工具现在在流式传输期间使用异步文件系统操作,图片缩放也在 worker 中脱离主 TUI 线程运行。
  • 更可靠的包更新 — pi update 和 git 包安装现在会协调固定的 git ref 并保持包设置完整。参见 Packages。
  • 自定义 Anthropic 兼容模型的自适应思考 — 自定义 Provider 模型配置可通过 compat.forceAdaptiveThinking 启用自适应思考 Claude 行为。参见 自定义 Provider 和 模型。

新增

  • 为自定义 Anthropic 兼容模型配置文档和验证添加了 compat.forceAdaptiveThinking 支持(#4797,感谢 @mbazso)。
  • 为 SDK 消费者添加了编辑工具结果详情的标准统一补丁(#4821)。

变更

  • 折叠的 read 工具卡片现在默认仅显示读取的行,展开后才显示完整内容(#4916)。
  • 修改了根开发安装文档,使用 npm install --ignore-scripts(#4868)。

修复

  • 修复了 pi update 将 git-pinned 包协调到其配置的 ref(#4869)。
  • 修复了 Windows 上的包/资源路径处理和 glob/模式解析(#4873,感谢 @mitsuhiko)。
  • 修复了配置模式匹配,从正确的基础目录解析模式(#4898,感谢 @haoqixu)。
  • 修复了主题选择器,按其内容名称而非文件名列出主题(#4830,感谢 @Perlence)。
  • 修复了 OpenCode Zen/Go 请求发送每个会话的 OpenCode 路由头(#4847)。
  • 修复了 Amazon Bedrock Provider 在严格包管理器下的加载,采用 @earendil-works/pi-ai 中声明的 @smithy/node-http-handler 依赖(#4842)。
  • 修复了 Amazon Bedrock Claude 请求默认发送模型输出 Token 上限,避免 Bedrock 的 4096 Token 默认截断(#4848)。
  • 修复了导出的会话 HTML,对属性值中的引号字符进行转义(#4832)。
  • 修复了 GitHub Copilot 设备码登录,在浏览器可用环境中持续打开验证 URL,同时忽略无头使用的浏览器启动失败(#4788,感谢 @vegarsti)。
  • 修复了 git 包安装,将现有检出与请求的 ref 对齐,并在不丢失过滤器的情况下更新包设置(#4870)。
  • 发布了 0.74.2 救援版本,告知 Node 20 用户在更新到更新版 Pi 之前先升级 Node(#4876)。
  • 修复了最终 bash 工具卡片,避免渲染重复的完整输出截断路径(#4819)。
  • 修复了 bash 工具截断行数统计,忽略尾随换行符作为额外输出行(#4818)。
  • 修复了底栏主目录缩写,避免缩短仅共享同一前缀的兄弟路径(#4878)。
  • 修复了 macOS Bun 发布二进制文件,解析原生剪贴板 sidecar,使 Ctrl+V 图片粘贴可以加载 @mariozechner/clipboard(#4307)。
  • 修复了 coding-agent 工具,避免在流式传输期间使用同步文件系统操作,并将图片缩放移出主 TUI 线程(#4756,感谢 @mitsuhiko)。
Pi AI

不兼容变更

  • 修改了 OAuthLoginCallbacks,要求提供 onDeviceCode 和 onSelect,以便 OAuth Provider 可以依赖 Pi 提供设备码和选择界面回调。

修复

  • 修复了自定义 Anthropic 兼容模型别名,通过添加 compat.forceAdaptiveThinking 模型元数据并将内置 adaptive-thinking 选择移出 Provider ID 子字符串检查(#4797,感谢 @mbazso)。
  • 修复了 GitHub Copilot OAuth 登录,依赖必需的设备码回调,无需运行时回调可用性保护。
  • 修复了 Amazon Bedrock Provider 在严格包管理器下的加载,声明其直接的 @smithy/node-http-handler 依赖(#4842)。
  • 修复了 Amazon Bedrock Claude 请求默认发送模型输出 Token 上限,匹配 Anthropic 请求并避免 Bedrock 的 4096 Token 默认截断(#4848)。
Pi TUI

变更

  • 将 Windows VT 输入的可选 koffi 依赖替换为小型内嵌原生辅助,减少安装体积的同时保留 Shift+Tab 处理(#4480)。

v0.75.4(2026-05-20)

Pi Coding Agent

新功能

  • 加固的 npm 安装与发布流程 — Pi CLI 现在附带生成的 shrinkwrap 来锁定传递依赖,阻止意外修改 lockfile,在检查中验证依赖固定和生命周期脚本白名单,在支持的平台上禁用自更新和本地发布安装的生命周期脚本,并在发布前对隔离的 npm 和 Bun 安装进行冒烟测试。

新增

  • pi update 运行后显示交互式更新说明,用户可在继续前查看已安装版本的变更日志(#4724,感谢 @mitsuhiko)。
  • 从包根目录导出了图像缩放工具函数,供 SDK 消费者使用(#4775,感谢 @xl0)。

变更

  • 修改源码语法,避免需要 JavaScript 产出的 TypeScript 构造,使核心源码兼容 Node.js 的 strip-only 类型检查。
  • 从 CLI 包中移除了 Web UI 工作空间引用和包级开发 watch 脚本。
  • 发布的 npm 安装包现在包含 npm-shrinkwrap.json 以锁定 CLI 包的传递依赖。
  • 改进了终端主题检测,优化了浅色/深色模式和真彩色处理。
  • 自更新包管理器命令现在在重新安装时禁用生命周期脚本。

修复

  • 修复系统提示,使模型在读取特定主题的相对引用前,先解析 pi 文档和示例的绝对包路径(#4752)。
  • 修复了扩展 ctx.abort() 在 tool call 预检期间停止后续确认并恢复队列中的交互输入(如 Escape)(#4276)。
  • 修复了 AgentSession 的重试、压缩和事件结算,改为使用等待的 Agent 生命周期而非独立事件队列,并在 agent_end 会话事件中添加了 willRetry。
  • 修复了分叉会话的运行时状态,使活动会话 ID 与分叉目标保持一致(#4799,感谢 @Perlence)。
  • 修复了子 Agent 扩展的并行模式,使其向父模型返回有用的每任务输出和失败任务诊断信息,而非仅 100 字符的预览(#4710)。
  • 修复了 Windows 本地 bash 执行,在后台 SDK 进程启动时隐藏辅助控制台窗口(#4699)。
  • 修复了托管的 npm 扩展文件夹,在支持的平台上设置云同步忽略元数据(#4763)。
  • 修复了 HTTP 空闲超时配置,使长时间运行的 Provider 流避免过早的空闲断开(#4759,感谢 @mitsuhiko)。
  • 修复了默认系统提示的边界,使用显式的 XML 标签实现更清晰的文件分隔(#4709,感谢 @herrnel)。
  • 修复了 HTML 分享/导出侧边栏中共享工具条目的点击,使其滚动到已渲染的 tool call(#4664,感谢 @yzhg1983)。
  • 修复了主题调色板,设置明确的文本颜色以避免终端默认颜色漂移。
  • 修复了真彩色检测,使终端图像渲染和交互主题决策保持一致。
  • 修复了来自 @earendil-works/pi-tui 的加载指示器启动逻辑,确保初始化不会在帧可用前运行。
  • 修复了来自 @earendil-works/pi-ai 的 OpenAI 兼容默认输出 token 请求,避免在 vLLM 等服务器上预留不可能完成的上下文窗口(#4675)。
  • 修复了来自 @earendil-works/pi-ai 的 OpenAI prompt 缓存键,使其保持在 64 字符的 Provider 限制内(#4720)。
  • 修复了 Windows 上 fnm 管理的 Node.js 安装的 npm 系列包命令,这些安装同时暴露了无扩展名的 Unix 脚本和 .cmd 存根(#4793)。
Pi TUI

变更

  • 移除了包级开发 watch 脚本,因为根级别的 TypeScript 检查现在已验证 strip-only 兼容的源码。

修复

  • 修复了加载器初始化,确保指示器启动不会在帧初始化前运行。
  • 修复了真彩色能力检测,使终端图像渲染与交互主题检测器保持一致。
Pi Agent

变更

  • 修改源码语法,避免需要 JavaScript 产出的 TypeScript 构造,保持包与 Node.js strip-only 类型检查兼容。
  • 移除了包级开发 watch 脚本。

修复

  • 修复了 tool call 预检在运行中止后停止准备兄弟 tool call(#4276)。
  • 修复了以换行符结尾的超长单行输出的尾部截断(#4715)。
  • 修复了 Windows Node 执行环境的命令启动,在后台进程中隐藏辅助控制台窗口(#4699)。
Pi AI

变更

  • 修改源码语法,避免需要 JavaScript 产出的 TypeScript 构造,保持包与 Node.js strip-only 类型检查兼容。
  • 移除了包级开发 watch 脚本。

新增

  • 新增了一流的 OAuth 设备码回调元数据、共享轮询支持和 GitHub Copilot OAuth 集成。

修复

  • 修复了 OpenAI 兼容的 streamSimple() 请求,停止发送模型派生的默认输出 token 上限,避免在 vLLM 等服务器上发生上下文窗口预留失败,同时保留显式的 maxTokens 和必需的 Anthropic max_tokens 处理(#4675)。
  • 修复了 OpenAI prompt 缓存键,将会话派生值限制在 64 字符的 API 限制内(适用于 OpenAI Responses、Chat Completions、Codex Responses 和 Azure OpenAI Responses)(#4720)。

v0.75.3(2026-05-18)

Pi Coding Agent

修复

  • 在模型选择器完成后刷新可用模型列表,使新增的 Provider 和模型立即可见。
  • 修复了终端关闭或 SSH 断开时的静默退出,确保 pi 正确关闭会话并清理系统任务。
  • 改进了失效会话的扩展生命周期,在发出 session_shutdown 后从扩展中移除过期的 withSession 回调。
  • 修复了通过外部编辑器编辑后在 pi -p 中错误应用扩展标志的问题。
  • 修复了 /compact 提示参数在命令行解析中被丢弃的问题。
  • 修复了自动密钥登录选择器面板在某些 Provider 上显示为空白的问题。
Pi AI

修复

  • 修复了 OpenAI 兼容的 token 计数,使用 tiktoken 解析器的 encodeSingle 方法以处理非 UTF-8 编码的输入,提高可靠性。
Pi Agent

修复

  • 修复了会话 fork 和克隆后运行时状态未完全重建的问题,确保所有内部回调指向正确的会话实例。

v0.75.2(2026-05-18)

Pi Coding Agent

修复

  • 为 piped 输入增加了 --print 模式的 ANSI 检测,防止二进制数据混乱终端状态。
  • 修复了 pi 在 Python 单元测试的 subprocess.run() 中启动时无法正确刷新输出的问题。
  • 修复了 /compact 设置默认提示时的问题。
Pi TUI

修复

  • 修复了 TUI 输出刷新处理,确保在管道和非 TTY 环境中正确工作。

v0.75.1(2026-05-18)

Pi Coding Agent

新增

  • 启动时检查更新 — Pi 现在在启动时检查新版本并通知用户更新可用,而非仅在显式运行 pi update 时检查。

变更

  • 在构建时预编译扩展宿主,以消除 jiti 导入开销,加快扩展加载速度。
  • 自动完成菜单现在出现在编辑器文本上方而非重叠,在编辑器靠近屏幕底部时提供更好的可见性。

修复

  • 修复了编辑视图滚动和 PageDown 处理。
  • 修复了 /compact 设置默认压缩提示的处理。
  • 将 @earendil-works/pi-tui 和 @earendil-works/pi-ai 作为外部依赖,保持 CLI 包体积紧凑。
  • 修复了保存的会话在加载后无法通过自定义 Keybindings 切换模型的问题。
Pi TUI

新增

  • 在包入口点导出了 EditorShelf 类型。

变更

  • 自动完成下拉菜单现在浮动在编辑器上方而非重叠,提供更好的可见性。
  • 将 @napi-rs/clipboard 设为可选依赖。

修复

  • 修复了编辑视图的滚动溢出行为。
  • 修复了水平滚动和 PageDown 键的处理。

v0.75.0(2026-05-17)

Pi Coding Agent

新功能

  • 事件驱动的自更新 — Pi 现在通过自动版本检查支持更可靠的自更新,检测到新版本时显示通知。支持 pi update 和 pi update self 命令。参见 Usage。
  • Model Context Protocol (MCP) 工具支持 — Pi 扩展现在可以注册 MCP 工具客户端。使用 pi.registerMCPServer() 配置 MCP 服务器,在会话启动时自动连接。参见 Extensions。
  • Shell 环境配置 — Pi 新的 Shell 环境设置允许自定义 SHELL、TERM 和 COLORTERM 环境变量。参见 Settings。
  • /compact 默认提示 — /compact 命令现在接受可选提示词来自定义压缩摘要的重点。

变更

  • 重构了 Provider 模型解析,改进对 Provider 前缀模型解析和 Provider 回退处理的错误报告。
  • 重构包以简化依赖结构,拆分 watch 和开发脚本。
  • 依赖项 @inquirer/prompts 更新到 7.6.0。
  • ANSI 处理更新以匹配 strip-ansi 行为。
  • 使用标准 uuid 包生成 UUIDv7,替代之前的 nanoid 实现。
  • 改进自动完成滚动指示器,并在无匹配时清除自动完成。

修复

  • 修复了 ANSI 剥离以匹配移除依赖后的 strip-ansi 行为。
  • 修复了会话 ID 共享的 UUIDv7 序列生成。
  • 修复了来自 @earendil-works/pi-ai 的 OpenRouter 缓存 token 使用统计、Fireworks 缓存兼容性和 OpenAI Codex WebSocket 代理处理。
  • 修复了来自 @earendil-works/pi-tui 的 Markdown 列表换行、任务列表复选框、大 Markdown 渲染、WezTerm Kitty 键盘转义处理和短视口内联图像放置。
  • 修复了跨包作用域的主题共享,使扩展不会因 Theme not initialized 崩溃(#4333)。
  • 修复了快捷键提示在 macOS 上显示 Option 而非 Alt(#4289)。
  • 修复了交互式更新通知,在终端支持超链接时将会话日志渲染为 OSC 8 超链接(#4280)。
Pi TUI

变更

  • 移除了 nanoid UUID 生成,改用标准 uuid 包。
  • 更新 ANSI 处理以匹配 strip-ansi 行为。
  • 移除了包级开发 watch 脚本。

修复

  • 修复了 Markdown 列表换行,避免在列表标记后错误换行。
  • 修复了 Markdown 任务列表复选框渲染。
  • 修复了大 Markdown 内容的高效渲染。
  • 修复了 WezTerm 中 CSI-u 修饰键的 Kitty 键盘协议处理。
  • 修复了短视口中内联图像的放置。
  • 修复了在选择器和自动完成组件中按预期显示滚动指示器。
Pi Agent

变更

  • 移除了包级开发 watch 脚本。

修复

  • 修复了错误边界在指示错误时重新抛出异常。
  • 修复了 tool call 预检使得相邻 tool call 在并行解析期间检测到上下文溢出时正确失败。
Pi AI

变更

  • 重构包以简化依赖结构,拆分 watch 和开发脚本。
  • 移除了 nanoid UUID 生成,改用标准 uuid 包。

修复

  • 修复了 OpenRouter 缓存的 token 使用统计处理。
  • 修复了 Fireworks 平台缓存的兼容性处理。
  • 修复了 OpenAI Codex WebSocket 代理处理。
  • 修复了 OpenAI 兼容流中交错的 content 和 tool call delta 处理。

v0.74.1(2026-05-16)

Pi Coding Agent

新功能

  • OpenAI Codex WebSocket 传输 — 新的 websocket-cached 传输模式为 ChatGPT Plus/Pro 用户保持 WebSocket 连接,实现更快的后续请求。参见 Providers。

新增

  • 为 Anthropic 模型支持了扩展的思考(thinking)块级别 high 和 xhigh。
  • 为 ChatGPT Pro 用户新增了 o3 和 o4-mini 模型。

变更

  • 将包作用域从 @mariozechner 迁移到 @earendil-works。
  • @earendil-works/pi-tui 和 @earendil-works/pi-ai 现在作为外部依赖,减小 CLI 包体积。
  • 改进了 pi update 命令,支持包名映射和重命名检测。

修复

  • 修复了子 Agent 扩展,当未提供 contextWindow 时正确获取 Provider 的模型上下文窗口。
  • 修复了扩展文件名检测,支持子目录中的嵌套扩展。
  • 修复了模型选择器中模型显示名称的格式化。
  • 修复了 @earendil-works/pi-tui 中的加载器范围和元数据键。
  • 修复了外部编辑器编辑后的扩展标志应用。
Pi AI

新增

  • 为 Anthropic 模型支持了扩展的思考块级别 high 和 xhigh。

变更

  • 将包作用域从 @mariozechner 迁移到 @earendil-works。
  • 重构了 Provider 流处理,支持 WebSocket 传输。

修复

  • 修复了 OpenAI Codex WebSocket 传输在流式和非流式模式下的处理。
  • 修复了流式响应的传输编码处理。
Pi Agent

变更

  • 将包作用域从 @mariozechner 迁移到 @earendil-works。

修复

  • 修复了 Agent 循环中的传输错误处理。
  • 修复了子 Agent 扩展的上下文窗口配置。
Pi TUI

变更

  • 将包作用域从 @mariozechner 迁移到 @earendil-works。
  • 移除了 @napi-rs/clipboard 依赖,改用纯 JavaScript 剪贴板实现。

修复

  • 修复了 WezTerm 中的 Kitty 键盘协议处理。
  • 修复了 macOS 上加载器指示器的渲染问题。

v0.74.0(2026-05-07)

Pi Coding Agent

变更

  • 更新了仓库链接和包引用,迁移到 earendil-works/pi-mono 和 @earendil-works/* 包作用域。

v0.73.1(2026-05-07)

Pi Coding Agent

新功能

  • npm 作用域迁移的自更新支持:pi update --self 现在支持即将到来的包名从 @mariozechner/pi-coding-agent 到 @earendil-works/pi-coding-agent 的迁移。新包发布后,现有的全局安装可以通过正常的自更新流程更新;pi 会卸载旧的全局包并安装版本检查端点返回的包名。
  • 交互式 OAuth 登录选择:OAuth Provider 现在可以在 /login 中呈现多个登录选项,实现 Provider 特定的交互式认证流程。参见 Providers。
  • JSONC 风格 models.json 解析:models.json 现在支持注释和尾逗号,使自定义 Provider 和模型配置更易于维护。参见 Providers 和 Custom Providers。

新增

  • 新增了交互式登录选择支持,使 OAuth Provider 可以呈现多个登录选项(#4190,感谢 @mitsuhiko)。

变更

  • pi update --self 现在遵循 Pi 版本检查端点返回的活动包名,省略时默认当前包,并在安装重命名包前卸载旧的全局包。
  • 扩展加载改用上游 jiti 2.7 替代 @mariozechner/jiti 分支(#4244,感谢 @pi0)。
  • models.json 解析现在允许注释和尾逗号(#4162,感谢 @julien-c)。

修复

  • 修复了 pi -p 将以 YAML frontmatter 开头的提示误认为扩展标志而非用户消息的问题(#4163)。
  • 修复了在工具运行时切换思考块可见性后,待处理的工具结果未在实时 TUI 中更新的问题(#4167)。
  • 修复了 /copy 在仅有 Wayland 的合成器(Hyprland、Niri 等)上报告成功但未写入剪贴板的问题——在 Linux 上跳过了仅 X11 的原生插件,改用 wl-copy/xclip/xsel(#4177)。
  • 修复了 HTML 会话导出,从渲染的用户消息中剥离 Skill 包装 XML(#4234,感谢 @aliou)。
  • 修复了在同一 choice 中交错 content 和 tool call delta 的 OpenAI 兼容聊天补全流。
  • 修复了 OpenAI Codex OAuth 刷新失败在 TUI 活动时直接写入 stderr 的问题(#4141)。
  • 修复了 OpenAI Codex Responses 请求发送非空系统提示的问题(#4184)。
  • 修复了 Kimi For Coding 模型中 Kimi K2 P6 别名的模型解析(#4218)。
  • 修复了 Kitty 内联图像重绘保持在 TUI 拥有的终端区域内,避免写入活动视口下方。
  • 修复了 Kitty 内联图像渲染,让终端分配图像 ID 并将解析的图像 ID 限制在有效值内。
  • 修复了内联图像能力检测,在 cmux 终端中禁用内联图像。

v0.73.0(2026-05-04)

Pi Coding Agent

新功能

  • 小米 MiMo API 计费和区域 Token Plan Provider — xiaomi 现在使用 API 计费,包含独立的 xiaomi-token-plan-{cn,ams,sgp} Provider。参见 Providers。(#4112,感谢 @Phoen1xCode)
  • 增量 bash 输出流式传输 — Bash 工具输出现在在命令运行时即可看到,而非仅在完成后显示。(#4145)
  • 紧凑的 read 渲染 — Pi 文档、上下文文件和技能的交互式 read 输出默认折叠,并显示选定的行范围。

不兼容变更

  • 将内置的 xiaomi Provider 从 Token Plan AMS 切换到小米的 API 计费端点,并将其 /login 显示名称从 "Xiaomi MiMo Token Plan" 改为 "Xiaomi MiMo"。XIAOMI_API_KEY 现在指向来自 platform.xiaomimimo.com 的 API 计费密钥。Token Plan 用户应切换到相应的 xiaomi-token-plan-* Provider 并设置对应的环境变量(#4112,感谢 @Phoen1xCode)。

新增

  • 新增了三个小米 MiMo Token Plan 区域 Provider:xiaomi-token-plan-cn(XIAOMI_TOKEN_PLAN_CN_API_KEY)、xiaomi-token-plan-ams(XIAOMI_TOKEN_PLAN_AMS_API_KEY)、xiaomi-token-plan-sgp(XIAOMI_TOKEN_PLAN_SGP_API_KEY),每个默认使用 mimo-v2.5-pro 模型(#4112,感谢 @Phoen1xCode)。

变更

  • read 工具渲染现在默认在交互式输出中折叠 Pi 文档、AGENTS/CLAUDE 上下文文件和 SKILL.md 的内容。

修复

  • 修复了为 Qwen 3.5/3.6 和 MiniMax M2.7 生成的 OpenAI 兼容模型元数据,使这些模型通过内置 Provider 目录正常工作(#4110,感谢 @jsynowiec)。
  • 修复了 Bedrock Claude Opus 4.7 的 xhigh 思考请求,保留 Provider 的原生效值。
  • 修复了 OpenAI Codex WebSocket 传输,在流开始前设置失败时回退到 SSE,并在助手消息中显示传输诊断信息(#4133)。
  • 修复了 OpenAI Codex WebSocket 传输在会话关闭时关闭缓存的 WebSocket 会话,避免 --print 和 JSON 模式进程在响应后保持存活(#4103)。
  • 修复了紧凑 read tool call 直接渲染并在交互式输出中包含选定行范围。
  • 修复了交互式会话在终端输入丢失时退出而非继续处于损坏状态。
  • 修复了 bash 工具输出在命令运行时增量流式传输,而非等待命令完成(#4145)。
  • 修复了选择器和自动完成的模糊排序,优先精确匹配。

v0.72.1(2026-05-02)

无显著变更。

v0.72.0(2026-05-01)

Pi Coding Agent

新功能

  • 小米 MiMo Token Plan Provider — 新增 Anthropic 兼容的 Provider,支持 XIAOMI_API_KEY 认证,默认模型 mimo-v2.5-pro,支持 /login 显示。参见 Providers。(#4005,感谢 @Phoen1xCode)
  • 模型思考级别元数据 — 模型现在可以通过 thinkingLevelMap 声明支持的思考级别,替代旧的 reasoningEffortMap。参见 Models 和 Custom Providers。(#3208)
  • 自定义 Provider 基础 URL 覆盖 — pi.registerProvider() 现在支持逐模型的 baseUrl 设置。参见 Custom Providers。(#4063)
  • 回合后停止回调 — Agent 循环现在可以通过 shouldStopAfterTurn 在完成一个回合后优雅退出。
  • 自更新检测修复 — Pi 现在能正确识别并应用可用更新。(#3942、#3980、#3922)

不兼容变更

  • 将 models.json 和 pi.registerProvider() 模型定义中的 compat.reasoningEffortMap 替换为模型级别的 thinkingLevelMap(#3208)。迁移方式:将旧映射从 compat.reasoningEffortMap 移至 thinkingLevelMap。使用字符串值表示 Provider 特定的思考值,使用 null 表示不支持且应在循环中隐藏和跳过的 pi 级别。

新增

  • 新增小米 MiMo Token Plan Provider 支持(#4005,感谢 @Phoen1xCode)。
  • 新增模型级别的 thinkingLevelMap 支持,使模型只暴露它们实际支持的思考级别(#3208)。
  • 新增 shouldStopAfterTurn Agent 循环回调,用于回合后停止控制。

修复

  • 修复了默认传输设置为 auto,使 OpenAI Codex 在可用时使用缓存的 WebSocket 上下文(#4083)。
  • 修复了 pi.registerProvider() 遵循逐模型的 baseUrl 覆盖(#4063)。
  • 修复了自更新检测,使 pi 能正确识别新版本并应用更新(#3942、#3980、#3922)。

v0.71.1(2026-05-01)

Pi Coding Agent

新增

  • 为 ChatGPT 订阅认证使用的 OpenAI Codex Provider 新增了 websocket-cached 传输选项。该模式在同一会话中保持 WebSocket 打开,首次请求后仅发送新增的对话内容而非重新发送完整聊天历史。

v0.71.0(2026-04-30)

Pi Coding Agent

不兼容变更

  • 移除了内置的 Google Gemini CLI 和 Google Antigravity 支持。使用这些 Provider 的现有配置必须切换到其他受支持的 Provider。

新功能

  • Cloudflare AI Gateway Provider 支持 — 支持 CLOUDFLARE_API_KEY/CLOUDFLARE_ACCOUNT_ID/CLOUDFLARE_GATEWAY_ID 认证,默认模型解析和 /login 显示。参见 Providers。(#3856,感谢 @mchenco)
  • OpenAI Responses API 支持 — 使用 compat: "openai-responses" 的新 o3 和 o4-mini 模型可通过兼容层使用。参见 Models。(#3898,感谢 @joshblum)
  • OpenAI Codex WebSocket 传输 — 新的 transport 设置支持 websocket 模式以实现更快的 ChatGPT 订阅认证请求。参见 Providers。(#3930,感谢 @f)
  • Anthropic 扩展思考级别 — Anthropic 模型现在支持 high 和 xhigh 思考级别。参见 Keybindings。(#3953,感谢 @mitsuhiko)
  • GitHub Models Provider — 新的 GitHub Models Provider 支持通过 GitHub API 密钥访问模型。参见 Providers。(#3840,感谢 @joshblum)
  • OpenAI 新模型 o3 和 o4-mini — 通过 OpenAI Responses API 使用。参见 Models。

新增

  • 新增 Cloudflare AI Gateway Provider。
  • 新增 OpenAI Responses API 兼容支持。
  • 新增 OpenAI Codex WebSocket 传输支持。
  • 新增 Anthropic high 和 xhigh 思考级别。
  • 新增 GitHub Models Provider。
  • 新增 OpenAI o3 和 o4-mini 模型。

修复

  • 修复了内置 Codex 模型元数据中 maxOutput 值和聊天补全与响应 API 之间的 maxTokens 默认值。
  • 修复了工具列表系统提示生成,正确包含上下文中的自定义工具。
  • 修复了 macOS 上终止 pi 时残留的 bash 子进程。
  • 修复了会话共享命令在非 TTY 环境中的优雅降级。

v0.70.6(2026-04-28)

Pi Coding Agent

修复

  • 修复了 TUI 在等待最终响应时标记后端进程为孤立进程并提前退出的问题。
  • 修复了聊天补全 Provider 的思考级别支持检测。
  • 修复了 streamSimple 模型中思考块中的 redacted 文本处理。
  • 修复了 maxOutput 设置与 Provider 的 maxTokens 的协调。
  • 修复了控制台应用控制序列(DCS)字符串的处理,改进终端兼容性。
Pi AI

修复

  • 修复了 streamSimple 模型中思考块的 redacted 文本聚合。
  • 修复了聊天补全 Provider 的思考级别支持检测。
  • 修复了 maxOutput 与 Provider 的 maxTokens 之间的映射。

v0.70.5(2026-04-27)

Pi Coding Agent

修复

  • 修复了自动 Keybinding 帮助弹窗意外出现的问题。
  • 修复了在某些终端配置中 TUI 布局在启动时被截断的问题。
Pi TUI

修复

  • 修复了编辑器内文本和行号的水平滚动同步。

v0.70.4(2026-04-27)

Pi Coding Agent

修复

  • 紧急修复了某些终端中启动时 TUI 渲染失败的问题。

v0.70.3(2026-04-27)

Pi Coding Agent

新增

  • 模型上下文大小显示 — /session 现在显示上下文中使用的 Token 数和模型的最大 Token 数。

修复

  • 修复了 Agent 事件队列处理,确保 tool_execution_start 在 message_start 之后的正确顺序。
  • 修复了 pi -p 中通过 @ 引用文件但文件不存在时的优雅降级。
  • 修复了自定义 Provider 中 Anthropic 兼容的 max_tokens 与 max_completion_tokens 设置。
  • 改进了 Git 变更检测以更好地处理未跟踪的文件。
Pi AI

修复

  • 修复了 streamSimple 中非标准 max_tokens 字段名的处理。
Pi Agent

修复

  • 修复了事件发射顺序,确保 tool_execution_start 在 message_start 之后可靠排序。

v0.70.2(2026-04-24)

Pi Coding Agent

修复

  • 修复了某些 Linux 终端中后备颜色主题检测的兼容性。
  • 修复了非交互式模式下的会话保存行为。

v0.70.1(2026-04-24)

Pi Coding Agent

修复

  • 修复了在终端调整大小时主题颜色的重新计算。
  • 修复了 Windows 上 Git Bash 的 shell 路径检测。
  • 修复了 macOS 上后台进程的进程组处理。
Pi AI

修复

  • 修复了 Provider 特定 maxTokens 到 max_tokens 字段的映射。

v0.70.0(2026-04-23)

Pi Coding Agent

新功能

  • 初始发布 — Pi Coding Agent 的首个公开版本。

历史版本

版本日期
0.69.02026-04-22
0.68.12026-04-22
0.68.02026-04-20
0.67.682026-04-17
0.67.672026-04-17
0.67.62026-04-16
0.67.52026-04-16
0.67.42026-04-16
0.67.32026-04-15
0.67.22026-04-15
0.67.12026-04-15
0.67.02026-04-14
0.66.02026-04-13
0.65.52026-04-11
0.65.42026-04-09
0.65.32026-04-09
0.65.22026-04-09
0.65.12026-04-09
0.65.02026-04-08
0.64.02026-04-08
0.63.42026-04-08
0.63.32026-04-07
0.63.22026-04-07
0.63.12026-04-07
0.63.02026-04-06
0.62.02026-04-02
0.61.12026-04-02
0.61.02026-04-02
0.60.22026-04-01
0.60.12026-04-01
0.60.02026-03-31
0.59.02026-03-30
0.58.02026-03-24
0.57.02026-03-20
0.56.12026-03-17
0.56.02026-03-17
0.55.72026-03-11
0.55.62026-03-10
0.55.52026-03-09
0.55.42026-03-09
0.55.32026-03-09
0.55.22026-03-06
0.55.12026-03-06
0.55.02026-03-06
0.54.02026-03-05
0.53.12026-03-04
0.53.02026-03-03
0.52.02026-03-03
0.51.22026-03-03
0.51.12026-03-03
0.51.02026-03-03
0.50.12026-03-02
0.50.02026-03-02
0.49.02026-03-01
0.48.02026-02-28
0.47.02026-02-28
0.46.02026-02-27
0.45.32026-02-27
0.45.22026-02-27
0.45.12026-02-26
0.45.02026-02-26
0.44.02026-02-24
0.43.42026-02-08
0.43.32026-02-06
0.43.22026-02-06
0.43.12026-02-05
0.43.02026-02-05
0.42.02026-02-04
0.41.02026-02-03
0.40.22026-02-02
0.40.12026-02-02
0.40.02026-02-02
0.39.12026-02-01
0.39.02026-02-01
0.38.02026-02-01
0.37.02026-01-31
0.36.02026-01-31
0.35.02026-01-31
0.34.02026-01-30
0.33.12026-01-29
0.33.02026-01-29
0.32.12026-01-29
0.32.02026-01-28
0.31.02026-01-28
0.30.02026-01-28
0.29.02026-01-27
0.28.02026-01-27
0.27.02026-01-26
0.26.02026-01-25
0.25.02026-01-24
0.24.02026-01-24
0.23.02026-01-23
0.22.02026-01-23
0.21.02026-01-22
0.20.02026-01-21
0.19.02026-01-15
0.18.02026-01-14
0.17.02026-01-13
0.16.02026-01-11
0.15.02026-01-10
0.14.02026-01-09
0.13.02026-01-08
0.12.02026-01-07
0.11.42026-01-07
0.11.32026-01-06
0.11.22026-01-06
0.11.12026-01-06
0.11.02026-01-05
0.10.62025-11-28
0.10.52025-11-28
0.10.42025-11-28
0.10.32025-11-28
0.10.22025-11-26
0.10.12025-11-25
0.10.02025-11-25
0.9.42025-11-26
0.9.32025-11-25
0.9.22025-11-24
0.9.12025-11-22
0.9.02025-11-22
0.8.02025-11-21
0.7.22025-11-21
0.7.12025-11-20
0.7.02025-11-20
0.6.32025-11-19
0.6.22025-11-18
0.6.12025-11-18
0.6.02025-11-18
0.5.32025-11-17
0.5.22025-11-17
0.5.12025-11-17
0.5.02025-11-15
0.4.02025-11-15
0.3.02025-11-14
0.2.02025-11-13
0.1.62025-11-13
0.1.52025-11-13
0.1.42025-11-13
0.1.32025-11-12
0.1.22025-11-12
0.1.12025-11-11
0.1.02025-11-10

完整变更日志

各包的完整变更历史:


法律声明:本页面聚合自 pi 各子包的 CHANGELOG.md 文件的中文翻译,仅供学习参考。