编辑文档 - OpenCode v1.14 → v1.15.5 重大更新一览

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

![051901.png](/uploads/7624ff433dad49a2a593350e751759bb.png)

## 1. 背景子智能体（v1.14.51）

这个是这波更新里最重磅的新功能。

之前你让 OpenCode 跑一个复杂任务，整个界面就被占住，你只能干等。现在有了背景子智能体，任务可以在后台跑着，你继续开新会话做别的事。

**这跟普通的"开多个会话"有什么区别？**

普通的多个会话是各自独立的，你得自己管理进度、自己记住上下文。背景子智能体不一样——它是从你当前会话里"分叉"出来的子任务，共享父任务的上下文，不需要你来回切换、自己拼凑信息。

**能做什么？**

跑代码重构的时候让它同时去查另一个模块的文档；让它在后台帮你写测试用例，你继续改主代码；或者让它研究一个依赖库的用法，你不等结果直接继续手头的活。

**举个例子：**

你在改一个项目，需要 AI 帮你做代码重构，同时还想让它 review 另一个模块的 PR。以前只能排队等重构跑完，再开新会话 review PR。现在直接开两个窗口，后台让重构跑着，前台继续看 PR，子任务完成后你回来查看结果就行。

不过这个功能目前还在实验阶段，需要手动开启 experimental flag 才能用。

---

## 2. Scout Agent（v1.14.42）

这个版本一口气扔出来三个新功能：Scout Agent、HTTP API 响应压缩、workspace 同步。

Scout Agent 是最值得说的——它专门帮你研究代码库、查文档、溯源依赖。接手陌生项目的时候，不用自己满代码库跳来跳去找一个函数从哪来的，Scout 直接帮你摸清楚。

---

## 3. 事件系统重构（v1.15.0 为主）

v1.15.0 搞了个 Effect 事件系统，对普通用户不会直接感知，但它修掉了一大批事件订阅的老毛病：

- 文件改了界面没反应
- 通知收不到
- 自定义 LSP 初始化后不刷新

这一系列问题从 v1.14 一直修到 v1.15.4 才彻底收拾干净。如果你之前被这些毛病折磨过，现在是个好时机升级试试。

---

## 4. DeepSeek 推理处理修完了（v1.14.24 → 26）

用 DeepSeek 推理模型写代码的时候，之前经常遇到 reasoning_content 处理出错导致会话中断的问题。这个坑从 v1.14.24 开始修，一直修到 v1.14.26 才彻底搞定。

还在用旧版本的，如果 DeepSeek 报错，升级就行。

---

## 5. 上下文窗口自动压缩

从 v1.14.9 开始有了上下文窗口警告，快到上限会主动提醒并触发自动压缩。长对话项目不会突然因为上下文超限就崩溃或丢内容了，对处理大型代码库重构的场景比较有用。

---

## 6. 其他值得知道的变化

**PowerShell 支持正式完善**（v1.14 周期）——Windows 用户体验提升明显，之前一些命令兼容性问题这期间集中修了。

**全局配置自动创建**（v1.14.49）——第一次用 OpenCode 不再需要自己新建配置文件，省一步操作。

**customize-opencode skill 默认开启**（v1.14.49）——改配置更容易出错，系统给了引导，踩坑概率降低。

**Azure gpt-5.5 支持**（v1.14.25）——微软系模型用户终于能用了。

**NVIDIA 作为内置 provider**（v1.14.19）——新增官方接入渠道，配置更简单。

**原生 ripgrep 后端恢复**（v1.14.18）——文件搜索功能在这之前坏了一段时间，v1.14.18 之后重新可用。

---

## 踩坑记录

**坑1：v1.14.18 之前的版本文件搜索不稳定**

有个版本把原生 ripgrep 后端改坏了，文件搜索和列表功能时好时坏。如果当时升级过遇到这个问题，回退或者直接跳到 v1.14.18+ 就行。

**坑2：背景子智能体要手动开**

v1.14.51 加了这个功能但默认不启用，需要找官方文档看对应的 experimental flag，手动加到配置里才能用。

---

## 怎么选版本

日常轻量任务 → v1.14.49 之后的版本够用，全局配置自动创建，上手更简单

跑长对话、大型代码库 → 建议 v1.15.x，事件系统修了一大批问题，更稳

用 DeepSeek 推理模型 → 至少 v1.14.26，最好直接 v1.15.x

Windows + PowerShell → v1.14 周期及之后，PowerShell 支持在这段时间才完善

想尝鲜（背景子智能体、Scout） → v1.15.5 + 手动开 experimental flag

---

## 写在最后

这次 v1.14 到 v1.15.5 的更新周期，核心信号是两个：**一个是让 OpenCode 从"单任务阻塞"走向"多任务并行"，另一个是修了一大批事件订阅和状态同步的历史债务。** 如果之前因为一些细节 bug 对它持观望态度，现在是个重新试试的好时机。

**你在用 OpenCode 吗？它现在最让你头疼的是什么？评论区说说。**

---

## 评论区预置内容

自己改写比拿来主义靠谱
省了不少时间
max_turns 20 其实够用了
原来可以这样用

摘要

标签多个标签用逗号分隔

分类