背景
近期在探索 AI Agent 应用时，发现需要让大模型能访问本地笔记数据。利用 Obsidian 配合 GitHub 私有库是个不错的方案，既能版本控制又能云端备份。这里记录下在 Mac 环境下的具体配置经验。
前置准备
确保本地已安装 Obsidian 和 Git 工具。检查 Git 是否可用，可在终端输入 git --version 确认。
| 类型 | 名称 |
|---|---|
| 操作系统 | macOS (非移动端) |
| Obsidian 版本 | 1.10.6 |
安装插件
打开 Obsidian，点击左下角设置图标进入设置页面。
开启安全模式后，点击'浏览插件市场'，搜索'Git'并确认安装。建议安装名为 obsidian-git 的官方插件。
安装完成后，重启 Obsidian 即可看到插件生效。
仓库初始化与关联
初始化本地仓库
按下快捷键 Cmd + P 唤起命令面板，输入 Git: Initialize a new repo 进行初始化。
初始化成功后，再次通过 Cmd + P 输入 Git: Open source control view，若能看到类似结构说明初始化完成。
绑定 GitHub 远程地址
同样使用 Cmd + P，搜索 Git: Edit remotes。
- Remote name 选择
origin - URL 格式填写：
https://github.com/你的用户名/你的仓库名.git
