Pi v0.84.4 - 更新日志

### 新功能 - **终端能力覆盖** — 覆盖检测到的终端超链接、图像和真彩色支持。请参阅 [能力覆盖](https://github.com/earendil-works/pi/blob/v0.84.4/packages/coding-agent/docs/terminal-setup.md#capability-overrides)。 - **扩展 UI 提示事件** — 集成可以区分代理的活跃工作与等待 `ctx.ui` 提示所花费的时间。请参阅 [扩展 UI 提示事件](https://github.com/earendil-works/pi/blob/v0.84.4/packages/coding-agent/docs/extensions.md#ui_prompt_start--ui_prompt_end)。 - **RPC 队列清理** — 使用 `clear_queue` 获取并清除队列中的引导和后续消息。请参阅 [RPC `clear_queue`](https://github.com/earendil-works/pi/blob/v0.84.4/packages/coding-agent/docs/rpc.md#clear_queue)。 - **全屏选择复制控制** — 禁用全屏模式下的自动选择复制，并使用 Ctrl+X 复制当前选中的内容。请参阅 [UI 与显示](https://github.com/earendil-works/pi/blob/v0.84.4/packages/coding-agent/docs/settings.md#ui--display)。 - **DeepSeek V4 Flash Vision（实验性）** — 通过内置的 DeepSeek 提供商使用具备视觉能力的模型。请参阅 [API 密钥](https://github.com/earendil-works/pi/blob/v0.84.4/packages/coding-agent/docs/providers.md#api-keys). ### 新增 - 添加了 `ui_prompt_start` 和 `ui_prompt_end` 扩展事件，以便主机集成能够区分代理的活跃工作与等待面向用户的 `ctx.ui` 提示的时间（[#8355](https://github.com/earendil-works/pi/pull/8355)，由 [@cristinaponcela](https://github.com/cristinaponcela) 贡献）。 - 将 `detectSupportedImageMimeTypeFromFile()` 添加到公共库导出中（[#8600](https://github.com/earendil-works/pi/pull/8600)，由 [@xl0](https://github.com/xl0) 贡献）。 - 添加了继承的实验性视觉能力 `deepseek-v4-flash-vision-exp` 模型支持。 - 当启用缓存未命中通知时，添加了用于压缩和分支摘要的转录使用通知。 - 添加了 RPC `clear_queue` 以获取并移除队列中的引导和后续消息（[#8432](https://github.com/earendil-works/pi/issues/8432)）。 - 添加了用于覆盖自动检测到的终端超链接、图像和真彩色能力的环境变量和高级设置（[#8665](https://github.com/earendil-works/pi/issues/8665)）。 - 添加了 `fullscreenCopyOnSelect` 以禁用全屏自动选择复制；禁用后，`Ctrl+X` 将复制当前文本选区（随后回退至上一个助手消息），而 `/tree` 命令仍会复制选中的消息（[#7720](https://github.com/earendil-works/pi/issues/7720)）。 ### 修复 - 修复了切换思考过程可见性时清除运行中 Bash 工具部分输出的问题（[#8611](https://github.com/earendil-works/pi/issues/8611)）。 - 修复了当 `PATH` 中不可用 `taskkill.exe` 时，Windows 终端中止导致 Pi 崩溃的问题（[#6596](https://github.com/earendil-works/pi/issues/6596)）。 - 修复了恢复会话时，若其 JSONL 文件末尾缺少换行符，会导致下一个追加条目损坏的问题（[#8345](https://github.com/earendil-works/pi/issues/8345)）。 - 修复了代理运行时使用 `triggerTurn: false` 发送的扩展消息被错误地插入到工具调用及其结果之间的问题，这会导致验证消息顺序的提供商拒绝重放历史记录。现在这些消息会在该轮工具结果返回后追加（[#8537](https://github.com/earendil-works/pi/issues/8537)）。 - 修复了压缩和分支摘要强制设置 `toolChoice: "none"` 的问题（[#8649](https://github.com/earendil-works/pi/issues/8649)，[#8638](https://github.com/earendil-works/pi/issues/8638)）。 - 修复了大型工具结果在达到自动压缩阈值时，在压缩前被发送给提供商的问题。Pi 现在会在同一轮运行中的工具执行与下一个助手响应之间进行压缩，并在该轮恢复时恢复交互式进度（[#6879](https://github.com/earendil-works/pi/issues/6879)）。 - 修复了当捆绑的 Node.js 运行时使用 HTTP(S) 代理时，Google Vertex 请求因 `HttpsProxyAgent is not a constructor` 而失败的问题（[#8610](https://github.com/earendil-works/pi/issues/8610)）。 - 修复了从非空模型范围保存默认模型后，该模型在该范围内不可用的问题。 - 修复了继承的 `@` 文件自动补全排名问题，使其优先匹配直接且层级较浅的路径，而非排名相同的嵌套路径（[#8669](https://github.com/earendil-works/pi/pull/8669)）。 - 修复了继承的 OpenAI 兼容流在流式传输期间重复序列化思考过程签名的问题（[#8671](https://github.com/earendil-works/pi/pull/8671)）。 - 修复了继承的主屏幕渲染在图像密集型输出超过 V8 字符串长度限制时崩溃的问题（[#8028](https://github.com/earendil-works/pi/issues/8028)）。 - 修复了继承的全屏双击单词选择功能在 `/` 和 `-` 处错误分割路径和 kebab-case 令牌的问题（[#8676](https://github.com/earendil-works/pi/pull/8676)）。 - 修复了继承的 Cloudflare AI Gateway 目录遗漏支持的 `workers-ai/*` 直通模型的问题。 - 修复了继承的 OpenAI 兼容推理重放功能，使其合并连续的流式文本和摘要 `reasoning_details` 增量。 - 修复了继承的 OpenRouter 推理控制功能，使强制要求推理的模型不会收到 `effort: "none"`（[#8614](https://github.com/earendil-works/pi/pull/8614)，由 [@davidbrai](https://github.com/davidbrai) 贡献）。 - 修复了继承的 OpenAI 兼容 Chat Completions 在未定义工具时忽略显式请求的 `toolChoice` 的问题。 - 修复了继承的碎片化 Mistral 工具调用在续传块省略工具调用 ID 时发生分割的问题（[#8387](https://github.com/earendil-works/pi/issues/8387)）。

### New Features - **Terminal capability overrides** — Override detected terminal hyperlink, image, and truecolor support. See [Capability Overrides](https://github.com/earendil-works/pi/blob/v0.84.4/packages/coding-agent/docs/terminal-setup.md#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](https://github.com/earendil-works/pi/blob/v0.84.4/packages/coding-agent/docs/extensions.md#ui_prompt_start--ui_prompt_end). - **RPC queue clearing** — Retrieve and clear queued steering and follow-up messages with `clear_queue`. See [RPC `clear_queue`](https://github.com/earendil-works/pi/blob/v0.84.4/packages/coding-agent/docs/rpc.md#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](https://github.com/earendil-works/pi/blob/v0.84.4/packages/coding-agent/docs/settings.md#ui--display). - **DeepSeek V4 Flash Vision (experimental)** — Use the vision-capable model through the built-in DeepSeek provider. See [API Keys](https://github.com/earendil-works/pi/blob/v0.84.4/packages/coding-agent/docs/providers.md#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](https://github.com/earendil-works/pi/pull/8355) by [@cristinaponcela](https://github.com/cristinaponcela)). - Added `detectSupportedImageMimeTypeFromFile()` to the public library exports ([#8600](https://github.com/earendil-works/pi/pull/8600) by [@xl0](https://github.com/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](https://github.com/earendil-works/pi/issues/8432)). - Added environment variables and advanced settings for overriding auto-detected terminal hyperlink, image, and truecolor capabilities ([#8665](https://github.com/earendil-works/pi/issues/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](https://github.com/earendil-works/pi/issues/7720)). ### Fixed - Fixed toggling thinking visibility clearing partial output from running Bash tools ([#8611](https://github.com/earendil-works/pi/issues/8611)). - Fixed Windows shell aborts crashing Pi when `taskkill.exe` is unavailable on `PATH` ([#6596](https://github.com/earendil-works/pi/issues/6596)). - Fixed resumed sessions corrupting the next appended entry when their JSONL file lacks a trailing newline ([#8345](https://github.com/earendil-works/pi/issues/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](https://github.com/earendil-works/pi/issues/8537)). - Fixed compaction and branch summaries forcing `toolChoice: "none"` ([#8649](https://github.com/earendil-works/pi/issues/8649), [#8638](https://github.com/earendil-works/pi/issues/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](https://github.com/earendil-works/pi/issues/6879)). - Fixed Google Vertex requests failing with `HttpsProxyAgent is not a constructor` when the bundled Node.js runtime uses an HTTP(S) proxy ([#8610](https://github.com/earendil-works/pi/issues/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](https://github.com/earendil-works/pi/pull/8669)). - Fixed inherited OpenAI-compatible streams serializing thinking signatures repeatedly during streaming ([#8671](https://github.com/earendil-works/pi/pull/8671)). - Fixed inherited main-screen rendering crashing when image-heavy output exceeded V8's string length limit ([#8028](https://github.com/earendil-works/pi/issues/8028)). - Fixed inherited fullscreen double-click word selection splitting paths and kebab-case tokens on `/` and `-` ([#8676](https://github.com/earendil-works/pi/pull/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](https://github.com/earendil-works/pi/pull/8614) by [@davidbrai](https://github.com/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](https://github.com/earendil-works/pi/issues/8387)).