应用内浏览器

应用内浏览器为你和 Codex 提供了一个在线程中共享渲染网页的视图。适用于构建或调试 Web 应用、预览页面以及附加视觉评论。

适用于本地开发服务器、基于文件的预览以及无需登录的公开页面。对于依赖登录状态或浏览器扩展的内容，请使用你的常规浏览器或 Codex Chrome 扩展。

你可以通过工具栏、点击 URL、在浏览器中手动导航，或按 Cmd+Shift+B（Windows 上为 Ctrl+Shift+B）来打开应用内浏览器。

应用内浏览器 不支持 身份验证流程、已登录页面、常规浏览器配置文件、Cookie、扩展程序或现有标签页。仅用于 Codex 无需登录即可打开的页面。

请将页面内容视为不受信任的上下文。不要将机密信息粘贴到浏览器流程中。

浏览器操作

浏览器操作允许 Codex 直接操控应用内浏览器。适用于本地开发服务器和基于文件的预览场景，当 Codex 需要点击、输入、检查渲染状态、截图或验证页面中的修复时使用。

要使用此功能，请安装并启用 Browser 插件。然后在任务中要求 Codex 使用浏览器，或直接通过 @Browser 引用它。应用会将浏览器操作限制在应用内浏览器中，你可以在设置中管理允许和阻止的网站。

示例：

使用浏览器打开 http://localhost:3000/settings，重现布局错误，并仅修复溢出的控件。

Codex 在使用某个网站前会征求你的同意，除非你已将其加入允许列表。将网站从允许列表中移除后，Codex 再次使用前会重新询问；将网站从阻止列表中移除后，Codex 可以再次询问，不再将其视为阻止状态。

对于需要登录的 Chrome 网站，请参阅 Codex Chrome 扩展。

预览页面

1. 在集成终端中或通过本地环境操作启动你的应用开发服务器。
2. 通过点击 URL 或在浏览器中手动导航，打开未认证的本地路由、文件支持的页面或公开页面。
3. 在代码差异旁边审查渲染状态。
4. 在需要更改的元素或区域上留下浏览器评论。
5. 要求 Codex 处理评论并保持范围聚焦。

示例反馈：

我在应用内浏览器的定价页面上留下了评论。请处理移动端布局问题，保持卡片结构不变。

在页面上评论

当错误仅在渲染页面中可见时，使用浏览器评论为 Codex 提供精确的页面反馈。

• 打开评论模式，选择元素或区域，然后提交评论。
• 在评论模式下，按住 Shift 并点击来选择区域。
• 按住 Cmd 并点击可立即发送评论。

留下评论后，在线程中发送消息要求 Codex 处理这些评论。当 Codex 需要进行精确的视觉更改时，评论最为有用。

好的反馈应该是具体的：

这个按钮在移动端溢出。如果标签能放在一行内就保持单行，否则换行但不要改变卡片高度。

这个工具提示覆盖了光标下的数据点。重新定位工具提示，使其保持在图表边界内。

样式反馈

当您在页面的某个区域添加批注（annotation）时，请按文本输入框旁边的配置图标，以向 Codex 提供更细粒度的样式反馈。您可以更改字体、文本、间距和颜色等数值，直接在页面上预览结果，然后发送该批注，以便 Codex 拥有更明确的修改目标。

保持浏览器任务范围聚焦

应用内浏览器用于审查和迭代。将每个浏览器任务保持足够小，以便一次审查完成。

• 明确页面、路由或本地 URL 的名称。
• 指明你关心的视觉状态，如加载中、空状态、错误或成功状态。
• 在需要更改的具体元素或区域上留下评论。
• 在 Codex 修改代码后审查更新后的路由。
• 在 Codex 使用浏览器之前，要求它启动或检查开发服务器。

对于仓库更改，使用审查面板检查更改并留下评论。