用途
setup-convex 用于将用户的 Convex 账户连接到本机的 Convex CLI,以便智能体能够创建和部署后端。它支持 macOS、Linux 和 Windows 系统。
主要能力
- 通过浏览器登录 Convex 账户。
- 使智能体能够创建 Convex 项目、部署后端并设置环境变量。
- 自动检查 Node 版本(要求 v20 或更高),若不符合则先运行 setup-node 技能。
- 使用 npx 运行 Convex,无需额外安装。
- 在后台启动登录流程,并读取登录链接和验证码提供给用户。
- 验证登录状态,确认账户和团队信息。
使用方式
- 确保 Node 可用(node --version,v20 或更高)。
- 如果 npx convex@latest login status 已显示登录账户和团队,则跳过登录步骤。
- 在后台启动登录:
npx -y convex@latest login --no-open --login-flow poll --device-name "$(hostname)" < /dev/null > <scratch>/convex-login.txt 2>&1 - 从输出文件中读取登录链接(和验证码,如果有),提供给用户。用户若无 Convex 账户,需在页面上用 GitHub 或 Google 创建账户,然后批准设备并回复“done”。
- 检查 npx convex@latest login status 直到显示团队信息。
- 验证:npx convex@latest login status 列出账户和至少一个团队。
- 结束时提供简短检查清单:Node 正常、已登录 Convex、找到团队 <名称>。然后告知用户智能体现在可以创建应用的数据库和后端。
适用场景
- 需要将 Convex 账户连接到本机 CLI 以进行后端开发和部署。
- 智能体需要创建 Convex 项目、部署后端或设置环境变量时。
限制
- 需要 Node v20 或更高版本。
- 需要用户手动创建账户并批准登录。
- 不创建项目;项目创建由 create-software 技能通过 npx convex dev --once 完成。
- 如果从链接获取此技能,不要从仓库安装其他内容;仅在步骤需要时使用 curl 获取文件。