Cloudflare 部署

mdorigin 不提供仓库内置的 wrangler.toml，而是为使用它的项目生成 Worker 包。

推荐安装：

npm install -g mdorigin

项目内安装 npm install --save-dev mdorigin 也可以。

构建 Worker 包

mdorigin build cloudflare --root docs/site

默认写入：

dist/cloudflare/worker.mjs

媒体较多的站点，使用外置二进制模式：

mdorigin build cloudflare --root docs/site --binary-mode external

外置模式下：

• 文本内容保持嵌入 worker.mjs
• 较小的二进制文件分阶段放在 dist/cloudflare/assets
• 超大二进制文件分阶段放在 dist/cloudflare/r2
• 生成的 Wrangler 配置把分阶段的资源目录接入 ASSETS 绑定
• 遍历时忽略点文件与点目录

当给 build cloudflare 提供 --search <search-dir> 时，搜索包在 Cloudflare 部署中同样外置：

• 搜索文件不嵌入 worker.mjs
• 较小的搜索文件放在 dist/cloudflare/assets/__mdorigin/search
• 超大搜索文件放在 dist/cloudflare/r2
• /api/search 在运行时懒加载分阶段的索引

初始化 Wrangler 配置

mdorigin init cloudflare --dir .

如果包中包含 R2 支撑的二进制文件，传入桶名：

mdorigin init cloudflare --dir . --r2-bucket <bucket-name>

部署前上传分阶段的 R2 对象：

mdorigin sync cloudflare-r2 --dir dist/cloudflare --bucket <bucket-name>

大型媒体文件、大型搜索包文件（或两者）可能要求执行这一上传步骤。

如果省略 --name，mdorigin 会从站点标题推导 Worker 名称。

你可以先部署到默认的 *.workers.dev 主机名。自定义域名是可选的，之后可以在用户项目的 Cloudflare 设置中添加。

生产部署时，在 mdorigin.config.json 设置 siteUrl，让渲染 HTML 与 /sitemap.xml 使用正确的绝对源。

部署后，当客户端发送以下头时，Worker 上的无扩展名路由同样可以返回 markdown：

Accept: text/markdown

这让智能体可以直接从站点域名获取 markdown，而无需在 URL 上追加 .md。