OpenClaw 技能：Obsidian/Markdown → Cloudflare Pages

这是一个用于将 Markdown 发布至 Cloudflare Pages 的 OpenClaw Skill。

• 支持 Obsidian 仓库文件夹 或任意 Markdown 文件夹
• 最初为读取 Obsidian Web Clipper 输出而构建：
  • https://obsidian.md/clipper

自动化执行安全的发布流程：

1. 从源文件夹中选择笔记
2. 同步至发布工作区（publish workspace）
3. 使用 Quartz 构建静态 HTML
4. 部署至 Cloudflare Pages

命令

• node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js init
  • 基于示例创建 config/config.json
• node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js wizard
  • 交互式配置向导（支持设置 vault、文件夹、站点/域名、Cloudflare 项目）
• node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js setup-project
  • 若配置的工作区中缺失 Quartz 项目，则初始化该项目
• node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js doctor
  • 校验路径及必需的二进制程序
• node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js sync
  • 将选定的笔记与资源同步至发布内容目录
• node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js build
  • 在项目目录中运行 Quartz 构建流程
• node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js deploy
  • 通过 wrangler 部署至 Cloudflare Pages
• node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js run
  • 依次执行 sync → build → deploy
• node skills/obsidian-cloudflare-pages/bin/publishmd-cf.js run --dry-run
  • 预览所有操作，但不修改文件或实际部署

配置

复制并编辑以下文件：

skills/obsidian-cloudflare-pages/config/config.example.json → skills/obsidian-cloudflare-pages/config/config.json

安全默认设置

• 按文件夹白名单控制可发布内容
• 可选的 frontmatter 门控字段：publish: true
• 默认排除私有文件夹

依赖要求

• node 20+
• rsync
• npm
• npx quartz
• wrangler

Cloudflare API Token 配置（推荐）

请创建一个至少具备以下权限的 Cloudflare API Token：

• Account → Cloudflare Pages:Edit
• （可选）Zone → DNS:Edit —— 若需在其他地方启用 DNS 自动化

您可通过两种方式提供该 Token：在 Shell 配置文件（如 ~/.zshrc）中导出环境变量，或使用技能专属的 .env 文件。

选项 A：Shell 配置文件（~/.zshrc）

export CLOUDFLARE_API_TOKEN=""
export CLOUDFLARE_ACCOUNT_ID=""

重载 Shell 配置：

source ~/.zshrc

选项 B：技能本地 env 文件（本技能推荐）

cp skills/obsidian-cloudflare-pages/.env.example skills/obsidian-cloudflare-pages/.env
# 然后编辑 .env 文件
# 可选认证环境变量：BASIC_AUTH_USERNAME / BASIC_AUTH_PASSWORD

CLI 会自动加载 skills/obsidian-cloudflare-pages/.env（且不会覆盖已存在的 Shell 环境变量）。

向导现在会询问以下信息：

• 完整生产域名（例如：YOURDOMAIN.COM）
• 品牌设置（根源文件夹、源索引标签、根索引标签、侧边栏标题 HTML）
• Token / Account 对应的环境变量名（默认值见上文）
• 可选的基础认证保护（用户名 / 密码）

注意事项

• ⚠️ setup-project 的回退行为：若直接调用 Quartz 初始化命令失败，回退路径可能在克隆 Quartz 前清空已配置工作区目录中的文件。请为此技能单独指定专用的工作区路径。
• 回退清理操作受保护机制约束；仅当工作区非空时，需显式设置 ALLOW_DESTRUCTIVE=1 才允许执行。
• Dry-run 输出将对敏感值（如 API Token）进行脱敏处理。

OpenClaw 使用技巧

示例提示词（prompt）：

• “为我的 Markdown 文件夹配置 obsidian-cloudflare-pages 向导。”
• “运行 doctor 并告诉我缺少哪个依赖。”
• “同步、构建并部署至 Cloudflare Pages。”
• “启用基础认证并重新部署。”

最佳实践：

• 将密钥存于 .env 中（切勿出现在聊天日志中）
• 优先使用环境变量支持的基础认证（BASIC_AUTH_USERNAME / BASIC_AUTH_PASSWORD）
• 提交 config.example.json，而非个人化的 config.json
• 使用作用域受限的 Cloudflare Token（仅授予 Pages 编辑权限；DNS 编辑权限仅在必要时启用）
• 上线前先在测试子域名上验证流程

独立使用（脱离 OpenClaw）

本工具亦可作为普通 Node CLI 直接运行：

node bin/publishmd-cf.js init
node bin/publishmd-cf.js wizard
cp .env.example .env
# 填写 .env 中各项值
node bin/publishmd-cf.js run

安全说明

本技能中的基础认证（Basic Auth）设计为简洁可选方案。除非您完全理解自身安全模型及加固策略，否则请勿发布高度敏感的内容。

安全开关：

• --dry-run（或设置 DRY_RUN=1）：预览全部操作，不修改文件、不触发部署
• ALLOW_DESTRUCTIVE=1：仅当您明确希望允许回退流程清空非空工作区目录时启用