对接Obsidian知识库：让AI助手读你的笔记

为什么需要对接 #

我在微信上通过 AI 助手（Hermes Agent）协助处理各种任务——写代码、查资料、分析基金持仓。但有一个痛点：AI 不知道我脑子里的知识积累。

我平时用 Obsidian 管理所有学习笔记——网络安全知识点、渗透测试技巧、阅读摘录等等。如果能把这些笔记喂给 AI，它就能在回答问题时参考我的知识库，给出更贴合我学习进度的答案。

方案：Obsidian Git + GitHub #

架构很简单：

我的电脑 (Obsidian) 
    ↓ 自动推送 (Obsidian Git 插件)
GitHub 私有仓库
    ↓ git pull
腾讯云服务器 (Hermes Agent)
    ↓ 搜索/读取
AI 助手参考我的笔记回答问题

为什么选这个方案 #

实施步骤 #

第一步：创建 GitHub 私有仓库 #

AI 助手直接在服务器上通过 GitHub API 创建：

# 用 SSH 密钥认证创建私有仓库
curl -X POST -H "Authorization: token $(cat ~/.ssh/github_blog.pub)" \
  https://api.github.com/user/repos \
  -d '{"name":"my-obsidian","private":true,"description":"我的Obsidian知识库"}'

第二步：生成 SSH 密钥并添加到 GitHub #

（这一步之前已经做了，用于解决 GitHub HTTPS 被墙的问题）

ssh-keygen -t ed25519 -C "blog-server" -f ~/.ssh/github_blog
# 公钥添加到 GitHub Settings → SSH and GPG keys

第三步：在本地 Obsidian 中配置 #

1. 打开 Obsidian → 设置 → 第三方插件 → 关闭安全模式
2. 进入社区插件市场 → 搜索 “Obsidian Git” → 安装
3. 在插件设置中配置：
   • 备份间隔：10 分钟
   • 自动推送：开启
   • 提交信息模板：vault sync: {{date}}
4. 将仓库克隆到你的 Obsidian Vault 目录
5. 点击"创建备份"，验证同步是否成功

第四步：AI 助手接入 #

服务器端拉取知识库：

git clone git@github.com:tttjhgan/my-obsidian.git ~/obsidian-vault

之后 AI 就可以直接搜索和阅读笔记了。

使用场景 #

对接完成后，AI 助手能基于我的笔记做这些事情：

• 📖 答疑 — “根据我的笔记，讲一下SQL注入的绕过技巧”
• 📝 总结 — “把我最近一周的笔记整理成一篇博客”
• 🔗 关联 — “我笔记里提到过XX技术，帮我展开讲讲”
• 🎯 规划 — “根据我的学习进度，推荐下一个该学的方向”

注意事项 #

• 用私有仓库 — 笔记是很私人的东西，一定选 Private
• 不要记密码 — API Key、密码等敏感信息不要放进笔记
• Git 冲突 — 如果同时在手机和电脑上编辑同一篇笔记，可能会冲突，Obsidian Git 有自动合并机制

这篇文章记录了完整的知识库对接方案，等实际部署后再更新实战经验。