OpenCode v2.2.1 - 更新日志

### 亮点 - **持续朝目标推进**：在 TUI 或桌面端运行 `/goal <objective>`，让会话持续运行，直到审核者确认目标已达成。使用 `/goal pause`、`/goal resume` 或 `/goal clear` 进行控制。([#59437](https://github.com/anomalyco/opencode/pull/59437)) - **生成图像**：启用 `experimental.image_generate`，即可让代理使用新的 `image_generate` 工具创建或编辑图像。你也可以通过 `experimental.image_generate.model` 可选地设置其默认模型。([#59939](https://github.com/anomalyco/opencode/pull/59939)，[#60096](https://github.com/anomalyco/opencode/pull/60096)) - **查看后台 Shell**：在桌面端的活动状态栏中点击正在运行的 Shell，即可查看其实时输出，并在不离开菜单的情况下停止它。([#59496](https://github.com/anomalyco/opencode/pull/59496)) - **全新的默认模型选择器**：在重新设计的模型选择器中搜索收藏模型、最近使用的模型、提供商和变体；该选择器现在是桌面端的默认选择器。([#59997](https://github.com/anomalyco/opencode/pull/59997)) ### 破坏性变更 #### `@opencode/ai` 提供商移除与重命名这些变更会影响直接导入 `@opencode/ai` 的代码，但不会改变 CLI、桌面端或 HTTP API。 - 移除 fal、Black Forest Labs、Replicate 和 Stability 提供商，同时移除对应的 `./providers/fal`、`./providers/black-forest-labs`、`./providers/replicate` 和 `./providers/stability` 入口。([#59977](https://github.com/anomalyco/opencode/pull/59977)) - 移除五个旧版入口。请改为导入嵌套路径；2.2.0 已经导出了这些路径：`./providers/amazon-bedrock-mantle` → `./providers/amazon-bedrock/mantle`，以及 `./providers/google-vertex-chat`、`-interactions`、`-mistral` 和 `-responses` → `./providers/google-vertex/chat`、`/interactions`、`/mistral` 和 `/responses`。([#59506](https://github.com/anomalyco/opencode/pull/59506)) - 每个提供商的 `configure()` 输入类型现在统一命名为 `Config`，例如 `Groq.LanguageModelOptions` → `Groq.Config`；当 `model()` 的所有设置均为可选时，这些设置也可以省略。([#59765](https://github.com/anomalyco/opencode/pull/59765)) ### 核心 #### 改进 - 添加 `/goal <objective>`，支持暂停、恢复和清除控制，并在目标达成前自动检查进度。([#59437](https://github.com/anomalyco/opencode/pull/59437)) - 通过 `/schedule`、代理工具和 `experimental.schedules` 添加可选启用的定时提示。([#59401](https://github.com/anomalyco/opencode/pull/59401)，[#59457](https://github.com/anomalyco/opencode/pull/59457)) - 添加可选启用的 `image_generate` 工具，用于在后台创建和编辑图像，并支持自动或配置模型选择。([#59939](https://github.com/anomalyco/opencode/pull/59939)，[#60096](https://github.com/anomalyco/opencode/pull/60096)) - Codex 登录后提供 GPT Image 2，并添加对 MiniMax 和 Meta Muse 图像生成的支持。([#60085](https://github.com/anomalyco/opencode/pull/60085)，[#59929](https://github.com/anomalyco/opencode/pull/59929)，[#60081](https://github.com/anomalyco/opencode/pull/60081)) - 为 OpenRouter、DigitalOcean 和 Venice 添加 Responses API 支持，包括自由格式工具。([#59991](https://github.com/anomalyco/opencode/pull/59991)，[#59963](https://github.com/anomalyco/opencode/pull/59963)) - 通过合并捕获操作并避免重复处理忽略文件，提升快照性能。([#59419](https://github.com/anomalyco/opencode/pull/59419)) #### Bug 修复 - 在将工具输出放入上下文窗口时，保留更多上下文余量。([#59934](https://github.com/anomalyco/opencode/pull/59934)) - 正确重试提供商限流，而不是将其报告为上下文溢出。([#59649](https://github.com/anomalyco/opencode/pull/59649)) - 按照 OpenRouter、Google 和 Vercel Grok 预期的格式发送图像编辑引用和图像尺寸。([#60067](https://github.com/anomalyco/opencode/pull/60067)，[#59927](https://github.com/anomalyco/opencode/pull/59927)) - 不再将凭据元数据和提示缓存设置混入模型设置和变体中。([#60057](https://github.com/anomalyco/opencode/pull/60057)，[#59500](https://github.com/anomalyco/opencode/pull/59500)) - 在使用拆分索引的仓库中保持 Git 快照正常工作。([#59417](https://github.com/anomalyco/opencode/pull/59417)) - 仅当工作区启用 Console 网页搜索时才提供该功能。([#59592](https://github.com/anomalyco/opencode/pull/59592)) - 改进 Code Mode 对解析错误、停滞的 await 以及类似 Promise 的搜索结果的诊断。([#59834](https://github.com/anomalyco/opencode/pull/59834)，[#59749](https://github.com/anomalyco/opencode/pull/59749)，[#59981](https://github.com/anomalyco/opencode/pull/59981)) ### TUI #### 改进 - 在提示符下方显示 `/goal` 状态，并提供用于暂停、恢复或清除目标的对话框。([#59437](https://github.com/anomalyco/opencode/pull/59437)) #### Bug 修复 - 显示首次模型步骤之前发生的执行失败。([#60079](https://github.com/anomalyco/opencode/pull/60079)) - 在持续运行的子代理执行期间保持活动加载指示器可见。([#59950](https://github.com/anomalyco/opencode/pull/59950)) - 连接到本地服务器时，正确发送粘贴的图像和 PDF 路径。([#59833](https://github.com/anomalyco/opencode/pull/59833)) - 改进空 `/usage` 对话框中的间距。感谢 [@Tarquinen](https://github.com/Tarquinen)。([#59918](https://github.com/anomalyco/opencode/pull/59918)) ### 桌面端 #### 改进 - 添加 `/reload`，无需重启即可重新加载配置。([#59887](https://github.com/anomalyco/opencode/pull/59887)) - 将重新设计的可搜索模型选择器设为默认选择器，并新增专门的“收藏”和“最近使用”区块，以及支持键盘操作的提供商控件。([#59997](https://github.com/anomalyco/opencode/pull/59997)) - 从活动状态栏中选择后台 Shell 时，显示实时输出和“停止”操作。([#59496](https://github.com/anomalyco/opencode/pull/59496)) - 在编辑器状态栏中显示 `/goal` 状态和相关操作。([#59437](https://github.com/anomalyco/opencode/pull/59437)) - 重新设计集成对话框，并始终在模型选择器中包含 OpenCode 免费模型。([#59976](https://github.com/anomalyco/opencode/pull/59976)，[#60047](https://github.com/anomalyco/opencode/pull/60047)) - 在会话位置菜单中添加项目、工作树、在应用中打开以及终端操作。([#59607](https://github.com/anomalyco/opencode/pull/59607)) - 优化项目和工作树选择、命令搜索、提示历史焦点、编辑器模型标签以及工件预览控件。([#59397](https://github.com/anomalyco/opencode/pull/59397)，[#59604](https://github.com/anomalyco/opencode/pull/59604)，[#59626](https://github.com/anomalyco/opencode/pull/59626)，[#59735](https://github.com/anomalyco/opencode/pull/59735)，[#59657](https://github.com/anomalyco/opencode/pull/59657)) - 在你撰写时间线内容的第一条评论时，高亮显示引用的内容。([#59286](https://github.com/anomalyco/opencode/pull/59286)) - 使用实验性媒体 URI 时，将草稿附件字节保留在本地。([#59104](https://github.com/anomalyco/opencode/pull/59104)) #### Bug 修复 - 连接插件服务器的事件流时，遵循每个插件服务器配置的端点。([#60087](https://github.com/anomalyco/opencode/pull/60087)) - 启用桌面端缩放时，将可到达的滚动边界视为末尾。([#60034](https://github.com/anomalyco/opencode/pull/60034)) - 防止 Shell 文本透过复制按钮显示，并避免关闭侧边栏时重新设置会话记录样式。([#59901](https://github.com/anomalyco/opencode/pull/59901)，[#59878](https://github.com/anomalyco/opencode/pull/59878)) - 即使工具元数据格式错误，也继续渲染，而不是导致时间线崩溃。([#59736](https://github.com/anomalyco/opencode/pull/59736)) - 让下拉菜单立即打开，并确保新会话位置快捷方式在与工具提示交互后仍能正常工作。([#59268](https://github.com/anomalyco/opencode/pull/59268)，[#59680](https://github.com/anomalyco/opencode/pull/59680)) - 移除 macOS 应用图标边缘的光晕。([#59900](https://github.com/anomalyco/opencode/pull/59900)) ### SDK #### 改进 - 添加 `client.experimental.schedule.{create,list,get,pause,resume,delete}`，用于管理定时提示。([#59457](https://github.com/anomalyco/opencode/pull/59457)) - 将实验性生成客户端方法归入 `client.experimental`；原有位置在下一个次要版本发布前仍作为已弃用别名保留。([#59072](https://github.com/anomalyco/opencode/pull/59072)) - 通过 Promise AI 客户端提供压缩功能。([#59987](https://github.com/anomalyco/opencode/pull/59987)) - 为 OpenRouter、DigitalOcean 和 Venice 添加自由格式工具支持及 Responses 路由。([#59963](https://github.com/anomalyco/opencode/pull/59963)，[#59991](https://github.com/anomalyco/opencode/pull/59991)) ### 扩展 #### 改进 - 添加实验性 `experimental.idle` Session 钩子，使插件能够在会话进入空闲状态前继续执行工作。([#59437](https://github.com/anomalyco/opencode/pull/59437)) - 允许 Code Mode 扩展全局对象返回 Effects，并声明所需服务。([#59948](https://github.com/anomalyco/opencode/pull/59948)) - 为 GUI 插件添加自定义编辑器状态栏弹出窗口。([#59437](https://github.com/anomalyco/opencode/pull/59437))

### Highlights - **Keep Working Toward a Goal**: Run `/goal <objective>` in the TUI or Desktop to let the session continue until a reviewer confirms the objective is met. Use `/goal pause`, `/goal resume`, or `/goal clear` to control it. ([#59437](https://github.com/anomalyco/opencode/pull/59437)) - **Generate Images**: Enable `experimental.image_generate` to let agents create or edit images with the new `image_generate` tool. You can optionally set its default model with `experimental.image_generate.model`. ([#59939](https://github.com/anomalyco/opencode/pull/59939), [#60096](https://github.com/anomalyco/opencode/pull/60096)) - **Inspect Background Shells**: Click a running shell in the Desktop activity pill to see its live output and stop it without leaving the menu. ([#59496](https://github.com/anomalyco/opencode/pull/59496)) - **New Default Model Picker**: Search favorites, recent models, providers, and variants from the redesigned model picker, which is now the default in Desktop. ([#59997](https://github.com/anomalyco/opencode/pull/59997)) ### Breaking changes #### `@opencode/ai` provider removals and renames These changes affect code that imports `@opencode/ai` directly. They don't change the CLI, Desktop, or the HTTP API. - The fal, Black Forest Labs, Replicate, and Stability providers are removed, along with their `./providers/fal`, `./providers/black-forest-labs`, `./providers/replicate`, and `./providers/stability` entry points. ([#59977](https://github.com/anomalyco/opencode/pull/59977)) - Five legacy entry points are removed. Import the nested paths instead, which 2.2.0 already exports: `./providers/amazon-bedrock-mantle` → `./providers/amazon-bedrock/mantle`, and `./providers/google-vertex-chat`, `-interactions`, `-mistral`, and `-responses` → `./providers/google-vertex/chat`, `/interactions`, `/mistral`, and `/responses`. ([#59506](https://github.com/anomalyco/opencode/pull/59506)) - Each provider's `configure()` input type is now named `Config`, for example `Groq.LanguageModelOptions` → `Groq.Config`, and `model()` settings are optional when every setting is optional. ([#59765](https://github.com/anomalyco/opencode/pull/59765)) ### Core #### Improvements - Add `/goal <objective>` with pause, resume, and clear controls, plus automatic progress review until the objective is met. ([#59437](https://github.com/anomalyco/opencode/pull/59437)) - Add opt-in scheduled prompts through `/schedule`, agent tools, and `experimental.schedules`. ([#59401](https://github.com/anomalyco/opencode/pull/59401), [#59457](https://github.com/anomalyco/opencode/pull/59457)) - Add the opt-in `image_generate` tool for background image creation and editing, with automatic or configured model selection. ([#59939](https://github.com/anomalyco/opencode/pull/59939), [#60096](https://github.com/anomalyco/opencode/pull/60096)) - Offer GPT Image 2 after Codex sign-in and add MiniMax and Meta Muse image generation support. ([#60085](https://github.com/anomalyco/opencode/pull/60085), [#59929](https://github.com/anomalyco/opencode/pull/59929), [#60081](https://github.com/anomalyco/opencode/pull/60081)) - Add Responses API support for OpenRouter, DigitalOcean, and Venice, including freeform tools. ([#59991](https://github.com/anomalyco/opencode/pull/59991), [#59963](https://github.com/anomalyco/opencode/pull/59963)) - Improve snapshot performance by coalescing captures and avoiding repeated ignore-file work. ([#59419](https://github.com/anomalyco/opencode/pull/59419)) #### Bug fixes - Preserve more context headroom when fitting tool output into the context window. ([#59934](https://github.com/anomalyco/opencode/pull/59934)) - Retry provider throttling correctly instead of reporting it as context overflow. ([#59649](https://github.com/anomalyco/opencode/pull/59649)) - Send image-edit references and image sizes in the formats expected by OpenRouter, Google, and Vercel Grok. ([#60067](https://github.com/anomalyco/opencode/pull/60067), [#59927](https://github.com/anomalyco/opencode/pull/59927)) - Keep credential metadata and prompt-cache settings out of model settings and variants. ([#60057](https://github.com/anomalyco/opencode/pull/60057), [#59500](https://github.com/anomalyco/opencode/pull/59500)) - Keep Git snapshots working in repositories that use a split index. ([#59417](https://github.com/anomalyco/opencode/pull/59417)) - Expose Console web search only when the workspace enables it. ([#59592](https://github.com/anomalyco/opencode/pull/59592)) - Improve Code Mode diagnostics for parse errors, stalled awaits, and promise-like search results. ([#59834](https://github.com/anomalyco/opencode/pull/59834), [#59749](https://github.com/anomalyco/opencode/pull/59749), [#59981](https://github.com/anomalyco/opencode/pull/59981)) ### TUI #### Improvements - Show `/goal` status below the prompt and provide a dialog for pausing, resuming, or clearing it. ([#59437](https://github.com/anomalyco/opencode/pull/59437)) #### Bug fixes - Show execution failures that occur before the first model step. ([#60079](https://github.com/anomalyco/opencode/pull/60079)) - Keep the activity spinner visible while a continued subagent runs. ([#59950](https://github.com/anomalyco/opencode/pull/59950)) - Send pasted image and PDF paths correctly when connected to a local server. ([#59833](https://github.com/anomalyco/opencode/pull/59833)) - Improve spacing in an empty `/usage` dialog. Thanks [@Tarquinen](https://github.com/Tarquinen). ([#59918](https://github.com/anomalyco/opencode/pull/59918)) ### Desktop #### Improvements - Add `/reload` to reload configuration without restarting. ([#59887](https://github.com/anomalyco/opencode/pull/59887)) - Make the redesigned searchable model picker the default, with dedicated Favorites and Recent sections and keyboard-accessible provider controls. ([#59997](https://github.com/anomalyco/opencode/pull/59997)) - Show live output and a Stop action when you select a background shell from the activity pill. ([#59496](https://github.com/anomalyco/opencode/pull/59496)) - Show `/goal` state and actions in a composer pill. ([#59437](https://github.com/anomalyco/opencode/pull/59437)) - Redesign the integrations dialog and always include OpenCode free models in the model picker. ([#59976](https://github.com/anomalyco/opencode/pull/59976), [#60047](https://github.com/anomalyco/opencode/pull/60047)) - Add project, worktree, open-in-app, and terminal actions to the session location menu. ([#59607](https://github.com/anomalyco/opencode/pull/59607)) - Refine project and worktree selection, command search, prompt-history focus, composer model labels, and artifact preview controls. ([#59397](https://github.com/anomalyco/opencode/pull/59397), [#59604](https://github.com/anomalyco/opencode/pull/59604), [#59626](https://github.com/anomalyco/opencode/pull/59626), [#59735](https://github.com/anomalyco/opencode/pull/59735), [#59657](https://github.com/anomalyco/opencode/pull/59657)) - Highlight quoted timeline content while you write its first comment. ([#59286](https://github.com/anomalyco/opencode/pull/59286)) - Keep draft attachment bytes local when using experimental media URIs. ([#59104](https://github.com/anomalyco/opencode/pull/59104)) #### Bug fixes - Follow each plugin server’s configured endpoint when connecting to its event stream. ([#60087](https://github.com/anomalyco/opencode/pull/60087)) - Treat the reachable scroll boundary as the end when Desktop zoom is active. ([#60034](https://github.com/anomalyco/opencode/pull/60034)) - Prevent shell text from showing through copy buttons and avoid restyling the transcript when closing a side panel. ([#59901](https://github.com/anomalyco/opencode/pull/59901), [#59878](https://github.com/anomalyco/opencode/pull/59878)) - Keep rendering malformed tool metadata instead of crashing the timeline. ([#59736](https://github.com/anomalyco/opencode/pull/59736)) - Make dropdowns open immediately and keep the new-session location shortcut working after tooltip interactions. ([#59268](https://github.com/anomalyco/opencode/pull/59268), [#59680](https://github.com/anomalyco/opencode/pull/59680)) - Remove edge halos from macOS application icons. ([#59900](https://github.com/anomalyco/opencode/pull/59900)) ### SDK #### Improvements - Add `client.experimental.schedule.{create,list,get,pause,resume,delete}` for managing scheduled prompts. ([#59457](https://github.com/anomalyco/opencode/pull/59457)) - Group experimental generated-client methods under `client.experimental`; previous locations remain as deprecated aliases until the next minor release. ([#59072](https://github.com/anomalyco/opencode/pull/59072)) - Expose compaction through the Promise AI client. ([#59987](https://github.com/anomalyco/opencode/pull/59987)) - Add freeform tool support and Responses routes for OpenRouter, DigitalOcean, and Venice. ([#59963](https://github.com/anomalyco/opencode/pull/59963), [#59991](https://github.com/anomalyco/opencode/pull/59991)) ### Extensions #### Improvements - Add the experimental `experimental.idle` Session hook so plugins can continue work before a session goes idle. ([#59437](https://github.com/anomalyco/opencode/pull/59437)) - Let Code Mode extension globals return Effects and declare required services. ([#59948](https://github.com/anomalyco/opencode/pull/59948)) - Add custom composer-pill popovers for GUI plugins. ([#59437](https://github.com/anomalyco/opencode/pull/59437))