iPad 使用 Obsidian 配合 Git 同步 Gitee 仓库指南

方法二：通过文件 App 中转

1. 在 Working Copy 中导出仓库：
   • 长按仓库 → 导出 → 存储到文件
2. 在 Obsidian 中打开导出的文件夹

⚙️ 第四步：配置 Obsidian Git 插件

1. 安装 Obsidian Git 插件

Obsidian → 设置 → 社区插件 → 浏览
搜索 "Obsidian Git" → 安装并启用

2. 配置插件设置

自动拉取：✅ 开启
自动推送：✅ 开启
自动提交：✅ 开启
提交消息："iPad sync: {{date}}"
自动拉取间隔：30 # 分钟
拉取更新启动时：✅ 开启

3. 配置 Git 用户信息

在 iSH 或 Working Copy 的终端中：

cd /path/to/your/obsidianws
git config user.name "你的用户名"
git config user.email "你的邮箱@gmail.com"

第五步：配置认证信息

对于 Gitee 的认证方案：

方案一：使用个人访问令牌（推荐）

# 1. 在 Gitee 生成访问令牌
# 设置 → 安全设置 → 私人令牌

# 2. 在 iPad 上配置 Git 使用令牌
git config --global credential.helper store
# 第一次推送时输入用户名和令牌（作为密码）

方案二：使用 SSH 密钥（复杂但安全）

# 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. 或等待自动同步

检查状态：

# 在终端中检查 Git 状态
cd /path/to/your/obsidianws
git status
git log --oneline -3

完整工作流程

日常同步流程：

1. **开始工作前**：
   - 打开 Obsidian
   - 自动或手动执行 `Pull` 获取最新更改

2. **工作期间**：
   - 正常编辑笔记
   - 自动提交会定期保存更改

3. **结束工作时**：
   - 手动执行 `Push` 确保同步到远程
   - 或等待自动推送

冲突解决流程：

1. **发现冲突**：
   - 状态栏显示冲突图标
   - 手动解决冲突文件

2. **解决冲突**：
   - 编辑冲突文件
   - 使用命令提交解决

3. **完成同步**：
   - 推送解决后的版本

🛠️ 针对 iPad 的优化配置

Working Copy 自动化配置：

1. 设置自动拉取：

   • Working Copy → 设置 → 自动拉取 → 开启

2. 配置 URL 回调：

   • 在 Working Copy 中配置 Obsidian URL 回调
   • 实现一键打开仓库

Obsidian Git 插件优化：

{
  "commitMessage": "iPad: {{date}}",
  "autoCommit": true,
  "autoPull": true,  
  "autoPush": true,
  "autoPullInterval": 30,
  "disablePush": false,
  "pullBeforePush": true
}

常见问题解决

问题 1：Git 命令找不到

# 确保使用 Working Copy 的终端
# 或者在 iSH 中正确安装 Git
apk update && apk add git

问题 2：认证失败

# 重新配置认证
git config --global --unset credential.helper
git config --global credential.helper store

# 或者使用令牌
git push https://username:[email protected]/xxx/obsidianws.git

问题 3：文件权限问题

# 在终端中修复权限
chmod -R 755 /path/to/your/obsidianws

问题 4：同步冲突

# 拉取最新并合并
git pull origin master

# 或者使用 Working Copy 的图形化冲突解决工具

💡 最佳实践建议

同步策略：

推荐设置:
  - 自动提交间隔：30 分钟
  - 自动推送：开启
  - 拉取启动时：开启
  - 推送前拉取：开启

备份策略：

多重备份:
  - Gitee 远程仓库
  - Working Copy 本地副本
  - iCloud 同步（可选）

工作习惯：

1. **开始工作**：先拉取最新更改
2. **重要修改**：手动提交并推送
3. **结束工作**：确认推送成功
4. **定期检查**：查看同步状态

🎯 快速开始清单

• 安装 Obsidian
• 安装 Working Copy
• 在 Working Copy 中克隆仓库
• 在 Obsidian 中打开仓库
• 安装配置 Obsidian Git 插件
• 设置 Git 用户信息
• 配置认证（令牌或 SSH）
• 测试同步功能