--- title: "OpenCode 2 升级要不要跟：1.19 停自动更新、分享下线，升级前 5 项检查" description: "OpenCode 1.19 系列在 10 月 11 日至 16 日停掉自动安装更新、下线会话分享，1.x 不会被自动带到 2.0。本文讲手动更新方法、分享失效后的处理，以及升 OpenCode 2 前的 5 项检查。" url: https://cdnping.org/blog/opencode-1-19-no-auto-update-opencode-2 language: zh-CN published: 2026-10-18 category: "开发工具" tags: ["OpenCode","OpenCode 2","会话分享","开发工具","版本升级"] source: cdnping.org license: Free to quote and summarize with a link to the url above. --- # OpenCode 2 升级要不要跟：1.19 停自动更新、分享下线，升级前 5 项检查 先说结论：OpenCode 1.19 系列在 10 月 11 日至 16 日之间做了三件事，不再自动安装更新，10 月 15 日下线会话分享，10 月 16 日明确 1.x 不会被自动带到 2.0。想用 OpenCode 2 升级，需要你自己执行命令；不想升，留在 1.x 也没有问题。下面按官方 release notes 把变化和升级前该做的事理一遍。 以下内容截至 2026 年 10 月，依据 OpenCode 的 [GitHub Releases](https://github.com/sst/opencode/releases)。 ## 这三个版本分别改了什么？ | 版本 | 日期 | 变化 | | --- | --- | --- | | [v1.19.0](https://github.com/sst/opencode/releases/tag/v1.19.0) | 10 月 11 日 | 新增 `opencode upgrade --major`，用于升级到 OpenCode 2；TUI 里 `/update` 可安装更新或升级到 2；更新不再自动安装；允许 OpenAI 的 `ultrafast` 服务档 | | [v1.19.1](https://github.com/sst/opencode/releases/tag/v1.19.1) | 10 月 15 日 | 会话分享停止，已有分享链接和分享命令不再可用，也不再支持从分享 URL 导入会话 | | v1.19.2 | 10 月 16 日 | 1.x 安装保持在 1.x 线，升级到 2.0 需要明确选择（细节以该版本说明为准） | v1.19.2 的完整说明见 [Releases 页面](https://github.com/sst/opencode/releases)。9 月的版本还让 Cloudflare AI Gateway 遵循供应商超时、调试输出隐去凭据，这和本次升级无直接关系。 ## 不再自动更新，我该怎么更新？ 更新要手动触发，有两种方式： 1. 在 TUI 里输入 `/update`，按提示安装更新； 2. 按你当初安装 OpenCode 的方式更新，具体命令以官方文档为准。 如果你只想留在 1.x，更新前先看清楚提示的目标版本，不要对“升级到 2”的选项直接确认。 查看当前版本，可以运行 `opencode --version`（具体参数以 `opencode --help` 和官方文档为准）。 ## 会话分享下线后，我的会话怎么办？ 官方只说明：分享链接和分享命令失效，不再支持从分享 URL 导入。release notes 没有提供替代的导出或迁移方案，也没有说明本地会话数据会如何处理。因此建议这样做： - 凡是靠分享链接给同事看过的对话，把需要保留的内容自行复制或截图存档； - 本地会话的存放位置和导出方式，以官方文档为准，不要自己猜目录去批量改动； - 别再把分享链接当作长期的工单或评审记录引用。 ## 升 OpenCode 2 前检查什么？ 官方 release notes 没有写 2.0 的变更清单，所以下面是通用的检查思路，而不是 2.0 的官方迁移指南： 1. 先备份配置文件和你自定义的 provider、模型设置，升级失败时能回到原状； 2. 在一台非主力机器或一个测试项目上先升级，跑几个真实任务； 3. 确认团队里是否有人依赖旧的分享链接，这部分无论升不升都已不可用； 4. 检查你的 CI 或脚本是否固定了版本，避免某次重装后版本和预期不一致； 5. 升级后确认接口地址、API Key 和模型选择仍然生效，再去做正式工作。 是否值得升，取决于你是否需要 2.0 的功能。v1.19.2 的说明是 1.x 安装保持在 1.x 线，升级需要你明确选择。如果你的工作流稳定，等一两个小版本再看，并不吃亏。 ## 升级后模型调用不通怎么排查？ OpenCode 本身只是客户端，能否出结果还取决于接口地址、密钥和上游服务。可以按顺序排查： - 先在 cdnping 的 [API 状态](/status/openai) 页看上游入口是否正常，或在 [官网动态](/changes) 看供应商有没有改价格和模型； - 再按 [Claude Code 连接超时排查清单](/blog/claude-code-connection-troubleshooting) 的思路逐层检查网络； - 自定义接口地址的写法可以参考 [Claude Code 自定义 API 与 Codex、OpenCode 接口地址配置](/blog/configure-custom-api-endpoint-claude-code-codex)。 如果你同时在用 Codex，也可以看看 [Codex 10 月 14 日退役旧默认模型与 CLI 0.163](/blog/codex-model-retirement-cli-0-163)，同一周内的工具变动不少，别把问题都归到某一个工具上。 ## 接入方式也想顺便整理一下？ OpenCode 可以通过“接口地址 + API Key”接入不同来源的模型。官方 API、云厂商托管和聚合网关各有取舍，对比可以看 [AI API 接入方式怎么选](/blog/official-api-vs-cloud-vs-gateway)。 AGI Plan 是 cdnping 的商业合作方，它提供 OpenCode 的分步接入教程，人民币结算、不需要海外信用卡，站方说明自己不是官方授权渠道。部分模型仅境外可用，具体可用模型与地区以 [https://agiplan.dev/models](https://agiplan.dev/models) 为准。想了解可以从 [https://agiplan.dev/startup](https://agiplan.dev/startup) 开始；与是否升级 OpenCode 2 无关，不需要为此换服务。 ## 参考来源 - [OpenCode GitHub Releases](https://github.com/sst/opencode/releases) - [OpenCode v1.19.0](https://github.com/sst/opencode/releases/tag/v1.19.0) - [OpenCode v1.19.1](https://github.com/sst/opencode/releases/tag/v1.19.1)