SuperAPI AI 工具集

ops-setup

部署与运维

查看项目

更新于 10-16 09:29

技能介绍

用途:该技能逐步引导用户完成支持平台的搭建与配置,目标是最大化自动化,能自动完成的就自动完成,只在必须时请求人工输入。

主要能力:可自动创建或更新 .env 文件、校验 API 连接、运行数据库迁移、通过 API 配置 webhook URL、生成密钥、更新配置文件、运行冒烟测试。需要人工完成的包括:创建 Front、Slack、Stripe 等账号,从控制台复制 API 密钥,批准 OAuth 权限。

使用方式:该平台采用 monorepo 环境模式,各应用不共享根 .env,而是各自拥有 .env.local(apps/web、apps/slack、apps/front)。可通过读取各 .env.local 中的变量名跟踪配置进度。用户提供密钥后会立即校验,如 Front 调用 https://api2.frontapp.com/me,Slack 调用 https://slack.com/api/auth.test,Stripe Secret Key 调用 https://api.stripe.com/v1/balance,Upstash 调用 ${url}/info;校验通过即写入 .env.local 并说明下一步。可运行 bun scripts/setup/validate-front.ts、validate-slack.ts、validate-stripe.ts、validate-all.ts 进行校验。配置顺序为 PlanetScale、Front、Slack、Stripe、Upstash、Cloudflare、Axiom 与 Langfuse、Vercel、BetterAuth。Vercel 环境变量需用 echo -n 添加以避免尾随换行导致认证失败。可通过 API 自动配置 Slack 与 Stripe webhook,Stripe Connect OAuth 需手动启用并添加回调地址。

适用场景:首次搭建该支持平台、按步骤配置某个服务、补充密钥或排查未配置项时使用。添加新产品时可借助 Front inbox ID 转换、运行 wizard、写库并连接 Stripe。常用命令包括 openssl rand -base64 32 生成 BetterAuth 密钥、bun scripts/setup/status.ts 查看配置、bun scripts/setup/validate-all.ts 全量校验、bun db:migrate 运行迁移。

限制:仅面向该支持平台仓库;账号创建、密钥复制、OAuth 授权无法自动完成。