43条更新,其中23条在修bug,4条属于破坏性变更,这是pi1.2.0交出的成绩单。翻完日志,定性一句话:修复密集、顺带立规矩的地基型版本,没有炫技的新故事,但每一刀都砍在短板上。
先说这版对谁最要紧:天天给pi写扩展、做集成的开发者,4条破坏性变更条条冲着你们来,必须细读;习惯把pi跑在远程机器上的人,则等来了盼了很久的功能。只用它写写代码的普通用户可以放心升,23个修复里有不少直接改善日常手感。
不熟悉pi的读者,三句话补个课。它是跑在终端里的AI编码智能体:不开浏览器、不装IDE插件,在命令行里用自然语言派活,它自己读代码、改文件、跑命令,一个回合一个回合把任务做完。
玩法相当开放:模型随便换,models.json里能配多家供应商,也能走OpenRouter这类聚合路由;主题、快捷键都是配置项,外观手感自己调;想深度改造,有extensions扩展体系,还能通过MCP协议接外部工具。更进阶的是codemode:让智能体写一段脚本,一次编排多个工具调用,把重复劳动压缩成一次执行。官方给它的注脚也颇有人味:
这版恰是在这些支撑面上动了大手术。
第一组新功能指向同一种体验:配置从写错靠猜,变成当场报错。
1. 四类配置全面支持schema声明。settings.json和models.json两份主配置,加上keybindings与themes,都能挂一行schema,编辑器立刻给出校验和补全。这套schema此番正式对外发布,主题那份单独迁到了新地址;更严格的是,主题在启动加载这一刻同样要过校验,和事后reload一视同仁。主题作者留意,这条在破坏性变更里还会出现。
2. OpenRouter按key出模型列表。之前的痛点:列表混着一堆当前key用不了的条目,价格还得自己查。现在:配哪个key,就只列哪个key真正可用的模型,连上下文窗口多大、最多输出多少、按什么价计费都直接标出,护栏标记和设成baseURL的区域端点也一并认出。这份列表会落盘缓存,断网也能翻。
配置能校验看着不起眼,实际是把配置当契约管——错一个字段,保存时就标红,而非跑到一半才发现主题压根没生效。对把pi配置收进仓库管理的团队,这相当于一份免费的配置体检。
远程开发党的福音。之前的痛点:pi跑在远程机器上,你透过一层多路复用工具attach到那台机器,或者挂在远程IDE的守护进程里,此时复制代码,内容只落在远端,本地怎么都够不着。
现在有了开关:
export PI_CLIPBOARD_OSC52=1打开后,pi在写入本地剪贴板之外,再走一遍OSC52协议,把文本送到终端客户端的剪贴板,也就是你手边这台机器。定位是兜底:遇到pi认不出的远程会话形态,由它接管,让复制跨过机器边界。对纯终端工作流的人来说,复制这个最低频、也最容易翻车的动作,终于不用再绕道倒腾了。
codemode是pi的特色玩法,这一版在透明度和性能两头同时补课。
透明度上,工具声明会把输入约束直接摆出来——取值范围、默认值、长度与格式限制,以标签形式附在参数说明里,写脚本不用再翻文档猜;对MCP工具,返回内容、结构化数据、是否报错也逐项写明,不再引用一个从未定义过的泛型。运行时,工具行会报出脚本已跑的秒数,结束后再给总耗时,和bash工具行同等待遇。还有一处对齐:工具描述还曾夸口失败必报错,实际带输出schema的工具失败时也会返回结果值,这版把说法捋直。
性能上,两个老毛病被根治:一是脚本里text()满天飞时,进程会被卡住几秒到几分钟,根子在输出拼接走了平方级复杂度;二是写在非首行的options注释以前被默默无视,超时参数形同虚设,现在直接报错拦下。此外,Node24、26下--watch运行报桥接损坏的问题也修掉了。
还有一处隐蔽但值钱的修复:由外部消息触发、带triggerTurn开关的运行,以前会在第一次工具调用之后,把扩展注入的系统提示词片段弄丢,导致提示词中途漂移,每回运行还要两次打爆供应商的提示词缓存。这版把它修齐了——而这正是下一节破坏性变更的由来。
破坏性变更单独拎出来,一条条写清谁要检查什么。名字里带破坏二字,不代表功能坏了,而是旧写法要跟着改。先看速查表:
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1. 主题作者:schema正式发布后,主题那份schema迁到了新地址,且启动加载也要过校验。请检查主题文件里的schema声明是否要更新指向,把重复使用的颜色抽成统一变量,再清掉不再被支持的元数据字段。
2. 扩展开发者:before_agent_start事件的触发面扩大了——空闲时由pi.sendMessage()带triggerTurn开关启动的运行,现在同样经历整套setup并触发该事件。事件结构改成按messageType区分的联合形态:user形态携带用户输入与图片,custom形态只带那条启动消息、没有用户输入;handler里给出的回复消息对两种运行同样生效,待投递到下一轮的消息也会跟着custom运行送出。只想对用户输入生效的handler,必须显式判断事件的messageType是不是user,再决定要不要接这单活。
3. 做集成、管并发的开发者:运行从启动那一刻起就算busy,连before_agent_start处理函数还在执行的阶段也算。这意味着isIdle()在该阶段返回假值;往启动中的运行里发消息会排队,而不是像过去那样直接报错拒收;sendUserMessage必须显式给出投递方式;启动期间请求的中止,会等运行真正开始后生效。靠旧语义写的排队与取消逻辑,都该重过一遍。
4. 解析pi命令行输出的工具链:查看MCP清单的JSON输出改了格式:
pi mcp list --json现在只报一个布尔值,标记该服务端是否具备resources能力;原先的资源与资源模板两个计数不再出现,pi连接服务端时也不再列举资源。按旧字段解析的脚本,升级后会读不到预期内容。
剩下的低感知改动,按读者视角归堆,一行一条:
1. MCP稳定性四连:服务端返回数组、null这类非对象的结构化内容时,工具调用不再失败;等待OAuth刷新期间已取消或超时的调用,不会在刷新完成后被偷偷补发;带iss参数却无法核验的授权响应,现在直接按签发方不匹配拒绝。
2. 供应商兼容:Mistral长思考期间的流式请求不再被超时误杀,超时只管响应头那一段;供应商拒绝严格工具集时,自动降级成不带严格模式的另一套首选工具再试一次;上游供应商报错也纳入瞬态重试;OpenRouter自动路由的模型,负数占位价按0计,不再显示吓人的负成本。
3. 扩展API:工具定义新增触达声明,写明一次调用可能牵动哪些工具,MCP扩展借此更准地等待服务端;命名空间支持别名,MCP直接拿服务端名充当。
4. 终端手感:硬件光标设置改为只用终端原生光标,不再叠画一层反色光标;全屏浮层聚焦时不再挡住滚轮翻记录;碎片化的颜色回显不会把色号值漏进输入框;Kitty键盘协议下,加号这类移位符号的键绑定能正常命中。
5. 打印模式被截断会报警:最终回答被输出上限截断时,以前静默成功,现在会打印已有内容、向stderr写警告,并以非零码退出。
6. 工程健壮性:git worktree里经软链接入的项目说明文件能正常加载;设置条目里的波浪线路径能正确展开;Windows上上一轮锁目录还没删干净时,读写认证文件会先短暂重试再报错。
7. 对话序列化更省:压缩、分支摘要和bug报告用的序列化不再携带思考块:回放的思考往往不在实时上下文里,带上它可能让摘要请求比被摘要的上下文还大。
8. 文档纠偏:登录命令的--timeout说明此前只提等浏览器,现在写明它管整个登录流程。
9. 扫尾:从未进过发布包的实验性服务端、客户端、插件代码栈连同配套包整体移除,一个不再使用的依赖也被摘掉。
一句话收束:1.2.0没有讲新故事,它把护栏立起来、把历史欠账还掉、给扩展生态定好规矩——对每天泡在终端里的人,这种版本最实在。
行动建议:普通用户直接升级即可:
npm install -g @earendil-works/pi-coding-agent@1.2.0主题作者与扩展开发者,先把上面四条红线过一遍再动版本。你被哪条变更劝退、又被哪个功能种草,评论区聊聊。
pi1.2.0升级命令:npm install -g @earendil-works/pi-coding-agent@1.2.0
MCP能力清单查看:pi mcp list --json
