🧠

Obsidian+AI 蓝皮书 · 入门与接入

把 AI 接进 Obsidian 笔记库，打造会自动整理、写作、检索的第二大脑

📘 蓝皮书 · 入门

📘 Obsidian + AI 蓝皮书 · 入门与接入

目标：从没用过 Obsidian，到把 AI 接进你的笔记库、用一句中文让它帮你整理 / 总结笔记。全程 Obsidian 免费、数据本地、不用翻墙。

最省事的路：Obsidian 去 obsidian.md 免费下，AI 这一头直接用 U-King 一键配（帮你装好命令行 AI / ClawX + 接好国内算力，跳过下面的折腾）。下面是想自己动手 / 想搞懂原理的完整手册。

一、Obsidian 是什么，为什么要给它配 AI

Obsidian 是一款免费、本地、基于 Markdown 的笔记软件，很多人叫它「第二大脑」。它有几个新手要先明白的特点：

数据全在你本地：每条笔记就是一个纯文本 .md 文件，存在你自己电脑的一个文件夹里。这个文件夹 Obsidian 叫它「库（vault）」——记住：vault 说白了就是一个普通文件夹，这点是后面接 AI 的关键。
双向链接 + 关系图谱：笔记之间能用 [[双链]] 互相引用，自动连成一张知识网。
插件生态强：上千款社区插件，AI 插件也是其中一类。

那为什么要给它配 AI？ 因为 Obsidian 本身只是个「能记」的工具，记多了会乱、会忘、懒得整理。把 AI 接进来后，它能帮你：

「把我这个月的零散笔记自动归类、打标签、连双链」
「这篇长笔记太啰嗦，帮我提炼成 5 条要点」
「根据我库里关于『增长』的所有笔记，帮我写一篇文章」

一句话：Obsidian 负责存，AI 负责整理、写作、检索。两个一合体，才是真正的第二大脑。

⚠️ 新手最大的误区：以为 Obsidian 自带 AI。它不带。AI 是你自己接进去的，而且接法有两条路（见第三节），选对了配起来很简单。

二、装 Obsidian + 建第一个库

Obsidian 是第三方免费软件，U-King 不替你装它（也没必要），照下面三步自己装，一分钟搞定：

下载：打开官网 obsidian.md，点 Download，选你的系统（Windows 选 .exe），双击一路下一步装好。它免费、无需注册账号。
新建库（vault）：打开 Obsidian → 「Create new vault / 新建库」→ 给它取个名（比如 我的大脑）→ 选一个文件夹位置（建议放在好找的地方，比如 D:\Obsidian\我的大脑）。

💡 把这个文件夹路径记下来！ 后面让命令行 AI 整理笔记，就是让它进这个文件夹干活。想看它在哪：Obsidian 左下角「设置 → 关于」或库名上右键能看到路径。
随手记一条：库里点「新建笔记」，写两行字试试。你会发现这条笔记就是那个文件夹里多出来的一个 .md 文件——笔记 = 文件，这就是 Obsidian 能被 AI 直接读写的根本原因。

到这里，Obsidian 已经能用了。接下来是重点：怎么把 AI 接进去。

三、两条接 AI 的路子（选一条就行）

给 Obsidian 接 AI，主流就两条路。新手建议先看路子一（最强、最灵活），插件党再看路子二。

路子一（最强 · 推荐）：用命令行 AI 直接读写你的库

因为 vault 就是个文件夹，所以任何能读写文件夹的命令行 AI（Claude Code / Codex），都能直接在你的库里读、写、整理笔记——这是目前最强的玩法，能批量整理、改写、生成笔记，不受插件能力限制。

怎么做（U-King 已帮你把这些命令行 AI 装好接好）：

用 U-King 一键装好 Claude Code 或 Codex（具体安装见各自手册，U-King 里点一下就好）。
打开 U-King 内置终端（或系统 PowerShell），cd 进你的库文件夹：
```
cd D:\Obsidian\我的大脑
```
（把路径换成你第二节记下的那个）
敲 claude（或 codex）进入对话，用中文直接说：「帮我把这个文件夹里的笔记整理一下、打上标签」。它就能读你所有 .md 笔记、直接改、直接写新笔记。

✅ 为什么这条最强：它不只是「问答」，而是真能动手批量改你的笔记文件。整理几百条笔记、统一格式、自动加双链，命令行 AI 一句话就办了，插件做不到这个深度。

路子二（图形党 · 插件法）：在 Obsidian 里装 AI 插件，填一个模型 Key

不想用命令行、就想在 Obsidian 窗口里点点点？那就走插件路。常见 AI 插件有：

Copilot for Obsidian —— 在 Obsidian 里直接聊 AI、基于你的笔记问答、续写。
Smart Connections —— 自动发现笔记之间的关联、做语义检索（轻量 RAG）。
Text Generator 等续写类插件。

装法（以 Copilot 为例）：

Obsidian → 「设置 → 第三方插件 / Community plugins」→ 关掉「安全模式」→ 「浏览 Browse」→ 搜 Copilot → 安装并启用。
进该插件的设置页，找到「API Provider / 模型服务商」和「API Key」两个框。
填一个模型 Key（怎么拿见第四节）。多数插件支持「自定义 OpenAI 兼容地址」，把地址 + Key 填进去即可。

💡 ClawX 也是一条路：如果你用 U-King 装了 ClawX（图形界面全能 AI），可以让它读取你的笔记文件做问答 / 写作，等于给 Obsidian 配了个外挂大脑，省去在插件里折腾 Key。

怎么选？ 想批量整理改写笔记 → 路子一（命令行 AI）；想在笔记里随手聊、续写 → 路子二（插件 / ClawX）。两条不冲突，可以都配上。

四、配模型：让 AI 真的能动（不用登录 OpenAI）

不管走哪条路，AI 背后都得接一个能用的模型。命令行 AI 由 U-King 直接接好；插件路则要你拿一个 Key 填进去。国内用户别去折腾 OpenAI 官方额度——下面两条路任选：

路线 A（推荐 · 免折腾）：虾盘云内置驱动

U-King 自带的 虾盘云 驱动，开箱即用、国内直连、不用注册任何第三方账号：

U-King「AI 设置」选 虾盘云，它用本机设备 Key 自动配好，无需手填。命令行 AI（Claude Code / Codex）和 ClawX 直接就能动。
余额不足点「充值」，扫码即到账。¥1 ≈ 50 万 token，充值/查看余额。

一个 Key 同时供 Claude Code（DeepSeek-V4 Pro 满血）和 Codex（GPT-5.3-Codex），整理笔记、AI 写作都走这一个，不用分别注册。如果走插件路想用虾盘云的地址 + Key，可在 U-King「AI 设置」里复制出兼容地址，填进插件的「自定义 API」。

路线 B（想用官方 / 自己的 Key）

Obsidian 的 AI 插件大多支持「OpenAI 兼容」地址，可以填任何国产模型的 Key。常见国产可用模型：

平台	特点	申请页
DeepSeek	国内最便宜、速度快	platform.deepseek.com
智谱 GLM	常有免费额度	open.bigmodel.cn
Kimi	超长上下文、适合长笔记	platform.moonshot.cn

通用四步：注册 → 实名认证（绕不过，先做） → 创建 Key（sk- 开头，多半只显示一次，立刻存好）→ 填进 Obsidian 插件的「API Key」框（服务商选 OpenAI 兼容、地址填该平台的 base URL）。想省事就直接用路线 A 的虾盘云。

五、跑通第一个 AI 任务：让 AI 整理一篇笔记

我们用**最强的路子一（命令行 AI）**跑一个完整例子。先在你库里随便准备一篇乱糟糟的笔记（比如一段开会记的流水账）。

打开 U-King 内置终端，cd 进你的库文件夹，敲 claude（或 codex），用中文说：

把当前文件夹里的 会议记录.md 整理一下：提炼出「结论」「待办」「风险」三块，加上合适的标签（用 #tag 格式），并在末尾用双链 [[ ]] 关联到相关主题。改好直接存回这个文件。

AI 会读这篇笔记、重写得清清楚楚、加好标签和双链、存回原文件。回 Obsidian 一看——笔记已经整整齐齐。这就是第二大脑的第一次心跳。

想先小试不改原文？把最后一句换成「先别改原文，把整理后的内容贴给我看」。确认满意再让它落盘。

进阶玩法（自动打标签、AI 写作、把网页/视频/PDF 喂进来生成读书卡、PARA/卡片盒、私人知识库 RAG、变现）全在 📕 红皮书。

六、常见问题 TOP5

1. Obsidian 自带 AI 吗？要在哪买？

不自带。 Obsidian 只是免费笔记软件，AI 是你自己接进去的。最省事：用 U-King 把命令行 AI / ClawX 装好接好国内模型，Obsidian 去 obsidian.md 免费下。不用在 Obsidian 里「买 AI」。

2. 让命令行 AI 改我的笔记，会不会把库改坏 / 丢数据？

笔记是纯文本文件，强烈建议先给库开版本备份：要么用 Obsidian 的「Sync / 同步」，要么把整个库文件夹用 Git 管理，要么干脆先复制一份备份。这样 AI 改坏了随时还原。第一次用可以先让它「只贴给我看、先别改原文」，确认靠谱再放手。

3. 插件里填了 Key 却连不上 / 报错？

九成是三件事填错：① 服务商没选对（国产模型多数要选「OpenAI 兼容 / Custom」）；② API 地址（base URL）填错或漏了；③ Key 复制时带了空格 / 不完整。对着第四节的申请页核对，或直接改用虾盘云（U-King「AI 设置」复制兼容地址 + Key）。

4. 命令行 AI 找不到我的笔记 / 说文件夹是空的？

多半是没 cd 进对的库文件夹。先确认库的真实路径（Obsidian 库名右键 / 设置→关于里看），在终端 cd 进去，再敲 claude / codex。路径里有中文或空格记得用引号包起来，例如 cd "D:\我的笔记库"。

5. 数据会不会被上传 / 泄露？

Obsidian 的笔记始终存在你本地。接 AI 时，只有你主动发给 AI 的那部分内容会走模型 API（用于让它理解和处理），库本身不会被整体上传。涉密笔记可以只让 AI 处理脱敏后的内容，或在红皮书里用本地模型方案。

接好了？继续看 👉 📕 红皮书 · 6 大实战玩法与变现

卡住了扫码加微信，1v1 帮你搞定：

$加微信$

u-king.org · 谁火装谁，装完教会用

⬇ 用 U-King 一键安装 Obsidian + AI（免环境配置）

📕 看红皮书（进阶实战与变现） · u-king.org 学院

U-King 学习盘 · 谁火装谁，装完教会用 · 内容持续更新