文档 / 浏览器 / 每个 worktree 的浏览器

每个 Orca worktree 都有自己独立的浏览器。它是一个真实的 Chromium 窗口——包含地址栏、历史记录和开发者工具——嵌入在一个窗格中。标签页按 worktree 隔离，因此你正在开发的应用不会干扰其他工作。

控件¶

• 带有历史记录和模糊 URL 补全的地址栏。非 URL 文本会使用你的默认搜索引擎进行搜索——与新标签页全能框使用相同的引擎。在 + 字段中以 ? 开头输入查询可强制搜索。
• 后退 / 前进 / 重新加载 / 停止。将鼠标悬停在重新加载控件上可查看普通重新加载快捷键；右键单击（或长按）可查看 Reload 和 Hard Reload 及其快捷键——在迭代本地前端资源时，强制重新加载会绕过缓存。
• Cmd-F — 在页面中查找。
• Cmd-T — 新建标签页，范围限定于当前 worktree。
• Cmd-Shift-T — 重新打开最近关闭的标签页。
• 使用 target=_blank 的页面链接以及普通的未命名弹窗会在新 Orca 标签页中打开，并使用打开者标签页的浏览器配置文件。命名弹窗或 OAuth 风格弹窗仍可在独立窗口中打开。

worktree 作用域¶

标签页按 worktree 过滤。切换 worktree 时会恢复该 worktree 的浏览器标签页和滚动位置。

远程工作区¶

对于位于已配对的远程 Orca 服务器上的工作区，新的浏览器页面默认在本桌面渲染，而 HTTP(S)、WebSocket、DNS 和环回流量仍通过远程主机传输。输入、选择和弹窗保持为本设备原生，不改变页面的网络身份。浏览器工具栏中的主机指示器显示流量去向。

在设置 → 浏览器 → 远程服务器工作区中，选择 This device 或 Server (streamed)。该选择仅适用于新页面；不会移动已经打开的页面。如果本地渲染的远程页面无法启动，Reopen on server 会在其最后地址打开一个新的服务器托管页面（登录状态或表单状态可能不同）。

对于 SSH 工作区，Browse through SSH workspace hosts 控制浏览器流量和 DNS 是通过工作区的 SSH 主机还是本设备传输。从客户端托管的远程页面下载的文件会保留在远程工作区主机上，上传文件会先暂存到该主机，然后页面才会接收。

链接路由¶

在设置 → 浏览器 → 链接路由中，选择来自终端、Markdown 和编辑器的 http(s) 链接是在 Orca 的按 worktree 划分的浏览器中打开，还是在系统浏览器中打开。

嵌套的 Hold Shift… 切换项可通过平台修饰键单击一次来反转该默认行为（macOS 上为 ⇧⌘-click，Windows / Linux 上为 Shift+Ctrl+click）：

• 当链接在 Orca 中打开时，修饰键会将单个链接发送到系统浏览器。
• 当链接在系统浏览器中打开时，打开该切换项，使修饰键改为在 Orca 内置浏览器中打开单个链接（普通单击仍使用系统浏览器）。

经过能力验证的已配对运行时可以为终端链接提供相同的 Orca/系统浏览器选择。SSH 拥有的终端链接以及来自旧版运行时的链接仍仅支持系统浏览器。参见终端 → 链接操作。

下载¶

浏览器下载在激活或最近完成时会显示在工具栏下方的下载架上，并提供操作以取消进行中的下载、打开已完成的文件、在文件夹中显示该文件或关闭该行。

共享为工件¶

在 worktree 浏览器中打开的本地 HTML 文件可使用工具栏中的 Share as artifact 通过已登录的 Orca 账户生成一个公共查看链接（与 Markdown 相同的选择加入门槛和管理界面）。相对 HTML 资源不会被上传——请分享自包含文件或使用绝对资源 URL。参见设置 → 工件 和CLI 参考 → 工件。

视口大小模拟¶

在浏览器标签页上设置自定义视口大小，可在不调整整个窗格大小的情况下测试响应式布局。Orca 底层使用 Chrome DevTools Protocol 设备模拟，因此页面会在 window.innerWidth 和媒体查询中看到模拟尺寸。

自动化¶

浏览器也可通过 Orca CLI 由代理进行脚本化操作——例如 orca snapshot、orca click、orca fill 等。你交互的是同一个浏览器，也是同一组标签页。

后续步骤¶

• 设计模式 — 将浏览器变为指向代码的反馈循环。
• 浏览器使用配置文件 — 使用特定登录状态或 cookie 存储运行浏览器。