核心用法
GCP Fullstack 是一个面向 Google Cloud Platform 的全栈超级代理，专注于现代 Web 应用的完整开发生命周期管理。其核心定位是将项目脚手架、基础设施配置、CI/CD 部署三大环节自动化串联，覆盖从代码初始化到生产上线的完整链路。
服务选型决策树是该技能的核心方法论：
- 计算层：默认推荐 Cloud Run（支持 SSR 框架、自动扩缩容），静态站点用 Cloud Storage + CDN，轻量 API 用 Cloud Functions 2nd gen
- 数据库层：Firestore（文档型、实时同步）或 Cloud SQL PostgreSQL（关系型、复杂查询），按需选择
- 认证层：Firebase Auth（消费级）→ Identity Platform（企业级 SSO/多租户）的渐进式升级路径
关键执行流程：强制 Planning Protocol → 环境勘测 → 服务选型 → 分步执行 → 健康检查 → 回滚预案。所有操作前必须完成 7 步规划协议，禁止跳过。
显著优点
1. 架构完整性：单一代理覆盖框架脚手架（Next.js/Nuxt/SvelteKit/Remix/Astro）、GCP 全栈服务（Cloud Run/Cloud SQL/Firestore/Secret Manager）、Cloudflare 边缘安全（DNS/CDN/WAF/Rate Limiting）三大技术域
2. 安全优先设计：明确禁止直接读取 .env 或凭证文件，强制使用 Secret Manager；Cloudflare 强制配置 Full (Strict) SSL、Always HTTPS、Bot Fight Mode
3. 渐进式复杂度：从 Firebase Auth 升级到 Identity Platform，从单租户到多租户，从手动部署到 Cloud Build CI/CD，支持团队成长路径
4. 可回滚性：Cloud Run 版本管理、流量切分、健康检查失败自动回滚机制完备
潜在缺点与局限性
1. GCP 厂商锁定：深度绑定 Google Cloud 服务生态（Cloud Run、Cloud SQL、Firestore），迁移至 AWS/Azure 需重构
2. Cloudflare 依赖：DNS/CDN/安全层完全依赖 Cloudflare，若用户已使用 Route53 或自建 DNS 需额外适配
3. 框架版本滞后：示例代码基于 Node 20、Next.js standalone 输出，未明确支持 Next.js App Router 最新特性或新兴运行时（Bun/Deno）
4. 成本盲区：Spanner、Cloud CDN、Cloudflare Pro 等高级功能未标注成本预警，小团队易超支
5. 权限风险：--allow-unauthenticated 默认开启，生产环境需手动加固 IAM；allUsers 存储桶公开配置若误用于敏感数据将导致泄露
适合人群
- 初创全栈团队：需快速从 0 到 1 搭建生产级 GCP 基础设施
- DevOps 转型开发者：熟悉 Node.js 框架但缺乏云原生部署经验
- 多项目技术负责人：需要标准化、可复用的项目模板与部署流程
- Firebase 存量用户：计划从 Firebase Hosting/Functions 迁移至 Cloud Run 的企业
常规风险
| 风险类型 | 具体场景 | 缓解措施 |
|---------|---------|---------|
| 凭证泄露 | `.env` 误提交、服务账号 JSON 硬编码 | 强制 `.gitignore` 检查、Secret Manager 托管 |
| 数据丢失 | Cloud SQL 实例误删、Firestore 集合误清除 | 显式用户确认、dry-run 模式、备份策略提示 |
| 配置漂移 | 本地与 Cloud Run 环境变量不一致 | `.env.example` 模板化、部署前校验 |
| 权限扩大 | `--allow-unauthenticated` 遗留、存储桶过度公开 | 生产环境 IAM 审计清单、最小权限原则 |
| DNS 故障 | Cloudflare CNAME 配置错误导致服务不可达 | 部署后健康检查、TTL 缓存刷新验证 |
| 成本失控 | Cloud Run `min-instances=0` 冷启动延迟 vs 常驻实例费用、Spanner/BigQuery 误用 | 成本估算提示、预算告警配置建议 |
执行建议
该技能输出的配置模板（Dockerfile、Cloud Build、Cloudflare API 调用）需经人工复核后方可应用于生产。建议在非关键项目先完成端到端测试，验证 Cloud Run 自定义域名映射、Cloudflare SSL 证书签发、以及 Firebase Auth 令牌验证链路的完整性。