背景
最近学习了 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
*.

