背景
最近学习了 AI agent 应用，计划将存储在 Obsidian 上的本地笔记数据让大模型访问。利用 Obsidian 工具配合 GitHub 私有库的方式实现此需求，记录本次配置经验。
步骤
默认电脑已下载 Obsidian 工具，相关版本如下：
| 类型 | 名称 |
|---|---|
| 操作系统 | macOS (非移动端) |
| Obsidian 版本 | version 1.10.6 |
安装插件
- 进入 Obsidian 界面，点击左下角设置。
- 开启安全模式（当前为已开启状态），点击'浏览插件市场'，搜索'git'并确认正确的工具名，然后安装。
配置 Obsidian
⚠️ 默认电脑已安装 Git 工具，未安装的需自行搜索 macOS 安装方式。检验方法：在命令行输入 git --version。
2.1 Obsidian 初始化仓库
- 快捷键
Cmd + P，搜索栏输入Git: Initialize a new repo，进行初始化。 - 确认是否初始化完成：快捷键
Cmd + P，搜索栏输入Git: Open source control view，出现类似结构说明初始化完成。
2.2 Obsidian 配置 GitHub 关联
- 快捷键
Cmd + P，搜索栏输入Git: Edit remotes，Remote name 选origin，url 格式：https://github.com/你的用户名/你的仓库名.git。 - 快捷键
Cmd + P，搜索栏输入Git: Set upstream branch，选择origin/main，完成主分支设置（只需设置一次）。
2.3 Obsidian 传输文件到 GitHub
- 方法一：命令行传输
在 Obsidian 输入快捷键
Cmd + P，搜索栏输入Git: Commit all changes。 - 方法二：手动提交传输 通过图形界面操作提交更改。
配置 Obsidian 插件
3.1 进入插件设置 打开插件管理界面。
3.2 按需配置 根据实际需求调整插件参数。
3.3 配置 .gitignore
上传到 GitHub 的信息应包含有价值内容，排除不必要的信息。macOS 打开 Obsidian，输入快捷键 Cmd + P，搜索栏选择指令，复制以下代码保存：
############################# Obsidian - 必须忽略（强烈推荐）#############################
工作区状态（窗口/当前文件/布局，多设备必冲突）
.obsidian/workspace
.obsidian/workspace.json
# 缓存文件（无价值，可再生）
.obsidian/cache/
.obsidian/index.db
.obsidian/index.db-shm
.obsidian/index.db-wal
############################# Obsidian - 可选忽略#############################
同步/发布相关（你不用官方 Sync/Publish 可忽略）
.obsidian/graph.json
.obsidian/appearance.json
.DS_Store
.DS_Store?
._*
.Spotlight-V100
.Trashes
*.tmp
*.temp
*.bak
*.swp
*.swo
*.
