发布到 Cloudflare · 手册

工作台首页和每个版本分开部署：首页是总入口，每个版本的需求文档、demo、测试用例在它自己的链接下。发布全部由 AI 通过 API 完成，不需要打开 Cloudflare 后台，也不需要手动上传。

线上结构

工作台总入口   https://fanzy-product.pages.dev/
               ├ 版本列表（每行三个按钮，指向各版本自己的链接）
               └ 快速入门 / 配置指南 / 使用规范 / 各手册

版本 A         https://v20261030-login-welcome.fanzy-product.pages.dev/
               ├ prd/v2026.10.30-login-welcome/              需求文档
               ├ demo/v2026.10.30-login-welcome/dist/        demo
               └ testcases/v2026.10.30-login-welcome/        测试用例
版本 B         https://v20261105-member-renew.fanzy-product.pages.dev/ …

在 Cloudflare 哪里查看已上传内容

打开 Cloudflare 控制台，选择配置时使用的账号 → Workers & Pages → fanzy-product（若配置了其他项目名，选择对应项目）→ Deployments / 部署。进入某次部署的详情，打开它的访问网址。入口说明见 Cloudflare 官方部署说明。

查看实际页面时，直接打开工作台首页的版本入口；测试录像在对应版本的测试用例页内播放。部署列表用于查看发布时间、部署状态和访问地址。

首次发布：自动补齐默认演示模板

工作台自带「登录页新人福利提示」（v2026.10.30-login-welcome）三件套，用于快速了解 demo、需求文档与测试录像。

1. 每次正式发布版本或工作台，AI 都会检查当前 Cloudflare 项目中模板是否已有成功部署。
2. 线上缺失时，先核实本地模板完整、测试全部通过，再单独发布模板，随后继续本次发布。
3. 线上已存在时直接保留，不重复上传；首页「演示模板」分类和手册示例入口会指向它。
4. 查询失败会停止并说明原因，不把网络问题当成模板缺失；预演不会创建或上传线上内容。

同一需求更新与历史版本

需要同时保留同一需求修改前、修改后的两套成果时，先告诉 AI 创建新版本包。发布记录会追加保留，但记录不等同于自动生成一份新的版本包。

发布后必须交付完整网址

AI 先核验线上页面和demo交互，再逐项列出下表四个完整网址。链接文字本身也显示完整路径，不只显示「打开demo」等快捷名称。以下以无感登录版本为例：

一次性配置

只需要在 deploy/cloudflare.json 里填两个值：账号 ID 和 API Token。每一步点哪里、复制什么，见 配置获取指南 · Cloudflare。Pages 项目不用先建，第一次发布时自动创建。

{
  "accountId": "32 位账号 ID",
  "apiToken": "只有 Cloudflare Pages · Edit 权限的 Token",
  "projectName": "fanzy-product",
  "siteUrl": ""
}

自检

对 AI 说「检查发布配置」：校验 Token 是否有效、项目是否存在，不会真的发布。

日常发布（对 AI 说）

发布了什么、没发布什么

每次发布前都会扫描一遍，发现疑似密钥就中止发布。

容量

Cloudflare 免费版每次部署最多 20000 个文件。现在每个版本单独部署，一个版本约 1100 个文件，不会再因为版本多而超限。本地磁盘紧张时可以让 AI「归档」旧版本：只删本地的打包产物和代码工作区，线上链接不受影响，需要时可以重新打包。

常见报错