OpenChamber 1.16.3 发布解读:Office 附件解析、会话迁移与更快的会话切换

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

OpenChamber 1.16.3 发布解读:Office 附件解析、会话迁移与更快的会话切换

本文围绕 OpenChamber 1.16.3(发布于 2026-07-22)的官方发布说明展开,逐条拆解 App 与 VS Code 两大侧的新功能、改进与修复,并深入仓库源码验证其底层实现。读完本文,你将掌握这版更新中 Office/OpenDocument 附件如何在本地被解包为文本与图片、HAR 与 Notebook 附件如何脱敏、空闲根会话如何连同子会话与未提交改动一起迁移到新工作树,以及大工作区会话切换性能优化的实际做法。

版本概览

1.16.3 的发布说明标题为 "Office attachments and faster session switching"(Office 附件与更快的会话切换),变更集中在三个方向:

  • 附件能力大幅扩展:新增 Office/OpenDocument 文档附件解析,并补充源码格式、Notebook、HAR、SVG/Draw.io 与 HEIC/HEIF 图片;
  • 会话与工作树管理增强:可将空闲根会话连同子会话与未提交改动整体迁入新工作树;
  • 性能与稳定性:大工作区中优先渲染被选中/可见的会话,并修复多项会话列表、流式输出与工作树锁定的问题。

发布说明源码位于 changelog/1.16.3.md,它属于仓库 changelog/ 目录下的"每个版本一个文件"的发布说明体系,由 oc-dev create-release 在发版时生成(参见 changelog/README.md)。

核心新功能一:Office 与 OpenDocument 附件解析

1.16.3 最突出的能力是 Chat attachments:现在可以在聊天中直接附加 Office 与 OpenDocument 文件(.docx、.pptx、.xlsx、.odt、.odp、.ods)。在消息发出之前,OpenChamber 会把文档中的文本以及其中能被 OpenChamber 读取的嵌入图片提取出来,再交给模型。

这并非简单地把文件原样上传,而是在浏览器端完成了一次完整的"解包 → 提取 → 重建"流程。核心实现在 packages/ui/src/sync/document-attachments.ts:

  • 入口 extractDocumentAttachments(file, reservedFilenames)(L670-L688)只处理上述六种扩展名(OFFICE_EXTENSIONS,L15),用 fflate 将 OOXML/ODF 的 zip 包解压后按格式分派;
  • 提取结果是一个 text/plain 文本文件 + 若干嵌入图片文件,图片在提取文本中以 <a href="https://link.gitcode.com/i/838a1f4f5d05e62dded239d154ae4c3c" target="_blank">文件名] 形式的引用占位,最终只保留"确实被引用到"的图片(citedImageFilenames 过滤,[L664-L687)。

各格式的提取策略

从源码结构看,每种格式都有独立的解析函数(extractDocumentText 分发,L631-L648):

格式 函数 提取要点
.docx extractDocx(L256-L270) 解析 word/document.xml 的 w:p 段落,并额外提取 word/headerN.xml / word/footerN.xml 页眉页脚
.pptx extractPptx(L280-L300) 按 ppt/slides/slideN.xml 顺序输出 ## Slide N,并通过关系文件找到演讲者备注(notesSlide)
.xlsx extractXlsx(L449-L469) 读取 xl/sharedStrings.xml 共享字符串,逐 Sheet 输出为 TSV 块或 Cells: 行;密集连续行合并为带 Range: 的表格块
.odt / .odp / .ods extractOdt / extractOdp / extractOds(L506-L545) 解析 ODF 的 content.xml,处理 text:p/text:h 段落、text:s 连续空格、表格行与 draw:page 分页

OOXML 的文本通过 .rels 关系文件(parseRelationships,L102-L112)把图片引用(r:embed / xlink:href)解析到实际归档路径,再经 EmbeddedImages.citation(L170-L202)校验魔数签名(PNG/JPEG/GIF/WebP,L139-L153)后导出。

安全与资源上限

附件解析必须面对"不可信的 zip"这一安全模型。实现中内置了一组严格的资源上限(L3-L13):

  • 附件压缩包不超过 20 MB(MAX_ARCHIVE_BYTES);
  • 解压后总大小不超过 100 MB(MAX_UNCOMPRESSED_BYTES);
  • 单个归档条目不超过 25 MB,单个 XML/rels 条目不超过 8 MB(MAX_ENTRY_BYTES / MAX_XML_ENTRY_BYTES);
  • 归档条目数不超过 5 000(MAX_ARCHIVE_ENTRIES);
  • 嵌入图片最多 50 张、单张 20 MB、合计 40 MB;
  • 提取文本最多 500 000 字符,超长时在末尾追加 [Document text truncated by OpenChamber](TEXT_TRUNCATION_NOTICE)。

此外,createArchiveEntryValidator(L547-L572)会拒绝绝对路径、.. 越界路径、反斜杠、盘符(C:)与含控制字符的条目名,防止 zip-slip 类攻击;解压时只保留 XML/rels 与图片条目(shouldExtractArchiveEntry,L574-L577),并在 Bun 运行时使用同步解码路径(源码注释说明 Bun 的 Blob worker 无法可靠执行 fflate 异步解码,L617-L619)。

核心新功能二:附件格式全家桶与模型能力警告

同一版本把可附加的文件类型扩展到了很广的范围,并新增"模型可能忽略某类附件"的警告机制。类型白名单集中在 packages/ui/src/sync/attachment-files.ts 的 ACCEPTED_ATTACHMENT_TYPES(L1-L107),除了图片、PDF、文本,还包含:

  • 更多源码格式:.diff/.patch、.proto、.sol、.svelte、.vue、.zig、.tf/.hcl、.kt/.kts、.swift、.cs、.dart、.erl 等;
  • Notebook:.ipynb;
  • HAR:.har;
  • 绘图文件:.svg 与 .drawio;
  • HEIC/HEIF 图片:.heic/.heif;
  • 以及 .jsonl、.ndjson、.yml、.toml 等结构化数据格式。

这些格式在附加前会先被预处理(prepareAttachmentFiles,L393-L414),处理方式各不相同:

  • HEIC/HEIF:通过 heic2any 转为 JPEG(质量 0.9,L358-L370);
  • HAR:sanitizeHarValue(L316-L335)会把 authorization、cookie、set-cookie、x-api-key、password、token 等敏感字段(SENSITIVE_NAMES,L208)替换为 <a href="https://link.gitcode.com/i/898e58ad41d533fcf1c16be00fa96afc" target="_blank">REDACTED],把响应体 text 与 encoding 替换为 [OMITTED BY OPENCHAMBER],URL 查询参数中的敏感键同样打码(redactUrl,[L304-L314);
  • Notebook:notebookText(L256-L302)把 Markdown 单元格与代码单元格渲染成可读的 Markdown,二进制输出(如图片)以 [Non-text output omitted: ...] 占位。

上述行为在 packages/ui/src/sync/attachment-files.test.ts 中有直接对应的测试用例,例如 L83-L120 验证 HAR 中 URL 的 token 参数、请求头 Authorization、Cookie 值被替换为 [REDACTED],而请求/响应体与 encoding 被 [OMITTED BY OPENCHAMBER] 替换,且原始密钥字符串不出现。

模型能力警告基于"输入模态"(text/image/pdf/audio/video)判定:getAttachmentInputModality(L154-L162)把附件 MIME 归一化为模态,getUnsupportedAttachmentInputs(L164-L177)再与模型声明的 supportedInputModalities 比对,找出"模型不支持的附件",composer 据此弹出警告。

会话与工作树:把空闲根会话整体迁入新工作树

发布说明的第二项大能力:Sessions/Worktrees —— 把空闲的根会话、它的子会话以及未提交的改动一起移动到新工作树。这对长期使用同一工作区、又想为某条任务线开辟独立环境的开发者很有用。

UI 侧有确认对话框 packages/ui/src/components/session/sidebar/SessionWorktreeMoveConfirmDialog.tsx,业务逻辑集中在 packages/ui/src/lib/worktrees/sessionWorktreeMove.ts。从该文件的导入与状态结构可以推断其执行链路:

  • 迁移前会调用 checkIsGitRepository、getGitStatus 统计脏文件/已暂存文件数量,构造 SessionTreeMoveConfirmation(含 dirtyFileCount、stagedFileCount,L54-L58)供用户确认;
  • 迁移本身通过 moveSessionToDirectory 与 createQuickWorktree / resolveProjectRef 完成,之后用 getLatestWorktreeMetadata 校验并 refreshGlobalSessionsForDirectories 刷新会话列表;
  • 状态机用 zustand 管理 pendingSessionIds / requestingSessionIds,暴露 useIsSessionWorktreeMovePending 与 useSessionTreeMoveConfirmation(L66-L79),保证同一会话的迁移请求不重复提交;
  • 失败文案区分"源目录校验失败""改动应用失败""改动可能已在目标工作树"三类场景(SessionTreeMoveMessages,L16-L35),提示用户核对改动去向。

相关修复也体现了对 Git 边界的谨慎:创建工作树时若此前一次 Git 操作把仓库锁住(.git/index.lock 残留),现在可以自动恢复;VS Code 的 Agent Manager 中"删除仍在初始化中的工作树不再让它在刷新后复活"。

性能:把选中与可见的会话排在前面

1.16.3 把"会话切换慢"作为主要性能修复点:在大工作区打开与切换会话时,被选中且当前可见的聊天优先渲染。同时修复了两个会破坏会话列表稳定性的问题:

  • 一次失败的刷新不再清空你已有的会话列表;
  • 父会话不再因为其子会话先加载完成而消失;
  • 会话数据被严格限定在它自己的实例、项目与工作树范围内(App),避免跨范围串数据。

侧边栏另一处体验改进是项目/工作区分组默认按手工排序显示,你自己做出的排序选择会被保留——也就是说,项目的排序不再被外部刷新打乱。

桌面端:远程实例直启、Windows OpenSSH 与菜单栏开关

  • Desktop:可以直接启动进入已保存的远程实例、一个 URL 或配对链接,无需本地 OpenCode、也无需本地服务器。这降低了远程开发的门槛——桌面端退化为纯粹的客户端入口。
  • Desktop/Windows:SSH 远程实例改为通过 Windows 原生 OpenSSH 连接;密码登录与端口转发在隐藏的后台进程中运行,连接失败时直接展示 SSH 自身的错误信息,便于排查。
  • Desktop/macOS:新增设置项可隐藏菜单栏图标。

定时任务与聊天体验改进

  • Scheduled Tasks:任务现在可以以"权限自动接受"开启的方式启动;其权限开关与 Run as 目标控制采用了与聊天 composer 相同的紧凑开关样式,配置路径更一致。
  • Chat:助手消息的页脚现在同时展示模型、代理(agent)、思考级别(thinking level)、耗时与时间;被隐藏的系统提示或子代理提示拆开的回复会合并读作一条完整回合。
  • Chat:正在工作的指示器会点名真正在写回复的模型;底部流式输出不再抖动;新用户消息的进入动画会完整播完,而不是突然跳到位。
  • Chat/Tools:插件与自定义工具返回的附件在流式输出与刷新后保持可见,并拥有与你自己附加的文件相同的图片预览与文件 chip(感谢 @FrostiDrinks)。
  • Context Panel:一个慢速的文件打开请求不再在你切换到其他标签后把面板强拉回那个文件。
  • Mobile/Terminal:在移动浏览器或 PWA 中打开终端会直接聚焦输入框并唤起键盘,无需二次点击(感谢 @bashrusakh)。

VS Code 与 Cursor 扩展侧变更

1.16.3 的 VS Code 扩展部分与 App 高度对齐,但只包含扩展真正挂载的能力(发布说明体系要求 ## VS Code 小节单独撰写,参见 changelog/README.md):

  • New:与 App 相同的 Office/OpenDocument 附件解析,以及源码格式、Notebook、HAR 脱敏、SVG/Draw.io、HEIC/HEIF 与模型能力警告;
  • Improvements:大工作区优先渲染选中/可见会话;助手消息页脚展示模型、代理、思考级别、耗时与时间;工作区分组按手工排序并保留用户排序;
  • Fixes:
    • 会话列表刷新失败保留旧数据、父会话不因子会话先加载而消失、会话数据限定在各自工作区与视图内;
    • VS Code 与 Cursor 中,当编辑器 webview 缺少常规消息 API 时打开聊天不再崩溃,已关闭的编辑器标签不再收到迟到的流式消息(感谢 @makeittech);
    • 启动时先确定活动工作区再恢复已保存状态,防止编辑器工作区外的项目顶替当前工作区;
    • Agent Manager 中工作树创建在 Git 锁残留时自动恢复,删除仍在初始化的工作树不再使其复活。

结语

OpenChamber 1.16.3 是一版"把附件做成第一公民、把会话搬进工作树"的更新:Office/OpenDocument 文档在发送前于本地完成解包、提权与脱敏(HAR 的凭据与 Cookie 被 [REDACTED]、响应体被 [OMITTED BY OPENCHAMBER]),嵌入图片经魔数校验后随文本一并交付给模型;空闲会话树可以整体迁入新工作树并自动处理 Git 锁残留;会话切换性能与流式 UI 稳定性也得到系统性修复。如果你想从代码层面继续深入,推荐从 packages/ui/src/sync/document-attachments.ts 与 packages/ui/src/sync/attachment-files.ts 两份文件出发,配合 packages/ui/src/sync/attachment-files.test.ts 观察脱敏与渲染的边界用例。

登录后查看全文
openchamber