核心用法
hosting 是一个编排型技能(Meta-skill),旨在将本地 Web 项目以最小 DevOps 摩擦部署到生产环境。其工作流程遵循「代码审计 → Git 初始化 → 基础设施网关 → 部署触发 → 状态监控 → 域名绑定」的因果链:
1. 代码审计:扫描项目根目录(package.json、next.config.*、vite.config.*、dist/ 等),自动识别框架类型(Next.js、Vite、纯静态 HTML 等),并推断构建输出路径。
2. Git 初始化:若本地无 Git 仓库则自动初始化,通过 github-api 创建远程仓库(支持 private/public),完成首次提交与推送。
3. 基础设施网关:根据项目类型推荐托管方案——前端/全栈项目默认走 Vercel 或 Netlify 托管路径;仅当 api-gateway 存在有效连接时才开放自定义 VPS 路径。
4. 部署触发:调用对应 CLI(vercel --prod 或 netlify deploy --prod)触发生产部署,并获取部署 ID 与实时状态。
5. 域名绑定(可选):在目标平台附加自定义域名,输出所需 DNS 记录(A/CNAME),并验证 DNS 传播与 HTTPS 就绪状态。
显著优点
- 零摩擦体验:用户仅需提供项目路径、仓库名、可见性及部署目标,剩余步骤由技能自动编排完成。
- 双路径冗余:同时支持 Vercel(前端/全栈优先)与 Netlify(Jamstack 友好),用户可按偏好或已有账户选择。
- 完整 DevOps 闭环:内置 Git 仓库创建、CI/CD 自动触发、SSL 证书(Let’s Encrypt)及自定义域名支持,无需手动配置 DNS 或 HTTPS。
- 严格准入控制:在「基础设施网关」阶段显式校验所有必需凭证(
MATON_API_KEY、VERCEL_TOKEN/NETLIFY_AUTH_TOKEN),缺失则阻断并给出精确修复指令,避免半程失败。
潜在缺点与局限性
- 外部依赖重:核心功能依赖
github-api、vercel/netlify及可选的domain-dns-ops/api-gateway四个子技能,任一子技能未安装或凭证失效即导致流程中断。 - 环境特异性限制:
domain-dns-ops被标注为「environment-specific」(仅特定环境可用),非通用技能;api-gateway对 DigitalOcean/AWS 等 VPS 的支持未在技能索引中明确列出,属「条件可用」而非保证。 - 无 SLA 承诺:文档明确声明「不保证 uptime/SLA」,实际稳定性由底层平台(Vercel/Netlify/GitHub)决定。
- 自定义域名非自动:DNS 记录需用户手动在域名注册商处配置,技能仅输出记录值,无法自动完成 DNS 传播等待。
适合人群
- 独立开发者 / 前端工程师:希望快速将个人项目、作品集或 MVP 上线,避免手动配置 CI/CD。
- 全栈学习者:需要理解「代码 → Git → 托管 → 域名」完整链路,但希望工具屏蔽底层复杂性。
- 小团队技术负责人:需标准化前端部署流程,确保团队成员使用一致的托管路径与凭证管理规范。
常规风险
- 凭证泄露风险:需配置
MATON_API_KEY及平台 Token(VERCEL_TOKEN/NETLIFY_AUTH_TOKEN),若存储于不安全环境变量或日志中,可能导致仓库或托管账户被滥用。 - 权限范围过宽:
github-api通过 Maton OAuth 连接操作仓库,需确保授权范围最小化,避免授予不必要的组织级权限。 - 域名接管风险:若自定义域名曾在其他平台使用过,DNS 缓存或旧记录可能导致流量被劫持至错误地址,需严格按技能输出的 DNS 值配置。
- 部分成功状态:当子技能部分失败(如 GitHub 仓库创建成功但部署触发失败),技能会返回
Partial状态,用户需手动介入完成剩余步骤。