无需插件:用 GitHub 同步实现 AI 对话一键存入 Obsidian
分享一下我今天配置的这套方案:和 AI 对话后,可以一键存进 Obsidian。Claude Code、Codex、Hermes 这类 Agent 工具可以全自动写入。Claude App、ChatGPT 这类手机 App,复制内容后一键触发,两秒存好。搭一次,永久用。免费,不需要任何 Obsidian 插件。
先把逻辑讲清楚,小白也能看懂:Obsidian 的笔记库本质上是手机和电脑之间的一个 iCloud 同步文件夹,往这个文件夹写文件,手机就能看到。我们在这个文件夹上加一层 GitHub:AI 工具 ↓ 调用 GitHub API 写入文件 → GitHub 仓库 ↓ 电脑每 5 分钟自动拉取 → 本地 Obsidian 文件夹(iCloud)。
第一步:把 Obsidian 文件夹变成 git 仓库。打开终端,执行:cd ~/Library/Mobile\ Documents/iCloud\~md\~obsidian/Documents/Obsidian\ Vault;git init;git branch -M main。然后创建 .gitignore,排除 iCloud 产生的临时文件:echo "*.icloud .DS_Store .obsidian/workspace.json" > .gitignore。
第二步:推到 GitHub 去。建一个私有仓库,什么都不要勾,建好后执行:git add .;git commit -m "init";git remote add origin https://t.co/WKDMBX88ts你的用户名/obsidian-vault.git;git push -u origin main。推送时会要求登录 GitHub,按提示操作就行。
第三步:电脑每 5 分钟自动拉取。先建一个脚本:cat > ~/obsidian-pull.sh << 'EOF' #!/bin/bash cd "/Users/你的用户名/Library/Mobile Documents/iCloud~md~obsidian/Documents/Obsidian Vault" git pull origin main --no-rebase >> /tmp/obsidian-pull.log 2>&1 EOF;chmod +x ~/obsidian-pull.sh。
第四步:拿 GitHub Token,用来授权写入。进入 GitHub Settings → Developer settings → Personal access tokens → Tokens (classic),勾选 repo 权限,生成后复制,存到本地:echo "ghp_你的token" > ~/.obsidian-github-token;chmod 600 ~/.obsidian-github-token。
第五步:iOS 快捷指令,7 个动作。新建快捷指令,按顺序添加:① 接收共享表单中的输入(类型:文本);② 将文本编码(Base64,输入选「快捷指令输入」);③ 获取当前日期;④ 格式化日期(自定义格式:yyyyMMdd-HHmm);⑤ 文本(填你的 GitHub Token);⑥ 获取 URL 内容 → https://t.co/JHgC1OGQeL;⑦ 运行脚本(或触发 HTTP 请求)。
测试:快捷指令里随便输入一段文字,运行。然后终端执行:cd ~/Library/Mobile\ Documents/iCloud\~md\~obsidian/Documents/Obsidian\ Vault;git pull origin main。看到新文件出现,再打开手机 Obsidian 确认,链路就跑通了。
这套方案的真正价值不只是手动存对话。GitHub API 是标准接口,任何能发 HTTP 请求的工具都能写入:Hermes / Claude Code / Codex → 对话自动存入;任何脚本 → 一行 curl 搞定。