发布日期: 2026-08-28
版本号: v0.84.4

本次更新引入了多项新功能，包括允许用户覆盖终端的超链接、图像和真彩色支持检测结果，扩展UI提示事件使集成应用能区分代理工作状态与等待用户提示的间隔，新增RPC指令用于获取并清除排队中的引导和后续消息，全屏模式下支持禁用自动选择复制并可通过快捷键复制活动选区，以及实验性地支持具备视觉能力的DeepSeek V4 Flash模型。具体添加项涉及扩展事件、公开图像类型检测函数、新模型支持、编译摘要通知、环境变量设置以及全屏复制控制优化。修复内容解决了包括切换思考可见性影响Bash工具输出、Windows下因taskkill缺失导致崩溃、会话恢复时JSONL文件格式错误、扩展消息插入顺序异常、编译摘要强制工具选择参数、大型工具结果跨阈值压缩、代理请求在特定运行环境下失败、默认模型保存范围限制、文件自动补全排序逻辑、流式传输中思考签名重复序列化、主屏幕渲染崩溃、全屏双击选词分割错误、云服务模型目录遗漏、推理摘要合并逻辑、推理模型参数传递以及工具选择未生效等十余个问题。

更新内容 （中文）

新功能

  • 终端能力覆盖 —— 覆盖检测到的终端超链接、图像及真彩色支持。详见能力覆盖。
  • 扩展界面提示事件 —— 集成方可区分智能体活跃工作时间与等待 ctx.ui 提示的时间。详见扩展界面提示事件。
  • RPC 队列清空 —— 使用 clear_queue 检索并清空排队中的引导消息和后续消息。详见 RPC clear_queue。
  • 全屏选择复制控制 —— 禁用全屏模式下的自动选择复制功能，使用 Ctrl+X 复制当前选中文本。详见界面与显示。
  • DeepSeek V4 Flash Vision（实验性） —— 通过内置 DeepSeek 提供商使用视觉能力模型。详见API 密钥。

新增

  • 新增 ui_prompt_start 和 ui_prompt_end 扩展事件，使主机集成方能够区分智能体活跃工作时间与等待用户 ctx.ui 提示的时间 (#8355，由 @cristinaponcela 提交)。
  • 在公共库导出中新增 detectSupportedImageMimeTypeFromFile() (#8600，由 @xl0 提交)。
  • 新增继承的实验性视觉能力模型 deepseek-v4-flash-vision-exp 支持。
  • 新增当启用缓存未命中通知时，用于压缩和分支摘要的转录使用通知。
  • 新增 RPC clear_queue 以检索并移除排队中的引导消息和后续消息 (#8432)。
  • 新增环境变量和高级设置，用于覆盖自动检测的终端超链接、图像及真彩色能力 (#8665)。
  • 新增 fullscreenCopyOnSelect 以禁用全屏模式下的自动选择复制；禁用时，Ctrl+X 会复制当前选中文本，若无选中文本则复制最后一条助手消息，而 /tree 仍复制所选消息 (#7720)。

修复

  • 修复切换思考可视性时，会清除正在运行的 Bash 工具的输出内容 (#8611)。
  • 修复 Windows 系统中当 taskkill.exe 不在 PATH 中时，终止 shell 会导致 Pi 崩溃的问题 (#6596)。
  • 修复恢复会话时，如果其 JSONL 文件缺少末尾换行符，会损坏下一个追加条目的问题 (#8345)。
  • 修复在智能体运行时发送 triggerTurn: false 的扩展消息，会被插入到工具调用及其结果之间，导致验证消息顺序的提供商拒绝重放的历史记录。现在，这些消息将在当前轮次的工具结果全部完成后追加 (#8537)。
  • 修复压缩和分支摘要强制使用 toolChoice: "none" 的问题 (#8649, #8638)。
  • 修复大型工具结果在压缩前，因超过自动压缩阈值而被发送给提供商的问题。现在，Pi 会在同一轮次内，于工具执行完成后、下一次助手响应前进行压缩，并在该轮次恢复时恢复交互式进度 (#6879)。
  • 修复当捆绑的 Node.js 运行时使用 HTTP(S) 代理时，Google Vertex 请求因 HttpsProxyAgent is not a constructor 而失败的问题 (#8610)。
  • 修复从非空模型范围保存默认模型时，使其在该范围内保持可用的问题。
  • 修复继承的 @ 文件自动补全排序问题，优先选择直接且较浅的匹配项，而非排名相似的嵌套路径 (#8669)。
  • 修复继承的 OpenAI 兼容流在流式传输期间重复序列化思考签名的问题 (#8671)。
  • 修复继承的主屏幕渲染问题，当输出包含大量图像并超过 V8 字符串长度限制时会导致崩溃 (#8028)。
  • 修复继承的全屏双击选词功能，在 / 和 - 处分割路径和短横线命名的词组的问题 (#8676)。
  • 修复继承的 Cloudflare AI Gateway 目录遗漏了支持的 workers-ai/* 直通模型的问题。
  • 修复继承的 OpenAI 兼容推理重放功能，以合并连续的流式文本和摘要 reasoning_details 增量。
  • 修复继承的 OpenRouter 推理控制，使必须进行推理的模型不再接收 effort: "none" (#8614，由 @davidbrai 提交)。
  • 修复继承的 OpenAI 兼容 Chat Completions 在未定义工具时忽略显式请求的 toolChoice 的问题。
  • 修复继承的分片 Mistral 工具调用在续接分片省略工具调用 ID 时会被分割的问题 (#8387)。

更新内容 （原始）

New 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 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).

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).

下载链接