| name | publish |
| description | 提交代码、构建并部署站点到 Cloudflare Pages。当用户说"发布"、"部署"、"上线"、"publish"、"deploy"时使用。 |
| argument-hint | commit|build|deploy|all |
| disable-model-invocation | true |
| allowed-tools | Bash, Read, Glob, Grep |
发布部署
提交代码推送到 GitHub,构建 VitePress 站点,并手动部署到 Cloudflare Pages。
参数
$ARGUMENTS — 可选,指定操作:
commit — 仅提交推送代码
build — 仅构建 VitePress
deploy — 仅部署到 Cloudflare(需先构建)
all(默认) — 提交 + 构建 + 部署
- 空 — 等同于
all
执行流程
1. commit — 提交推送代码
git add -A
git commit -m "描述本次改动"
git push
提交前先用 git status 和 git diff 查看变更,编写准确的提交信息。
2. build — 构建站点
NODE_OPTIONS="--max-old-space-size=8192" npm run docs:build
注意:项目有 370+ 个 markdown 文件,必须设置 8GB 堆内存,否则会 OOM。
构建完成后检查是否有错误输出。
3. deploy — 部署到 Cloudflare Pages
npx wrangler pages deploy docs/.vitepress/dist --project-name=full-stack-roadmap
需要已通过 npx wrangler login 登录 Cloudflare 账号。
部署完成后会输出预览 URL,生产站点为 https://t.tecfav.com
执行步骤
- 根据
$ARGUMENTS 决定执行哪些操作(默认执行全部)
- commit: 查看变更 → 编写提交信息 →
git add → git commit → git push
- build: 执行
NODE_OPTIONS="--max-old-space-size=8192" npm run docs:build,检查构建错误
- deploy: 执行
npx wrangler pages deploy,确认部署成功
- 汇总报告结果
快捷命令
一键全流程(等同于 npm run deploy,但包含提交推送):
git add -A && git commit -m "消息" && git push
NODE_OPTIONS="--max-old-space-size=8192" npm run docs:build
npx wrangler pages deploy docs/.vitepress/dist --project-name=full-stack-roadmap
常见问题
- 如果构建 OOM,确认
NODE_OPTIONS="--max-old-space-size=8192" 已设置
- 如果构建报 "Invalid end tag",检查
docs/index.md 中 HTML 标签是否被 fix-markdown.js 错误转义
- 如果 wrangler 部署报错未登录,先执行
npx wrangler login
- 如果需要只构建不部署,用
npm run docs:build
- 死链接已在 VitePress 配置中设置为忽略 (
ignoreDeadLinks: true)