opencode v2.1.2 把免费额度用尽变成可恢复流程,新增 `OPENCODE_DISABLE_FREE_MODELS` 与 `experimental.location_idle_timeout`

v2.1.2 于 2026 年 10 月 21 日发布在 @opencode/cli(npm latest 于 03:39 UTC 切换)—— 一个 patch 版本,同样没有 GitHub release 页面 —— 本文读取 opencode.ai/changelog 的官方 changelog 条目(2026-10-22 抓取)。与没赶上 changelog 条目的 v2.1.1 不同,这次有完整的官方说明。

要点:免费额度恢复、隐藏免费模型、可配置的位置卸载

免费额度恢复:免费消息用尽时,Desktop 与 TUI 现在显示重置时间、找回已提交的 prompt,并提供直接的升级或换模型操作,而不是一条笼统报错(#57466, #57467, #57471)。TUI 侧是带重置时间与 /connect、/models 操作的内联提示(composer 为空时找回 prompt),动画版 “Free limit reached” OpenCode Go 对话框带着 Subscribe / Dismiss / Don’t show again 回归,冗余的失败通知也被移除。Desktop 恢复了免费额度对话框、重置时间的时间线提示与已提交的 prompt —— 订阅 OpenCode Go 现在会切换当前会话的模型,而不是新开一个草稿(#57466)。隐藏免费模型:设置 OPENCODE_DISABLE_FREE_MODELS=1(或 true)即可把零成本的 OpenCode 与 OpenCode Go 模型从目录、默认值与回退中移除(#57478)。可配置的位置卸载:experimental.location_idle_timeout 接受时长字符串(如 "4 hours")或 false,控制不活跃的位置服务何时卸载(#57476)—— 会话等待输入、运行长工具或持有后台任务时,位置服务现在保持加载(#57416)。全新安装更可靠:安装脚本在缺失时创建 ~/.zshrc 或 Fish 的 config.fish,把 OpenCode 加进 PATH,并提示执行 exec $SHELL(#57348)。

2.1.2 的其他内容

Core 修复:遗留的 console.opencode.ai 凭据现在会转发到 opencode.ai/console(#57588);推理被拒时复用最近的 Console 配置检查,而不是重新跑一遍(#57465)。TUI 只在服务端明确报告位置缺失时才显示 “location unavailable”(#57594)。SDK 方面,结构化会话错误新增 retryAfterMs,客户端可以展示 provider 给出的重试时间(#57146);配额、限流与 provider 内部会话错误不再丢失该重试时间(#57589);OpenAI realtime client-secret 请求现在带上必需的 expires_after.anchor。插件方面:Code Mode 异步任务不再在语句中间穿插执行并丢失写入,并发工具调用得到保留(#54276)。