跳转至正文
Windsurf logo

通过 Windsurf 与 Capgo 一起交付您的移动应用

Windsurf 可构建、发布并为您的 Capacitor 应用提供 Live Update：无需 Mac 即可构建 iOS 和 Android 版本，数分钟内完成 OTA 修复，支持一键回滚。

  • IDE
  • 托管 MCP
  • 本地 MCP
  • 技能
  • CLI

在 Windsurf 中配置 Capgo

只需三步。直接复制每个代码块即可。

  1. 第 1 步

    添加托管的 Capgo MCP

    在 Cascade 面板中，打开 Actions 菜单并点击 Open MCP config file。添加 Capgo，并在提示时登录。无需 API 密钥。

    mcp_config.json 
    {
  "mcpServers": {
    "capgo": {
      "serverUrl": "https://api.capgo.app/mcp"
    }
  }
}

  2. 第 2 步

    添加用于构建和上传的本地 CLI MCP

    在终端运行一次 npx @capgo/cli@latest login，然后添加 capgo-cli 条目。

    mcp_config.json 
    {
  "mcpServers": {
    "capgo": {
      "serverUrl": "https://api.capgo.app/mcp"
    },
    "capgo-cli": {
      "command": "npx",
      "args": [
        "@capgo/cli@latest",
        "mcp"
      ]
    }
  }
}

  3. 第 3 步

    安装 Capgo skills

    安装程序支持 Windsurf 和 Devin 的 skill 文件夹。

    终端
    $ npx skills add Cap-go/capgo-skills

你可以问 Windsurf 什么

复制 prompt 并粘贴到 Windsurf 中。请将 App ID 和版本替换为你自己的。

  • 构建

    “使用 Capgo Build 为此应用构建一个已签名的 iOS release 版本。”

  • 发布

    “请求一个 Android release 构建，并发送到 Google Play 内部测试轨道。”

  • 更新

    “检查这个改动是否需要 Native Build，还是可以直接作为 live update 发布。”

  • 更新

    “构建 Web 应用，并将这个修复推送到 production 渠道。”

  • 回滚

    “回滚 production channel 上的最后一个 bundle。”

  • Observe

    “显示 v2.3.0 的更新统计数据：有多少设备已安装，有多少安装失败。”

  • Observe

    “为什么我上次的 iOS build 失败了？请阅读 build logs 并提供修复建议。”

  • 更新

    “创建一个 beta channel，并把此分支作为 live update 发到该 channel。”

完整的发布闭环

一个账号就能覆盖从首次 build 到下一次线上修复的每一步。

  1. 1

    构建

    在云端完成 iOS 和 Android 的签名 build。你这边无需 Mac，也无需 Xcode。

    Capgo Build（原生应用）
  2. 2

    发布

    将 build 发送到 TestFlight 和 Google Play，或提交给应用商店审核。

    无需 Mac 即可构建并发布 iOS 应用
  3. 3

    更新

    几分钟内即可将 JavaScript、HTML 和 CSS 修复推送到频道，一步回滚。

    Capgo 实时更新
  4. 4

    Observe

    查看谁接收了更新、哪些环节失败，以及每次发布的表现。

    使用 Capgo Observe

Windsurf 说明与限制

  • Windsurf 现已更名为 Devin Desktop。上述配置使用了 Cascade MCP 配置文件。
  • 使用 Devin CLI，运行 devin mcp add -s user capgo https://api.capgo.app/mcp，然后执行 devin mcp login capgo。
  • 在 Teams 和 Enterprise 版本中，管理员设置的 MCP 白名单会拦截不在名单内的服务器。请联系您的管理员添加 Capgo。

常见问题

Capgo 与 Windsurf：常见问题

Windsurf 能在没有 Mac 的情况下构建我的 iOS 应用吗？

可以。Windsurf 会运行 Capgo CLI，将您的项目上传到 Capgo Build。Capgo 会在云端进行 iOS 和 Android 应用的签名与构建，并能将其发送至 TestFlight 和 Google Play。

Native Build 文档

使用 Windsurf 需要 Capgo API 密钥吗？

托管版 MCP 不需要 API 密钥：它通过 OAuth 登录。本地 CLI MCP 和 CLI 使用一个只需用 npx @capgo/cli@latest login 保存一次的 API 密钥。请在 Capgo 控制台的 Settings > Organization > API keys 下创建该密钥。

创建 Capgo API 密钥

Windsurf 可以回滚错误的更新吗？

可以。只需让 Windsurf 将 channel 指向之前的 bundle 即可。设备会在下次检查更新时自动切换。此外，当新 bundle 启动失败时，Capgo updater 也会自动执行回滚。

Live update 文档

App Store 和 Google Play 允许使用 Live Updates 吗？

可以，但仅限 Web 层：JavaScript、HTML、CSS 和静态资源。Native code、新权限和新插件仍需通过应用商店发布，Capgo Build 可以帮你完成。

在 Windsurf 中使用 Capgo 的费用是多少？

MCP servers、skills 和 CLI 均可免费使用。你需要 Capgo 方案，每个方案都提供 14 天免费试用，无需信用卡。Build、Live Updates 和 Observe 都包含在每个方案中。

定价

从 Windsurf 发布你的下一个版本

立即创建 Capgo 账号，连接 Windsurf，并推送你的第一个 build 或 live update。

文档

相关页面