OpenCode 2.3.1 的后台摘要和 Shell 超时分别怎样工作?

周予安
周予安
发布时间:2026-11-18 | 10人浏览过
原创

OpenCode 2.3.1 默认预生成摘要,未使用的摘要仍有Token开销;前台Shell默认等待120秒后转后台,显式后台任务仍有超时边界。

OpenCode 2.3.1 的后台摘要服务于长对话的压缩等待,Shell 超时则决定工具调用如何等待命令结束。默认后台压缩可能提前产生 Token 开销,而前台命令等满 120 秒后可以转后台继续执行,两项机制需要分别理解。

OpenCode终端界面

对话接近压缩阈值时会准备什么?

这一版本默认开启后台压缩,在会话接近自动压缩时提前写出摘要。下一条提示词到来后,符合复用条件的现成摘要可以减少现场等待。能否获得这部分收益,与摘要完成时间和之后是否继续使用该会话有关。

摘要属于模型生成内容,准备它本身会产生 Token 开销。官方明确提醒,即使预生成的摘要最终没有使用,这部分消耗也已经发生。compaction.background 的 false 取值用于关闭后台预生成,因此这项设置体现的是提前准备摘要的取舍。

OpenCode官方发布说明中的后台压缩与Shell超时更新

使用独立压缩模型的会话有什么变化?

在相关实现修复中,开发者指出了一个具体场景:agents.compaction.model 与会话模型不同,旧的比较逻辑可能拒绝已经生成的摘要,随后重新总结上下文。这会让摘要付出两次生成成本,却只使用后一次结果。

此次修改去掉了复用条件中的模型和初始指令比较,现有摘要按对话起点和保留位置判断。这个变化解释了修复的目标,实际收益还受配置和对话过程影响。记录中没有出现相同触发条件时,无法据此断定每个会话都存在相同浪费。

长构建等满两分钟后会直接结束吗?

OpenCode 2.3.1 将超时的前台 Shell 命令转入后台,使原进程可以接着完成构建或测试。默认前台时限是 120 秒;工具参数 timeout=0 也采用默认时限。这个字段以毫秒为单位,0 在这里没有无限等待的含义。

转后台描述的是执行与等待方式的变化。原任务尚未退出时,编译进程和相关资源仍可能活跃,最终结果要等任务真正完成才能确定。因等待界面结束而再次启动相同构建,可能形成两个同时运行的任务。

后台运行也保留了终止条件

显式以 background=true 启动的任务,如果设置 timeout=600000,运行到 10 分钟会按超时规则停止。前台命令达到时限后转后台,与后台命令达到自身时限后停止,对应的是两条处理路径。

升级还带来配置项变化。shell_timeout_background 已移除,官方表示旧配置仍能加载;后台压缩使用 compaction.background,experimental.background_compaction 已删除。阅读旧配置或排查长任务时,分别核对适用版本、参数含义与最终任务状态,能够减少由旧行为预期带来的误判。

相关专题:

本站声明

本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。

Python 相关产品和应用

全部下载

专题列表