核心用法
obsidian-cloudflare-pages 是一个 OpenClaw Skill，用于将 Markdown 内容（特别是 Obsidian 笔记）自动化发布为静态网站并部署到 Cloudflare Pages。
工作流程
1. 初始化配置 (init/wizard)：交互式设置源文件夹、目标工作区、域名及 Cloudflare 项目
2. 项目搭建 (setup-project)：自动初始化 Quartz 静态站点生成器
3. 健康检查 (doctor)：验证路径与依赖（Node 20+、rsync、wrangler 等）
4. 内容同步 (sync)：将选定笔记和资源同步到发布目录，支持文件夹白名单和 publish: true frontmatter 闸门
5. 构建 (build)：运行 Quartz 生成静态 HTML
6. 部署 (deploy)：通过 wrangler CLI 推送到 Cloudflare Pages
7. 一键执行 (run)：串行执行 sync → build → deploy
显著优点
- Obsidian 原生兼容：专为 Obsidian vault 设计，同时支持任意 Markdown 文件夹
- 自动化流水线：从笔记编辑到线上发布全程自动化，大幅降低技术门槛
- 安全默认配置：文件夹级发布白名单、可选 frontmatter 闸门、默认排除私密文件夹
- 灵活认证：支持可选的基础 HTTP 认证（Basic Auth），保护预览内容
- dry-run 模式：所有变更和部署前可预览，避免误操作
- 环境隔离：支持
.env文件或 shell 环境变量管理 Cloudflare API 凭证
潜在缺点与局限性
- 依赖链复杂：需要 Node 20+、rsync、npm、Quartz、wrangler 五个外部工具，环境配置门槛较高
- 破坏性回退风险：
setup-project的 fallback 机制在失败时可能清空工作区目录，需显式设置ALLOW_DESTRUCTIVE=1 - 基础认证局限：Basic Auth 仅为简单保护，不适合高敏感度内容的生产环境
- Cloudflare 锁定：部署目标绑定 Cloudflare Pages，迁移成本较高
- 前端构建黑盒：Quartz 的构建过程对普通用户较为抽象，定制化需要前端知识
适合人群
- 知识管理用户：希望将 Obsidian 笔记库公开为个人博客或知识库
- 技术写作者：需要 Markdown 源文件驱动的静态站点方案
- 开发者和极客：能接受 CLI 工具链、熟悉环境变量和 API 令牌管理
- 小团队协作：需要快速搭建内部文档站点并支持基础访问控制
常规风险
- 凭证泄露：Cloudflare API Token 若提交到版本控制或聊天日志中会导致账户风险
- 误删数据：工作区目录在 fallback 场景下可能被清空，需使用专用路径并开启保护开关
- 内容泄露：frontmatter 闸门或白名单配置错误可能导致私密笔记意外公开
- 部署失败：网络波动或 Cloudflare API 限制可能导致构建成功但部署中断