SuperAPI AI 工具集

labs-quickstart

前端与建站

查看项目

更新于 10-15 21:51

技能介绍

用途:从用户一句话描述出发,实时搭建一个可运行的 Next.js + shadcn“wow-shell” Convex 应用,预置 passkey 登录与 Chef 反馈面板;v1 通过且用户确认后可发布到公开的 https://<app>.convex.app。若只需无登录、无面板、不发布的本地骨架,应改用 quickstart 技能。

主要能力:自动脚手架;通过 Chef 面板用 progress:post、todos:plan/todos:setState、refinementQuestions:post、featureRequests:setState 展示进度与流程;passkey 登录(默认 AUTH_MODE=passkeys,使用 signInOrRegisterWithPasskey);发布时经托管网关执行构建、打包与审核上传。

使用方式:获取一句话想法;下载并运行脚手架(下载与执行须分为两次 Bash 调用,第二条以后台运行并重定向到 .quickstart-bootstrap.log);轮询日志直到出现 BOOTSTRAP_COMPLETE;打开日志中的 OPEN_BROWSER_URL;随后遵循服务端 runbook。后端代码全部放在 convex/ 目录,导入自 ./_generated/server 与 ./_generated/api,读路径用 withIndex 并分页或用 take,避免无界 collect 与 filter。完成后运行 npx tsc --noEmit 并推送到部署,必要时用 npx convex dev --once(仅在 whoami 失败时加 CONVEX_AGENT_MODE=anonymous)。发布前须先询问用户,同意后重绑 SITE_URL、AUTH_PASSKEY_RP_ID、AUTH_PASSKEY_ORIGIN 到 .convex.app 页面域,Next.js 配置 output: "export",再执行 npx convex deploy 与 node publish-convex-app.mjs。

限制:若脚手架无法运行(无网络、无人交互、沙箱临时目录等),应直接写标准 Convex 项目代码,不等待脚手架。passkey 邮箱为自述且不验证,授权应以 getAuthUserId(ctx) 的 _id 为准;passkey 需要安全上下文,localhost 可用。发布绑定 .convex.app,认证路由仍在 .convex.site。本版本不支持自定义域名。不得为通过构建而关闭 lint 或类型检查。更具体的定价、性能数据暂未提供。