SuperAPI AI 工具集

setup-convex

部署与运维

查看项目

更新于 10-21 19:58

技能介绍

用途

setup-convex 用于将用户的 Convex 账户连接到本机的 Convex CLI,以便智能体能够创建和部署后端。它支持 macOS、Linux 和 Windows 系统。

主要能力

  • 通过浏览器登录 Convex 账户。
  • 使智能体能够创建 Convex 项目、部署后端并设置环境变量。
  • 自动检查 Node 版本(要求 v20 或更高),若不符合则先运行 setup-node 技能。
  • 使用 npx 运行 Convex,无需额外安装。
  • 在后台启动登录流程,并读取登录链接和验证码提供给用户。
  • 验证登录状态,确认账户和团队信息。

使用方式

  1. 确保 Node 可用(node --version,v20 或更高)。
  2. 如果 npx convex@latest login status 已显示登录账户和团队,则跳过登录步骤。
  3. 在后台启动登录:
    npx -y convex@latest login --no-open --login-flow poll --device-name "$(hostname)" < /dev/null > <scratch>/convex-login.txt 2>&1
    
  4. 从输出文件中读取登录链接(和验证码,如果有),提供给用户。用户若无 Convex 账户,需在页面上用 GitHub 或 Google 创建账户,然后批准设备并回复“done”。
  5. 检查 npx convex@latest login status 直到显示团队信息。
  6. 验证:npx convex@latest login status 列出账户和至少一个团队。
  7. 结束时提供简短检查清单:Node 正常、已登录 Convex、找到团队 <名称>。然后告知用户智能体现在可以创建应用的数据库和后端。

适用场景

  • 需要将 Convex 账户连接到本机 CLI 以进行后端开发和部署。
  • 智能体需要创建 Convex 项目、部署后端或设置环境变量时。

限制

  • 需要 Node v20 或更高版本。
  • 需要用户手动创建账户并批准登录。
  • 不创建项目;项目创建由 create-software 技能通过 npx convex dev --once 完成。
  • 如果从链接获取此技能,不要从仓库安装其他内容;仅在步骤需要时使用 curl 获取文件。