核心用法
Firebase skill 是 Maton 提供的托管式 API 网关服务，将复杂的 Firebase Management API 封装为标准化 REST 接口。开发者无需直接处理 Google OAuth 2.0 授权流程，仅需通过 MATON_API_KEY 即可完成认证，大幅降低接入门槛。
该 skill 覆盖 Firebase 项目的完整管理能力：
- 项目级操作：列举、创建、更新项目，获取 Admin SDK 配置，添加 Firebase 到现有 GCP 项目
- 应用管理：Web、Android、iOS 三端应用的 CRUD 操作，支持获取各平台专属配置文件（web 的 JS 配置、Android 的 google-services.json、iOS 的 GoogleService-Info.plist）
- 安全凭证：Android 应用的 SHA 证书增删管理
- Analytics 集成：绑定/解绑 Google Analytics 账户与属性
所有操作通过 https://gateway.maton.ai/firebase/{native-api-path} 代理，原生兼容 Firebase Management API 的 v1beta1 版本路径。
显著优点
1. OAuth 免托管：Maton 集中管理 refresh token，开发者无需维护凭证轮换逻辑
2. 多连接隔离：支持通过 Maton-Connection 头部指定不同 Firebase 账户，便于多租户或团队协作场景
3. 配置一键获取：直接获取 web / Android / iOS 三端集成所需的完整配置对象，省去控制台手动导出
4. 异步操作透明化：创建项目、添加 Firebase 等长耗时操作返回 Operation ID，可通过统一端点轮询状态
5. 软删除保护：应用删除后 30 天内可通过 undelete 恢复，降低误操作风险
潜在缺点与局限性
- Beta API 依赖：当前基于 v1beta1 版本，存在 Google 官方 breaking change 风险
- 网关单点依赖：所有流量必经 Maton 网关，若服务不可用将完全中断管理能力
- 权限粒度粗：依赖 Firebase/GCP IAM 原权限体系，无法在网关层做额外细粒度控制
- 实时性限制：配置变更存在潜在缓存延迟，极端场景下可能非立即生效
- 平台锁定：深度绑定 Maton 账号体系，迁移成本较高
适合人群
- 需自动化管理多 Firebase 项目的 DevOps 工程师
- 构建内部开发者平台（IDP）需要程序化项目配置的团队
- 为多客户代管 Firebase 基础设施的 SaaS 提供商
- 希望避免 OAuth 实现复杂度的全栈开发者
常规风险
| 风险类别 | 说明 |
|---------|------|
| 凭证泄露 | `MATON_API_KEY` 泄露将导致账户下所有 Firebase 项目暴露，需严格保管 |
| 越权操作 | 若 Maton 连接关联的 Google 账户拥有过高权限，误操作可能影响生产环境 |
| 数据残留 | 删除操作标记为 `immediate: true` 时不可逆，建议先确认备份 |
| 合规风险 | 通过第三方网关处理项目配置可能触及企业数据跨境传输政策 |
| 速率限制 | 429 错误时需实现退避重试，避免触发 Firebase 配额上限 |