应用部署允许您通过 Cascade 工具调用直接在 Windsurf 中部署 Web 应用和站点。此功能可帮助您通过公共 URL 分享您的工作、更新您的部署以及认领项目以进行进一步自定义。此功能目前处于 Beta 阶段，对更多框架、更健壮的构建等的支持即将推出。

​
概览

通过应用部署，您可以

  • 将网站或 JS Web 应用部署到公共域名
  • 在更改后重新部署到同一 URL
  • 将项目认领到您的个人账户

应用部署主要用于预览目的。对于包含敏感数据的生产应用，我们建议您认领您的部署并遵循安全最佳实践。

​
支持的服务提供商

我们目前支持以下部署服务提供商

  • Netlify - 用于静态站点和 Web 应用
计划在未来的版本中支持更多的服务提供商。

​
工作原理

当您使用应用部署时，您的代码会被上传到我们的服务器，并在我们的主账户下部署到服务提供商。部署后的站点将可以通过以下格式的公共 URL 访问

<SUBDOMAIN_NAME>.windsurf.build

​
部署流程

  1. Cascade 分析您的项目以确定合适的框架
  2. 您的项目文件会安全地上传到我们的服务器
  3. 部署在服务提供商的平台上创建
  4. 您将收到一个公共 URL 和一个认领链接

​
项目配置

为了方便重新部署，我们在您的项目根目录下创建了一个 windsurf_deployment.yaml 文件。此文件包含未来部署所需的信息，例如项目 ID 和框架。

​
使用应用部署

要部署您的应用，只需向 Cascade 提问，例如

"Deploy this project to Netlify"
"Update my deployment"

Cascade 将指导您完成整个过程，并帮助解决常见问题。

​
团队部署

您需要拥有团队管理员权限才能切换此功能。

团队版和企业版计划的用户可以将他们的 Netlify 账户与 Windsurf 账户连接，并部署到他们的 Netlify 团队。

这可以在团队设置中切换，您可以通过个人资料页面或点击此处访问。

​
安全注意事项

您的代码将被上传到我们的服务器进行部署。请仅部署您愿意公开分享的代码。

我们采取了几项措施来确保安全

  • 文件大小限制和验证
  • 基于您的账户等级的速率限制
  • 项目文件的安全处理

为了增强隐私保护，请访问clear-cookies.windsurf.build，检查并清除 windsurf.build 域名下网站设置的任何 cookie。如果出现任何 cookie，它们不应该存在，清除它们有助于防止跨站 cookie 问题，并保持您的体验干净。

Windsurf 站点由人类和 AI 构建，虽然我们鼓励 AI 做出最佳实践决策，但保持谨慎是明智的。Windsurf 不对用户部署的站点引起的问题负责。

​
认领您的部署

部署后，您将收到一个认领 URL。通过此链接，您可以在您的个人服务提供商账户中认领该项目，从而获得

  • 对部署的完全控制
  • 访问服务提供商特定功能
  • 修改域名的能力
  • 直接访问日志和构建信息

未认领的部署可能会在一段时间后被删除。我们建议您及时认领重要项目。

​
速率限制

为防止滥用，我们应用以下基于等级的速率限制

计划每日部署次数最大未认领站点数
免费版11
专业版105

​
支持的框架

应用部署支持大多数流行的 JavaScript 框架，包括

  • Next.js
  • React
  • Vue
  • Svelte
  • 静态 HTML/CSS/JS 站点

​
故障排除

​
部署构建失败

如果您的部署失败

  1. 检查 Cascade 提供的构建日志
  2. 确保您的项目可以在本地构建（运行 npm run build 进行测试）
  3. 验证您的项目遵循框架推荐的结构
  4. 查看关于如何通过 netlify.toml 将您的框架部署到 Netlify 的文档
  5. 考虑认领项目，以在服务提供商的仪表板上访问详细日志

我们无法直接支持框架特定的构建错误。如果您的部署因代码问题失败，请在本地调试或认领项目以便与服务提供商的支持团队合作。

​
Netlify 站点未找到

这很可能意味着您的构建失败了。请认领您的站点（您可以在您的部署历史记录中找到它），并检查构建日志以获取更多详细信息。通常您可以将构建日志粘贴到 Cascade 中寻求帮助。

​
更改您的子域名 / URL

​
更新 netlify.app 域名

您可以通过认领您的部署并更新 Netlify 站点设置来更改您的子域名。这将更新您的 .netlify.app 域名。

​
更新自定义 .windsurf.build 子域名

部署后，您无法更改您的自定义 .windsurf.build 子域名。相反，您需要部署一个带有新子域名的新站点。

要更新您的自定义 .windsurf.build 子域名，您需要部署一个带有新子域名的新站点

  1. 从您的项目中删除 windsurf_config.yaml 文件
  2. 请 Cascade 部署一个带有新子域名的新站点，并告诉它您想要的子域名
  3. 启动新对话或清除自动生成的记忆可能会有所帮助，这样 Cascade 就不会尝试重新部署到旧的子域名
  4. 当您创建新的部署时，您可以在子域名 UI 上点击“编辑”按钮，在点击“部署”之前进行更新

​
错误：无法获取项目 ID 对应的项目名称

当我们的记录系统中找不到您的项目 ID 或 Cascade 错误地将子域名用作项目 ID 时，会发生此错误。要解决此问题

  1. 检查项目是否仍在您的 Netlify 账户中存在（假设它已被认领）。
  2. 检查 windsurf_deployment.yaml 文件中是否存在项目 ID。如果文件中没有，您可以从您的部署历史记录下拉菜单中下载您的配置文件。
  3. 尝试重新部署并更明确地告诉 Cascade 使用 windsurf_deployment.yaml 文件中的 project_id