19a - AI 辅助部署自动化

你的项目类型是什么？
│
├── 前端/Next.js 应用
│   └── → Vercel（最佳 DX，v0 集成）
│
├── 后端 API / 微服务
│   ├── 需要全球低延迟？ → Fly.io
│   ├── 快速原型 / MVP？ → Railway
│   └── 生产级稳定性？ → Render
│
├── 全栈应用（前端 + 后端 + 数据库）
│   ├── 预算充足？ → Vercel + Railway 组合
│   └── 预算有限？ → Railway（全栈支持）
│
├── 需要完全控制 / 数据主权？
│   └── → Coolify（自托管在你的 VPS）
│
└── 桌面/移动应用？
    └── → GitHub Actions + 平台特定工具链

工作流：
  1. 在 v0.dev 用自然语言描述你的应用
     "创建一个带用户认证的 SaaS 仪表板，包含数据图表和暗色主题"
  2. v0 生成完整的 React + Tailwind + shadcn/ui 代码
  3. 点击 "Deploy" → 自动部署到 Vercel
  4. 获得生产 URL，包含 SSL、CDN、边缘缓存

# 1. 安装 Vercel CLI
npm i -g vercel
 
# 2. 在项目根目录初始化
vercel
 
# 3. 之后每次 git push 自动触发部署
git push origin main  # → 自动构建 + 部署到生产环境

// app/api/agent/route.ts — Vercel AI SDK Agent 示例
import { openai } from '@ai-sdk/openai';
import { streamText } from 'ai';
 
export async function POST(req: Request) {
  const { messages } = await req.json();
 
  const result = streamText({
    model: openai('gpt-4o'),
    messages,
    tools: {
      // 定义 Agent 可用的工具
      searchDocs: { /* ... */ },
      runQuery: { /* ... */ },
    },
    maxSteps: 10, // Agent 最多执行 10 步
  });
 
  return result.toDataStreamResponse();
}

我需要为以下项目生成 Vercel 部署配置：

项目信息：
- 框架：[Next.js 15 / Remix / Astro / SvelteKit]
- 运行时：[Node.js 20 / Edge Runtime]
- 环境变量：[列出需要的环境变量]
- 自定义域名：[your-domain.com]
- 需要的功能：[Cron Jobs / KV 存储 / Blob 存储 / AI 集成]

请生成：
1. vercel.json 配置文件（包含路由重写、headers、cron 配置）
2. 环境变量设置说明（区分 development / preview / production）
3. 构建优化建议（缓存策略、ISR 配置）
4. 监控和告警设置建议

# 方式 1：GitHub 仓库连接（推荐）
# 1. 在 railway.com 创建项目
# 2. 连接 GitHub 仓库
# 3. Railway 自动检测技术栈并部署
# 每次 git push 自动触发重新部署
 
# 方式 2：Railway CLI
npm i -g @railway/cli
railway login
railway init        # 初始化项目
railway up          # 部署当前目录
railway domain      # 生成公开域名

常用模板：
├── PostgreSQL + Redis + API 服务
├── n8n 自动化工作流
├── Dify AI 平台
├── Supabase 自托管
└── OpenClaw AI Agent

我需要在 Railway 上部署以下服务：

服务架构：
- API 服务：[Python FastAPI / Node.js Express / Go Gin / Rust Actix]
- 数据库：[PostgreSQL / MySQL / MongoDB]
- 缓存：[Redis]
- 消息队列：[如需要]

请生成：
1. railway.toml 配置（构建命令、启动命令、健康检查）
2. nixpacks.toml 自定义构建配置（如需要）
3. 环境变量列表和说明
4. 服务间通信配置（内部网络引用）
5. 自动扩缩策略建议

# 1. 安装 Fly CLI
curl -L https://fly.io/install.sh | sh
 
# 2. 登录并创建应用
fly auth login
fly launch          # 自动检测项目并生成 fly.toml
 
# 3. 部署
fly deploy
 
# 4. 扩展到多个区域
fly scale count 2 --region nrt,sin  # 东京 + 新加坡
fly scale count 1 --region iad      # 美东
 
# 5. 查看状态
fly status
fly logs

# fly.toml — 全球分布式 API 服务
app = "my-api-service"
primary_region = "nrt"  # 主区域：东京
 
[build]
  dockerfile = "Dockerfile"
 
[http_service]
  internal_port = 8080
  force_https = true
  auto_stop_machines = "stop"      # 无流量时自动停机（省钱）
  auto_start_machines = true       # 有请求时自动启动
  min_machines_running = 1         # 至少保持 1 台运行
 
[checks]
  [checks.health]
    type = "http"
    port = 8080
    path = "/health"
    interval = "10s"
    timeout = "2s"

# 1. 在 VPS 上一键安装 Coolify（需要 2GB+ RAM）
curl -fsSL https://cdn.coollabs.io/coolify/install.sh | bash
 
# 2. 访问 http://your-vps-ip:8000 完成初始设置
# 3. 添加 GitHub/GitLab 仓库
# 4. Coolify 自动检测 Dockerfile 或使用 Nixpacks 构建
# 5. 配置域名和 SSL（Let's Encrypt 自动签发）

✅ 适合：
├── 数据主权要求（GDPR、医疗、金融）
├── 预算敏感的创业者（VPS $5-20/月 vs 云平台 $50-200/月）
├── 需要完全控制基础设施
└── 多项目统一管理

❌ 不适合：
├── 需要全球边缘分发（用 Fly.io 或 Vercel）
├── 团队没有基础运维能力
└── 需要企业级 SLA 保障

1. 连接 GitHub/GitLab 仓库
2. 选择服务类型：
   - Web Service（API / 全栈应用）
   - Static Site（前端 SPA）
   - Background Worker（后台任务）
   - Cron Job（定时任务）
   - PostgreSQL / Redis（托管数据库）
3. Render 自动检测构建命令和启动命令
4. 配置环境变量和自定义域名
5. 每次 git push 自动部署，支持蓝绿部署

# .github/workflows/ci.yml — AI 生成的标准 CI 流水线
name: CI
 
on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]
 
jobs:
  lint-and-test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: 'npm'
 
      - name: Install dependencies
        run: npm ci
 
      - name: Lint
        run: npm run lint
 
      - name: Type check
        run: npm run type-check
 
      - name: Unit tests
        run: npm run test -- --run --coverage
 
      - name: Upload coverage
        uses: codecov/codecov-action@v4
        with:
          token: ${{ secrets.CODECOV_TOKEN }}
 
  build:
    needs: lint-and-test
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
 
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: 'npm'
 
      - name: Install and build
        run: |
          npm ci
          npm run build
 
      - name: Upload build artifacts
        uses: actions/upload-artifact@v4
        with:
          name: build-output
          path: dist/

# .github/workflows/release.yml — 自动版本发布
name: Release
 
on:
  push:
    tags: ['v*']
 
permissions:
  contents: write
 
jobs:
  release:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0
 
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 22
          cache: 'npm'
 
      - name: Install and build
        run: |
          npm ci
          npm run build
 
      - name: Generate changelog
        id: changelog
        run: |
          # 用 AI 辅助生成 changelog
          echo "CHANGELOG<<EOF" >> $GITHUB_OUTPUT
          git log $(git describe --tags --abbrev=0 HEAD^)..HEAD \
            --pretty=format:"- %s (%h)" >> $GITHUB_OUTPUT
          echo "EOF" >> $GITHUB_OUTPUT
 
      - name: Create GitHub Release
        uses: softprops/action-gh-release@v2
        with:
          body: ${{ steps.changelog.outputs.CHANGELOG }}
          files: dist/*
          generate_release_notes: true

<!-- .github/agents/deploy-review.md -->
# 部署审查 Agent
 
## 触发条件
当 PR 包含对 `infrastructure/` 或 `Dockerfile` 的修改时触发。
 
## 任务
1. 检查 Dockerfile 是否遵循最佳实践（多阶段构建、非 root 用户）
2. 验证环境变量配置是否完整
3. 检查是否有硬编码的密钥或敏感信息
4. 生成部署影响评估报告并作为 PR 评论发布

请为我的项目生成 GitHub Actions CI/CD 工作流：

项目信息：
- 语言/框架：[TypeScript + Next.js / Python + FastAPI / Rust + Tauri / Go]
- 包管理器：[npm / pnpm / yarn / pip / cargo]
- 测试框架：[Vitest / Jest / Pytest / cargo test]
- 部署目标：[Vercel / Railway / Fly.io / Docker Registry / GitHub Releases]
- 需要的检查：[lint / type-check / unit-test / e2e-test / security-scan]

请生成：
1. CI 工作流（PR 检查：lint + test + build）
2. CD 工作流（main 分支合并后自动部署）
3. Release 工作流（tag 推送后自动发布）
4. 缓存优化配置（依赖缓存、构建缓存）
5. 密钥管理说明（哪些 secrets 需要配置）

# .github/workflows/tauri-release.yml
name: Tauri Release
 
on:
  push:
    tags: ['v*']
 
permissions:
  contents: write
 
jobs:
  build:
    strategy:
      fail-fast: false
      matrix:
        include:
          - platform: macos-latest
            target: aarch64-apple-darwin
            label: macOS-ARM64
          - platform: macos-latest
            target: x86_64-apple-darwin
            label: macOS-x64
          - platform: ubuntu-22.04
            target: x86_64-unknown-linux-gnu
            label: Linux-x64
          - platform: windows-latest
            target: x86_64-pc-windows-msvc
            label: Windows-x64
 
    runs-on: ${{ matrix.platform }}
    steps:
      - uses: actions/checkout@v4
 
      - name: Setup Rust
        uses: dtolnay/rust-toolchain@stable
        with:
          targets: ${{ matrix.target }}
 
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 22
 
      - name: Install Linux dependencies
        if: matrix.platform == 'ubuntu-22.04'
        run: |
          sudo apt-get update
          sudo apt-get install -y libwebkit2gtk-4.1-dev \
            libappindicator3-dev librsvg2-dev patchelf
 
      - name: Install frontend dependencies
        run: npm ci
 
      - name: Build Tauri app
        uses: tauri-apps/tauri-action@v0
        env:
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
          # macOS 代码签名（可选）
          APPLE_CERTIFICATE: ${{ secrets.APPLE_CERTIFICATE }}
          APPLE_CERTIFICATE_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
          APPLE_SIGNING_IDENTITY: ${{ secrets.APPLE_SIGNING_IDENTITY }}
          APPLE_ID: ${{ secrets.APPLE_ID }}
          APPLE_PASSWORD: ${{ secrets.APPLE_PASSWORD }}
          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
        with:
          tagName: ${{ github.ref_name }}
          releaseName: 'App ${{ github.ref_name }}'
          releaseBody: 'See CHANGELOG.md for details.'
          releaseDraft: true
          prerelease: false

□ 代码签名
  ├── macOS：Apple Developer Certificate（$99/年）
  │   └── 必须公证（notarize），否则用户无法打开
  ├── Windows：EV Code Signing Certificate（$200-500/年）
  │   └── SmartScreen 信任需要 EV 证书
  └── Linux：AppImage 签名（可选，GPG 签名）

□ 自动更新
  ├── Tauri Updater 插件（内置支持）
  ├── 更新服务器选项：
  │   ├── GitHub Releases（免费，最简单）
  │   ├── 自建更新服务器（完全控制）
  │   └── CrabNebula Cloud（Tauri 官方推荐）
  └── 灰度发布：先推送给 10% 用户，确认无问题后全量

□ 崩溃报告
  ├── Sentry（免费层：5K 事件/月）
  ├── 自动收集崩溃堆栈和系统信息
  └── AI 辅助分析崩溃模式和根因

□ 遥测（需用户明确同意）
  ├── 匿名使用统计（功能使用频率）
  ├── 性能指标（启动时间、内存占用）
  └── 推荐：PostHog（开源，可自托管）

# .github/workflows/electron-release.yml — Electron 多平台构建
name: Electron Release
 
on:
  push:
    tags: ['v*']
 
jobs:
  build:
    strategy:
      matrix:
        os: [macos-latest, ubuntu-latest, windows-latest]
 
    runs-on: ${{ matrix.os }}
    steps:
      - uses: actions/checkout@v4
 
      - name: Setup Node.js
        uses: actions/setup-node@v4
        with:
          node-version: 22
 
      - name: Install dependencies
        run: npm ci
 
      - name: Build and publish
        env:
          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
        run: npm run electron:build -- --publish always

# Expo EAS Build — 云端构建 iOS 和 Android
npm install -g eas-cli
eas login
 
# 配置构建
eas build:configure
 
# 构建 iOS（需要 Apple Developer 账号）
eas build --platform ios --profile production
 
# 构建 Android
eas build --platform android --profile production
 
# 提交到应用商店
eas submit --platform ios
eas submit --platform android

我需要为 [Tauri / Electron / React Native] 应用生成完整的部署配置：

应用信息：
- 框架版本：[Tauri 2.x / Electron 33 / React Native 0.76]
- 目标平台：[macOS / Windows / Linux / iOS / Android]
- 前端框架：[React / Vue / Svelte / Angular]
- 是否需要代码签名：[是/否]
- 自动更新方式：[GitHub Releases / 自建服务器 / 应用商店]
- 崩溃报告：[Sentry / 自建]

请生成：
1. GitHub Actions 多平台构建工作流
2. 代码签名配置说明（需要哪些证书和 secrets）
3. 自动更新配置
4. 版本号管理策略（语义化版本）
5. 发布前检查清单

第 1 步：用 AI 生成部署架构方案
┌─────────────────────────────────────────────┐
│  提示词：                                      │
│  "我有一个 Next.js + FastAPI + PostgreSQL     │
│   的 SaaS 应用，月预算 $50 以内，              │
│   预期用户 1000 人，请推荐部署方案"             │
└─────────────────────────────────────────────┘
         ↓
AI 推荐方案：
├── 前端：Vercel（免费层足够）
├── 后端：Railway（$20/月 Pro 计划）
├── 数据库：Railway PostgreSQL（包含在 Pro 计划中）
└── 总成本：~$20/月

第 2 步：用 AI 生成各平台配置
┌─────────────────────────────────────────────┐
│  前端 → vercel.json + 环境变量配置              │
│  后端 → railway.toml + Dockerfile              │
│  CI/CD → .github/workflows/ci.yml             │
│  监控 → Uptime Kuma 健康检查配置                │
└─────────────────────────────────────────────┘

第 3 步：配置 CI/CD 流水线
├── PR 检查：lint + test + type-check
├── main 合并：自动部署前端到 Vercel + 后端到 Railway
├── tag 推送：创建 GitHub Release + 生成 changelog
└── 定时任务：每日健康检查 + 周报

第 4 步：配置监控和告警
├── Vercel Analytics（前端性能）
├── Railway Metrics（后端资源使用）
├── Uptime Kuma（可用性监控）
└── Sentry（错误追踪，免费层）