OpenChamber 1.8.4 更新解读：Chat 内链接 GitHub Issue/PR、Changes 输出模式与收藏模型快捷键

• AI Agent
• 人工智能
• 代码智能体
• 交互助手

OpenChamber 1.8.4（2026-03-04）是一次以「Chat 协作效率」为核心的迭代，重点引入了在会话中直接关联 GitHub Issue/PR 的 Attach 菜单、可点击的文件路径链接、新的Changes工具输出模式，以及收藏模型循环快捷键等能力。本文将结合仓库源码，逐项解读这些新特性背后的实现原理、使用场景与底层行为，帮助你快速评估并上手这一版本。

一、版本概览：1.8.4 的关键主题

从 changelog/1.8.4.md 的发布说明看，本次更新围绕四个方向展开：

1. Chat 与 GitHub 联动：会话中直接链接 issue/PR，并把文件路径变成可点击引用；
2. 输出可读性：新增Changes工具输出模式，让编辑/补丁结果默认展开、活动流保持清晰；
3. 操作效率：收藏模型循环快捷键、会话侧边栏搜索、移动端长按编辑项目；
4. 稳定性与安全：终端认证加固、技能文件路径保护收紧、减少敏感请求日志暴露。

App 端与 VS Code 扩展端同步推进，后者额外增加了「将助手消息保存为图片」的能力。

二、Chat 新能力：文件路径链接、Changes 模式与 GitHub 关联

2.1 助手消息中的可点击文件路径链接

1.8.4 让助手（assistant）消息中的文件路径引用变成可点击链接，且支持行号定位。这意味着 Agent 在回复中提及某个文件（如src/lib/util.ts:42）时，你无需手动搜索，直接点击即可跳转到对应文件与行。

从实现层面看，消息渲染层对文件路径做了专门的解析与展示逻辑。在 ToolPart.tsx 中可以看到renderPathLikeGitChanges这类针对路径文本的渲染辅助函数，负责把路径字符串转换为可交互的链接形态；点击后通过编辑器打开对应的 diff 或文件（例如调用runtime.editor.openDiff打开带(changes)标签的对比视图）。这条能力在 VS Code 扩展端同样生效：Chat: file references in assistant responses are now clickable (including line targets)。

2.2 新的Changes工具输出模式

Changes是一种工具输出展示模式：它默认展开编辑/补丁（edit/patch）结果，同时让活动（activity）流保持紧凑可读。此前工具输出可能需要手动展开才能看到完整 diff，而Changes模式把这些改动直接呈现出来，适合需要快速 review Agent 改动的场景。

该模式在 App 与 VS Code 端的行为略有差异：

• App 端：Changes模式在默认情况下展开 edits/patches，同时保持活动列表的易读性；
• VS Code 端：Changes模式默认打开编辑/写入/补丁结果（edit/write/patch），让活动流更易扫描（easier to scan）。

消息渲染层对工具输出的展示模式（如 JSON summary / tree / raw 等视图的持久化选择）有专门的实现与测试覆盖，可参考 parts/DOCUMENTATION.md，其中说明了工具输出视图模式的保存与读取机制：选定视图模式会持久化到 UI 设置，新会话与刷新后的工具输出会沿用已保存的模式。Changes模式正是这一「工具输出呈现」体系中的新成员。

2.3 Attach 菜单：直接关联 GitHub Issue / PR

这是本次版本标题级的特性——在任何会话中通过 Attach 菜单把 GitHub issue 和 PR 直接链接进来。链接后，Agent 在对话中即可感知到对应的 issue/PR 上下文（标题、编号、作者等），从而围绕真实任务展开协作，而不是凭空猜测需求。

从源码结构看，Chat 输入区维护了一套「关联引用」的数据结构，定义于 ChatInput.tsx：

type LinkedGitHubIssue = { number: number; title: string; url: string; contextText: string; author?: LinkedReferenceAuthor; }; type LinkedGitHubPr = { number: number; title: string; url: string; contextText: string; author?: LinkedReferenceAuthor; }; type LinkedReferences = { issue: LinkedGitHubIssue | null; pr: LinkedGitHubPr | null; linear: LinkedLinearIssueRef | null; };

可以看到，链接的 issue/PR 会携带编号、标题、URL、上下文文本与作者信息，作为附件（attachment）注入会话线程（源码中通过attachedThread统一处理issue与pull两类引用）。这也解释了「Attach menu actions to link GitHub issues and PRs directly in any session」的具体落地：附件不再局限于文件，还能携带 GitHub 引用作为对话上下文。

VS Code 端采用 picker 选择式交互：Attach menu support for linking pull requests into your draft with picker-based selection and attached PR context——即在草稿中输入时通过选择器挑选 PR，并把选中的 PR 上下文挂载到草稿中。

2.4 收藏模型循环快捷键

新增两个快捷键动作：cycle_favorite_model_forward（向前切换收藏模型）与cycle_favorite_model_backward（向后切换）。实现位于 useKeyboardShortcuts.ts：

cycle_favorite_model_forward: () => cycleFavoriteModel(1), cycle_favorite_model_backward: () => cycleFavoriteModel(-1),

cycleFavoriteModel(delta)的核心逻辑是：

1. 检查当前是否有活跃的编辑区（composer）或其他弹层遮挡，若有则跳过；
2. 在favoriteModels列表中定位当前 provider/model 的索引；
3. 用取模运算计算下一个目标模型：favoriteModels[(index + delta + length) % length]；
4. 调用config.setProvider/config.setModel切换模型，并把新模型记入最近使用列表（addRecentModel）。

也就是说，它只在收藏列表内循环，且会自动更新当前会话使用的 provider 与 model。该快捷键在 App 与 VS Code 端同步提供，对应动作标签可从 i18n 资源确认，例如英文为 "Cycle favorite model forward"（见 en.settings.ts），多语言环境（de、es、fr、ja、ko、pl、pt-BR 等）均已同步翻译。

三、会话与项目管理体验

3.1 会话侧边栏：活动项目搜索

侧边栏新增了「活动项目会话搜索」：在会话列表中按当前激活的项目过滤，匹配行为更清晰，且在筛选过程中更容易一键清除过滤条件。这对于同时打开多个工作区、需要快速定位当前项目会话的用户非常实用。

3.2 移动端项目编辑：长按 + 底部面板 + 拖拽排序

移动端/Projects 面板支持长按项目唤出底部面板（bottom-sheet）进行编辑，并支持拖拽重新排序。仓库中移动端工作区相关实现可参考 MobileWorkspaceDrawer.tsx（MobileWorkspaceTab定义）与 MobileChangesSurface.tsx 等移动端 surface 组件。

3.3 Web / PWA / Android 安装体验优化

改进了安装流程：安装前命名（pre-install naming）与 manifest 快捷方式更新（manifest shortcut updates），让 PWA 安装更顺滑、图标/快捷方式更一致。相关 PWA 配置可查看 site.webmanifest 及 Web 端的 PWA 构建配置。

四、稳定性与修复要点

4.1 修复

• Worktrees/Git：修复分支与 PR 源解析问题，包括含斜杠的分支名（slash-named branches）与 fork PR 的 head 分支；
• Git：修复 PR 面板刷新循环，该循环可能引发 PR 区域重复更新与不稳定行为；
• Chat/Files：恢复用户图片预览与全屏导航，并优化窄屏布局下文本选择操作按钮的位置。

4.2 安全与可靠性加固

1.8.4 收紧了安全边界：

• 终端认证加固（hardened terminal auth）；
• 技能文件路径保护收紧（tightened skill-file path protections），防止恶意路径越权读取；
• 敏感请求日志暴露减少（reduced sensitive request logging exposure），降低日常使用中的信息泄露风险。

这些改动属于「静默但重要」的可靠性投入，配合工作区中的 SECURITY.md 与安全相关文档，建议部署在公网/内网代理环境（参考 REVERSE_PROXY.md）的用户及时升级。

五、App 与 VS Code 双端功能对照

可以看到，双端特性高度对齐，仅「保存为图片」「简化 Attach files 流程」为 VS Code 端独有，而移动端（长按编辑、拖拽排序）与 PWA 安装优化则是 App/Web 侧的能力。

六、升级建议与结论

1.8.4 适合以下用户优先升级：

• 重度依赖 GitHub 工作流的开发者——Attach issue/PR 能把任务描述直接带入会话，显著减少上下文搬运；
• 经常 review Agent 改动的用户——Changes输出模式让 diff 一目了然；
• 多模型切换频繁的用户——收藏模型循环快捷键省去反复打开模型选择器；
• 移动端使用者——长按编辑与拖拽排序改善了项目管理体验。

升级路径与验证方式可参考仓库的 CHANGELOG.md 以及各包的发布脚本（scripts/bump-version.mjs）。如果你正在使用 OpenChamber 的 VS Code 扩展或 Web/PWA 版本，建议在升级后重点回归：GitHub 关联附件、文件路径链接跳转、以及 PR 面板的稳定性，这三块正是本版本改动最集中、也最可能影响日常协作流程的区域。

• AI Agent
• 人工智能
• 代码智能体
• 交互助手