进阶 opencode.ai 2026-11-11 16:13:22 · 20 阅读

第27章 OpenCode 更新日志:v2.2.7 版本新增 GitHub Copilot 自动选择与 SDK 性能优化

Changelog更新日志OpenCode 新增更新与改进RSS 订阅源(在新标签页中打开)在 GitHub 上关注版本发布(在新标签页中打开)关注 @opencode on X(在新标签页中打开)RSS 订阅源(在新标签页中打开)在 GitHub 上关注版本发布(在新标签页中打开)关注 @opencode on X(在新标签页中打开)

2026年11月10日v2.2.7

GitHub Copilot 自动选择

当你的 Copilot 账户拥有自动额度池(Auto pool)时,在模型选择器中启用自动选择。Copilot 的路由器将以自动折扣价为你决定每个会话使用的模型。若路由失败,OpenCode 将回退到账户的默认聊天模型。#62997

侧边栏标签快捷操作

右键单击侧边栏标签并选择关闭右侧标签。现在无论焦点在哪里,⌘W 都会关闭侧边栏标签,⌥⌘W 或 Ctrl+Alt+W 总是关闭会话标签,而 ⌘⇧T 会在原位置重新打开最近关闭的任意类型标签。#62922

标记会话已读或未读

在标签、主页行、项目行或收件箱卡片的菜单中选择标记为未读,使其红点保留至你下次访问。#62889

破坏性变更

@opencode/ai:移除 ImageResponse.image

这影响直接导入 @opencode/ai 的代码。请改为读取 response.images[0] 而非 response.image。#63011

SDK:减少端点等待插件加载的时间

在仍正在加载插件的 Location 上,agent.list 返回迄今加载的代理;而 integration.list、usage.limits、vcs.init、rpc.call 和 artifact.* 不再最多等待 5 秒。插件提供条目和动作时会出现在完成加载时,请在匹配的 *.updated 事件上刷新。Model、provider、generate.*、voice.* 和 websearch.query 端点仍会等待。#62796 #63040

改进项(13 个更多改进)

修复项(34 个更多修复)

2026年11月6日v2.2.6

共享 MCP 连接

为 MCP 服务器开启连接池(pooling),可在拥有相同配置的项目间共享一个连接,从而减少进程数量并加快启动速度。#61185

GUI 插件主题与新插槽

GUI 插件现在可以添加颜色主题,在代码块中渲染或添加动作,并使用原生设置和菜单组件。#61485 #61533 #61527 #61509

移动端编辑区停靠

在智能手机和平板电脑上,编辑区的操作现以较大的按钮置于键盘上方的触控停靠区中。#61773

在 worktree 中运行脚本任务

运行 opencode run -w 在新 git worktree 中开始会话,或用 --worktree=<名称> 进行命名。#60712

自动归档脚本运行

给 opencode run 加 --archived,可将脚本及 CI 会话排除在收件箱和会话列表之外。#61270

改进项(14 个更多改进)

修复项(33 个更多修复)

2026年10月30日v2.2.5

Worktree 与 Shell 模式快捷操作

在 macOS 上按 ⌘⌥O,在 Windows 和 Linux 上按 Ctrl+Alt+O 来选择 worktree;按 ⌘⌥B 或 Ctrl+Alt+B 来选择其基础分支。⌘⇧X 或 Ctrl+Shift+X 现已在编辑区中切换 Shell 模式。#60713

从评论弹窗发送引用

在引用弹窗中按住 ⌘ 或 Ctrl,可将其勾号变为发送按钮,或按 ⌘Enter 或 Ctrl+Enter 来发送该条引用与评论,同时不改动编辑区其他内容。#60640

百分比压缩缓冲

在 opencode.json 中设置 "compaction": { "buffer": "20%" },可为各模型保留一部分空闲上下文窗口,使一个设置适配不同窗口大小的模型。Token 计数仍正常工作。#60647

改进项

核心:当读取因文件夹缺失而失败时,报错会指明缺失的文件夹及最近存在的文件夹。#60688

核心:当编辑找不到 oldString 时,报错会显示文件中最接近的行,或说明该变更已存在。#60689

核心:调用名为 bash 的工具现会以 shell 方式运行,不再直接失败,且权限不变。名为 bash 的插件工具仍优先级更高。#60687

桌面端:新增扁平输入表面及紧凑输入尺寸。#60598

修复项(7 个更多修复)

2026年10月30日v2.2.4

持久桌面终端

桌面终端现隶属于会话,在服务器重启时保留滚动回看记录,并与 TUI 及其他窗口保持同步。重命名的终端在重启后也会保留名称。#60346

发布交互工件

在 opencode.json 中启用 "experimental": { "artifacts": true },可让代理通过内置本地服务提供者或插件提供的存储服务来发布、更新及提供 HTML 或静态工件。#60351

引导式 Claude 代理设置

在提供者选择器中选中 Claude Agent,可复制 claude auth login,安装 Claude Code,并在继续选择模型前验证连接。#60603

快速选择基础分支

创建 worktree 时,在 macOS 上按 ⌘⌥. 或在 Windows 和 Linux 上按 Ctrl+Alt+. 打开选择基础分支。此命令也可在命令面板及设置 快捷方式 中找到。#60579

改进项

核心:启用排程的任务现在在 opencode serve 下运行,并协调多个服务器进程,使排程只触发一次。排程仍为可选,通过 experimental.schedules 开启。#60478

核心:提高 OpenCode Go 对 DeepSeek V4.1 Flash 的限额。#60625

桌面端:简化会话位置弹窗,改善长路径可读性。#60492

SDK:扩展 client.experimental.persistentPty.update,以重命名终端或清除用户标题,并公开 userTitle 及 persistent-pty.updated 事件。#60329

修复项(10 个更多修复)

2026年10月30日v2.2.3

在 OpenCode 中使用 Claude Code

安装 Claude Code,运行 claude auth login,然后在 /connect 中选择 Claude Agent,即可使用你的 Claude Code 登录及模型。#58782

桌面端长会话更快

流式回复及长对话现在大幅减少了渲染工作量。#60489 #60521 #60513 #60481

桌面端稳定性修复

修复了侧边栏标签、反复弹出的会话未找到提示及通过 HTTP 打开文件的问题。#60430 #60436 #60459 #60462

破坏性变更

TUI 插件需 OpenTUI 0.8

@opencode/plugin 现需 @opentui/core 及 @opentui/solid 0.8.0 或更高版本。在 OpenTUI 0.8 中,ScrollBox 的 wrapper、viewport、content 和滚动条现为 facade 对象而非可渲染对象,且自定义 RenderContext 必须实现 clock 及 onAnimationTick。见 OpenTUI 0.8.0 发布说明。#60385

管理策略:integration.use 仅覆盖集成

integration.use 现用于控制可用集成账户,新 mcp.use、skill.use、plugin.use 动作分别控制 MCP 服务器、技能及插件。旧 mcp:、skill:、plugin: 资源前缀规则会自动转换,但裸的 integration.use 规则不再作用于 MCP 服务器、技能或插件。#60315

改进项(16 个更多改进)

修复项(26 个更多修复)

2026年10月29日v2.2.2

默认启用图像生成

当连接的提供者支持图像模型时,代理现无需额外配置即可使用 experimental_image_generate。通过 experimental.image_generate.model 设置首选模型。#60258

更快的 worktree 选择

在新建会话界面中,单击当前 Git 分支可直接打开该项目的运行会话于 worktree 选择器。#60263

统一引用与批注

时间线引用、终端引用与浏览器批注现共享一个紧凑的可选评论编辑器,而来源高亮仍附着于本地草稿。#60164

改进项(9 个更多改进)

修复项(18 个更多修复)

2026年10月29日v2.2.1

持续朝目标推进

在 TUI 或桌面端运行 /goal <目标>,使会话继续运行,直到审阅者确认目标达成。使用 /goal pause、/goal resume 或 /goal clear 来控制。#59437

生成图像

启用 experimental.image_generate,让代理用新 image_generate 工具创建或编辑图像。可选地通过 experimental.image_generate.model 设置默认模型。#59939 #60096

检查后台 Shell

在桌面端活动气泡中点击运行中的 Shell,可查看其实时输出并停止,无需离开菜单。#59496

新默认模型选择器

从重新设计的模型选择器中搜索收藏、近期模型、提供者与变体,该选择器现为桌面端默认。#59997

破坏性变更

@opencode/ai 提供者移除与重命名

以下变更影响直接导入 @opencode/ai 的代码,但不改变 CLI、桌面端或 HTTP API。

fal、Black Forest Labs、Replicate 与 Stability 提供者被移除,连同其 ./providers/fal、./providers/black-forest-labs、./providers/replicate、./providers/stability 入口点。

五个遗留入口点被移除,请改导入 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。

各提供者的 configure() 输入类型改名为 Config,例如 Groq.LanguageModelOptions 改为 Groq.Config,且 model() 设置当所有项均为可选时亦变为可选。#59977 #59506 #59765

改进项(15 个更多改进)

修复项(17 个更多修复)

2026年10月28日v1.19.5

TUI 请求失败现返回错误,不再让调用方挂起

2026年10月27日v2.2.0

创建、安装与共享桌面端插件(实验性)

刷新桌面端应用体验#56898 #58865 #55838 #57962

为插件及 SDK 新增实验性图像与决策生成 API

为插件及 SDK 新增实验性图像与决策生成 API,支持图像生成或决策模型(如 think typesafe、clef 等)工作流。#59190 #59380 #58758

插件可附加与更新带键的会话指令

插件现可用 ctx.session.instructions.entry.put/list/remove 附加及更新带键的会话指令。相比直接编辑系统提示词并破坏提示缓存,每次更改会在下一步作为小幅更新加入。这些条目在压缩与回滚时仍保留,且不会启动额外的模型回合。#56550

通过可选方式在桌面端恢复 Todo 工具#59092

新增按提供者/模型配置的提示缓存 TTL#59157

破坏性变更

@opencode/ai 根目录现为 Promise API

@opencode/ai 现如同 @opencode/sdk 及 @opencode/client:包根导出 Promise API,Effect API 移至 @opencode/ai/effect。@opencode/ai/promise 被移除,通配子路径导出改为显式列出的提供者与协议入口。

``` -import { AI } from "@opencode/ai/promise" -import { LLM } from "@opencode/ai" +import { AI } from "@opencode/ai" +import { LLM } from "@opencode/ai/effect" ``` #58847 #59183

移除 OpenCode GitHub Action

不再发布 OpenCode GitHub Action。请从工作流中移除。#59032

TUI 插件需 OpenTUI 0.7

@opencode/plugin 现需 @opentui/core 及 @opentui/solid 0.7.0,高于此前的 0.6.8 或更高。依赖 OpenTUI 0.6 的插件在升级前将无法安装。在 OpenTUI 0.7 中,自定义可渲染对象在构建时从类读取 hook:在构造器中给 renderBefore、renderAfter、onLifecyclePass 赋值,而非作为类字段;添加 hook 后调用 refreshHooks();并用静态 nativeIntegration 声明取代 defineNativeIntegration()。见 OpenTUI 0.7.0 发布说明。#59295

改进项(78 个更多改进)

修复项(112 个更多修复)

2026年10月22日v1.19.4

升级捆绑的 Bun 运行时至 1.4.4

升级捆绑 Bun 运行时至 1.4.4,包含针对 Brotli、TLS、HTTP/1.1、HTTP/2、HTTP/3、WebSocket 及 fetch 的安全修复,并将根证书更新至 NSS 3.131.1。

评论 (0)