452 lines
12 KiB
Markdown
452 lines
12 KiB
Markdown
---
|
||
categories:
|
||
- '[[LLM Wiki]]'
|
||
tags:
|
||
- wiki
|
||
- concept
|
||
- obsidian
|
||
- git
|
||
- multi-device
|
||
- synchronization
|
||
created: 2026-04-07
|
||
source: '[[Obsidian-Git多端同步指南]]'
|
||
type: concept
|
||
aliases:
|
||
- Obsidian 多端同步
|
||
- Git 分支策略
|
||
- Obsidian Git 插件
|
||
relations:
|
||
- type: part_of
|
||
target: '[[Git]]'
|
||
description: 同源：Obsidian-Git多端同步指南
|
||
confidence: 3
|
||
- type: extends
|
||
target: '[[Gitea]]'
|
||
confidence: 2
|
||
- type: extends
|
||
target: '[[Obsidian]]'
|
||
confidence: 2
|
||
---
|
||
|
||
[raw:Obsidian-Git多端同步指南:1]# Obsidian + Git 多端同步
|
||
|
||
> **一句话描述**：使用 Git 分支策略实现 Obsidian 笔记在 PC、手机和 AI 之间的多端同步
|
||
|
||
## 架构概览
|
||
|
||
```mermaid
|
||
graph LR
|
||
A[用户] --> B[Gitea仓库<br/>git.haiguang.xyz]
|
||
|
||
B --> C[main分支<br/>用户维护]
|
||
B --> D[openclaw分支<br/>OpenClaw维护]
|
||
|
||
C --> E[merge/PR<br/>用户按需合并]
|
||
D --> E
|
||
|
||
E --> A
|
||
|
||
A --> F[你的设备<br/>PC/手机]
|
||
A --> G[OpenClaw服务器<br/>自动运行]
|
||
|
||
F --> A
|
||
G --> A
|
||
```
|
||
|
||
### 分支分工
|
||
|
||
| 分支 | 维护者 | 用途 |
|
||
|
|
||
------|
|
||
--------|------|
|
||
| **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 分钟一次。
|
||
|
||
## 相关概念
|
||
|
||
- [[Gitea]] - Git 托管服务
|
||
- [[Obsidian]] - 笔记工具
|
||
- [[Git]] - 版本控制系统
|
||
- OpenClaw - AI 自动化服务（外部服务）
|
||
|
||
## 来源
|
||
|
||
- [[Obsidian-Git多端同步指南]] - 完整的多端同步文档
|
||
- Obsidian Git 插件文档：<https://github.com/denolehov/obsidian-git>
|
||
|
||
[raw:Obsidian-Git多端同步指南:1]# Obsidian + Git 多端同步
|
||
|
||
> **一句话描述**：使用 Git 分支策略实现 Obsidian 笔记在 PC、手机和 AI 之间的多端同步
|
||
|
||
## 架构概览
|
||
|
||
```mermaid
|
||
graph LR
|
||
A[用户] --> B[Gitea仓库<br/>git.haiguang.xyz]
|
||
|
||
B --> C[main分支<br/>用户维护]
|
||
B --> D[openclaw分支<br/>OpenClaw维护]
|
||
|
||
C --> E[merge/PR<br/>用户按需合并]
|
||
D --> E
|
||
|
||
E --> A
|
||
|
||
A --> F[你的设备<br/>PC/手机]
|
||
A --> G[OpenClaw服务器<br/>自动运行]
|
||
|
||
F --> A
|
||
G --> A
|
||
```
|
||
|
||
### 分支分工
|
||
|
||
| 分支 | 维护者 | 用途 |
|
||
|------|--------|------|
|
||
| **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 分钟一次。
|
||
|
||
## 相关概念
|
||
|
||
- [[Gitea]] - Git 托管服务
|
||
- [[Obsidian]] - 笔记工具
|
||
- [[Git]] - 版本控制系统
|
||
- OpenClaw - AI 自动化服务（外部服务）
|
||
|
||
## 来源
|
||
|
||
- [[Obsidian-Git多端同步指南]] - 完整的多端同步文档
|
||
- Obsidian Git 插件文档：<https://github.com/denolehov/obsidian-git>
|