跳转到主要内容
浏览器预览是一个私有链接,指向在 Devin 的机器上运行的 Web 应用程序。Devin 在会话中启动开发服务器后,可以暴露相应端口,并为你提供一个可在 Web 浏览器中打开的链接。 预览适用于任何技术栈。只要应用在某个端口上提供 HTTP 服务,Devin 就能预览。应用及其数据始终保留在 Devin 的机器上,不会上传到任何第三方服务。
本页介绍的是 Devin 会话中的预览。如需在 Devin Desktop 中预览本地开发服务器,请参阅 Devin Desktop 预览。

打开预览

当 Devin 启动了需要你查看的应用时,会自动打开预览。你也可以主动要求预览,例如“预览这个应用”。 Devin 会在聊天中发布一张 Open preview 卡片。点击该卡片,即可在会话的预览选项卡中打开应用。若按住 Cmd 或 Ctrl 点击,或用鼠标中键点击该卡片,则会在新的浏览器选项卡中打开预览。 对于从 Slack 发起的会话,会话线程中会显示 Open preview 链接。

预览 URL

预览 URL 的格式如下:
名称取自 Devin 为预览设置的名称。id 是随机生成的,因此该 URL 无法被猜测。 该 URL 归属于会话。即使 Devin 重启应用或将其迁移到其他端口,URL 也保持不变。不同会话中的预览会分配到不同的 URL。 预览 URL 还支持另一种语法,可单独访问 devin 在机器上暴露的各个端口:
这些端口必须由 Devin 主动暴露,但一旦暴露,任何人都可以访问。

谁可以打开预览

预览是私有的,不会向公共互联网暴露任何内容。 打开预览 URL 的任何人都必须先登录 Devin。登录后,预览的访问权限与其所属会话保持一致:只要你能向该会话发送消息,就能打开它的预览。 默认情况下,您的组织中所有可以使用 Devin 会话的成员都能访问,因此你可以直接把链接发给队友,对方点开即可查看。如果会话仅限其所有者或特定人员访问,则只有这些人能打开该预览,其他人会看到提示预览不可用的页面。

预览选项卡的功能

预览选项卡就像一个小型浏览器,提供前进、后退、刷新、缩放和页内查找按钮,以及一个设备尺寸切换器,可在桌面、平板和手机宽度之间切换。 你还可以在页面上添加标注,告诉 Devin 需要修改哪些内容。在会话中使用“选择”按钮时,只需点击某个元素或拖动框选一个区域,添加备注,然后发送到聊天即可。Devin 会同时收到你选中的元素和备注。

使用多个端口的应用

一个预览可以涵盖多个端口,例如前端运行在一个端口上,后端 API 运行在另一个端口上。Devin 打开预览时会列出所有端口,预览默认打开第一个端口。你可以通过预览选项卡中的 Ports 菜单在这些端口之间切换。 你的前端无需感知预览 URL。如果页面调用 http://localhost:8000,预览会将该请求发送到 Devin 的机器上的 8000 端口。预览会安装一个 service worker,由它在你的浏览器中重写这些请求;WebSocket 连接也按同样的方式处理。由于请求始终使用预览自身的地址,你无需更改 CORS 设置。 此功能仅适用于 Devin 已为预览公开的端口。

您的应用看到的内容

在您的服务器看来,请求来自 localhost。预览会在请求到达您的应用之前,将 Host 和 Origin 标头设置为 localhost,因此会检查主机名的开发服务器无需额外配置即可正常工作。Devin 在运行和测试应用时也同样使用 localhost。 与在您自己的计算机上运行应用相比,以下几方面的行为有所不同:
  • Service worker。 预览使用自己的 service worker,因此您的应用无法再注册 service worker。如果您的应用是 PWA,请在开发环境中关闭 service worker,否则自动端口重写可能无法正常工作。
  • Cookie。 您的应用在预览选项卡中设置的 Cookie,与在独立浏览器选项卡中打开预览时设置的 Cookie 相互隔离。如果您在其中一处登录了应用,在另一处可能需要重新登录。
  • 通过身份提供商登录。 您的浏览器访问的是预览 URL,而不是 localhost。如果只将 localhost 注册为重定向 URL,Microsoft Entra ID、Okta 或 Google 等提供商会拒绝登录。请参阅端口隧道。
  • HTTPS 开发服务器。 您的浏览器看到的是 Devin 的证书,而不是您服务器的证书。请参阅 HTTPS 回环。

端口隧道

有些服务要求你的浏览器确实运行在 localhost 上才能正常工作,最常见的就是通过身份提供商登录。身份提供商只接受你已注册的重定向 URL,而大多数开发环境注册的都是 http://localhost:<port>。预览有自己的 URL,因此会被身份提供商拒绝。 遇到这种情况,你可以通过隧道将端口从 Devin 的机器转发到你自己的计算机。这样,应用就会在你的浏览器中以 http://localhost:<port> 打开,与在本机运行时完全相同,身份提供商也会接受该地址。 建立端口隧道有两种方式:
  • Devin Desktop。 在 Devin Desktop 中打开会话,并在其中转发端口。
  • SSH。 运行 devin forward <session> 3000,或者向 devin ssh 或普通的 ssh 传入 -L 3000:localhost:3000。参见转发端口。
隧道只对运行它的那台计算机有效,因此无法作为链接分享给队友。需要共享时请使用预览,需要 localhost 的场景则使用隧道。 如果你更想继续使用预览,可以将会话的预览 URL 添加到身份提供商的重定向 URL 列表中,或者为应用提供一种绕过身份提供商的开发登录方式。Devin 也可以在它自己的浏览器中通过 localhost 登录。参见 Interactive Browser。

HTTPS 回环

如果开发服务器在其端口上提供 HTTPS 服务,无需额外配置即可在预览中使用。Devin 会检测到该端口使用 HTTPS,并通过 HTTPS 与其建立连接。 你的浏览器不会看到你服务器的证书,因为预览 URL 使用的是 Devin 的证书。与你的开发服务器之间的连接是在 Devin 的机器上建立的,且不会在那里检查你的证书,因此自签名的开发证书可以正常使用,不会出现警告。 这一点仅在少数情况下需要注意,例如某个应用要求浏览器看到一个具体的证书。

休眠中的会话

会话空闲时,Devin 的机器会进入休眠状态。你无需手动唤醒它:打开预览即可唤醒机器,应用会在原 URL 上恢复运行。首次加载页面可能需要几秒钟。 预览使用期间,机器会保持唤醒状态,并在最后一次请求约 5 分钟后再次进入休眠。 会话归档或结束后,预览将无法使用。

预览与 Devin Apps

预览与单个会话绑定,适合用来查看进行中的工作、审查变更,或向队友展示 Devin 构建的成果。大多数情况下,预览就已足够。 Devin Apps 则面向另一类场景:会话工作结束后,您的团队仍会持续使用的内部工具、仪表板或类似应用。如果你要构建的正是这类应用,可以让 Devin 将预览发布为 Devin App。Devin Apps 与预览的运行方式相同,都由 Devin 的机器提供服务,但拥有稳定的 URL 以及一套独立且完善的共享设置。