PPanel Edge发布文档站
将 apps/docs/dist 单独发布到 Cloudflare Workers Static Assets 或 Pages。
本站使用 TanStack Start、Fumadocs Base UI 和按需加载的 MDX，构建时为中文和英文的全部页面生成 HTML。搜索索引也是静态 JSON，不需要搜索 API。默认语言路径是 /docs，英文是 /en-US/docs。
bun run --cwd apps/docs typecheck
bun run --cwd apps/docs test
bun run --cwd apps/docs build
bun run --cwd apps/docs preview构建自动从两个 API 契约生成参考，校验页面标题、描述和内部链接，输出首屏 JavaScript 测量。最终部署目录是 apps/docs/dist，其中不含 SSR 服务。
Workers Static Assets
修改 apps/docs/wrangler.jsonc 的应用名和示例自定义域名，然后从该应用目录执行 bunx wrangler deploy。此配置仅有静态资源，不需要 Hyperdrive、数据库、DO、R2 或业务 secrets。使用专用文档域名，不与面板 Worker 共享路由。
Cloudflare Pages
设置构建命令 bun run --cwd apps/docs build、发布目录 apps/docs/dist，并使用 Bun >=1.3.14。可直接上传最终目录。保留 _headers、_redirects 和 404.html；未知路径应返回 404，不启用 SPA 全站回退。配置自定义域名后检查中文、英文、深层链接、搜索和静态契约下载。
发布前需有目标账户和域名授权；仓库中的配置只包含占位值。主应用的发布工作流不负责文档站发布。