iPad 端 Obsidian 结合 Gitee 实现 Git 同步实战

方法二：文件 App 中转

如果直接打开受限，可在 Working Copy 中导出仓库到'文件'App，再在 Obsidian 中打开该文件夹。

插件配置：Obsidian Git

1. 安装插件

进入 设置 -> 社区插件 -> 浏览，搜索 Obsidian Git 并启用。

2. 基础设置

根据需求调整以下选项，建议开启自动化以减少手动操作：

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

3. 配置 Git 用户信息

需要在终端中指定作者身份，否则提交会失败。

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

认证与安全

Gitee 对密码验证有限制，建议使用以下方式之一。

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

无需配置复杂的密钥，只需生成一个 Token。

1. 在 Gitee 后台生成私人令牌。
2. 配置 Git 存储凭证：

   git config --global credential.helper store
   

3. 首次推送时，输入用户名和令牌（作为密码）。

方案二：SSH 密钥

更安全但配置稍繁琐。

1. 在 Working Copy 中生成 SSH 密钥。
2. 将公钥添加到 Gitee 设置。
3. 修改远程地址为 SSH 协议：

   git remote set-url origin [email protected]:你的用户名/仓库名.git
   

测试与验证

修改几行笔记后，手动触发同步检查是否正常。

1. 打开命令面板 (Cmd+P)。
2. 搜索 Obsidian Git: Pull 或 Push。
3. 查看终端状态确认日志：

   git status
   git log --oneline -3
   

常见问题排查

Git 命令找不到

确保当前使用的是 Working Copy 的终端，或在 iSH 中正确安装了 Git 包。

认证失败

尝试重置凭证辅助程序：

git config --global --unset credential.helper
git config --global credential.helper store

或者直接在使用令牌时拼接 URL：

git push https://username:[email protected]/xxx/obsidianws.git

文件权限问题

若遇到写入失败，可尝试修复权限：

chmod -R 755 /path/to/your/obsidianws

同步冲突

若发生冲突，先拉取最新代码合并：

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）
• 测试同步功能