网页发布流程

本地 docs/*.md 是内容源；Cloudflare Pages 是公开在线文档站。改文档后自动同步成 HTML，再发布，不需要发文件。

固定工作流

以后凡是文档有更新，默认走这一条：

1. 只改本地 docs/*.md（必要时改首页 HTML）。
2. 运行一条发布命令，自动完成 docs → HTML 同步并上传。
3. 把生产链接和本次预览链接直接贴给你。
4. 你也可以随时从首页「文档中心」打开任意文档。

python scripts/网页发布/发布Cloudflare页面.py --note "改了什么"

发布后默认贴这几条：

• 固定首页：https://vdr-dataset-overview.pages.dev/
• 本次预览：命令输出的 https://xxxx.vdr-dataset-overview.pages.dev
• 云端 STATUS：https://vdr-dataset-overview.pages.dev/docs/status.html

首页「文档中心」和任意文档页左侧导航都能互相跳转，本地与云端是同一套文档。

两类链接

• 生产链接（固定）：https://vdr-dataset-overview.pages.dev/
• 始终指向最新一次生产部署，适合长期入口和首页收藏。
• 部署预览链接（每次不同）：例如 https://2cebdbfe.vdr-dataset-overview.pages.dev
• 对应某一次具体部署，适合分享、评审和回看。
• 日常对外优先发预览链接，避免后续更新改变对方看到的内容。

历史发布记录见 reports/Cloudflare发布记录.md。

发布做了什么

1. 运行 构建文档站.py，把 docs/*.md 同步成 HTML，并刷新首页 STATUS 摘要。
2. 生成带统一导航的独立文档子页面。
3. 发布整站 reports/vdr-dataset-overview-site/。
4. 更新固定生产链接，提取本次预览链接。
5. 把时间、说明和两类链接追加到本地发布记录。

Cloudflare 登录凭据保存在项目 .tmp/，不得提交 Git。发布失败时不写记录。

在线入口

• 首页：https://vdr-dataset-overview.pages.dev/
• 状态：https://vdr-dataset-overview.pages.dev/docs/status.html
• 项目总纲：https://vdr-dataset-overview.pages.dev/docs/vision.html
• 训练资产：https://vdr-dataset-overview.pages.dev/docs/training-datasets.html
• 冻结评测：https://vdr-dataset-overview.pages.dev/docs/evaluation-datasets.html
• 合成流程：https://vdr-dataset-overview.pages.dev/docs/synthesis-pipeline.html
• 合成结果：https://vdr-dataset-overview.pages.dev/docs/synthesis-results.html
• 模型服务：https://vdr-dataset-overview.pages.dev/docs/qwen-service.html
• GPT-5.6 指南：https://vdr-dataset-overview.pages.dev/docs/gpt-5-6-guidance.html
• 网页发布：https://vdr-dataset-overview.pages.dev/docs/publishing.html

谁能看到

任何拿到链接的人都能直接打开，无需 Cloudflare 账号、无需登录。