SuperAPI AI 工具集

iblai-ops-deploy

部署与运维

查看项目

更新于 10-15 22:16

技能介绍

用途:将 ibl.ai 应用前端部署到托管平台,当前支持 Vercel,设计上可扩展到其他平台。

主要能力:自动识别部署模式——若 next.config 中设置了 output: 'export' 则为静态模式,否则为服务器模式;静态模式构建后生成 out/vercel.json 并部署 out/ 目录,服务器模式直接以生产模式部署。部署后通过 Vercel API 将项目的 ssoProtection 与 passwordProtection 置为 null,使部署公开可访问。服务器模式还会同步环境变量并重新构建:把 .env.local 推送到项目的 production 与 preview 环境,NEXT_PUBLIC_* 以明文写入,其余加密;跳过 VERCEL_、NODE_ENV、VERCEL_TOKEN 及占位符;已有键用 PATCH、新键用 POST。若有键变化,则以 --force 和 VERCEL_FORCE_NO_BUILD_CACHE=1 重新部署,使 NEXT_PUBLIC_ 重新内联进客户端包。若配置了 Tauri,还会把 src-tauri/tauri.conf.json 的 build.devUrl 更新为部署 URL。

使用方式:需先在 iblai.env 中设置 VERCEL_TOKEN,缺失或为占位符时向用户索取一次并保存:echo 'VERCEL_TOKEN=<token>' >> iblai.env。令牌可在 https://vercel.com/account/tokens 创建。静态模式执行 pnpm build,写入 out/vercel.json 后运行 npx vercel deploy out/ --token="$VERCEL_TOKEN" --yes --public;服务器模式运行 npx vercel deploy --prod --token="$VERCEL_TOKEN" --yes --public;有团队 scope 时追加 --scope <team>。

适用场景:在运行 Tauri 开发构建(pnpm exec tauri dev、tauri ios dev、tauri android dev)之前部署,使 WebView 从网络 URL 加载;前端改动后迭代开发构建;需要分享预览 URL 时。

限制与回退:目前仅支持 Vercel,其他平台需扩展。若要停止移动端开发构建使用 Vercel URL,从 src-tauri/tauri.conf.json 中移除 devUrl,WebView 将恢复加载本地静态文件。完整的 Vercel API 调用、scope 解析与保留变量列表见 references/deploy-command.md。