
主要功能亮点
此次 v2.2.5 版本带来了几项实用的交互改进。在快捷键方面,用户现在可以使用特定的组合键快速管理 worktree 和 shell 模式。在 macOS 上,按下 ⌘⌥O 可选择 worktree,按 ⌘⌥B 选择基础分支;而在 Windows 和 Linux 系统上,对应的是 Ctrl+Alt+O 和 Ctrl+Alt+B。另外,⌘⇧X 或 Ctrl+Shift+X 现在用于在编辑器中切换 shell 模式(#60713)。
引用发送功能也获得了增强。在弹出式引用窗口中,按住 ⌘ 或 Ctrl 键可以将勾选标记转换为发送按钮,或者直接按 ⌘Enter 或 Ctrl+Enter。这样操作会发送当前的引用和评论,同时保留编辑器中其他未修改的内容(#60640)。
针对上下文管理,新版引入了百分比压缩缓冲机制。通过在 opencode.json 中设置 “compaction”: { “buffer”: “20%” },系统可以保留模型上下文窗口的特定比例作为自由空间。这种设置方式比固定的 Token 数量更灵活,能同时适配拥有小窗口和大窗口的不同模型,当然原有的 Token 计数功能依然有效(#60647)。
核心机制优化
改进项
- 压缩缓冲兼容性compaction.buffer 参数现在支持输入百分比数值,比如说 “20%”,这意味着配置更加直观,不再局限于绝对的 Token 数(#60647)。
- 错误提示更精准当 read 操作因文件夹缺失而失败时,报错信息会明确指出缺失的文件夹名称,并列出附近存在的最近文件夹(#60688)。同样,当 edit 操作找不到 oldString 时,系统会显示文件中最接近的行,或者提示该更改已经存在(#60689)。
- Shell 命令别名调用名为 bash 的工具时,系统现在会将其作为 shell 执行,避免了直接调用失败的情况,且权限保持一致。如果插件中真正定义了一个名为 bash 的工具,则该插件工具拥有更高优先级(#60687)。
Bug 修复
- MCP 大消息处理MCP 服务器发送超过 10 MiB 的标准输入输出(stdio)消息时,连接不再断开,且读取速度大幅提升(#60694)。
- 闲置状态重启问题处于闲置状态的位置,在关闭 MCP 服务器后,不再立即重启这些服务器(#60668)。
- 压缩提示上限当输入限制大于模型上下文窗口时,压缩功能的提示现在会被限制在模型窗口大小以内(#60660)。
- 上下文错误处理LiteLLM 的上下文窗口错误现在会触发压缩操作,而不是直接终止会话(#60692)。
- 推理文本保护在切换模型或恢复中断的响应时,推理内容不再被转换为纯文本,修复了部分提供商所以导致的请求错误(#60498)。
终端用户界面 (TUI) 修复
- 连接菜单清理连接菜单不再列出 MCP 服务器,因为这些服务器已在各自的管理区域中做独立管理(#60675)。
桌面端体验更新
新增功能与改进
- 快捷键与工具提示增加了用于选择 worktree 及其基础分支的键盘快捷键,并在工具提示中显示。同时增加了切换 shell 模式的快捷键。Worktree 路径现在支持选中复制整个目录(#60713)。
- 快速发送引用在引用弹窗中按住 ⌘ 或 Ctrl 可直接发送引用及其附带的评论(#60640)。
- 输入界面调整增加了平面输入表面和紧凑输入尺寸选项(#60598)。
缺陷修复
- 菜单逻辑修正桌面端的连接菜单也不再显示 MCP 服务器(#60675)。
- UI 细节修正修复了“最近关闭”菜单中搜索栏缺失顶部间距的问题(#60652)。










