文档站部署

本仓库使用 VitePress 构建文档站，并将公开路径固定为：

https://docs.fyzure.fyi/lucky-skills/

本地开发

npm install --include=dev --no-package-lock
npm run docs:dev

构建 Cloudflare Pages 产物

npm install --include=dev --no-package-lock
npm run docs:pages

最终可部署目录是 dist/。VitePress 站点本体位于 dist/lucky-skills/，因此 Pages 源站天然支持 /lucky-skills/ 子路径，而不是依赖运行时重写。

构建脚本还会把 Pages 专用的 _headers 与 _redirects 放到 dist/ 根目录：

• / 重定向到 /lucky-skills/；
• VitePress 带哈希的静态资源使用长期 immutable 缓存；
• 文档页面使用较短缓存，确保更新能及时生效。

CDN 拓扑

文档的正式入口与 CDN 桥接域名分离：

docs.fyzure.fyi/lucky-skills/   文档入口
cdn.fyzure.fyi                  CDN 桥接域名
saas.sin.fan                    外部 SaaS CDN 接入点

cdn.fyzure.fyi 仅承担 CDN 桥接角色，不在仓库中保存任何第三方 CDN 密钥或控制面配置。Pages 保持为可独立验证的源站，避免 CDN 控制面异常时影响构建与发布流程。

手工部署

Cloudflare Pages 项目创建完成后，可使用 Wrangler 直接上传：

wrangler pages deploy dist --project-name lucky-skills-docs --branch main

部署后应分别验证：

1. Pages 的 *.pages.dev/lucky-skills/ 源站；
2. docs.fyzure.fyi/lucky-skills/ 正式入口；
3. cdn.fyzure.fyi 的 DNS 链与 SaaS CDN 状态；
4. HTML 与带哈希静态资源的 Cache-Control 响应头。