New Hot

OpenCode 2.3.1 修复超时命令被终止与僵尸进程,长时间构建任务自动转入后台运行该怎么调整

OpenCode超时命令僵尸进程压缩

OpenCode 2.3.1 让超时的 shell 命令转入后台继续运行,而不是直接被杀掉;同时修复 opencode-pty 的僵尸进程、切换模型后被拒绝请求、子代理状态误报与多会话流式内存占用。后台压缩默认开启,长任务与多会话工作流的默认体验都有变化。

2.3.1 超时命令转入后台,清理 opencode-pty 僵尸进程

OpenCode 2.3.1 修复了超时命令被直接终止、僵尸进程残留与多会话流式内存占用等异常。 同时调整了压缩与超时的默认行为。

超时命令转后台

shell 命令超时后不再被杀掉,而是转入后台继续运行,长构建与测试可以跑完再回报(#63699)。前台 timeout: 0 现在表示默认 120 秒,而不是一直等待。(来源:OpenCode 官方发布说明)

僵尸进程清理

修复了 opencode-pty 下已结束命令留下僵尸进程的问题,进程守护会在命令退出时清理;成功命令用 & 启动的后台进程仍会保留,失败命令的残留会被停止(#64266、#64251)。

会话与权限

拒绝一次权限请求时只拒绝同一步骤里的其他请求;切换模型后不再因为 reasoning 字段差异被拒绝;子代理结束后不会因为回答里出现特定标题而被误报仍在运行。服务器请求崩溃时会返回带可读 JSON 的 500,存储问题会直接给出原因。

后台压缩默认开启,CLAUDE.md 回退读取与工具报错调整

跑长构建、多会话并行或频繁切换模型的用户感知最明显。 单文件编辑的体验变化不大。

压缩改为后台

自动压缩的摘要默认在后台写入,下一条提示不再等待;设置 compaction.background: false 可以关闭。注意未被使用的后台摘要仍会消耗 token,experimental.background_compaction 已被移除。

编码代理与配置

没有 AGENTS.md 时会重新读取 CLAUDE.md,全局文件缺失时回退到 ~/.claude/CLAUDE.md;需要跳过可设置 OPENCODE_DISABLE_CLAUDE_CODE 或 OPENCODE_DISABLE_CLAUDE_CODE_PROMPT。

插件与工具

可以在 Settings › Extensions 检查并更新插件。正则 grep、读取结构化结果与错误提示都有调整,畸形文件名 glob 会明确报错而不是返回空结果;websearch 返回扁平结果列表,包含 url、title、content 与发布时间。读工具现在拒绝 limit: 0,并返回明确错误。同版本还修复了分页读取单行空白结果的问题。

长构建与多会话并行的用户建议升级

长任务多、用 opencode-pty 或依赖后台压缩的用户建议升级。 只做短命令交互的可以按计划跟进。

谁适合先升级

需要长构建与测试、多会话并行流式输出、或在会话中切换模型的用户优先。

升级方式

版本为 v2.3.1,按现有安装方式更新即可;官方发布页没有给出额外命令。

绕行与回退

官方未披露回退步骤与额外开关,暂时不能升级时保留旧版本安装包,并在升级前记录当前的压缩与超时配置。同类长任务行为变化也可以参考 Devin Desktop 3.14 修复 Windows 更新残留与流式回复卡在运行工具状态的问题。

常见问题

OpenCode 2.3.1 超时命令还会被终止吗?
不会,超时后命令会转入后台继续运行,长构建与测试可以跑完再回报。
OpenCode 2.3.1 修复了哪种僵尸进程?
修复了 opencode-pty 下已结束命令留下僵尸进程的问题,守护进程会在命令退出时清理。
OpenCode 2.3.1 的后台压缩怎么关闭?
设置 compaction.background: false 可以关闭,但未被使用的后台摘要仍会消耗 token。
OpenCode 2.3.1 还会读取 CLAUDE.md 吗?
会,在没有 AGENTS.md 的目录读取 CLAUDE.md,全局文件缺失时回退到 ~/.claude/CLAUDE.md。

相关术语

opencode-pty
opencode-pty 是 OpenCode 管理伪终端的组件,负责启动与回收 shell 命令。
僵尸进程
僵尸进程是已退出但父进程尚未回收状态的进程,会占用进程表项。
compaction
compaction 是会话压缩,把较长历史生成摘要以减少上下文占用。
Code Mode
Code Mode 是 OpenCode 中让模型以代码调用工具的执行模式。

这篇文章的来源是什么?

文中涉及版本、价格与功能的信息,均以厂商原文为准;下面是可以核对的原始出处。

  • v2.3.1 · OpenCode · 2026-11-18
「v2.3.1」 —— OpenCode

搜索文章

输入关键词,快速查找标题和正文内容。