用途:把用户或 AI 构建的网站、仪表盘、报告、作品集、文档站或原型发布到用户自有的托管平台,默认 GitHub Pages,需要自定义域名、重定向/头或 Functions 时用 Cloudflare Pages,Netlify 作为备选。仅覆盖静态站点和 SPA 构建产物(纯 HTML/CSS/JS,或 Vite/Next-export/Astro 等的 dist/build 目录),不覆盖服务端运行时。
主要能力:本地预览供确认;每次部署前先 git 提交并打 deploy-YYYYMMDD-HHMM 标签,保证可复现与回滚;按提供方阶梯部署;用 curl 验证线上 URL 返回 200 并检查首页内容;支持回滚到上一标签或使用平台面板的部署历史。
使用方式:流程为构建→本地预览→提交并打标签→按阶梯部署→curl 验证。本地预览:python3 -m http.server 8080 --directory dist;可分享预览:cloudflared tunnel --url http://localhost:8080。版本化:git add -A && git commit -m "deploy: <what>" && git tag deploy-YYYYMMDD-HHMM。GitHub Pages:git subtree push --prefix dist origin gh-pages,首次用 gh api repos/{owner}/{repo}/pages -X POST -f 'source[branch]=gh-pages' -f 'source[path]=/' 启用。Cloudflare Pages:npx wrangler@latest pages deploy dist --project-name <name>。Netlify:netlify deploy --prod --dir dist。验证:curl -sS -o /dev/null -w '%{http_code}' <url> 期望 200。
前提:至少一个已认证的提供方 CLI(gh auth status、wrangler whoami 或 CLOUDFLARE_API_TOKEN、netlify status),以及可发布的静态输出目录。
限制与注意:绝不提交密钥或 .env;GitHub Pages 为纯静态,无服务端环境变量;SPA 在 GitHub Pages 上深层路由会 404,需复制 index.html 为 404.html;首次启用可能有 1–10 分钟延迟;路径大小写敏感;项目页有 base path 问题;wrangler 登录需浏览器,无头环境用 API Token;自定义域名 DNS 传播需时间;不要部署源码而非构建产物。资料未提供收费、价格或平台效果信息。