openpress-deploy

open-press 部署

open-press deploy 负责把关公开发布。只有在用户要求配置、检查、试运行或发布 open-press 文档时，才使用它。

职责

• 检查 openpress/settings.json 中的 "deploy" 部署配置。
• 检查目标适配器、暂存源、项目名称和确认设置。
• 运行部署预检和试运行。
• 避免将密钥写入源文件。
• 发布前必须获得明确确认。
• 部署成功后，报告公开 URL；如果包含 PDF，也要报告 PDF URL。

边界

• openpress 负责通用 CLI 用法、非部署验证、本地审阅，以及源文件与生成文件的边界。
• openpress-create-pages 负责页面制品内容和视觉就绪情况。
• openpress-create-slide 负责幻灯片内容和视觉就绪情况。
• 本技能负责确认公开目标并执行部署。

公开部署规则

未经明确确认，绝不发布；确认内容必须注明目标项目。

恰当的确认格式：

This will publish the current open-press build to Cloudflare Pages project `<projectName>` from `<deploy.source>`.
Do you want me to deploy now?

预检

正式部署前，运行以下命令以确认输出已准备就绪：

npm run build              # validates + renders dist-react/

还要扫描面向公众的源文件，查找未完成标记：

rg "\\[TODO:|\\[FIX:|\\[DRAFT:" "press/*/chapters" press/design.md

PDF 大小限制

Cloudflare Pages 会拒绝任何大于 25 MB 的单个文件。包含多篇内容或图片较多的 PDF 通常会超过此限制。

除非用户明确要求发布 PDF，否则部署时不要包含 PDF：

npm run openpress:deploy -- --confirm --no-pdf

--no-pdf 会跳过 PDF 生成，并将其完全排除在部署源文件之外。

如果用户想先检查 PDF 大小：

npm run openpress:pdf
du -sh .deploy/**/*.pdf 2>/dev/null

如果 PDF 大于 25 MB，而用户仍希望将其托管在公开位置，建议使用单独的托管服务（Cloudflare R2、S3 等）。OpenPress 目前不支持填写作者指定的外部 PDF URL，因此不要在 openpress/settings.json 中自行添加；应在交付说明中报告单独的 URL。

部署命令

试运行：

npm run openpress:deploy:dry-run -- --no-pdf

获得明确确认后发布：

npm run openpress:deploy -- --confirm --no-pdf

只有当用户明确将 PDF 列入已确认的发布目标时，才移除 --no-pdf。

何时阅读参考资料

• 创建或修复 Cloudflare Pages 配置、项目设置、Wrangler 身份验证要求或 UI 部署按钮行为时，请阅读 references/cloudflare-pages.md。