第23章 每个工作树独立浏览器
每个工作树独立浏览器
每个 Orca 工作树都配有一个独立的浏览器实例。这是一个嵌入在面板中的真实 Chromium 窗口，拥有地址栏、历史记录和开发者工具。标签页与所属的工作树隔离，确保你正在开发的 App 不会干扰其他工作场景。
带有地址栏和标签页条的独立工作树浏览器面板
控制项
地址栏支持历史记录和模糊匹配 URL 补全。输入非 URL 文本时，会使用默认搜索引擎进行搜索——与新建标签页时的全能框使用相同的引擎。在 + 字段中以 ? 开头可强制触发搜索。双击单词可选中该词，与其他浏览器行为一致。 提供后退、前进、刷新和停止按钮。将鼠标悬停在刷新控件上可查看标准刷新快捷键；右键点击（或长按）可访问“刷新”和“强制刷新”及其对应的快捷键——强制刷新会绕过缓存，适用于本地前端资源迭代开发时。 Cmd-F — 页内查找。 在窄面板中，次要浏览器工具会折叠进溢出菜单，确保导航控件、地址栏和 Cmd-F 始终可访问。 Cmd-T — 新建标签页，该标签页归属于当前工作树。 Cmd-Shift-T — 重新打开最近关闭的标签页。 链接和 window.open 遵循 Chrome 的路由逻辑：在 Chrome 中会打开新标签页的页面链接或脚本，在 Orca 中也会打开新标签页，并沿用发起方的浏览器配置文件。具名弹窗或 OAuth 风格的弹窗仍可在全局独立窗口中打开。 新标签页在后台加载，即使当前未激活，其 URL、标题和导航状态也已准备就绪，切换时即可使用。恢复的非激活标签页可能仍会延迟加载。 HTML 预览在地址栏中显示其文档路径。在预览中直接输入 Web URL，可将预览转换为浏览器标签页；在浏览器标签页中输入工作区 HTML 路径，则可将其转回为预览。当标签页没有中间历史记录时，返回操作可跨越这种转换。
工作树隔离 标签页按工作树进行过滤。切换工作树时，会恢复该工作树的浏览器标签页及滚动位置。 带有持久会话的独立工作树浏览器标签页 — 一键从 Chrome 或 Edge 导入 cookies。 Google 登录状态不会被导入；请在 Orca 中直接登录 Google 账号。
远程工作区 对于位于配对远程 Orca Server 上的工作区，新浏览器页面默认在本桌面渲染，而 HTTP(S)、WebSocket、DNS 和环回流量仍通过远程主机传输。输入、选择和弹窗操作保持本设备原生特性，无需更改页面的网络身份。浏览器工具栏中的主机指示器会显示流量去向。 在 设置 → 浏览器 → 远程服务器工作区 中，选择“本设备”或“服务器（流式传输）”。此选择仅对新页面生效；不会移动已打开的页面。如果本地渲染的远程页面无法启动，“在服务器上重新打开”会在其最后访问地址处打开一个新的由服务器托管的页面（登录状态或表单状态可能会有差异）。 对于 SSH 工作区，“通过 SSH 工作区主机浏览”功能控制浏览器流量和 DNS 是通过工作区的 SSH 主机还是本设备传输。来自客户端托管远程页面的下载会保留在远程工作区主机上，上传内容会先暂存在那里，随后页面才会接收。
链接路由 在 设置 → 浏览器 → 链接路由 中，选择终端、Markdown 和编辑器中的 http(s) 链接是在 Orca 的独立工作树浏览器中打开，还是在系统浏览器中打开。 嵌套的“按住 Shift…”切换开关会通过平台修饰键（macOS 上为 ⇧⌘-点击，Windows / Linux 上为 Shift+Ctrl+点击）一次性反转该默认行为：
- 当链接默认在 Orca 中打开时，修饰键会将单条链接发送至系统浏览器。 - 当链接默认在系统浏览器中打开时，启用该开关后，修饰键会在 Orca 内置浏览器中打开单条链接（普通点击仍保持系统浏览器行为）。
经过能力验证的配对运行时或符合条件的 SSH 工作区可以为其终端链接提供同样的 Orca/系统浏览器选择。旧版运行时中的链接仅支持在系统浏览器中打开。参见 终端 → 链接操作。
下载 活动期间或刚完成的浏览器下载会出现在工具栏下方的搁架中，提供取消进行中的下载、打开已完成文件、在文件夹中显示或关闭该行等操作。
共享为工件 在独立工作树浏览器中打开的本地 HTML 文件可使用工具栏中的“共享为工件”功能，通过已登录的 Orca 账户生成一个公开查看链接（与 Markdown 相同的 opt-in 门槛和管理界面）。每个文件的共享内容限制在 10 MiB 以内。相对路径的 HTML 资源不会上传——请共享自包含文件或使用绝对资源 URL。参见 设置 → 工件 和 CLI 参考 → 工件。
视口大小模拟 在浏览器标签页上设置自定义视口大小，无需调整整个面板即可测试响应式布局。Orca 底层使用 Chrome DevTools Protocol 的设备模拟功能，因此页面在 window.innerWidth 和媒体查询中看到的是模拟后的尺寸。
自动化 浏览器也可通过 Orca CLI 被 Agent 脚本控制——包括 orca snapshot、orca click、orca fill 等命令。操作的是同一个浏览器、同一组标签页。 Agent 通过 CLI 驱动 Orca 内置浏览器 — 相同标签页，相同会话
下一步
- 设计模式 — 将浏览器转变为“指针到代码”的反馈循环。 - Browser-use 配置文件 — 使用特定登录状态、cookie 罐或 User Agent 运行浏览器。
