openchamber 1.22.1 版本解析:服务端消息队列与 OpenCode Go 会话头兼容

原创2026-09-23 23:14:311,876 阅读
文章标签:人工智能AI 应用代码智能体前端桌面应用后端移动开发

openchamber 1.22.1 版本解析:服务端消息队列与 OpenCode Go 会话头兼容

openchamber 1.22.1(2026-09-04 发布)是一次聚焦“可靠性”与“多端一致性”的版本更新,核心是两个面向基础设施的变更:消息队列从浏览器迁移到 OpenChamber 服务端,以及所有自发性请求全面携带 OpenCode Go 所需的 x-opencode-session 头。本文以该版本更新日志为骨架,结合仓库源码(服务端消息队列运行时、OpenCode Go 配额提供器、UI 队列组件等)逐项拆解这两个核心能力,并完整梳理 Git、工作树、MCP、主题、终端等维度的改进与修复,帮助你理解本次升级的实际影响与迁移要求。

服务端消息队列:队列不再属于某个浏览器标签页

从“UI 侧队列”到“服务端权威队列”

1.22.1 之前,用户在会话忙碌时排队的消息由浏览器 UI 持有;1.22.1 引入的服务端消息队列改变了这一归属:消息由 OpenChamber 服务端在会话转为空闲的那一刻发送。其直接收益有三点,均可在 message-queue 运行时文档 中确认:

  • 关闭标签页不丢消息:队列存放在服务端进程,浏览器标签页关闭、手机锁屏、连接断开都不会让已排队的消息“搁浅”;
  • 多设备看到同一队列:队列状态通过全局事件广播,所有已连接设备(SSE 与 WebSocket)同步同一份队列投影;
  • 发送时机由服务端判定:会话空闲即触发发送,无需依赖某个 UI 实例持续存活。

从源码结构看,该功能采用了与 permission-auto-accept 相同的“服务端权威 + 共享 UI 投影”模式:Web/桌面端由服务端运行时持有状态、UI 只渲染投影;VS Code 扩展没有独立服务端,因此保留了自己的 UI 侧队列与前台上送钩子。

运行时结构与接线

消息队列的实现集中在 runtime.js(约 900 行)与配套测试 runtime.test.js。其接线位置在 server/index.js:在全局事件中枢与 session-knowledge 运行时之后创建;路由注册于 feature-routes-runtime.js(位于通用 OpenCode 代理之前),并由 shutdown-runtime.js 负责停止。这意味着队列运行时与 OpenChamber 主服务生命周期完全绑定。

队列条目(Item)的数据契约

队列中的每条消息被定义为“UI 原本会自己发送的内容”,在入队时一次性捕获,发送时不再重新解析易变的 UI 状态。根据 message-queue 文档,条目结构为:

{
  id, createdAt,
  content,         // 用于展示与编辑的原始文本
  contextPreview?, // 受限的纯展示摘要(UI 捕获)
  text,            // 实际投递文本(去除 agent 提及、解析文件提及);默认等于 content
  agentMention?,   // 以 agent part 形式投递
  attachments: [{ id, filename, mimeType, size, source, serverPath?, dataUrl }],
  context: [       // 发送时附带的上下文,按发送顺序排列
    { kind: 'context', text, metadata, instructions? },  // 草稿 chip 或关联 issue/PR
    { kind: 'instruction', text },                       // 由文本派生的技能指令
    { kind: 'synthetic', text },                         // 其他界面交给 composer 的合成文本
  ],
  sendConfig: { providerID, modelID, agent?, variant? }  // 必填
}

服务端对 context 扮演“信使”角色:校验其结构(kind 必须属于已知集合、context 条目必须携带 metadata 对象),然后将每个条目作为合成文本 part 投递;条目的 instructions 会作为独立 part 紧邻其前发送,metadata 原样携带,使时间线能还原出上下文区块。metadata 内部的负载是 UI 的契约(见 contextParts.ts),由 UI 在回程解析。

入队时会调用 parseQueuedItemInput 做严格校验——凡是服务端将来无法投递的条目(无文本/附件/上下文、缺模型、附件或上下文条目畸形)一律拒绝,保证队列中不会滞留“永远发不出去”的消息。而公开快照与广播会剥离大负载(附件 dataUrl 可能达数 MB 的 base64、context 可能含 PR diff),只有显式 take 才能取回完整条目;快照仅保留被截断到 100 字符以内的 contextPreview。

持久化与崩溃安全

队列持久化在 <data-dir>/message-queue.json(OPENCHAMBER_DATA_DIR 或 ~/.config/openchamber),结构为 { version, revision, sessions: { [sessionId]: { directory, items } } },通过“临时文件 + 重命名”的原子写入链落盘:

  • 文件缺失 = 空队列;
  • 文件损坏 = 失败而非空队列:原文件会被改名为 message-queue.json.corrupt-<timestamp> 后以空队列启动,避免下一次写入覆盖用户数据;
  • revision 是全局单调递增计数器,每次变更都递增,客户端用它拒绝过期快照。

刻意不落盘的只有运行期状态:正在发送的条目(sendingId)、重试退避、中止时间戳与 hold——因为重启后本就没有在途发送,若把“sending”标志持久化反而会让消息永远卡住。

投递循环:如何确保“只在真正空闲时发送”

投递循环是队列正确性的关键,runtime.js 中的逻辑可归纳为:

  1. 事件驱动:运行时订阅全局上游 hub;在加载完成及每次 hub connect 时,为所有含条目的会话武装(arm)调度;
  2. 空闲触发:session.status 为 idle 时启动 500ms 的静默定时器(合并回合边界上的突发事件);busy/retry 则清除定时器。助手回复完成(message.updated)也会触发武装,避免错过 idle 事件导致队列滞留;session.deleted 会丢弃该会话队列;
  3. tick 门控:队列为空、有条目在途、会话处于 hold 状态时直接退出;用户中止后会有 2 秒的 post-abort hold(保持 UI 旧行为:停止后不立即发送下一条);头部条目处于重试退避时重新武装;
  4. 发送前二次核验:因为 prompt_async 若打在正在运行的回合上会被“引导进”当前回合而非开启下一回合,所以发送前必须确认 GET /session/status 不把会话列为 busy/retry,且尾部消息不能是未完成的助手回复(本运行时启动前产生的未完成回复不阻塞——它所属的运行已随旧服务端消亡,永远不会完成;没有 created 时间的回复仍会阻塞);状态获取失败视为“未知”而非“空闲”,会带退避重新武装;
  5. 发送与重试:头部条目标记在途并广播,然后投递——以 / 开头且命中 OpenCode /command 列表(含技能)、且未捕获上下文的文本走 POST /session/:id/command;其余走 POST /session/:id/prompt_async,part 顺序与 UI 直接发送一致(文本、文件、捕获的上下文、技能调用、待决的项目知识、agent 提及)。成功即移除条目并持久化、广播、标记用户消息已发送供通知使用;失败保留条目并按 2s→60s 翻倍退避后重新武装;
  6. 顺序保证:下一条目在下一个 busy→idle 周期后投递。

hold 机制与 API 路由

自动评审(auto-review)流程由 UI 驱动,会在每轮迭代之间让原始会话经过 idle;运行期间 UI 通过 PUT .../hold 通知服务端持有该会话队列,运行结束释放。hold 有默认 5 分钟、上限 10 分钟的 TTL,因为声称 hold 的 UI 可能已消失;运行持续期间 UI 每两分钟重新声明一次。释放 hold 会触发一次调度。

队列通过一组 /api/message-queue 路由对外暴露,均为常规鉴权的 OpenChamber 运行时路由(绝不在浏览器 URL-token 白名单上):

路由 用途
GET /api/message-queue 全量快照 { revision, sessions[] }
POST .../sessions/:id/items 追加 { directory, item },返回 { revision, session, itemId } 并触发调度
DELETE .../sessions/:id/items/:itemId 移除;条目在途时返回 409
POST .../sessions/:id/items/:itemId/take 移除并返回完整条目(含负载);404/409
POST .../sessions/:id/take 按顺序移除并返回全部非在途条目
PUT .../sessions/:id/order { itemIds } 必须是完整排列(拖拽排序)
DELETE .../sessions/:id 清空;在途条目保留
PUT .../sessions/:id/hold { held, ttlMs? }

每次变更都会向所有连接客户端(SSE 与 WS)广播 openchamber:message-queue.updated,负载携带 { revision, session } 且会话始终带有 directory——UI 按目录键控投影,广播缺少 directory 会导致已投递消息残留在屏幕上。限额方面:每会话最多 20 条、最多 50 个会话(最旧的被驱逐,绝不驱逐有在途条目的会话)、内容上限 20 万字符;附件负载受路由族 50MB JSON 限制。

UI 侧体验:队列 chips 与草稿编辑

UI 侧投影位于 messageQueueStore.ts,渲染组件是 QueuedMessageChips.tsx:队列以可折叠的浮动面板呈现,每条消息是一个 chip,支持拖拽排序(桌面鼠标移动 8px 后触发、触屏长按 200ms 触发)、编辑(take 后连附件一起还原回 composer)、发送与移除。1.22.1 的改进之一是排队消息保留其附加的上下文、文件提及与技能,编辑时全部带回 composer——这与 composer 草稿持久化机制(useComposerDraft.ts,按 runtime/directory/session 三元组隔离草稿、500ms 防抖 + 页面卸载强制落盘)协同,确保排队与编辑过程中不丢内容。

OpenCode Go 会话头:9 月 6 日前的必做迁移

1.22.1 的另一个关键变更与 OpenCode Go 服务有关:从 9 月 6 日起,OpenCode Go 要求所有请求携带 x-opencode-session 头。此前只有聊天流量携带该头;本次更新让 OpenChamber 自行发出的每一类请求——提交消息、PR 文本、recap 与后续跟进、走查(walkthrough)、Goal Mode 检查、笔记、用量查询——都带上它。如果你使用 OpenCode Go,必须在 9 月 6 日前升级到 1.22.1。

仓库中的实现证据清晰可查。在 opencode-go.js 中,用量获取请求:

const response = await fetchImpl('https://opencode.ai/zen/go/v1/usage', {
  headers: {
    Accept: 'application/json',
    Authorization: `Bearer ${apiKey}`,
    'x-opencode-session': 'openchamber-usage',
    'User-Agent': 'OpenChamber quota provider',
  },
  signal: AbortSignal.timeout(15_000),
});

该提供器通过 parseOpenCodeGoUsage 解析 usage 负载中的 5h/weekly/monthly 窗口(映射为 rolling/weekly/monthly),并返回 usedPercent(钳制在 0–100)与 resetsAt 时间戳;401/403 视为认证失败,窗口无法解析则报错。配额模块的完整提供器清单见 quota/DOCUMENTATION.md,其中 opencode-go 的凭据读取自 OpenCode auth.json 中 opencode-go 别名的 API key。VS Code 扩展侧的对应实现位于 opencodeGoQuota.ts,其用量请求同样携带该头(并有 quotaProviders.test.ts 与 opencode-go.test.js 双端测试保障)。

运维提示:升级窗口很紧——聊天流量本就合规,但提交消息、PR 文案、recap、走查、Goal Mode 检查、笔记与用量查询等“自发请求”必须在 9 月 6 日前完成升级,否则 OpenCode Go 会拒绝这些请求。

Git 与工作树:分支切换安全化与大量体验修复

分支切换新增提交/还原对话框

未提交变更的分支切换现在会先停在对话框前,要求你先提交或还原,并可选择推送(感谢 @yulia-ivashko)。推送失败会取消切换——这防止了“以为切过去了、其实本地与远端状态不一致”的隐性错误。移动端 Changes 视图新增分支选择器,且分支选择器会列出近期分支并标记含未推送提交的分支;基于含未提交变更目录的草稿,其分支选择器上会显示警告;工具完成变更或工作树变化后 Git 状态会自动刷新。

工作树(Worktree)改进与修复

  • 归档提速:归档一个工作树的会话从约 15 秒降到约 1 秒(121 个会话),侧边栏批量选中归档同样快速(@yulia-ivashko);
  • 移除不冻结:移除工作树不再冻结界面,改为后台运行 + 进度 toast;
  • 落后于上游的分支:从落后于其上游的分支创建工作树时,会先 fetch 再从远端分支(@jtatum);
  • 对话框保留输入:工作树列表变化时 New Worktree 对话框保留已输入内容;
  • 侧边栏清理:被移除的工作树会从列出的每个项目下消失;新建工作树执行 setup 命令期间,Git 状态不再闪烁“半成品变更”。

MCP:断线自动重连

MCP 服务器启动失败或连接丢失后现在会自动重连,两次尝试之间最多等待 30 秒。被禁用的服务器和等待登录的服务器不受影响。该能力仅限 Web 与桌面端。这意味着 MCP 工具链的瞬态故障(网络抖动、服务端重启)不再需要用户手动干预。

设置、主题与桌面

  • Fixel Text 作为界面字体可用:字体选项在 fontOptions.ts 中注册,UiFontOption 增加 fixel,与 Inter、Geist Sans、Atkinson Hyperlegible、Source Sans 3、Roboto 等并列;VS Code 扩展同步支持;
  • 主题改进:新安装默认使用 OpenChamber 明/暗主题,已有的 Flexoki 选择会被保留;切换会话跨目录时主题不再翻转,主题字段缺失时保留当前偏好(@kydorn);
  • exe.dev 用量窗口被追踪:配额体系新增 exe.dev 用量窗口(提供器见 quota/DOCUMENTATION.md 的 exe-dev 行,Token 存于 ~/.config/openchamber/quota/);
  • 桌面实例切换器:状态在打开之间保持、不再把已连接实例显示为 checking、中继实例最多等待 15 秒才判定不可达、显示完整实例名;
  • 私有中继上的开发服务器预览:Desktop 的 dev server 预览现在可经 private relay 工作;
  • 实例切换清理:切换实例会清除前一实例的 Linear/GitHub 登录、配额、MCP 状态、技能与记忆;
  • 设置 → Integrations 收窄:不再提供 Claude Code 与 Cursor 插件安装入口,现仅保留 GitHub 与 Linear(VS Code 端同样移除该页面)。

聊天、终端与杂项修复

  • 新会话位置记忆:新会话在你上次使用的 Chat 或 Project 侧打开;重命名会话时全选标题(@yulia-ivashko);
  • 聊天输入中的 + 按钮:在聊天内点击加号会打开一个新的聊天草稿;
  • 思维力度(Thinking effort)持久化:选择 Default 后在发送、切换 agent/会话后均保持;重新打开的会话会恢复其最后一条消息所用的力度(@yulia-ivashko);
  • 终端修复:文本不再因未调整终端大小而渲染错误,运行于 Bun 下的服务器上的终端也能正常连接;
  • Origin 校验:处于 HTTP 代理跳之后的 HTTPS 浏览器不再被误判为 origin 不匹配而被拒绝;
  • 侧边栏:项目标签在悬浮操作出现时不再位移;
  • 隔离工作树会话:从回答中启动隔离工作树会话时,若当前会话已位于某工作树中,会选择正确的项目;
  • 窗口缩放:窗口缩放不再把空闲的 reader 弹回对话末尾;
  • 土耳其语界面:缺失的 Git 仓库发现标签已恢复(@kydorn)。

升级建议与验证要点

  1. OpenCode Go 用户:9 月 6 日前升级到 1.22.1,否则自发请求(提交消息、PR 文案、recap、走查、Goal Mode、笔记、用量)会被拒绝;
  2. 多设备重度用户:服务端消息队列意味着排队消息与设备解耦,可放心在任意设备排队、在任意设备看到同一队列;若自建服务端,注意 message-queue.json 位于数据目录(OPENCHAMBER_DATA_DIR 或 ~/.config/openchamber),做好备份即可完整迁移队列;
  3. MCP 依赖方:瞬态断连现在会自动恢复(最多 30 秒间隔),无需手动干预;但被禁用的服务器不会自动启动,仍须手动启用;
  4. 工作树归档:大批量会话归档的耗时从十秒级降到秒级,适合在归档前放心批量选择。

综上,1.22.1 的工程重心是“把关键状态从浏览器挪到服务端、把协议兼容性补齐到截止日期之前”:消息队列的归属变更配合原子持久化、严格的投递门控与跨端广播,构成了一个可重启、可崩溃恢复的可靠发送管道;x-opencode-session 头的全面覆盖则是与 OpenCode Go 平台节奏对齐的必要一步。对使用者而言,这是一次“升级动作小、可靠性收益大”的版本。

登录后查看全文
openchamber