核心用法
该技能通过Maton API网关提供Netlify平台的完整管理能力，采用托管OAuth认证模式，用户无需自行处理Netlify OAuth流程。核心功能覆盖六大模块：
1. 站点管理：查看站点列表、创建新站点、更新配置、删除站点。站点ID为UUID格式，支持分页查询（page/per_page参数）。
2. 部署与构建：查看部署历史、获取部署详情、锁定/解锁特定部署、回滚到历史版本、手动触发构建。构建钩子（Build Hooks）支持外部CI/CD系统集成。
3. 环境变量：在账户级别管理环境变量，支持按站点作用域过滤，提供all/production/deploy-preview/branch-deploy/dev等多上下文配置。
4. DNS管理：完整的DNS zone和记录管理，包括A记录、CNAME等类型的增删改查。
5. Webhook与表单：配置部署事件 webhook（deploy_created/deploy_succeeded/deploy_failed等），查看表单提交数据。
6. 连接管理：支持多账户场景，通过Maton-Connection头部指定特定OAuth连接。
认证采用双因素：Maton API Key（MATON_API_KEY环境变量）+ Netlify OAuth令牌（由Maton网关托管）。
显著优点
- 零配置OAuth：无需开发者自行申请Netlify OAuth应用，Maton处理完整的授权流程
- 安全网关代理：所有请求经
api.maton.ai中转，自动注入令牌，避免密钥泄露风险 - 操作防护机制：强制要求写操作前展示资源标识符并获取用户显式确认，防止误删生产环境
- 多账户支持：单一API Key可管理多个Netlify账户，通过连接ID灵活切换
- 详细审计日志：所有API调用可追溯，符合合规要求
潜在缺点与局限性
- 供应商锁定：完全依赖Maton网关服务，若Maton服务中断则功能不可用（报告RISK-002）
- 只读优先设计：写操作需要额外确认步骤，批量自动化场景效率较低
- 无直连选项：不支持绕过网关直接调用Netlify原生API
- 环境变量要求：
MATON_API_KEY必须妥善保管，泄露可能导致账户被滥用 - 功能延迟：网关代理可能引入轻微延迟，且新Netlify API特性需等待网关更新
适合人群
- DevOps/SRE工程师：需要脚本化批量管理多个Netlify站点和部署
- 全栈开发者：集成Netlify到自动化工作流，如CI/CD管道、基础设施即代码
- 技术团队负责人：统一管理团队多个Netlify账户，审计部署活动
- 需要OAuth托管的企业用户：不愿自行维护OAuth应用凭证
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| API密钥泄露 | 中 | `MATON_API_KEY`若写入代码或日志可能导致未授权访问 |
| 误操作生产环境 | 低 | 写操作需确认机制降低了风险，但用户仍需仔细核对资源ID |
| 服务可用性 | 低 | 依赖Maton网关，需评估其SLA是否满足业务需求 |
| OAuth权限过度授权 | 中 | 授权时应审查Netlify请求的权限范围，遵循最小权限原则 |
| DNS配置错误 | 高 | 修改DNS记录可能导致网站不可访问，建议先在测试域名验证 |
缓解建议：定期轮换API密钥；使用Maton-Connection明确指定连接；生产环境变更前在staging站点验证；优先使用部署锁定而非删除操作。