研究
研究草稿3 分钟阅读

opencode 的会话循环、inbox 调度与压缩

草稿。 结论尚未定型,可能需要且可能有多种方案并存;实践验证后再晋升为经验,请勿直接当作可复用的结论。

opencode 和别家最大的不同,是把「会话里多条输入怎么排队」当成一等问题。

  • 不是「用户消息直接进循环」,而是 admit 进 inbox、wake 起循环、循环 drain 后调模型。
  • steer / queue / interrupt / revert 四种输入语义各有状态字段。
  • 结论取自 2.3.0 单文件二进制的符号串,精度低于源码级分析。

问题

发布物是编译后的单文件(@opencode/cli 只带二进制),没有可读源码,只能从服务名与字符串还原结构。

候选

主循环

text
Session.prompt → inbox.admit(item) → wake(sessionID)
loop: drain inbox → 调模型 → 执行 tool call → 回填历史 → 再 drain

tickInFlightPrompt、pendingLoopWakeup、consecutiveKeepalives 三个字段描述的正是这条唤醒与占用状态。

工具面

类别内容
文件read / write / edit / apply_patch(内部映射到 patch)
检索glob / grep
执行bash / execute
网络webfetch / websearch
委派subagent:可续聊、可指定 agent 类型与模型
交互permission request:allow_once / allow_always / reject
模式plan mode(hasExitedPlanMode、needsPlanModeExitAttachment)

二进制里还能看到 cachedClaudeMdContent 与 CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL 一类兼容层,说明它在向 Claude Code 的约定对齐。

压缩

触发动作
/compact 或 token 压力Session.compact → admitCompaction({ delivery }) 把压缩任务排进 inbox
完成后生成 type: "compaction" 消息段替代旧历史,pendingPostCompaction 标记待续点

当前判断

  • 把输入排队、抢占、打断做成显式状态机,换来的是弱网、多端、多人同时喂消息时不丢不串。
  • 实现用 Effect 组织服务边界,职责清楚但阅读门槛高。

下一步

  • 需要跑一次真实会话验证 inbox 的抢占与 keepalive 语义(未验证)。

参考