opencode 2.3.1 默认提前在后台生成上下文摘要,目的是缩短下一轮对话等待压缩的时间。这项变化仍会消耗生成摘要所需的 token:提前写好的摘要如果最终没有使用,已经产生的开销仍然存在。同一版本还调整了 shell 工具的前台超时行为,长构建超过等待时限后可以继续在后台运行。

后台压缩把哪一段等待提前了?
长对话接近自动压缩时,需要将已有上下文整理成摘要。OpenCode 2.3.1 会提前在后台准备这份摘要,使后续提示词有机会直接使用已准备的结果。这里改变的是摘要准备的时机,实际可减少多少等待,取决于摘要是否及时完成以及后续对话是否用到了它。
因此,后台压缩同时涉及两个判断:交互等待有没有缩短,生成摘要的开销有没有被有效利用。一次摘要即使没有进入后续请求,生成过程也可能已经计入消耗。官方为这项功能保留了 compaction.background 配置,false 表示关闭后台预生成。

为什么官方还修复了摘要复用条件?
相关实现说明指出,旧的复用检查会比较压缩代理模型与会话模型。当 agents.compaction.model 使用另一个模型时,准备好的摘要可能被丢弃并重新生成,形成重复开销。此次调整移除了这项模型比较,复用判断转而核对对话起点与保留位置。
在发送至付费API前,通过三层压缩预处理提示词;利用本地Ollama模型智能压缩消息并生成历史摘要。
这项修复针对具备上述配置和触发条件的摘要复用路径。日常对话到底减少了多少消耗,仍需结合实际请求记录判断,不能从一次版本升级直接推算统一的节省比例。
Shell 前台超时后,原进程发生了什么?
在 OpenCode 2.3.1 中,超过前台等待时限的 Shell 命令会转入后台继续运行。默认等待时间为 120 秒,timeout 为 0 也采用这个默认值。这里的 timeout 属于 OpenCode 的 Shell 工具调用参数,单位为毫秒。
前台等待结束与进程结束是两个不同状态。构建和测试转入后台后,原进程可能继续占用 CPU、内存、网络或构建锁;任务完成后再返回结果。重复启动同一任务可能使这些资源开销叠加,判断是否需要重启时应以原任务的结束状态为依据。
显式后台任务仍有自己的超时边界
带有 background=true 的调用属于显式后台任务。如果同时指定 timeout=600000,达到 10 分钟时会按后台超时逻辑停止。由此可见,相同 timeout 字段的结果还取决于命令当前处于前台还是后台,120 秒也不能解释为所有后台任务的统一最长运行时间。
此版本移除了 shell_timeout_background 开关,并让这项行为覆盖全部构建;官方说明旧配置仍可加载。后台压缩对应的新配置为 compaction.background,旧 experimental.background_compaction 已移除。评估升级影响时,应分别看对话摘要的生成与复用,以及命令进程的等待与结束状态。

















