cloudflare-publish · 让 AI 编程助手替你上线网页

这是什么？

「上线一个网页」在命令行层面只有一条 npx wrangler pages deploy，真正的坑都在部署之后：验证页面是不是真的更新了、资源是不是真的上传成功了。这个技能把下面这些用血泪换来的规则交给 AI，让它替你把整条链路走完、走对。

假 200 陷阱：开了 SPA 回退的站，不存在的路径也返回 200 + index.html。「返回 200」不能证明资源存在，必须比对 Content-Type 与大小。

代理污染陷阱：命令行走代理测 pages.dev，css/js 会被污染成与 index.html 等长的 HTML 回退页。测 pages.dev 必须直连 --noproxy "*"。

假 DIFF 陷阱：哈希校验不带 Accept-Encoding: identity，拿到的是 br/gzip 压缩字节，哈希必不一致——而且压缩后大小可能恰好接近其他文件，极具迷惑性。

边缘收敛窗口：部署后全球节点有 5-10 分钟收敛期，同一资源会在新旧内容间摆动。期间不要下「部署残缺」的结论，等收敛后全量复核。

Functions 部署判定：带服务端的项目必须在项目目录内执行，日志出现 Uploading Functions bundle 才算真的带上了后端。

源码找回：从 pages.dev 抓回完整静态源码（顺 import 爬依赖树），但 Pages Functions 源码无法取回——服务端逻辑丢了只能重写。

三步安装

1准备条件

装好 Node.js，注册一个 Cloudflare 账号（免费套餐即可），然后在终端登录一次：

npx wrangler login

浏览器会弹出 OAuth 授权页，确认后凭证就保存在本机了。

2保存 SKILL.md

把完整技能文件保存到你的项目里（项目级），或复制到全局目录（所有项目可用）：

# 项目级（只在该项目生效）
<你的项目>\.trae\skills\cloudflare-publish\SKILL.md

# 全局（Trae，所有项目生效）
C:\Users\<你>\.trae-cn\builtin\global\skills\cloudflare-publish\SKILL.md

下载 SKILL.md 文件

保存后新开会话即可被识别（技能在会话启动时扫描）。

3让 AI 干活

在对话里直接下指令，技能会自动触发（或输入 /cloudflare-publish 显式调用）：

把 d:\mysite 这个目录部署上线
更新线上站，部署后帮我验证真的更新了
从 xxx.pages.dev 把源码抓回来

AI 会自动完成：创建项目 → 直传部署 → 直连抓生产域名比对 Content-Type/大小/内容标志 → 报告真实验证结果，而不是只扔给你一句「部署成功」。

技能里的验证规则按中国大陆网络环境编写（代理/直连分流）。海外网络环境可忽略代理相关两条，其余规则同样适用。

完整 SKILL.md

以下即为技能全文（与下载文件内容一致），可直接复制保存。

加载中…

常见问题

哪些 AI 编程工具能用这个技能？

凡是支持「技能 / Skill」机制的工具都可以：如 Trae（.trae\skills\ 或全局技能目录）、Claude Code（.claude\skills\）等。本质就是一份写给 AI 的操作手册，格式通用（YAML frontmatter + Markdown 正文），复制到对应目录即可。

免费额度够用吗？

Cloudflare Pages 免费版：每月无限请求、单次部署 20,000 个文件、每文件 25 MB 上限，个人项目完全够用。不需要绑卡。

必须是纯静态站吗？

技能覆盖三种形态：纯静态直传（Pages）、带 Pages Functions 的服务端（D1/KV/Secrets 绑定）、以及 Worker + Assets + D1。最常见的前两类命令都在技能里。

为什么部署成功了还要验证？

wrangler 提示「Deployed!」只代表上传动作完成。SPA 回退、边缘收敛、压缩编码都会让验证结果骗过简单的状态码检查——这正是踩坑规则存在的意义：假 200、假 DIFF 都能被 Content-Type + 大小 + identity 哈希三重确认识破。