iPad Obsidian Git 同步 Gitee 仓库完整指南
# iPad Obsidian Git 同步 Gitee 仓库完整指南
## 整体思路
在 iPad 上同步已有的 Gitee 仓库需要：
1. **安装 Obsidian 和 Git 相关工具**
2. **克隆远程仓库到 iPad**
3. **配置 Obsidian Git 插件**
4. **设置认证信息**
## 第一步：安装必要工具
### 1. **安装 Obsidian**
- 从 App Store 安装 Obsidian
- 打开应用
### 2. **安装 Git 环境（关键步骤）**
#### 方案一：使用 Working Copy（推荐）
```bash
# Working Copy 是 iOS 上功能最完整的 Git 客户端
# 1. 从 App Store 安装 "Working Copy"
# 2. 它提供了完整的 Git 命令行环境
```
#### 方案二：使用 iSH Shell
```bash
# 1. 安装 iSH Shell from App Store
# 2. 在 iSH 中安装 Git：
apk update
apk add git
```
#### 方案三：使用 a-Shell
```bash
# 1. 安装 a-Shell from App Store
# 2. 内置了 Git 支持
```
**推荐使用 Working Copy**，因为它与 Obsidian 集成最好。
## 第二步：克隆仓库到 iPad
### 使用 Working Copy 克隆：
1. **打开 Working Copy**
2. **添加远程仓库**：
```
+ → Clone Repository → Enter URL
URL: https://gitee.com/xxx/obsidianws.git
```
3. **选择克隆位置**：建议选择 "On My iPad"
4. **完成克隆**
### 或者使用 HTTPS 克隆：
```bash
# 如果在 iSH 或 a-Shell 中：
git clone https://gitee.com/xxx/obsidianws.git
```
## 📁 第三步：在 Obsidian 中打开仓库
### 方法一：直接打开（推荐）
1. **打开 Obsidian**
2. **打开其他库** → **打开文件夹**
3. **找到 Working Copy 中的仓库路径**：
```
通常路径：/private/var/mobile/Containers/.../Working Copy/obsidianws
```
### 方法二：通过文件 App 中转
1. **在 Working Copy 中导出仓库**：
- 长按仓库 → 导出 → 存储到文件
2. **在 Obsidian 中打开导出的文件夹**
## ⚙️ 第四步：配置 Obsidian Git 插件
### 1. **安装 Obsidian Git 插件**
```
Obsidian → 设置 → 社区插件 → 浏览
搜索 "Obsidian Git" → 安装并启用
```
### 2. **配置插件设置**
```yaml
自动拉取: ✅ 开启
自动推送: ✅ 开启
自动提交: ✅ 开启
提交消息: "iPad sync: {{date}}"
自动拉取间隔: 30 # 分钟
拉取更新启动时: ✅ 开启
```
### 3. **配置 Git 用户信息**
在 iSH 或 Working Copy 的终端中：
```bash
cd /path/to/your/obsidianws
git config user.name "你的用户名"
git config user.email "你的邮箱@gmail.com"
```
## 第五步：配置认证信息
### 对于 Gitee 的认证方案：
#### 方案一：使用个人访问令牌（推荐）
```bash
# 1. 在 Gitee 生成访问令牌
# 设置 → 安全设置 → 私人令牌
# 2. 在 iPad 上配置 Git 使用令牌
git config --global credential.helper store
# 第一次推送时输入用户名和令牌（作为密码）
```
#### 方案二：使用 SSH 密钥（复杂但安全）
```bash
# 1. 在 Working Copy 中生成 SSH 密钥
# 设置 → SSH 密钥 → 生成新密钥
# 2. 将公钥添加到 Gitee
# 设置 → SSH 公钥 → 添加公钥
# 3. 修改远程地址为 SSH
git remote set-url origin [email protected]:xxx/obsidianws.git
```
## 第六步：测试同步功能
### 测试推送：
1. **在 Obsidian 中做一些小修改**
2. **手动触发同步**：
```
命令面板 (Cmd+P) → 搜索 "Obsidian Git: Pull"
命令面板 → 搜索 "Obsidian Git: Push"
```
3. **或等待自动同步**
### 检查状态：
```bash
# 在终端中检查 Git 状态
cd /path/to/your/obsidianws
git status
git log --oneline -3
```
## 完整工作流程
### 日常同步流程：
```markdown
1. **开始工作前**：
- 打开 Obsidian
- 自动或手动执行 `Pull` 获取最新更改
2. **工作期间**：
- 正常编辑笔记
- 自动提交会定期保存更改
3. **结束工作时**：
- 手动执行 `Push` 确保同步到远程
- 或等待自动推送
```
### 冲突解决流程：
```markdown
1. **发现冲突**：
- 状态栏显示冲突图标
- 手动解决冲突文件
2. **解决冲突**：
- 编辑冲突文件
- 使用命令提交解决
3. **完成同步**：
- 推送解决后的版本
```
## 🛠️ 针对 iPad 的优化配置
### Working Copy 自动化配置：
1. **设置自动拉取**：
- Working Copy → 设置 → 自动拉取 → 开启
2. **配置 URL 回调**：
- 在 Working Copy 中配置 Obsidian URL 回调
- 实现一键打开仓库
### Obsidian Git 插件优化：
```json
{
"commitMessage": "iPad: {{date}}",
"autoCommit": true,
"autoPull": true,
"autoPush": true,
"autoPullInterval": 30,
"disablePush": false,
"pullBeforePush": true
}
```
## 常见问题解决
### 问题 1：Git 命令找不到
```bash
# 确保使用 Working Copy 的终端
# 或者在 iSH 中正确安装 Git
apk update && apk add git
```
### 问题 2：认证失败
```bash
# 重新配置认证
git config --global --unset credential.helper
git config --global credential.helper store
# 或者使用令牌
git push https://username:[email protected]/xxx/obsidianws.git
```
### 问题 3：文件权限问题
```bash
# 在终端中修复权限
chmod -R 755 /path/to/your/obsidianws
```
### 问题 4：同步冲突
```bash
# 拉取最新并合并
git pull origin master
# 或者使用 Working Copy 的图形化冲突解决工具
```
## 💡 最佳实践建议
### 同步策略：
```yaml
推荐设置:
- 自动提交间隔: 30分钟
- 自动推送: 开启
- 拉取启动时: 开启
- 推送前拉取: 开启
```
### 备份策略：
```yaml
多重备份:
- Gitee 远程仓库
- Working Copy 本地副本
- iCloud 同步（可选）
```
### 工作习惯：
```markdown
1. **开始工作**：先拉取最新更改
2. **重要修改**：手动提交并推送
3. **结束工作**：确认推送成功
4. **定期检查**：查看同步状态
```
## 🎯 快速开始清单
- [ ] 安装 Obsidian
- [ ] 安装 Working Copy
- [ ] 在 Working Copy 中克隆仓库
- [ ] 在 Obsidian 中打开仓库
- [ ] 安装配置 Obsidian Git 插件
- [ ] 设置 Git 用户信息
- [ ] 配置认证（令牌或 SSH）
- [ ] 测试同步功能
