Cloudflare Pages 静态站与 API 部署工作流

通过 Wrangler CLI 或 GitHub Actions 实现零配置全球静态加速与轻量 Serverless API 分发。

#Cloudflare#Serverless#Wrangler#CI/CD

工作流脚本规约 (WORKFLOW SCRIPT DEFINITION)

# Cloudflare Pages 静态站与 API 部署工作流

本工作流涵盖将纯静态构建产物发布至 Cloudflare 全球 CDN 网络，以及配置 Cloudflare Worker 协同工作的全流程。

## 1. 静态产物构建
在项目根目录下执行标准 Next.js SSG 静态生成：

```bash
# 生成 out/ 纯静态 HTML/CSS/JS 目录
npm run build
```

## 2. 命令行直连发布 (Wrangler Direct)
若在本地或内网终端中进行紧急交付发布：

```bash
# 登录 Cloudflare 认证凭证
npx wrangler login

# 直接将 out 目录发布至 Pages
npx wrangler pages deploy out --project-name=agent-matrix
```

## 3. Worker API 发布
进入 `worker/` 目录：

```bash
cd worker
npm install
npx wrangler deploy
```

## 4. GitHub Actions 自动化接管
通过在 GitHub 仓库中注入两项 Actions Secrets：
- `CLOUDFLARE_API_TOKEN`: 具备 Cloudflare Pages 编辑权限的 API Token
- `CLOUDFLARE_ACCOUNT_ID`: 您的 Cloudflare 账户 ID

当向 `main` 分支提交代码时，`.github/workflows/deploy.yml` 会自动完成构建与边缘发布，无需人工干预。