WebPreview 预览

在 Agent 沙箱中运行 Web 应用，并把 localhost 链接转换成可外网访问的 Buda 预览链接。

WebPreview 用来预览 Agent 沙箱里正在运行的 Web 应用。你只需要用自然语言告诉 Agent 启动项目、给出预览链接，然后使用 Local Browser打开即可。

什么时候使用 WebPreview

当 Agent 帮你做网页、Demo、小游戏、Dashboard、前端项目，或者修改了一个 Web 应用后，你想在浏览器里看到实际效果，就可以使用 WebPreview。

你可以直接这样说：

请启动预览，并给我链接。

请使用 /buda-web-preview 检查进程，并给我一个可用的预览链接。

请使用 Local Browser 打开页面，检查是否正常展示。

http://localhost:3000

其他端口也一样。例如你在 Local Browser 输入：

http://localhost:4000

Buda 会自动为 4000 端口申请外网可访问的预览链接，并打开页面。

如果页面空白、一直加载，或者出现错误，请在对话框里告诉 Agent 检查服务是否正在运行，并让它重新给你预览链接。

可以这样说：

请检查预览服务是否正在运行，并给我预览链接。

请使用 /buda-web-preview 检查进程，并给我预览链接。

预览没有正常打开，请检查 3000 端口的 dev server，并给我一个可用链接。

如果 Local Browser 里出现唤醒按钮，也可以直接点击。Buda 会把检查或重启请求发送给 Agent，并在服务恢复后刷新预览。

回到 Local Browser，重新输入原来的 localhost 地址，例如：

http://localhost:3000

Buda 会重新申请一个新的签名预览链接，并再次打开页面。

通常表示应用进程没有运行，或者实际运行端口不对。请在对话框里告诉 Agent：

请使用 /buda-web-preview 技能检查进程，并给我预览链接。

你也可以直接点击 Local Browser 里的唤醒按钮，触发同样的恢复流程。你可以打开 buda-web-preview 技能页面查看这个系统内置技能的详细信息。

通常不需要。直接用自然语言描述目标即可，例如：

请启动这个项目，并打开 WebPreview 给我看。

Agent 会检查项目结构，启动合适的服务，并输出预览链接。