核心用法
obsidian-cloudflare-pages 是一个专为知识管理场景设计的自动化发布工具，可将 Obsidian 笔记库或任意 Markdown 文件夹转换为精美的静态网站并部署至 Cloudflare Pages。其核心工作流分为三步：选择同步（基于文件夹白名单或 publish: true 前置条件筛选笔记）、构建生成（调用 Quartz 将 Markdown 渲染为静态 HTML）、安全部署（通过 Wrangler CLI 推送至 Cloudflare Pages）。
工具提供完整的 CLI 命令体系，从 init/wizard 交互式配置，到 doctor 环境诊断，sync/build/deploy 单步执行，再到 run 一键完成全流程。特别支持 --dry-run 模式，可在不修改文件、不实际部署的情况下预览完整操作，显著提升操作安全感。
显著优点
1. Obsidian 原生兼容：专为 Obsidian 生态设计，完美支持 Obsidian Web Clipper 输出，同时兼容任意 Markdown 文件夹结构
2. 安全优先设计：多层安全机制——文件夹级发布白名单、前置条件门控、可选基础认证保护、ALLOW_DESTRUCTIVE 破坏性操作开关、敏感值自动脱敏
3. 灵活配置：支持环境变量与本地 .env 文件双轨管理，Wizard 引导式配置降低上手门槛
4. 开源透明：基于 Node.js 的开放实现，可独立运行脱离 OpenClaw 框架
潜在局限
- 依赖较重：需同时满足 Node 20+、rsync、npm、Quartz、Wrangler 等工具链
- 学习曲线：Cloudflare API Token 配置、域名绑定等需要一定基础设施知识
- 基础认证简易：内置的基础认证仅适合轻度保护，不适合高敏感内容
- Quartz 绑定：构建环节深度依赖 Quartz 方案，定制主题需额外学习成本
适合人群
- 使用 Obsidian 构建数字花园（Digital Garden）的知识工作者
- 希望将笔记库低成本、高性能托管至边缘网络的技术写作者
- 需要选择性公开部分内容（而非全库暴露）的隐私敏感用户
- 熟悉 Node.js 生态、追求自动化工作流的开发者
常规风险
1. API Token 泄露：Cloudflare API Token 拥有 Pages 编辑权限，泄露可能导致站点被篡改，务必存入 .env 并避免提交至版本控制
2. 误操作覆盖：setup-project 的 fallback 行为在启用 ALLOW_DESTRUCTIVE 时会清理工作目录，生产环境务必使用独立路径
3. 域名配置失误：Wizard 中填写的生产域名需与 Cloudflare Pages 项目配置保持一致，否则可能导致部署失败或访问异常
4. 基础认证绕过：简易 HTTP 基础认证无法防御 determined attacker，敏感内容需配合 Cloudflare Access 等零信任方案