llm_wiki/raw/Obsidian-Git多端同步指南.md

# Obsidian + Git 多端同步指南

> 最后更新：2026-03-29
> 仓库地址：<https://git.haiguang.xyz/giteahh/obsidian_claw.git>

---

## 📐 架构概览

```
┌─────────────────────────────────────────────────────────┐
│                    Gitea 仓库                           │
│          git.haiguang.xyz/giteahh/obsidian_claw        │
│                                                         │
│  ┌─────────────┐              ┌──────────────┐          │
│  │ main 分支    │              │ openclaw 分支 │          │
│  │ 你维护       │              │ OpenClaw 维护 │          │
│  └──────┬──────┘              └──────┬───────┘          │
│         │        merge/PR            │                  │
│         └──────── ◄─────────────────┘                  │
│           （你按需合并，完全由你控制）                     │
└───────────┬─────────────────────────┬───────────────────┘
            │                         │
     pull/push                    pull/push
            │                         │
     ┌──────┴──────┐          ┌──────┴───────┐
     │ 你的设备     │          │ 服务器        │
     │ PC / 手机    │          │ OpenClaw      │
     │ Obsidian     │          │ 自动运行      │
     └─────────────┘          └──────────────┘
```

### 分支分工

| 分支 | 维护者 | 用途 |
|------|--------|------|
| **main** | 你（HeHaiGuang） | 正式笔记，手动编辑，你的"主阵地" |
| **openclaw** | OpenClaw（AI） | 自动生成的笔记、草稿、报告、日志等 |

---

## 📱 手机/PC 端配置步骤

### 第一步：安装 Obsidian Git 插件

1. 打开 Obsidian → 设置 → 社区插件
2. 关闭「安全模式」
3. 搜索 **Obsidian Git** 并安装
4. 启用插件

### 第二步：克隆仓库到 Obsidian

**如果你已经有本地仓库：**
```
不需要额外操作，确保 Obsidian 打开的 vault 就是从 Git 克隆的目录即可
```

**如果是从零开始：**
```bash
# 在你的 PC 上
git clone https://git.haiguang.xyz/giteahh/obsidian_claw.git
# 然后用 Obsidian 打开这个文件夹作为 Vault
```

### 第三步：配置 Obsidian Git 插件

在 Obsidian → 设置 → Obsidian Git 中设置：

| 设置项 | 推荐值 |
|--------|--------|
| 自动拉取间隔 | 5 分钟 |
| 自动提交间隔 | 30 分钟（或者关闭，手动提交） |
| 提交消息 | `update: {{date}}` |
| 显示状态栏 | ✅ 开启 |
| 当前分支 | **main** |

### 第四步：验证

1. 在 Obsidian 左下角状态栏应该能看到 `main` 分支名
2. 随便编辑一个笔记，等插件自动 commit + push
3. 去 Gitea 网页上确认是否看到你的提交

---

## 🔄 日常工作流

### 你（手动操作）

```
1. 打开 Obsidian → 正常写笔记
2. Obsidian Git 插件自动 commit + push（无需手动操作）
3. 如果想看 AI 写了什么：
   - 方法1：去 Gitea 网页看 openclaw 分支
   - 方法2：在 Obsidian 中切换分支（见下方说明）
   - 方法3：让我帮你合并到 main
```

### OpenClaw（全自动）

```
1. 每5分钟自动检查文件变化
2. 有变化 → 自动 commit + push 到 openclaw 分支
3. 同时自动拉取 main 分支的更新（读取你的最新笔记）
4. 如有冲突 → 自动放弃合并，不会搞乱任何东西
```

---

## 🔀 如何查看和合并 AI 的内容

### 在 Obsidian 中切换分支查看（推荐）

1. 安装 Obsidian Git 插件后，使用命令面板（`Ctrl/Cmd + P`）
2. 搜索 `Obsidian Git: Checkout branch`
3. 选择 `openclaw` 分支
4. 查看 AI 生成的内容
5. 切回 `main`：`Obsidian Git: Checkout branch` → `main`

> ⚠️ 切换分支前确保当前修改已提交，否则会冲突

### 通过 Gitea 网页查看

1. 打开 <https://git.haiguang.xyz/giteahh/obsidian_claw>
2. 点击分支选择器，切换到 `openclaw`
3. 浏览文件内容

### 合并 AI 的内容到 main

**方法一：让我来合并（最简单）**
```
直接告诉我："帮我把 openclaw 分支的内容合并到 main"
我会处理好所有合并操作
```

**方法二：在 Gitea 上创建 Pull Request**
1. 打开仓库页面
2. 点击「New Pull Request」
3. 源分支：openclaw → 目标分支：main
4. 审查变更后点击合并

**方法三：命令行合并（PC 端）**
```bash
git checkout main
git pull origin main
git merge openclaw
git push origin main
```

---

## ⚠️ 注意事项

### 关于删除文件

| 你想做什么 | 做法 |
|-----------|------|
| 删掉自己写的文件 | 直接删，commit + push 即可 |
| 不想看到某个 AI 生成的文件 | 告诉我，我加到 `.gitignore` |
| 彻底删除某文件（三端清除） | 告诉我，我处理本地 + Git + 坚果云 |

### 关于冲突

- **正常情况下不会冲突**，因为我们各用各的分支
- 唯一的合并时机是你主动 merge openclaw → main，这时如果冲突，Git 会标记出来，你可以选择保留哪版

### 关于坚果云备份

坚果云备份 **继续运行**，作为额外的"冷备份"：

- 每 30 分钟自动同步到坚果云
- 不受 Git 分支策略影响
- 即使 Git 出问题，坚果云还有一份

### 三层保障体系

```
第一层：Git（Gitea）  ← 主同步通道，实时双向
第二层：坚果云（rclone） ← 冷备份，每30分钟
第三层：本地磁盘        ← 服务器 /home/obsidian/
```

---

## 🆘 常见问题

### Q: Obsidian Git 插件报错怎么办？

A: 检查网络连接是否正常，Gitea 地址 `git.haiguang.xyz` 是否可访问。也可以手动在终端 `git pull` 看具体报错。

### Q: AI 生成的笔记太多了，不想全部合并？

A: 合并前先在 Gitea 上审查，或者告诉我只需要合并哪些文件。

### Q: 在手机上怎么操作？

A: 手机端 Obsidian 也有 Git 插件（Android 支持，iOS 需要用 iVim 或 Working Copy）。最简单的方案是：手机只看不同步，同步交给 PC。或者用 Termux + git 命令行。

### Q: 服务器 IP 变了怎么办？

A: 服务器上用的是 Gitea 远程地址，跟服务器 IP 无关，不受影响。

### Q: 我想修改自动同步的频率？

A: 告诉我，我改 crontab 配置即可。目前服务器端是每 5 分钟一次。