阿爪工作流：内容生产 → 三端同步

📐 三端同步架构

终端	位置	用途	访问方式
① Canvas	`canvas/xxx.html`	本地在线预览	`pages.zhangyun.xyz/__openclaw__/canvas/`
② Obsidian	`knowledge_vault/05-Claw-Pages/`	手机离线查看	Obsidian App → GitHub 同步
③ kb 知识库	GitHub `iatnit/claw-pages`	正式知识库	`kb.zhangyun.xyz`（Google 登录）

三者独立存储，互不影响。新内容同时放三份。

🔄 完整流程（以一篇文章为例）

运哥发来一个链接 → "帮我研究并存档到三端"

1

抓取 & 研究内容

用 web_fetch / baoyu-url-to-markdown 抓取文章
深入研究、整理、提炼核心要点
📁 原文存档：url-to-markdown/域名/slug.md

2

生成 HTML 页面

将研究成果做成精美 HTML 页面
📁 保存到：canvas/文件名.html
✅ 此时 Canvas（终端①）已可访问

3

复制到 Obsidian

cp canvas/文件名.html → knowledge_vault/05-Claw-Pages/
推送 GitHub：git push origin master && git push origin master:main
✅ 此时 Obsidian（终端②）手机可同步

4

⚠️ 更新 kb 首页 index.html（关键步骤）

先拉取最新版：git pull origin main
只追加卡片，不重写整个文件：在对应分类下新增一个 <a class="card">
绝不运行 build-kb-site.py 生成 index.html

5

推送 kb 仓库

复制 HTML 文件到 kb 仓库：cp canvas/文件名.html → /tmp/claw-pages/
git add -A && git commit && git push origin main
Cloudflare Pages 自动部署（1-2分钟生效）
✅ 此时 kb.zhangyun.xyz（终端③）可访问

6

验证 & 确认

用 web_fetch 访问 kb.zhangyun.xyz 确认首页内容完整
告诉运哥三端链接，确认完成

🛡️ 防覆盖规则

🚫 绝对禁止

禁止运行 build-kb-site.py 生成 index.html（它会覆盖首页）
禁止整体重写 index.html（只能追加卡片）
禁止 git push --force（会丢失历史）
禁止不拉取就推送（先 git pull 再 git push）

✅ 正确做法

index.html 只做追加操作：在对应分类下插入新卡片
每次操作前先 git pull origin main 拿到最新版
新文件直接 cp 进仓库，不影响其他文件
update-kb-site.sh 已修改为跳过 index.html

🔙 备份与回滚能力

场景	恢复方法
首页被覆盖	`git log --oneline` 找到正常的 commit `git show <commit>:index.html > index.html` 恢复
某个文件被删除	`git checkout <commit> -- 文件名.html`
整个仓库搞乱了	`git reset --hard <正常的commit>` `git push origin main --force`（仅此情况允许 force push）
Canvas 文件丢失	从 Obsidian 或 kb 仓库反向复制回来
Obsidian 文件丢失	从 Canvas 或 kb 仓库反向复制回来

💡 三重备份 = 天然冗余

同一份文件存在三个地方（Canvas + Obsidian + kb仓库），任何一个出问题都能从另外两个恢复。加上 Git 历史，相当于有四层保险。

📝 追加卡片模板

往 index.html 对应分类下插入：

<a class="card" href="新文件名.html">
  <div class="title">📌 文章标题</div>
  <div class="desc">一句话描述。</div>
  <div class="meta">
    <span class="tag learning">标签</span>
    <span>2026-03-30</span>
  </div>
</a>

可用标签样式：health business learning tool family
如需新分类，在已有分类之间插入一个新的 <div class="category"> 块即可。

⚡ 快速命令参考

# ===== 终端② Obsidian 同步 =====
cp canvas/新文件.html knowledge_vault/05-Claw-Pages/
cd knowledge_vault
git add -A && git commit -m "📚 新增：标题"
git push origin master && git push origin master:main

# ===== 终端③ kb 知识库同步 =====
cd /tmp/claw-pages && git pull origin main
cp ~/clawd/canvas/新文件.html ./
# 手动编辑 index.html 追加卡片（不要整体替换！）
git add -A && git commit -m "📚 新增：标题"
git push origin main
# Cloudflare Pages 1-2分钟自动部署

🐾 阿爪工作流手册