外部精选
Pi 0.84.4
本文来自外部来源,不是黄奕彬的原创文章。本站提供原文入口,并在采集端生成 AI 结构化摘要、解读与中文翻译(如有),一切以原文为准。
阅读原文(pi.dev)结构化摘要 AI 生成
背景与问题
这是 Pi 0.84.4 的发布说明(Release notes),发布于 2026年8月28日(北京时间)。面向 Pi 用户与集成开发者,回答的问题是:该版本新增了哪些能力、修改了哪些行为、修复了哪些缺陷,以及应查阅哪些文档章节(如 Capability Overrides、API Keys)。
原文显示 Pi 是一个具备全屏终端 UI、Bash 工具、扩展与 RPC 集成、多模型 provider 支持的终端应用。
方法或内容
内容按四部分组织:
- New Features:5 项新功能(终端能力覆盖、扩展 UI prompt 事件、RPC
clear_queue、全屏选择复制控制、实验性 DeepSeek V4 Flash Vision)。 - Added:新增 API、事件与设置,如
supportsMidConvoEffort、ui_prompt_start/ui_prompt_end、detectSupportedImageMimeTypeFromFile()。 - Changed:全屏滚动条、搜索箭头、
/scoped-models等选择器行为调整。 - Fixed:约 20 项缺陷修复,多数附 issue 编号。条目指向原文内的文档章节,但原文未提供这些文档的 URL。
关键发现 / 结果
- 新功能:环境变量与高级设置可覆盖终端 hyperlink、image、truecolor 自动检测(#8665);
ui_prompt_start/ui_prompt_end事件区分 agent 主动工作与等待ctx.uiprompt(#8355);RPCclear_queue获取并清除排队的 steering 与 follow-up 消息(#8432);fullscreenCopyOnSelect禁用全屏自动复制后用Ctrl+X复制选区(#7720);内置 DeepSeek provider 支持实验性deepseek-v4-flash-vision-exp。 - 另新增 Anthropic 自定义模型设置
supportsMidConvoEffort、公开导出detectSupportedImageMimeTypeFromFile()(#8600)、压缩与分支摘要的用量提示。 - Changed:全屏滚动条改为指针进入时显示,新增
scrollbarTrack/scrollbarThumb主题色与轨道点击跳转;/scoped-models改为逐项切换并对不可用模型加删除线(#8900)。 - Fixed 约 20 项:切换 thinking 可见性清除 Bash 部分输出(#8611)、Windows 缺
taskkill.exe时崩溃(#6596)、JSONL 缺尾换行损坏恢复会话(#8345)、压缩/分支摘要强制toolChoice: "none"(#8649、#8638)、Vertex 代理报HttpsProxyAgent is not a constructor(#8610)、超阈值工具结果先压缩再发送(#6879)等。
结论与意义
发布说明未给出作者结论或影响评估。按条目事实,其意义是:升级到 0.84.4 可获得终端能力覆盖、扩展事件、RPC 队列清理等能力,并修复 Windows 崩溃、会话数据损坏、多家 provider 兼容性等缺陷。
适用边界:deepseek-v4-flash-vision-exp 标注 experimental;多项修复带 inherited 前缀,其含义原文未说明;详细用法需查阅原文指向的文档章节(原文未提供 URL)。
AI 解读 AI 生成
方法:按「时空变量」分析(时间 / 空间 / 变量,严格区分包含、相关与因果),对象包括原文作者、署名人员与关键技术及其实际原理;结论用「元反空」(元思考、反思考、空思考、综合)整理。
时间:何时发生,现在是否仍成立
条目描述 2026年8月28日发布的 Pi 0.84.4(来源日期 UTC 2026年8月28日 08:00(北京时间),即北京时间 2026-08-28 08:00),发布渠道为 GitHub release 与 npm。
就 0.84.4 版本本身而言,这些变更描述是成立的事实;但是否为当前最新版本、后续版本是否再改这些行为,原文未说明。原文链接:https://pi.dev/changelog/releases/0.84.4
空间:谁的环境 / 场景
适用对象为 Pi 用户与集成开发者(扩展/宿主集成、RPC 调用方、自定义模型与 provider 配置者)。产品与版本:Pi 0.84.4。场景包括:
- 终端能力检测与覆盖(hyperlink、image、truecolor)。
- 全屏模式 UI(滚动条、选择复制、搜索、双击选词)。
- Windows 且
taskkill.exe不在PATH的环境。 - 使用捆绑
Node.jsruntime 并经 HTTP(S) 代理访问 Google Vertex 的部署。 - Anthropic、OpenAI 兼容、OpenRouter、Mistral、Cloudflare AI Gateway、DeepSeek 等 provider 集成。其他部署形态原文未说明。
变量:实际改变了什么
- 新增接口/事件/设置:
supportsMidConvoEffort、ui_prompt_start/ui_prompt_end、detectSupportedImageMimeTypeFromFile()、RPCclear_queue、fullscreenCopyOnSelect、终端能力覆盖的环境变量与高级设置、scrollbarTrack/scrollbarThumb主题色。 - 行为变化:全屏滚动条改为指针进入时显示并支持轨道点击跳转;
/scoped-models改为逐项切换、不可用模型加删除线;带triggerTurn: false的扩展消息改为在本回合工具结果齐备后追加(原先会插在工具调用与其结果之间)。 - 修复的行为:超过自动压缩阈值的工具结果改为先压缩再发送,压缩发生在同一运行内工具执行与下一次 assistant 响应之间,并在恢复时还原交互进度;JSONL 缺尾换行不再损坏恢复会话的下一条目。
区分:包含 ≠ 相关 ≠ 因果
有明确因果证据的:各 Fixed 条目陈述缺陷与修复的因果(如 Windows 下 taskkill.exe 不可用导致 Pi 崩溃并已修复;JSONL 缺尾换行导致恢复会话的下一条目损坏并已修复)。属于包含/机制关系的:环境变量与高级设置是实现终端能力覆盖的手段;ui_prompt_start/ui_prompt_end 是区分等待与工作的机制。
仅相关、因果未明的:单条修复附多个 issue 编号(#8649、#8638)只表示相关编号,各自具体成因原文未说明;inherited 前缀与该版本的关系原文未说明。
对象:作者/署名与关键技术原理
作者/署名:结构化作者字段为空,原文未标注作者。关键技术及原文描述的原理:
- 终端能力覆盖:用环境变量与高级设置覆盖自动检测的 hyperlink、image、truecolor 支持。
- 扩展事件:
ui_prompt_start/ui_prompt_end让宿主集成区分 agent 主动工作与等待用户响应的ctx.uiprompt。 - RPC
clear_queue:获取并移除排队的 steering 与 follow-up 消息。 - 压缩(compaction):超过自动压缩阈值的工具结果不再直接发给 provider,Pi 在同一运行内、工具执行与下一次 assistant 响应之间压缩,并在恢复时还原交互进度。
- Provider 兼容:Anthropic 自定义模型设置、OpenAI 兼容流式与 reasoning 回放、OpenRouter reasoning 控制、Mistral 分片工具调用、Google Vertex 代理、Cloudflare AI Gateway 目录、DeepSeek 实验性视觉模型
deepseek-v4-flash-vision-exp。
元反空综合结论
元:这本质是一份版本变更清单,解决「用户如何知道 0.84.4 改了什么、如何启用新能力、哪些缺陷已修」的信息传递问题。
反:最可能失效或有边界的部分——deepseek-v4-flash-vision-exp 标注 experimental,行为可能变化或移除;终端能力覆盖建立在自动检测之上,检测准确性原文未说明;inherited 修复的来源与适用范围原文未说明;后续版本可能覆盖本版行为。
空:去掉叙事后剩下的必要事实——2026年8月28日经 GitHub release 与 npm 发布 0.84.4;含 5 项新功能、多项新增 API/事件/设置、多处 UI 行为调整、约 20 项修复(多数附 issue 编号)。
综合:这是一份事实密度高但无作者立场、无性能数据与影响评估的发布记录;引用时以条目与 issue 编号为准,详情需查阅原文指向的文档(原文未提供 URL),作者信息原文未说明。
中文译文 AI 生成
更新日志 发布说明 2026年8月28日 Pi 0.84.4 GitHub release npm
新功能
- 终端能力覆盖 — 覆盖检测到的终端超链接、图片与真彩色支持。参见 Capability Overrides。
- 扩展 UI 提示事件 — 集成可以区分正在进行的 agent 工作与等待
ctx.ui提示所花费的时间。参见 Extension UI prompt events。 - RPC 队列清除 — 使用
clear_queue获取并清除排队的 steering 和 follow-up 消息。参见 RPCclear_queue。 - 全屏选区复制控制 — 禁用全屏模式下的自动选区复制,并使用 Ctrl+X 复制当前选区。参见 UI & Display。
- DeepSeek V4 Flash Vision(实验性)— 通过内置的 DeepSeek 提供商使用具备视觉能力的模型。参见 API Keys。
新增
- 为自定义 Anthropic Messages 模型兼容性设置新增了
supportsMidConvoEffort。 - 当缓存未命中通知启用时,为提供商恢复期间被丢弃的 Anthropic thinking 块新增了 transcript 通知。
- 新增了
ui_prompt_start和ui_prompt_end扩展事件,使宿主集成能够区分正在进行的 agent 工作与等待面向用户的ctx.ui提示的时间(#8355,由 @cristinaponcela 贡献)。 - 向公共库导出新增了
detectSupportedImageMimeTypeFromFile()(#8600,由 @xl0 贡献)。 - 新增了继承的实验性、具备视觉能力的
deepseek-v4-flash-vision-exp模型支持。 - 当缓存未命中通知启用时,为压缩和分支摘要新增了 transcript 使用通知。
- 新增了 RPC
clear_queue,用于获取并移除排队的 steering 和 follow-up 消息(#8432)。 - 新增了用于覆盖自动检测到的终端超链接、图片和真彩色能力的环境变量与高级设置(#8665)。
- 新增了
fullscreenCopyOnSelect以禁用全屏模式下的自动选区复制;禁用后,Ctrl+X 会先复制当前文本选区,再回退到上一条助手消息,而/tree仍会复制选中的消息(#7720)。
变更
- 变更了全屏滚动条:在指针进入时显示,支持可选的
scrollbarTrack和scrollbarThumb主题颜色(带有muted和text回退),在普通与展开状态下保持同一种滑块颜色,并支持点击轨道跳转。 - 变更了全屏 transcript 搜索箭头,使其在悬停时显示下划线,并将搜索占位文本改为首字母大写。
- 变更了
/thinking、/model、/scoped-models、/trust、按模型的 thinking 设置以及主题设置中的选择器,使其在浏览时保持标记当前激活的选项。/scoped-models现在使用一致的逐项开关,并对不可用的模型添加删除线(#8900)。
修复
- 修复了切换 thinking 可见性会清除正在运行的 Bash 工具部分输出的问题(#8611)。
- 修复了当
taskkill.exe在PATH中不可用时,中止 Windows shell 会导致 Pi 崩溃的问题(#6596)。 - 修复了恢复的会话在其 JSONL 文件缺少末尾换行符时会损坏下一个追加条目的问题(#8345)。
- 修复了在 agent 运行时以
triggerTurn: false发送的扩展消息被插入到工具调用与其结果之间的问题,此问题会导致校验消息顺序的提供商拒绝重放的历史记录。这些消息现在会在该回合的工具结果就绪后追加(#8537)。 - 修复了压缩和分支摘要强制使用
toolChoice: "none"的问题(#8649、#8638)。 - 修复了超过自动压缩阈值的大型工具结果在压缩之前被发送给提供商的问题。Pi 现在会在同一次运行中的工具执行与下一次助手响应之间进行压缩,并在该运行恢复时还原交互进度(#6879)。
- 修复了当捆绑的
Node.js运行时使用 HTTP(S) 代理时,Google Vertex 请求因HttpsProxyAgent is not a constructor而失败的问题(#8610)。 - 修复了从非空模型作用域保存默认模型的问题,使其在该作用域中保持可用。
- 修复了继承的
@文件自动补全排序,使其更偏好直接匹配和较浅层级的匹配,而非排名相近的嵌套路径(#8669)。 - 修复了继承的 OpenAI 兼容流在流式传输期间重复序列化 thinking 签名的问题(#8671)。
- 修复了继承的主屏幕渲染在图片密集的输出超过 V8 字符串长度限制时崩溃的问题(#8028)。
- 修复了继承的全屏双击选词会在
/和-处拆分路径与 kebab-case 标记的问题(#8676)。 - 修复了继承的 Cloudflare AI Gateway 目录遗漏受支持的
workers-ai/*透传模型的问题。 - 修复了继承的 OpenAI 兼容 reasoning 重放,以合并连续流式传输的 text 和 summary
reasoning_details增量。 - 修复了继承的 OpenRouter reasoning 控制项,使强制 reasoning 的模型不会收到
effort: "none"(#8614,由 @davidbrai 贡献)。 - 修复了继承的 OpenAI 兼容 Chat Completions 在未定义任何工具时忽略显式请求的
toolChoice的问题。 - 修复了继承的 Mistral 分片工具调用在续接分块省略 tool-call ID 时被拆分的问题(#8387)。
展开原文提取正文(采集端自动提取,可能有缺失)
ChangelogRelease notesAug 28, 2026Pi 0.84.4GitHub releasenpmNew Features
Terminal capability overrides — Override detected terminal hyperlink, image, and truecolor support. See Capability Overrides. Extension UI prompt events — Integrations can distinguish active agent work from time spent waiting for ctx.ui prompts. See Extension UI prompt events. RPC queue clearing — Retrieve and clear queued steering and follow-up messages with clear_queue. See RPC clear_queue. Fullscreen selection copy controls — Disable automatic selection copying in fullscreen mode and use Ctrl+X to copy the active selection. See UI & Display. DeepSeek V4 Flash Vision (experimental) — Use the vision-capable model through the built-in DeepSeek provider. See API Keys.
Added
Added supportsMidConvoEffort to custom Anthropic Messages model compatibility settings. Added transcript notices for Anthropic thinking blocks dropped during provider recovery when cache miss notices are enabled. Added ui_prompt_start and ui_prompt_end extension events so host integrations can distinguish active agent work from waiting on user-facing ctx.ui prompts (#8355 by @cristinaponcela). Added detectSupportedImageMimeTypeFromFile() to the public library exports (#8600 by @xl0). Added inherited experimental vision-capable deepseek-v4-flash-vision-exp model support. Added transcript usage notices for compaction and branch summaries when cache miss notices are enabled. Added RPC clear_queue to retrieve and remove queued steering and follow-up messages (#8432). Added environment variables and advanced settings for overriding auto-detected terminal hyperlink, image, and truecolor capabilities (#8665). Added fullscreenCopyOnSelect to disable automatic fullscreen selection copy; when disabled, Ctrl+X copies the active text selection before falling back to the last assistant message, while /tree still copies the selected message (#7720).
Changed
Changed fullscreen scrollbars to reveal on pointer entry, support optional scrollbarTrack and scrollbarThumb theme colors with muted and text fallbacks, keep one thumb color across normal and expanded states, and support track-click jumping. Changed fullscreen transcript search arrows to underline on hover and capitalized the search placeholder. Changed selectors in /thinking, /model, /scoped-models, /trust, per-model thinking settings, and theme settings to keep active options marked while browsing. /scoped-models now uses consistent per-item toggles and strikes through unavailable models (#8900).
Fixed
Fixed toggling thinking visibility clearing partial output from running Bash tools (#8611). Fixed Windows shell aborts crashing Pi when taskkill.exe is unavailable on PATH (#6596). Fixed resumed sessions corrupting the next appended entry when their JSONL file lacks a trailing newline (#8345). Fixed extension messages sent with triggerTurn: false while the agent is running being inserted between a tool call and its result, which made providers that validate message order reject the replayed history. They are now appended once the turn's tool results are in (#8537). Fixed compaction and branch summaries forcing toolChoice: "none" (#8649, #8638). Fixed large tool results crossing the auto-compaction threshold being sent to the provider before compaction. Pi now compacts between tool execution and the next assistant response in the same run, and restores interactive progress when that run resumes (#6879). Fixed Google Vertex requests failing with HttpsProxyAgent is not a constructor when the bundled Node.js runtime uses an HTTP(S) proxy (#8610). Fixed saving a default model from a non-empty model scope so it remains available in that scope. Fixed inherited @ file autocomplete ranking to prefer direct and shallower matches over similarly ranked nested paths (#8669). Fixed inherited OpenAI-compatible streams serializing thinking signatures repeatedly during streaming (#8671). Fixed inherited main-screen rendering crashing when image-heavy output exceeded V8's string length limit (#8028). Fixed inherited fullscreen double-click word selection splitting paths and kebab-case tokens on / and - (#8676). Fixed inherited Cloudflare AI Gateway catalogs omitting supported workers-ai/* passthrough models. Fixed inherited OpenAI-compatible reasoning replay to merge consecutive streamed text and summary reasoning_details deltas. Fixed inherited OpenRouter reasoning controls so reasoning-mandatory models do not receive effort: "none" (#8614 by @davidbrai). Fixed inherited OpenAI-compatible Chat Completions ignoring an explicitly requested toolChoice when no tools are defined. Fixed inherited fragmented Mistral tool calls splitting when continuation chunks omit the tool-call ID (#8387).
原文入口
阅读原文(pi.dev)原文将在新窗口打开。收录时间不是内容更新时间;正文、译文与解读的版权归原作者/来源所有,本站仅作个人阅读辅助并保留原文入口;页面时间均为北京时间。
了解来源批准与收录规则