一次关联，之后随 Git 发布。
指南仓库是内容来源；Cloudflare Pages 负责构建与托管。向生产分支推送后自动部署，构建成功后才更新正式网站。
当前公开站点
项目指南的公开地址为 guides.cpai.dpdns.org，首份指南位于 /entity-identity/。主体核验是首个指南，后续项目在同一仓库维护。本站的生产分支为 main，修改并推送指南后由 Cloudflare Pages 自动构建发布。
仓库中的 guides/<slug>/ 发布为 /<slug>/；网址不再重复 guides 目录。旧 /guides/<slug>/… 路径保留301重定向。绑定自定义域名后，Pages输出目录仍为 dist。
首次接入 Cloudflare Pages
- 登录 Cloudflare 控制台，进入 Workers & Pages。
- 选择创建应用，再切换至 Pages；选择连接 Git 仓库。不要选择 Direct Upload 或创建 Worker。
- 连接 GitHub 账号，授权 Cloudflare GitHub App。首次授权可只授予
chenponsh/project-guides；若已有Cloudflare授权，则添加此仓库并保留其他项目的权限。 - 选择此仓库并按下表填写构建设置，保存并部署。
| 设置 | 值 |
|---|---|
| 项目名 | project-guides（如被占用，选择另一可用名） |
| 生产分支 | main |
| 框架预设 | None／无 |
| 构建命令 | python3 scripts/build.py && python3 scripts/check.py |
| 构建输出目录 | dist |
| 根目录 | 留空（仓库根目录） |
| 环境变量／API Key | 不需要 |
仓库可以保持私有，生成的网站会公开访问。只把可公开的指南放进仓库；业务代码、内部连接记录、凭据和原始运行日志不应作为指南导入。
验证自动更新
首轮成功后打开 Pages 返回的真实 *.pages.dev 地址。修改一篇指南并推送到 main，检查 Pages 的生产部署记录与 GitHub 提交一致，再查看 /build-info.json 中的 commit。这样才能确认自动构建和上线已经连通。
python3 scripts/build.py
python3 scripts/check.py
git add .
git commit -m "更新某项目的指南"
git push origin main自动部署需要先完成 GitHub 关联，默认在生产分支更新时触发。失败的构建不会代表新内容已经上线。业务仓库的提交也不会自动改写或同步指南。
后续维护
- 可以在 Pages 项目设置中连接自有域名；请先完成默认域名下的部署验证。
- 生产自动部署需保持启用；预览分支是否部署可另行设置。
- 如误发内容，使用 Pages 的部署记录回退并修正源文档；不要在云端手改生成文件。