agentic

如何使用 Cursor 发布网站:云代理或您自己的主机1 min read

Reading Time: 2 minutes发布在 Cursor 中构建的网站:测试项目,在符合条件时使用 Cloud Agent Publish with Vercel,或通过其他主机部署存储库。

Cursor publishing a website cover

如何使用 Cursor 发布网站:云代理或您自己的主机1 min read

Reading Time: 2 minutes

要使用Cursor发布网站,首先让项目运行,然后选择部署路径。 Cursor 的云代理具有记录的连接到 Vercel 的存储库的发布流程。如果您在桌面编辑器中构建或使用不同的主机,请使用该主机的正常管道部署经过审查的存储库。 Cursor 的预览和转发端口可让您检查应用程序,但您向客户提供的公共地址也不是。

本演练适用于想要正常启动而不是生成的登陆页面屏幕截图的构建者。它涵盖存储库选择、提示、本地和云预览、构建检查、发布以及利益相关者的可选共享工件路径。如果多人需要在发布前审阅同一份草案,请考虑 共享 AgentGrid.io 工作区 而不是交换屏幕截图。

如何在Cursor中建立网站并使用AgentGrid.io发布

在 Cursor 中编写代码之前设置 AgentGrid.io,以便应用程序位于正确的工作区中。

步骤1:在AgentGrid.io中创建站点工作区

登录 app.agentgrid.io,选择正确的团队,然后为网站选择工作区。为较小的受众使用单独的工作空间。为网站选择一个应用程序工件,而不是 Markdown 简介。共享私人工件链接不会将其变成公共站点。

AgentGrid.io 工作区,突出显示“邀请代理”
在 AgentGrid.io 工作区中,邀请代理启动受支持的连接。

步骤2:连接Cursor代理,而不仅仅是编辑器

在Cursor中打开站点项目,并使用Agent模式,可以编辑文件和运行终端命令。给它这个指令: Connect this Cursor Agent to agentgrid.io. Run npx @animaapp/cli@latest login, show me the verification URL and code, and wait for my approval. Do not publish yet. 批准其名称、工作区以及在浏览器中的读写。除非您希望部署代理,否则请关闭“发布”。然后要求Cursor运行 npx @animaapp/cli@latest workspaces 并验证它是否可以看到预期的工作空间。如果终端访问被禁用,请改用手动文件夹导入。

第 3 步:构建、测试并导入项目一次

提示符Cursor: 为自行车车间构建响应式预订登陆页面。使用此存储库,添加清晰的服务列表和预订号召性用语,运行可用的检查,并告诉我哪些文件是站点入口点。不要更改不相关的代码。 查看其差异并打开本地预览。让连接的代理运行 npx @animaapp/cli@latest create -t import --from ./project --artifact-type app --workspace <workspace-id>,替换实际文件夹及其列出的工作区 ID。打开返回的工件 URL。对于静态站点,请确保 index.html 及其参考资产存在。排除 node_modules、构建输出和凭据。如果无法连接,请选择新建 → 上传文件夹或新建 → 从 AgentGrid.io 中的 ZIP 导入。导入是快照,不会与存储库自动同步。验证其文件、预览和工作区。

白莲花演示网站神器AgentGrid.io
AgentGrid.io 中的示例网站工件:White Lotus 演示在其版本经过审核时是私有的。

第 4 步:更新相同的工件,然后有意发布

将工件 URL 粘贴到 Cursor 代理中,并请求精确的改进,例如修复该工件上的移动菜单。确认历史的变化。当站点获得批准后,请使用 AgentGrid.io 中的“发布”或明确要求具有“发布”功能的连接代理进行部署。打开生成的公共 URL 并测试导航和预订链接。发布与共享私有工件是分开的。稍后的代码更改不会自动替换公共部署:当您希望更新生效时发布更新。

更新了 AgentGrid.io 共享菜单,显示“发布”选项
更新后的“共享”菜单包括“发布”,它将批准的工件转变为实时网站。

Cursor可以直接发布什么

Cursor 的 云环境设置文档 描述了特定的顺序:将工作保存到存储库、连接 Vercel 帐户、在代理窗口中选择“发布”,然后接收部署 URL。 Cursor 将存储库链接到 Vercel 项目并部署其默认分支。稍后默认分支会自动提交部署。部署到 Vercel 团队的 Cursor 团队需要高于 Hobby 的计划。这些要求并不是每个本地编辑器项目的通用发布按钮。

第 1 步:从正确的存储库开始

对于现有站点,在 Cursor 中打开其存储库,并要求代理遵循现有框架、组件、测试和设计约定。在更改代码之前,让它识别已部署的内容以及哪个分支是生产环境。对于新的云代理项目,Cursor 记录了从头开始的路线和 Origin 存储库创建步骤;在依赖您的帐户之前请先检查其可用性。没有保存存储库的草稿环境尚未准备好用于记录的 Vercel 发布路径。

提示示例: “在此存储库中,为 Cedar House 植物商店构建响应式主页、研讨会和访问网站。使用提供的徽标和研讨会时间表,而不是发明的可用性。保留现有的框架和样式约定。添加页面标题和描述、project-notes.md 中的工作注册链接以及键盘友好的移动菜单。显示计划、实施它、列出更改的文件和测试,并在部署之前停止。”

如果项目具有 API 路由、身份验证或服务器渲染页面,请立即识别这些内容。纯静态主机可能不支持运行时。询问应用程序需要哪些环境变量以及是否有任何环境变量会暴露给浏览器。切勿将生产机密粘贴到代理提示符中或将其提交到源代码管理。

第 2 步:预览正在运行的应用程序

安装依赖项并运行项目定义的开发命令。对于本地 Cursor 编辑器会话,请在浏览器中打开本地开发 URL。对于云代理,Cursor 记录在代理窗口中检测到并手动配置的转发端口。在内部浏览器中打开转发的应用程序并检查真实页面。表示“完成”的构建日志无法验证响应式导航或工作号召性用语。

以较窄和较宽的宽度检查场地。点击预期目的地和测试表格的链接。尝试键盘导航和可见焦点。检查图像替代项、元数据、标题顺序、丢失的资源和加载状态。根据批准的来源验证商店营业时间、联系方式、合法副本和肖像权。如果站点依赖于 API,请检查失败的请求并确认浏览器捆绑包中没有出现凭据。

测试提示: “运行此存储库的 lint、测试和生产构建脚本。在浏览器中以移动和桌面宽度打开三个页面。报告损坏的资产、无效链接和无法访问的控件,然后修复代码缺陷。不要更改部署配置或发布。总结需要人工决策的故障。”代理报告成功后,实际自己打开浏览器。

第三步:选择启动路径

路径 最佳时间 什么公开
云代理发布到 Vercel 存储库和 Vercel 连接已准备就绪 Vercel 部署 URL 和配置的域
您的主机的部署工作流程 您已经使用 CI/CD 管道或其他平台 主机的部署 URL
AgentGrid.io神器 团队首先需要一个可审查的工作版本 在该工件单独发布之前什么都没有

前两条路径是部署路线。第三个是协作和发布工作流程及其自己的应用程序副本。选择一个事实来源并记录审阅者看到的版本。

步骤 4:使用 Cursor Cloud Agent 和 Vercel 发布

工作进入存储库后,连接 Cursor 中的 Vercel 帐户。在代理窗口中,选择代理输入上方的发布。如果 Cursor 提供添加 Vercel,请首先完成该连接。在批准之前检查存储库、目标 Vercel 团队、默认分支、环境变量和构建设置。然后,Cursor 的记录流程链接存储库、部署默认分支并返回 URL。

不要使用预览分支作为默认分支上的内容的证明。在合并之前检查差异和任何所需的人工代码审查。稍后对该分支的提交可以自动重新部署实时站点,因此现在定义批准和回滚过程。如果生成的站点是静态的,请确认输出目录;如果涉及服务器路由,请确认主机支持应用程序的运行时。将域 DNS 和计费视为单独的所有权决策。

步骤 5:通过另一台主机部署,或共享以供审核

使用另一台主机,提交经过审查的代码并遵循该提供商的特定于框架的存储库或上传工作流程。在该主机上配置构建命令、输出位置、环境变量、重定向和自定义域。如果可用,请使用其预览部署以获得利益相关者的批准。 Cursor 协助代码和命令;主机拥有公共 URL 和生产设置。

对于团队审查,AgentGrid.io 记录了 Cursor 连接。确认代理环境可以运行连接流,仅授予对预期工作区的访问权限,并要求其返回工件链接。如果连接不合适,请自行导入审阅的项目文件夹或ZIP。传输后检查工件预览和来源;私人链接不是生产网站,原始存储库中的编辑不会自动同步到导入的副本。

范围切换提示: “在我授权连接后,将经过审核的 Cedar House 项目作为未发布的应用程序工件放入指定的工作区中。返回其私有 URL 并列出所有未能传输的依赖项或后端功能。请勿发布、外部共享或选择其他工作区。”当团队结束时,使用工件的 单独的发布流程 如果 AgentGrid.io 是所选主机。

第6步:验证实际部署

注销时通过电话打开公共 URL。将其页面与批准的预览进行比较。测试导航、表单、注册目的地、HTTPS、元数据、图像加载和任何自定义域。记录已部署的提交或工件修订。如果公共页面较旧,请在宣布之前检查分支选择、构建输出、环境变量、部署日志和缓存。每次生产更新后重新运行测试。

慎重考虑下一次更新

记录批准的版本和公共 URL。新的编辑在再次审核和发布之前都是草稿。

常见问题

Cursor 可以在没有 Vercel 的情况下发布网站吗?

是的,通过为另一个托管提供商的工作流程生成代码。此处讨论的记录的云代理发布控件使用 Vercel。桌面编辑器预览和转发端口不是独立的托管服务。

为什么发布在我的云代理会话中不可用?

检查项目是否已保存到存储库并且 Vercel 是否已连接。资格、计划、组织设置和存储库权限也很重要。请遵循 Cursor 的当前设置指南,而不是假设每个帐户中都出现相同的控件。

Cursor 预览会更新我的实时网站吗?

不会。本地或转发预览会公开开发过程以供检查。部署是一个单独的事件。在 Cursor 的 Vercel 路径中,未来对默认分支的提交可以在集成设置后更新生产。

我可以仅使用 AgentGrid.io 进行审批吗?

是的。保留未发布的工件以供共享审阅,然后发布该已批准的工件或通过现有主机部署相应的审阅存储库。如果同时使用,请保持两份副本对齐。

有关切换的比较,请参阅我们的指南 将代理输出共享为链接。的 发布 Claude 设计网站 涵盖了另一个起点,而 Muse 网站发布演练 显示已审阅的工件即将发布。这些是不同的工作流程,而不是可互换的产品功能。

|

Co-founder & CEO