编辑文档 - OpenCode v1.17.8 / v1.17.9 又连发 2 个版本：MCP 6 连击 + GLM-5.2 thinking variants，长跑 agent 不再崩

标题

工具栏

点击或拖拽上传图片

支持 PNG, JPG, GIF, WebP 格式

内容 (Markdown 格式)

上周写过《OpenCode v1.17.5 / v1.17.6 / v1.17.7 连发，这周碰到的几个 fix 帮了我大忙》（点我看）。**v1.17.7 之后又连发两个版本——v1.17.8（6-17）和 v1.17.9（6-21）**。

继续按上次的方式——**只挑我用过的说**，全 changelog 放在最后。

## v1.17.8：MCP 用户必更

**v1.17.8 发于 2026-06-17**，核心是 **6 个 MCP 相关的 fix**。我自己接了好几个 MCP 服务器，这版本对我来说**全是干货**。

### Session timeline 加载快了

打开会话历史页面的速度肉眼可见地快了——之前会话多的时候（我有个 30+ 回合的实验会话）打开要卡 1-2 秒。v1.17.8 改完之后**几乎是瞬开**，滚动也不抖了。

changelog 写的是：

> Session timelines load much faster and avoid flicker or scroll jumps.

这个我天天在用，**真的能感受到差别**。

### MCP 6 连击：第三方服务终于稳了

我接的 MCP 服务器里有一半是 OpenAI 兼容的，**之前偶尔报「tool schema validation failed」**——具体是 OpenAI 兼容服务器返回的 schema 有 `additionalProperties: false` 之类的字段，OpenCode 的校验器认不出来。v1.17.8 加了 schema 清理，**现在这些服务器全部能正常调**了。

PR 是社区贡献者 @jquense 提的 `#32489`。

**其他几个我立刻用上的 fix**：

- **Cloudflare AI Gateway 终于收到 API key**——之前我配的 Cloudflare Gateway 死活调不通，v1.17.8 修了（@keefetang `#32052`）
- **MCP 工具没声明 schema properties**——之前和某些 provider 报错，现在能跑
- **长跑 MCP 工具的 timeout 不会断**——之前跑 5 分钟以上的工具会超时，现在**报告进度的时候 timeout 会被重置**（@Nomadcxx `#32477`）

**这点很重要**——我有个 `mcp-ocr-server` 跑长文档要 3-5 分钟，**之前跑到一半被超时砍掉**，v1.17.8 之后没出过。

**MCP 错误处理也升级了**：

- **错误信息现在显示 MCP 服务器的实际报错**——之前只显示「generic failure」，**排查问题要去看 server 日志**。现在直接在客户端里能看到原因
- **OAuth 错误页正确转义**——之前 OAuth 失败页面会把 provider 的报错 HTML 原样显示，**有 XSS 风险**。现在转义了
- **OAuth callback server 授权完就关**——之前即使授权完成 callback 还会挂着，**浪费端口**

### Desktop 端：Home tab + 文件选择器

**桌面端两个小升级**：

- **Home tab toggle**——能切换 Home 和上次用的 tab，**不用每次都点回 Home**
- **新的文件/文件夹选择器**——v2 布局下更快更好导航

我桌面端主要是看代码和跑会话，**这两个改动对我是 nice-to-have，不算痛点**。

## v1.17.9：GLM 用户 + 长跑用户双赢

**v1.17.9 发于 2026-06-21**（4 天后），这个版本**亮点是 GLM-5.2 + 几个影响深远的 fix**。

### GLM-5.2 thinking variants

**v1.17.9 给 GLM-5.2 加了 `high` 和 `max` 两个 thinking variants**。

我之前用 GLM 跑代码任务，**默认 thinking 模式下推理深度不太够**——长任务会过早收敛。**`max` 模式跑出来明显更稳**，但 token 消耗也上去了。

社区贡献者 @imranshaiedi-byte 提的 PR `#32446`——多个 provider 都覆盖了（OpenAI 兼容 / Anthropic 兼容 / 自定义 endpoint）。

**怎么用**：在 `opencode.json` 里配置 GLM provider 时指定 thinking variant：

```json
{
  "provider": {
    "glm": {
      "options": {
        "thinkingVariant": "max"
      }
    }
  }
}
```

**这是给我这种「跑长任务不在意 token 消耗」的用户准备的**。

### 长跑 agent 不再中途崩

这条 fix 是 v1.17.9 我最看重的：

> Honor configured agent step limits by forcing a final text response instead of failing mid-run.

**翻译一下**：之前如果配置了 agent 的 step 上限（比如 20 步），跑到上限时**直接报错挂掉**——你写了一半的代码、读了一半的文件全部丢失。v1.17.9 改成了**强制输出一个 final text response**，**不报错，session 能继续**。

我自己跑 agent 经常配置 step 上限（防止无限循环），**之前真的被这个坑过**——长任务跑到上限整个 session 死掉，半天工作白干。现在改成「跑完最后一步，输出个总结」，**体验顺滑太多**。

### Devstral 模型识别修

之前用 Devstral 模型（Mistral 系），**provider ID 大小写敏感**——`devstral` 配错就识别不了。v1.17.9 改成了大小写不敏感（@Robin1987China `#33109`）。

这个 fix 我没用 Devstral 所以**没实际跑过**，但**对用 Mistral 系模型的人是直接痛点**。

### Copilot 自定义 header 终于传了

**这条对 GitHub Copilot 用户是隐藏的痛点**——之前 Copilot 模型的 custom headers 不会被传到 request 里，**配了等于没配**。v1.17.9 修了。

**我自己用 Copilot 不多**（主要是 DeepSeek 和 GLM），但**这条对 Copilot 重度用户很重要**——他们经常要配 `X-Custom-Auth` 之类的 header。

### Prompt cache 修复

**这个 fix 影响面很大**——我之前都没意识到：

> Stop wrapping follow-up user messages in a steering reminder so prompt caching stays effective.

**翻译**：之前 OpenCode 会在**用户跟进消息外面包一层「steering reminder」**——这层 wrapper **让 Anthropic / OpenAI 的 prompt cache 全部失效**。**每个 follow-up 都要重新算 prompt token**，**贵且慢**。

v1.17.9 去掉了这个 wrapper，**prompt cache 正常工作**。

**这条对所有用 Claude / GPT 的用户都有影响**——你之前感觉 OpenCode「比直接用 Anthropic API 慢」可能就是这个原因。**现在应该会快很多**（我跑了一下，确实快了一截）。

### TUI 小修

> Only show the background subagent shortcut when the server supports it.

TUI 的子代理快捷键**只在服务器支持时才显示**——避免点了没反应。**小 fix 但是细心**。

## 我的更新建议

按上次 v1.17.5-7 的更新策略——**patch 版本有 changelog 提到我用的功能才更**。

**v1.17.8 我立刻更了**（MCP 6 个 fix 全是痛点）。**v1.17.9 我也立刻更了**——GLM-5.2 max thinking、agent step limit fix、prompt cache fix 这 3 条都是直接受益的。

**这 2 个版本加起来，OpenCode 的 MCP 稳定性大幅提升**。之前 MCP 跑长任务、超时、错误信息、OAuth、schema 校验这一堆问题，**v1.17.8 一口气修了 6 个**。v1.17.9 接着把 agent step limit 和 prompt cache 这两个老大难也修了。

**如果你用 OpenCode + MCP，建议无脑更 v1.17.9**。

## 怎么更

```bash
# macOS / Linux
curl -fsSL https://opencode.ai/install | bash

# Windows (PowerShell)
irm https://opencode.ai/install.ps1 | iex
```

桌面端自动更新。

## 2 个版本合并 changelog

最后贴一下合并 changelog（去重后），方便需要的人一次看完：

**Core / Improvements**
- Session timeline 加载速度大幅提升
- GLM-5.2 新增 `high` 和 `max` thinking variants
- 关闭 follow-up user message 的 steering reminder wrapper，prompt cache 恢复有效
- Desktop Home tab toggle
- Desktop v2 布局下新的文件/文件夹选择器

**Core / Bugfixes**
- Agent 跑到 step limit 时强制 final text response，不再报错挂掉
- Devstral 模型 ID 大小写不敏感
- Copilot 模型请求现在传 custom headers
- OpenAI 兼容 provider 接受 MCP tool schema
- Cloudflare AI Gateway 正确收到 API key
- MCP 无 schema properties 的工具能跑了
- 长跑 MCP 工具 timeout 在 report progress 时重置
- MCP OAuth callback server 授权完正确关闭
- MCP 工具失败时显示 server 的实际错误文本
- MCP OAuth 错误页正确转义 provider 错误
- TUI 子代理快捷键只在服务器支持时显示

**社区贡献者**：
- v1.17.8: @Nomadcxx, @keefetang, @jquense
- v1.17.9: @Grantmartin2002, @Robin1987China, @kimnamu, @imranshaiedi-byte

合计 **7 个 PR**，**全是 fix 或小改进**——**没有夹带新功能**。**OpenCode 这种「小步快跑 + 不夹带新功能」风格对生产用户友好**，这一点没变。

摘要

标签多个标签用逗号分隔

分类