OpenCode 2.3.1 默认预生成摘要,未使用的摘要仍有Token开销;前台Shell默认等待120秒后转后台,显式后台任务仍有超时边界。
OpenCode 2.3.1 中 timeout 为 0 为什么仍按 120 秒处理?
时间:2026-11-18
浏览:324
文章目录
在 OpenCode 2.3.1 的 Shell 工具中,timeout=0 会采用默认的 120 秒前台等待时限。超过时限仍在运行的命令会转到后台继续执行。这个变化让长构建有机会完成,也要求区分工具停止前台等待与命令进程真正退出。

timeout 的数值应结合执行模式理解
这里讨论的是 OpenCode Shell 工具的调用参数,timeout 的单位为毫秒。2.3.1 将前台的 0 值解释为默认时限,因此它不会让一轮工具调用一直阻塞到命令退出。
命令超过前台时限后,OpenCode 会把同一个进程交给后台继续运行,完成后再报告结果。编译、测试或其他长命令因此可以越过一次前台等待窗口,但实际退出码与最终产物仍由后续执行结果决定。

前台转后台与后台任务超时有什么区别?
显式设置 background=true 的任务具有后台超时规则。官方示例给出的 timeout=600000 对应 10 分钟,达到时限时该后台任务会停止。前台超时后的转后台行为,不能用于推断所有后台命令都能一直运行。
长任务仍可能持有构建锁、文件句柄或端口,也可能继续占用 CPU、内存及网络资源。等待窗口结束后重复提交相同命令,会带来额外进程和输出,排查时应结合原任务的最终状态判断是否确实需要重新运行。
同一版本的后台压缩怎样改变等待?
OpenCode 2.3.1 还默认提前生成上下文摘要。长会话接近自动压缩时,摘要在后台准备,之后的提示词有机会使用已生成结果,从而缩短等待。这部分机制作用于对话上下文,与 Shell 命令的进程生命周期分别处理。
预生成摘要也会消耗 Token。官方指出,最终没有被使用的后台摘要仍然带来开销,compaction.background 的 false 取值可以关闭后台预生成。因此,更流畅的交互和更少的消耗需要通过各自的实际记录评估。
摘要重复生成和旧开关分别作了哪些调整?
压缩实现修复了独立压缩模型与会话模型不同导致的摘要复用问题。过去部分已付出生成成本的摘要会被比较条件排除,此次移除了模型和初始指令比较,复用检查保留对话起点与保留位置。
此版本同时删除了 shell_timeout_background,并将前台超时转后台的行为应用于全部构建。官方说明旧的相关配置仍可加载。后台压缩的新设置是 compaction.background,旧 experimental.background_compaction 已移除。理解这些变化时,应分别核对命令的完成状态和摘要实际使用情况。
实用工具推荐
绿化、压缩、噪点和虚拟水印,自由调节做旧程度。
选择画质和输出格式,预览压缩前后的大小。