Pi终端里的会话树导航界面
Pi coding agent于2026年10月21日发布1.4.0稳定版，npm上的latest标签已同步指向新版。更新日志分四节共42条：新功能5条、补充5条、行为变更7条、修复25条，过半篇幅在修东西，这是一次典型的打磨型更新。对日常使用影响最大的三件事，先给结论：
1.摘要不再被固定上限卡死。上下文压缩和分支摘要改跟模型自己的输出上限走，跑长推理、深思考会话的用户最先受益。
2.三处渠道默认模型同版切换。用GitHub Copilot、NVIDIA、小米渠道的读者，升级前先复核自己落在哪个模型上，gpt-5.4已在退役名单里。
3.codemode并行任务先排队再失败。写并行脚本、跑进程内子代理的人不用再撞并发墙，worker默认2个，最长等60秒。
长时运行实验版Pi Durable发布卡
先看摘要机制。过去的上下文压缩（compaction）与分支摘要共用一套固定摘要预算，推理一拉长，预算先见底，摘要直接撞上generation hit the token cap，长思考任务等于被自己的日志噎住。1.4.0把逻辑反过来：摘要上限直接取模型自身的输出天花板，reserveTokens只决定压缩何时启动，generateSummaryWithUsage()和generateSummary()一并忽略该参数。思考越长，摘要反而越完整。顺带修掉一个连环坑：此前被输出上限截断的会话在恢复后，缺失的tool call会让provider把之后的所有请求全部拒掉，会话就此报废。升级即生效，无需配置。
再看分类器。codemode里的models.classify()新增images参数，分类器模型可以接收图像输入，Jev（TypeSafe系）与Clef（Cloudflare系）两族模型先行覆盖，typesafe与cloudflare-workers-ai渠道直接可用，OpenRouter同样支持，Jev 1.14与Clef Omni两个新模型也登上了Workers AI。它打开的是「截图进流水线」的玩法：界面异常分类、内容初审这类活，可以串进codemode脚本交给分类器。compat配置现在对分类器模型同样生效，别家分类器要借道代理服务时，用新增的sendImageOptInHeader与imageInput做开关；Workers AI侧的分类器定价也一并修正，Clef Flash按每100万输入tokens收0.038美元、Jev收0.042美元，此前Jev被错标为免费。
最后是并行编排。codemode的两个worker全忙时，并行脚本和进程内跑的subagent不再直接报错，改成排队等待，最长60秒。失败从运气问题变成了容量问题——排队还失败，说明该加worker了。worker默认给2个，PI_CODEMODE_MAX_WORKERS这个环境变量按脚本并发量调。
Pi 1.0稳定版发布时的公告卡
默认模型一口气换了三处。GitHub Copilot把默认模型从gpt-5.4（已退役）挪到gpt-6.1-sol；NVIDIA渠道换成nvidia/nemotron-3.5-super-vl-120b-a12b；小米和Xiaomi Token Plan也从mimo-v2.5-pro（该模型已退出目录）换到mimo-v2.6-pro。默认值正在跟着模型目录的更替提速，「上月默认、本月退役」会反复发生，升级后建议显式指定模型，把选择权收回来。
归因请求头这版被统一收编。各家的归因头现在统一由pi-ai那套client identity机制来出：OpenRouter、NVIDIA NIM以及OpenCode的归因头，在before_provider_headers这个处理器里再也见不到了（返回null照样能摘掉某个头）；发往Cloudflare的请求与GitHub release的检查，User-Agent也换成Pi的详细版。写过自定义请求头的扩展，升级后值得跑一遍回归。
用量与渠道侧有两处动静。Sign in with ChatGPT场景下，ChatGPT Business版工作区的用量一旦超限，不再空转重试，改为直接提示去找工作区管理员提额；minimax-cn和minimax两个渠道上架MiniMax-M3.1-Flash（思考等级low至max）；xai渠道给Grok 4.3和4.5补上了xhigh这一档思考等级。
浏览器端的会话树可视化扩展面板
会话树是重灾区，也是这版受益最大的地方。/tree导航或恢复会话时，分支里若先记下了某个扩展工具、后才有它的注册信息（比如扩展是会话开跑后才装的），这些工具会失活；现在默认重新激活，除非注册时显式设了defaultActive: false。重度用户来回跳分支，工具不再凭空消失。
终端状态残留有了兜底清理。Pi异常退出、没走正常清理流程时，备用屏幕、鼠标追踪、焦点上报与Kitty键盘协议的状态会残留在shell里，转义序列把提示符刷成乱码，现在退出路径会兜底还原。
并发对话框也理顺了。扩展的select、confirm、input、editor对话框并发弹出时，后弹出的会顶掉先弹出的，先那个的promise还永远等不到结果；现在关掉当前对话框，会退回显示上一个。
扩展在终端内运行Doom的演示界面
代表项之外，剩下22条按类型归拢，完整清单见文末传送门：
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
长尾还有几条：自动重试覆盖面扩到Codex CLI的代理断流、网关上游的失败与Vertex OAuth令牌瞬态失败；openai-codex把注定连不上的gpt-5.5和gpt-5.3-codex-spark下了架；/compact指令在特定切分回合场景被忽略的问题修复；未闭合的$$数学块不再吞掉后面Markdown的表格；@文件补全对含正则元字符的查询不再返回空结果。其中不少出自社区贡献者之手。
Pi品牌卡上的官方标语
|
|
|
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
行动清单按人群各给一句：
1. 跑生产或CI的：升级后显式指定模型，别让默认值切换波及流水线。
2. 写扩展的：回归before_provider_headers与并发对话框逻辑，归因头已统一收编。
3. 长会话与codemode重度用户：可以直接升，摘要扩容、截断恢复、排队等待都是给你准备的，并发量大就把PI_CODEMODE_MAX_WORKERS调上去。
官方把Pi定位成「属于你自己的那套agent harness」，而这一版的42条条目，大半花在让这套harness更耐用上。稳定版的含金量，看的是修补清单，不是新功能数量——1.4.0的主线是打磨，不是扩张。
1. GitHub release v1.4.0：https://github.com/earendil-works/pi/releases/tag/v1.4.0
2. npm包页@earendil-works/pi-coding-agent@1.4.0：https://www.npmjs.com/package/@earendil-works/pi-coding-agent/v/1.4.0
