乔木网站开发自动化部署
qiaomu-website-develop
自动化处理网站开发全流程,包括 GitHub 推送、Vercel 部署及 Cloudflare 域名绑定与验证。

试试这样做
把这个项目部署到 Vercel,绑定 style.qiaomu.ai,并关联 GitHub。
以后这个 Web 项目用 Cloudflare Pages 发布,域名用 demo.qiaomu.ai。
这个域名在 Cloudflare 托管,你直接用 CLI 帮我设置到 Vercel 项目上。
详细介绍
qiaomu-website-develop
你说“用这个域名部署一下”,Agent 就按固定流程完成 GitHub、Vercel、Cloudflare DNS 和 HTTPS 验证。
适用场景
- 网站发布时,需要自动化部署到 Vercel 并绑定自定义域名
- 需要确保 GitHub、Vercel、Cloudflare DNS 和 HTTPS 验证的完整流程无误
效果预览
已验证样例:
| 项目 | 结果 |
|---|---|
| GitHub | https://github.com/joeseesun/qiaomu-artist-style |
| Vercel project | qiaomu-artist-style |
| Vercel URL | https://qiaomu-artist-style.vercel.app |
| Custom domain | https://style.qiaomu.ai |
| Cloudflare DNS | TXT 验证 + 非代理 CNAME |
| 最终验证 | curl -I https://style.qiaomu.ai 返回 HTTP/2 200 |
核心能力
- 检查 CLI 登录状态
- 本地构建项目
- 推送代码到 GitHub
- 在 Vercel 中 link、deploy、连接 Git 仓库
- 添加自定义域名到 Vercel
- 在 Cloudflare 中写入 TXT、CNAME、A 记录
- 执行 Vercel 域名验证
- 通过 curl 验证 HTTPS 访问是否正常
工作方式
- 用户用自然语言提出部署请求,例如:“把这个网站发布到 Vercel,并绑定 style.qiaomu.ai”
- Agent 按照固定流程依次执行:检查 CLI 登录 → 本地构建 → GitHub 推送 → Vercel link/deploy/git connect → Vercel 添加域名 → Cloudflare 写 DNS 记录 → Vercel verify → curl 验证 HTTPS
- 最终输出部署成功的 URL 和验证结果
你需要提供
- 安装并登录 GitHub CLI:
brew install gh && gh auth login - 安装并登录 Vercel CLI:
npm i -g vercel && vercel login - 安装并登录 Wrangler:
npm i -g wrangler && wrangler login - Cloudflare DNS 写入时,设置
CLOUDFLARE_API_TOKEN或CF_API_TOKEN - Cloudflare API token 至少具备目标 zone 的 zone read 和 DNS edit/write 权限
你会获得
- 部署后的 Vercel 项目
- 自定义域名绑定成功
- HTTPS 验证通过,可通过
curl -I获得HTTP/2 200响应
使用示例
把这个项目部署到 Vercel,绑定 style.qiaomu.ai,并关联 GitHub。
以后这个 Web 项目用 Cloudflare Pages 发布,域名用 demo.qiaomu.ai。
这个域名在 Cloudflare 托管,你直接用 CLI 帮我设置到 Vercel 项目上。
内置自动化脚本
先 dry-run:
python3 ~/.agents/skills/qiaomu-website-develop/scripts/qiaomu_site_deploy.py \
vercel-cloudflare \
--project-dir . \
--domain style.qiaomu.ai \
--dry-run
执行 Vercel + Cloudflare 绑定:
export CLOUDFLARE_API_TOKEN="..."
python3 ~/.agents/skills/qiaomu-website-develop/scripts/qiaomu_site_deploy.py \
vercel-cloudflare \
--project-dir . \
--domain style.qiaomu.ai \
--ensure-link \
--connect-git \
--deploy \
--wait \
--check-http
注意事项
安全
- 不要把 API token 写入仓库、README、脚本或聊天总结。如果 token 曾经被贴出来,用完后建议到 Cloudflare 里轮换。
常见问题
| 问题 | 处理 |
|---|---|
wrangler whoami 正常但 DNS 写入失败 |
Wrangler OAuth 不等于脚本可写 DNS。设置 Cloudflare API token,并给目标 zone 的 zone read 和 DNS edit/write 权限。 |
| Vercel 显示 domain verification required | 让脚本写入 Vercel 返回的 TXT 记录,然后重新调用 verify。 |
| Vercel 显示 DNS misconfigured | 检查同名 A/AAAA/CNAME 冲突;Vercel 子域名 CNAME 默认应关闭 Cloudflare proxy。 |
| apex 域名不能设置 CNAME | apex 用 Vercel 推荐的 A 记录;子域名才用 CNAME。 |