从0到1 构建AI 知识工作流，Obsidian笔记入门

各位看官今天来聊 Obsidian ，学完你也可以拥有一个第二大脑！

先说结论：笔记软件用过一圈，有道云、Notion 都用过，折腾到最后，所有笔记搬进了一个本地文件夹。

笔记应该是文件，不是别人服务器上的一行数据。

它就是你的「第二大脑」。

不过第二大脑不是仓库。什么都往里扔，扔到几百篇，搜也搜不动、翻也翻不到，最后只能放弃。堆进去不算数，能翻出来、能用上，才算数。

25年初，AI 能读本地文件了开始普及。 这意味着整理这件事可以交给 AI 了。但怎么整理、按什么规矩整理，主动权还是得留在自己手里。这篇的第八章和第九章讲这个。

目录

• 一、Obsidian 到底是什么 —— 一个文件夹，加一层 UI
• 二、下载安装，建第一个库 —— 装完别急着配，先写第一条笔记
• 三、界面和三个真正有用的功能 —— 双链、标签、全文搜索
• 四、笔记规范：frontmatter 五个字段 —— 让笔记对人可读、对 AI 可查
• 五、插件：起步只装两个 —— 装二十个插件是最大的坑
• 六、目录结构与入口笔记 —— 十个顶层目录，五十八篇入口
• 七、日记与模板 —— 真正让人坚持下来的那一环
• 八、让 AI 接管整理 —— 前提、边界、和三层架构
• 九、几个能直接用的 AI 工作流 —— 日记周报、读书笔记、调研、写作
• 十、常见坑 —— 九个，每一个都有代价
• 十一、问题答疑 —— 十二问

一、Obsidian 到底是什么

一个把 Markdown 纯文本文件当笔记来用的软件。

每一篇笔记，就是硬盘上一个 .md 文件，用记事本都能打开。Obsidian 做的事只有一件——给这堆文件加了一层界面：双链、图谱、搜索、插件。

这跟云笔记是根本区别：

|  | 云笔记（Notion / 有道云） | Obsidian |
| 数据在哪 | 厂商服务器 | 自己的硬盘 |
| 文件格式 | 私有格式 | Markdown 纯文本 |
| 断网能用吗 | 不能 | 能 |
| 厂商倒了 | 笔记可能没了 | 文件还在 |
| 迁移 | 导出困难 | 直接拷文件夹 |
| AI 能不能直接读 | 要走 API，受限 | 能，就是个文件夹 |
| 上手难度 | 低 | 中 |
| 费用 | 免费额度 + 订阅 | 个人免费 |

光看前五行，Obsidian 只是「更放心」。第六行才是这两年的分水岭。

为什么AI 能不能直接读是关键

AI 能整理笔记的前提只有一个：它得碰得到这些文件。

• Apple Notes、印象笔记：格式私有，AI 摸不到。
• Notion：只能走 API，受权限、速率、格式转换三重限制。
• 本地 Markdown 文件夹：AI 直接读写，不需要 API、不需要认证、不需要网络请求。

这不是体验好坏的区别，是能做和不能做的区别。

Markdown 为什么适合喂给 AI

三条，都是可验证的：

第一，省 token。 同样一段信息，Markdown 比 JSON、XML 少 30% 到 50% 的 token。省下来的都是上下文空间。

第二，结构天然清晰。 ## 就是标题、> 就是引用、三个反引号就是代码块——这些符号本身就是分隔线，AI 不用猜哪里是哪里。

第三，AI 的默认输出格式就是 Markdown。 它写起来顺手，读起来也顺手。

有个数字值得记住：20 万 token 的上下文大约能装 50 到 80 万字的 Markdown。 一篇笔记撑死几千字，所以个人知识库这个量级，AI 一次能读的量远超需要。

一个旁证

2026 年前后，三个互不相关的项目不约而同把 Markdown 当成了 AI 的记忆层：

| 项目 | 记忆存在哪 |
| Manus（AI Agent 公司） | task_plan.md、notes.md |
| OpenClaw（开源 Agent 框架） | MEMORY.md、SOUL.md |
| Claude Code（Anthropic） | CLAUDE.md、memory/ 目录 |

不是向量数据库，不是 SQL，不是 JSON。就是 Markdown 文件。

专有名词扫一遍

Vault / 库     一个文件夹就是一个库，所有笔记都在里面
Markdown       一种纯文本标记语法，用 # 表示标题、** 表示加粗
双链 [[ ]]      用 [[笔记名]] 链接到另一篇笔记，双向可追溯
Backlinks      反向链接：哪篇笔记链接了这篇，自动列出来
Frontmatter    笔记开头的 --- 包裹的属性区（标题、标签、日期）
附件            图片、PDF 等，放在专门的附件目录
Callout        引用块的特殊写法，带类型和折叠
插件            官方核心插件 + 社区插件，功能靠插件长出来

简单记忆版：

📁 Vault        → 一个文件夹
📝 Markdown     → 纯文本写笔记
🔗 双链          → 笔记之间连线
🏷️ Frontmatter  → 给笔记打属性
🧩 插件          → 按需长出功能
🤖 AI 可读        → 因为它是纯文本

官网：https://obsidian.md

二、下载安装，建第一个库

打开 obsidian.md，下载对应平台的客户端。

全平台免费，无注册、无账号、无试用期。 装完打开，它只问一件事：选一个文件夹当库。

已有的 Markdown 文件夹可以直接选，Obsidian 不会改动里面任何文件，只会在根目录多出一个 .obsidian/ 配置目录。

库放哪儿：这里有个坑

别把库放在 iCloud、坚果云、OneDrive 这类实时同步目录里。

原因很直白——同步盘和 Obsidian 会同时读写同一批文件，容易冲突。轻则生成一堆「冲突副本」，重则笔记内容损坏。

推荐位置：

要跨设备同步，三种方案：

• 官方 Obsidian Sync —— 最省事，付费
• Git —— 免费，有完整版本历史，适合愿意碰命令行的
• 手动备份 —— 定时把整个文件夹单向拷到移动硬盘或网盘（只拷，不双向同步）

手机端也装一个，在外面记灵感用，回头再归位。

装完先改两处设置

第一，语言改成中文：设置 → General → Language → 简体中文。

第二，立即行动，先把第一条笔记写了。

这一条比看起来重要。不要在还没写够五十条笔记的时候，花三个小时设计标签体系和文件夹结构。

一个反直觉的事实：笔记系统应该从笔记里长出来，不是从设计图纸里长出来。 一开始就设计完美体系的人，绝大多数在两周内放弃——因为体系撑不住现实，改又懒得改，最后干脆不写了。

先写一百条，再回来定规矩。

三、界面和三个真正有用的功能

界面就三块：

┌──────────┬────────────────────┬──────────┐
│  左侧栏   │       编辑区        │  右侧栏   │
│  文件树   │    写笔记的地方      │ 反链/大纲 │
│  搜索     │                    │ 标签      │
└──────────┴────────────────────┴──────────┘

必背的快捷键

学这几个就够，别一次背完：

Ctrl/Cmd + N          新建笔记
Ctrl/Cmd + O          快速切换笔记（比鼠标点文件树快十倍）
Ctrl/Cmd + P          命令面板（忘了快捷键就搜）
Ctrl/Cmd + Shift + F  全局搜索（支持正则）
Ctrl/Cmd + E          编辑 / 预览模式切换
Ctrl/Cmd + D          打开当天日记（需先开 Daily Notes）
Ctrl/Cmd + B          加粗
[[                    输入两个方括号，自动弹出笔记补全

注意两个容易搞混的：快速切换是 Cmd+O 不是 Cmd+P；命令面板是 Cmd+P。从 VS Code、Cursor 过来的人几乎都会按错一次。

Markdown 速查

会这几个就能写 90% 的笔记：

# 一级标题        ## 二级标题        ### 三级标题
**加粗**          *斜体*            ~~删除线~~
- 无序列表        1. 有序列表
> 引用
`行内代码`        ```            代码块

| 表头 | 表头 |                      ← 表格
- [ ] 待办        - [x] 已完成
[[笔记名]]                          ← 双链
![[图片.png]]                       ← 嵌入图片
---                                 ← 分隔线

两个和普通 Markdown 不一样的地方，值得单独记：

[[笔记名]] 和 ![[图片.png]] 是 Obsidian 专有语法，标准 Markdown 里没有。前者建双链，后者嵌入图片或另一篇笔记的内容。

这个区别在 AI 协作时会咬人。 通用 AI 默认用 [文字](链接) 的写法，如果不告诉它，它会把双链写成普通链接，Obsidian 就认不出来了。解决办法在第八章讲——装一个官方的 obsidian-skills，让 AI 知道该用哪种写法。

功能一：双向链接

输入 [[，弹出搜索框，选一篇笔记，回车。

关键细节：链接到一篇不存在的笔记时，Obsidian 会直接创建一个空白笔记等着。 也就是说可以先把链接建好，内容以后再填——这个顺序反过来更符合真实写作：写到一半想起一个概念，先把钩子挂上，回头再补。

笔记下半部分会出现 Backlinks 面板，列出所有链接到这篇的其他笔记。

为什么这个功能对 AI 时代特别重要：AI 可以沿着链接遍历。 让它写一篇关于 RAG 的文章，它读到 RAG 笔记里链了 [[向量数据库]] 和 [[embedding]]，会自己顺着去读这两篇，拿到的上下文完整得多。靠 grep 搜关键词，是碰运气；靠链接遍历，是确定路径。

功能二：标签

一条笔记只能待在一个文件夹里，但可以打任意多个标签。标签不需要提前定义，Obsidian 自动收集所有出现过的标签。

标签解决的是多维分类问题。一篇讲「用 AI 做跨境电商选品」的笔记，放 AI/ 还是放 电商/ 都不对——打 #AI #跨境电商 两个标签就都覆盖了。

功能三：全文搜索

Cmd+Shift+F，支持正则表达式，支持按标签、文件夹、时间范围筛选。

三者合起来是一条公式：

双链（明确关联）+ 标签（多维分类）+ 全文搜索（模糊发现）= 笔记找得到、用得上。

图谱：定位是体检工具，不是装饰

Cmd+P 输入 graph 打开。三种读法：

• 被很多笔记链接的节点 → 核心概念，值得单独完善
• 边缘孤岛 → 该建链接但还没建的
• 意外的集群 → 隐藏的联系，往往是新想法的来源

每周花五分钟扫一眼就够了。 别指望每天盯着它看能带来什么——图谱是体检报告，不是健身器材。

四、笔记规范：frontmatter 五个字段

从这一节开始，讲的是让笔记对 AI 也友好的写法。人看得懂不够，还得让 AI 三秒钟判断出这条笔记讲什么、要不要读全文。

基本模板

每篇笔记开头：

---
title: 笔记标题
tags: [tech, reference]
created: 2026-09-28
type: permanent
summary: 一句话说清这篇讲了什么
---

五个字段，各有用处

| 字段 | 作用 | 对 AI 的意义 |
| title | 笔记标题 | 语义搜索的关键信号 |
| tags | 主题分类 | 批量筛选某个领域的笔记 |
| created | 创建日期 | 判断时效性（AI 领域三个月前的信息可能已过时） |
| type | 笔记类型 | 决定处理策略（永久笔记细读，闪念笔记可跳过） |
| summary | 一句话摘要 | 不读全文就能判断相关性 |

四条硬规则

一、tags 用英文。

Obsidian 原生支持中文标签，但英文标签在命令行工具的 grep 搜索里表现更稳定。用 #AI 而不是 #人工智能，用 #reading-notes 而不是 #读书笔记。

二、created 用 ISO 格式。

2026-09-28，不要写「9 月 28 日」或「September 28, 2026」。ISO 是唯一没有歧义的写法，排序也天然正确。

三、type 只用三个值。

fleeting      闪念，随手记的，AI 可跳过或帮忙整理
literature    文献，读来的，AI 帮忙提要点、建关联
permanent     永久，自己消化过的，AI 生成内容时优先参考

分类越细，维护成本越高，越容易放弃。

四、summary 一句话，30 到 80 字。

写法技巧：假设朋友问「这条笔记讲啥」，会怎么用一句话回答。

例：对比了 RAG 的三种检索策略（向量 / 关键词 / 混合），结论是混合检索在大多数场景下效果最好。

写不出一句话摘要的笔记，可能本身就该拆成两篇。

给老笔记补 frontmatter

不需要手工补。让 AI 批量处理：

读取 vault 里所有没有 frontmatter 的 Markdown 文件，
按内容生成 title、tags、created、type、summary 五个字段，
不确定的一律标成 type: fleeting，最后给一份处理清单。

加一张术语表

同一个概念，一条笔记写「RAG」，另一条写「检索增强生成」，第三条写「retrieval augmented generation」——AI 搜「RAG」只会命中第一条。

解决办法：库根目录放一个 glossary.md，列出标准用词，写清楚「统一用 A，不用 B」。

仓库里的 CLAUDE.md 也可以写一份同样用途的清单，AI 每次启动自动读。

五、插件：起步只装两个

先开这两个核心插件

设置 → 核心插件：

• 日记（Daily Notes） —— 每天自动创建以日期命名的笔记
• 模板（Templates） —— 一键套用模板

日记是整个笔记系统里摩擦力最低的入口——不用想标题、不用选文件夹、不用决定放哪。点一下就有一篇当天的笔记等着。

模板的意义不止省事。结构一致的笔记对 AI 极其友好——AI 读到就知道「核心观点」在第几段、「想法」在第几段，不需要每次重新理解版式。

其余核心插件

文件列表 · 全局搜索 · 快速切换 · 图谱 · 反向链接
标签面板 · 属性 · 页面预览 · 命令面板 · 大纲
字数统计 · 文件恢复 · 同步 · 笔记合成

社区插件：分三档

设置 → 第三方插件（先关闭安全模式）。

必装的，零个。 真的。先用两个月，哪里痛了再装对应的。

想清楚再装的三个：

| 插件 | 什么时候需要 |
| Templater | 模板要跑变量或脚本时（比自带模板强） |
| Calendar | 右侧栏要一个月历，点日期直接开当天日记 |
| Dataview | 想把库当数据库查，用类 SQL 语法筛笔记 |

AI 相关的，看情况装：

| 插件 | 干什么 |
| Smart Connections | 语义搜索。搜「投资」也能找到写了「资产配置」的笔记；侧边栏自动推荐语义最近的笔记 |
| Copilot for Obsidian | 直接对库提问，基于自己的笔记回答，标注引用来源 |
| Obsidian Git | 定时自动 commit，比如每 30 分钟一次 |

最大的错误：一上来装二十个插件。

装完发现一个都不会用，笔记没写几篇，库先卡了，侧边栏挤满图标，快捷键还互相冲突。

工具是用来干活的，不是用来搭的。先写一百篇，再回来挑插件。

资料怎么进来

笔记不会凭空长出来，第一道工序是「把外面的东西弄进库」。

网页文章：官方有 Obsidian Web Clipper（浏览器扩展），点一下把正文抓成 Markdown 存进库。 扩展Obsidian Web Clipper地址：https://chromewebstore.google.com/detail/obsidian-web-clipper/

选它而不是随便一个剪藏工具的原因：它输出干净的 Markdown，不是富文本。 富文本粘进库会带一堆内联样式，把纯文本库污染掉。

微信文章：微信没有对外接口，一般靠第三方剪藏工具转存，或者手动复制正文。复制完记得删掉「点击上方蓝字关注」那几段，那些会污染 AI 的检索结果。

推特 / X 收藏：可以用脚本批量导出成 Markdown，每条一个文件，打上作者标签。

三条规矩，比工具选择重要：

一、进来先进 Inbox，不要直接归到最终位置。 归位是要花脑子的，剪藏的时候没那个脑子。分开做。

二、收藏不等于知识。 剪藏夹里躺着一千篇文章，不等于学到一千篇。定期清 Inbox，处理完才移到 01 资料仓库。

三、AI 可以帮忙清。 攒了太多没处理的，直接让它读一遍，按主题分组、写摘要、移到合适的位置。这正好是第八章那个整理流程的第一次练习——从低风险的剪藏开始，比一上来就动自己的原创笔记稳妥。

六、目录结构与入口笔记

这一节开始讲组织方式。Obsidian 用得废不废，八成取决于这一节。

十个顶层目录

不一定按这个来，你可以让AI 创建一个适合你的，我的起初让AI 创建的。

当前我的仓库库顶层结构：

00 Inbox          收件箱，想法先扔这，未整理的文件
01 资料仓库        别人的：推特收藏、微信收藏、豆瓣收藏、网页剪藏
02 个人知识        自己的：出海、AI、沟通、财务、自我认知、自媒体
03 工作资料        简历、客户、项目、会议、任务
04 附件           图片、PDF
08 转译           翻译、转译
09 原创           自己写的文章
98 模板           模板文件
99 归档           不用了但不删的
100 日记          每日记录

为什么用数字编号

这是个从工程里学来的土办法：

文件管理器按名字排序，数字永远排在汉字和字母前面，顺序就不会乱。

而且中间留了空——08 之后直接跳到 98。98、99、100 是「元目录」：模板、归档、日记，这三样跟「内容」不是一回事，所以放最后，永远垫底。

核心土办法：入口笔记

十一个目录里，藏了 58 篇叫「XX入口」的笔记。

规则只有一条：

每个目录都有一篇叫「XX入口」的笔记，它只干一件事——把这一层列出来，链到下一层。

比如 首页.md 链到所有总入口，02 个人知识入口 再链到出海、AI、沟通、自媒体……

它解决的是笔记软件最要命的问题：东西一多就找不到。

大部分人用 Obsidian 是怎么废的？——什么都往里扔，扔到三百篇，搜也搜不动，翻也翻不到，最后放弃。

入口笔记让「从哪开始看」永远有一个确定答案，而不是每次靠搜索碰运气。

当前库里 556 篇笔记，从首页点三层以内必到。

首页怎么写

首页.md 就四块：

一、今天先用这三个入口     ← 最常用的三个，放最上面
二、其他入口               ← 剩下全部的入口链接
三、当前阶段               ← 这个月重点做什么
四、每天使用规则           ← 什么东西该放哪，写死

第三块特别有用——「当前阶段」写一句话，每隔几天就知道自己该干嘛，不用重新想。

这套结构对 AI 也是最优解

一个文件夹里有五十个文件，AI 进来要逐个扫描才知道哪个重要。

如果放一个 index.md——三五行，写清楚这个文件夹是干什么的、关键文件是哪几个——AI 读这一个文件，三秒就懂了。

入口笔记和 index.md 是同一个东西的两个视角：对人，它是导航；对 AI，它是索引。

有个做法值得抄：入口笔记不要手写，让 AI 批量生成。 这本身就是一次很好的协作练习——把整个库交给它，看它怎么理解结构。

七、日记与模板

目录是骨架，入口是地图，但真正让人坚持下来的，是日记。

设置

设置 → 日记：

日期格式    YYYY-MM/YYYY-MM-DD    ← 自动按月份文件夹分类
存放位置    100 日记
模板文件    98 模板/日记模板

每天打开 Obsidian，点一下日历，当天笔记自动生成。不用想文件名，不用想放哪。

个人模板参考

## 今日要事
- [ ] 
- [ ] 
- [ ] 

## 作息
- 睡：　　起：

## 记录
- 

## 数字
- 发文/视频：
- 冷触达：
- 粉丝：
- 收入：

## 想法 / 灵感
- 

## 明日或计划
- 

把八月的 27 篇日记逐天打标复盘，记录方式错了，比不记录还糟。

八、让 AI 接管整理

前面七节讲的都是「怎么自己记」。从这一节开始讲「怎么让 AI 帮着整理」。

先把边界划清楚，不然很容易走偏。

三代方案，各自的缺陷

笔记整理这件事，历史上试过三代方案，每一代都把整理的责任压在人身上：

| 方案 | 缺陷 |
| 文件夹 | 一条笔记只能属于一个主题。「用 AI 做跨境电商」放哪个文件夹都不对 |
| 标签 | 维护成本极高，而且不一致比没有更糟——#AI、#人工智能、#ai 混着用，等于没有标签 |
| 双向链接 | 前提是得记得去链接。手动给每篇笔记的人名、书名加双链，每天十几分钟，坚持不下来 |

三代方案的共同点是：整理这件事，靠的是纪律，而纪律是消耗品。

第一周精心打标签，第三周开始扔进「待整理」，第三个月「待整理」里有二百条。

新的分工

AI 能读写本地文件之后，分工可以变：

人负责记录、思考、决策；AI 负责整理、关联、检索、维护。

注意这里没有说「AI 负责判断」。判断权不能交出去，这是后面所有内容的前提。

怎么连上

不需要插件，不需要 API，不需要 MCP。两行命令：

cd ~/Documents/MyVault      #进入库目录
claude                       #启动

启动后自动获得整个库目录的读写权限。因为库就是一个文件夹，不需要任何配置。

第一件事先做个冒烟测试，确认连接正常：

这个 vault 里有什么？概览一下。

装 obsidian-skills，让 AI 懂 Obsidian 的语法

通用 AI 默认只会标准 Markdown。它不知道 [[双链]] 是什么，会把 callout 拆散，可能把 frontmatter 的 YAML 格式改坏。 也可以不装跳过到下一节，现在的AI 能力基本都能识别了！

Obsidian 的 CEO（网名 kepano）在 2026 年 1 月发布了一组官方 Skills 解决这个问题，包含四个：

| Skill | 管什么 |
| obsidian-markdown | [[wikilinks]]、callout、frontmatter |
| obsidian-bases | .base 数据库文件 |
| json-canvas | .canvas 白板文件 |
| defuddle | 网页内容清洗——存进库之前去掉广告、导航栏，省 token |

装完 AI 就知道：遇到 [[ ]] 不要当普通链接处理，遇到 callout 不要拆散结构，遇到 frontmatter 要保留 YAML 格式。

全篇唯一一个敢说「必装」的东西，因为它修的是「AI 会把格式搞坏」这个硬伤，而不是锦上添花。

装法按官方仓库的说明来（这类工具迭代快，命令以仓库 README 为准）。

三种工具各管什么

这是最容易搞混的地方。三样东西不是「都用上就好了」，它们各管一件事：

| 工具 | 管什么 | 回答的问题 |
| 文件夹 | 生命周期 | 这个东西处于什么阶段？ |
| 标签 | 主题 | 这个东西属于什么领域？ |
| 双链 | 关系 | 这个概念和哪个概念有直接关联？ |

三个例子说清楚：

文件夹：进行中的放 projects/，完成的移 archive/。不要用文件夹做主题分类——「AI」文件夹、「投资」文件夹这种不要建，因为「用 AI 做量化交易」放哪都不对。

标签：一条笔记可以打多个。保持克制，一级标签不超过 20 个，嵌套标签（#AI/RAG）不超过两层。

双链：比标签精确。标签说「这两篇都关于 AI」，双链说「这篇引用了那篇里的一个具体观点」。

最常见的错误是只用一种。 只用文件夹 → 无法多维分类；只用标签 → 没有直接关联；只用双链 → 没有全局视图。

CLAUDE.md：给 AI 的员工手册

库根目录放一个 CLAUDE.md，AI 每次启动自动读。四块内容：

1. 身份与领域       身份、关注领域、偏好（三五行）
2. vault 怎么组织   文件夹结构、命名规范、各区域用途
3. 行为边界         什么能动、什么不能动
4. 笔记模板         新笔记长什么样、frontmatter 有哪些字段

第 3 块是最重要的，写清楚红线：

可以：添加标签、创建 [[双向链接]]、生成摘要、整理和分类
不可以：删除已有笔记内容、修改原始记录

这份手册不要一上来就写完美。 有个更实际的用法：

AI 每犯一个错，就往里加一条规则。

规则库是从错误里长出来的，不是设计出来的。写三个月，它自然会变成一份贴合实际工作流的说明书。

三层架构：raw / wiki / output

这个三层架构稍微复杂，意思是其他目录用来放手动整理的，这个三层架构呢，放AI生成的。最好做到人的原始笔记和 AI 的产出分开放。

这是把「AI 整理笔记」从零散操作变成持续系统的关键设计。

vault/
├── raw/        原始素材。只增不改，这是事实来源

├── wiki/       AI 读 raw 后写的结构化文章
│   ├── concepts/    概念页
│   ├── entities/    实体页（人物、产品、组织）
│   ├── topics/      主题页
│   └── INDEX.md
├── output/     基于 wiki 生成的报告、分析
├── SCHEMA.md   规范文件
└── CLAUDE.md

三层的规矩不一样：

• raw/ —— 丢进来的一切原始素材，只增不改。「买回来的食材不要动，加工在厨房里进行。」
• wiki/ —— AI 读 raw 之后写的结构化文章，主要由 AI 维护，人可以修正。这是整个系统的价值所在。
• output/ —— 基于 wiki 生成的产物。好的 output 可以反哺 wiki——分析里产生了新洞察，就更新回对应的 wiki 文章。

一个容易忽略的地方

「AI 全权维护知识库」听起来很爽，但有个问题：AI 写的东西可能过时，可能有错，混久了分不清哪些是原始记录、哪些是 AI 生成的。

所以上面的结构里有一条容易被忽略但很重要的规矩：

人的原始笔记和 AI 的产出，必须分开放。

两个原因：

1. 信任度不同。AI 内容可能有幻觉、可能过时。
2. 处理策略不同。原始笔记是源数据，不能随意改；AI 产出是衍生数据，随时可以重新生成。

做法：文件夹分开（notes/ vs ai-output/），或者文件名加前缀（_ai-）。并且在 CLAUDE.md 里写明两边的修改权限。

整理可以交出去，判断得留在自己手里。AI 帮忙整理没问题，别把判断也一起交出去。

整理旧笔记的实际操作

把散乱笔记扔进一个目录，然后：

扫描 unsorted/ 目录下的所有 Markdown 文件，为每个文件：
1. 添加 frontmatter（title、tags、created、summary）
2. 根据内容主题，移动到合适的文件夹
3. 搜索 vault 中其他笔记，添加相关的 [[双向链接]]
4. 生成一份整理报告，保存到 unsorted/整理报告.md

注意：
- 不要删除任何内容，只添加结构
- 如果不确定分类，放到 inbox/ 并在报告中标注
- tags 根据内容自动生成，不超过 5 个

三条护栏都写在 prompt 里了，这不是啰嗦——是踩过坑才知道要加的：

• 「不要删除任何内容，只添加结构」
• 「不确定的放 inbox 并标注」
• 「分批处理」

关于分批：有上千个旧文件的话，每次处理 100 到 200 个，每批审查质量再下一批。这样能在过程中修正 AI 的分类逻辑，后面的批次会越来越准。

给 AI 上一道保险：Git

让 AI 一次动几十个文件，没有退路是不敢放手的。Git 提供的就是退路。

它给三样东西：

• 完整改动历史 —— 任何时候能回到之前的状态
• git diff —— 精确看到 AI 到底改了什么，比逐个打开几十个文件快得多
• 放手的底气 —— 敢说「把这五十篇笔记的目录结构重新组织一下」

初始化：

cd ~/Documents/MyVault

# 先写 .gitignore，把布局文件排除掉
cat > .gitignore <<'EOF'
.obsidian/workspace.json
.obsidian/workspace-mobile.json
EOF

git init
git add -A
git commit -m "初始化 vault"

日常就三条：

git status                      #看改了哪些
git diff                        #看具体改了什么（审查 AI 的改动主要靠这条）
git add -A && git commit -m "AI 整理了读书笔记"

改坏了想退回上一次提交：

git checkout -- .               #丢弃所有未提交的改动

每次让 AI 做批处理之前，先 commit 一次。这样出问题时，回退的代价是一条命令，而不是一个下午。

不想碰命令行的话，装 Obsidian Git 插件，设置成每 30 分钟自动 commit 一次。

多设备与多个库

多设备：库本身放本地，跨设备靠同步。官方 Sync 最省事（付费），Git 免费但要手动 pull/push。

多个库：可以把工作和个人分成两个库。好处是换工作时工作库留下，个人库永远跟着走，也避免公司机密和个人日记混在一起。

但有四个限制要知道：

• 双链不能跨库。两个库之间的笔记互相链不上。
• 配置不共享。每个库有独立的 .obsidian/，插件和主题要分别设。
• AI 一次只能操作一个库（一个工作目录），切换要 cd。
• 每个库可以有自己的 CLAUDE.md，工作库的规则可以更严格。

建议：一开始就用一个库。等到确实觉得「这两类内容不该放一起」时再拆，过早拆只会增加管理成本。

要不要上向量数据库

这是被问得最多的问题。直接给结论：

• 10 万字以内：wiki/ + INDEX.md + AI 直读，不需要向量数据库
• 10-40 万字：同上，wiki 目录按主题细分，不需要向量数据库
• 40-100 万字：加语义搜索插件辅助，可选
• 100 万字以上：配合 RAG 做语义检索，需要

40 万字以内完全不需要。原因在第一节说过：20 万 token 大约能装 50 到 80 万字 Markdown。

而且 AI 不需要一次读完所有 wiki——它先读 INDEX.md 知道有哪些文章，再按当前问题有针对性地读相关几篇。跟人查百科全书一样，先看目录，再翻到对应页面。

九、几个能直接用的 AI 工作流

下面五个，都不增加额外负担。注意最后一列。

• 日记 → 周报：人照常写日记；AI 汇总、提炼、成文；每天多花 5 分钟
• 读书笔记：人照常读书划线；AI 结构化、关联已有笔记；0（读书时顺手）
• 调研积累：人照常收集资料；AI 整合成 wiki 文章；0（调研时顺手）
• 写作：人一句话说选题；AI 搜库、找素材、出初稿；0
• 自动加双链：人照常写；AI 识别实体、建链接；0

一、日记 → 每周回顾

门槛最低，只试一件事就从这里开始。

平时照常在日记里写几行——每天五分钟，不要写长篇，写长了撑不过两周。格式随意，不需要结构化。

周末在终端里：

读取 100 日记/ 下本周的所有日记，生成一份周报：
1. 本周主要做了什么（按项目分类）
2. 值得记住的想法和洞察
3. 下周可以跟进的事情
保存到 weekly/2026-W39.md

年底可以让它读整年的日记或周报，生成年度回顾——做了几个项目、最频繁思考的话题、哪些想法反复出现。

日记最大的价值不在于回顾，在于积累。今天随手写的一个想法，可能三个月后写文章时被搜出来当素材。

二、读书笔记

读书时随便划线，读完把划线和批注原样粘贴成一个文件，不用整理。

读取 反脆弱-原始标注.md，生成结构化读书笔记：
1. 这本书的核心论点（3-5 个）
2. 每个论点的关键论据和例子
3. 批注中表达的反应和想法（保留原味，不要改写）
4. 这本书和 vault 中已有的哪些笔记有关联（搜索一下 vault）
保存到 books/反脆弱.md，并用 [[双向链接]] 链接到相关概念。

最后一步是关键。AI 会搜索整个库，自动把已有的相关笔记关联起来——每一本书不再是一个孤岛，它被织进了整个知识网络。

三、调研积累

用得最多的一个。

调研时把原始材料（文章、产品文档、真实评价）丢进 raw/，然后：

读取 raw/ 下所有关于 Obsidian 的调研文件，整合成一篇 wiki 文章，
保存到 wiki/topics/obsidian.md。要求：
1. 按主题组织（是什么、核心功能、竞品对比、社区生态、AI 集成现状）
2. 标注每条信息的来源
3. 用 [[双向链接]] 链接到 vault 中已有的相关笔记
4. 列出调研中发现的、值得深入了解的问题

收益在第二次。三个月后再写同话题，AI 读一下这篇 wiki 就知道之前调研过什么，可以增量更新，不用从零开始。

每一次调研不再是一次性消耗品，而是知识库的一次增量。

四、写作

前面三个都是「存」，这个是「用」。

只需要一句话描述选题，不需要大纲、不需要结构：

写一篇关于「AI 工具的更新速度为什么让写书变得很难」的文章

AI 先搜整个库（日记、读书笔记、调研文件、以前的文章），给一份「已有素材清单」，然后基于这些素材组织初稿。

对比一下两种状态：

• 起点：没有库是空白页，有库是一句话选题
• 素材：没有库靠凭记忆想 + 重新上网搜，有库是从自己的笔记里搜出来
• 初稿：没有库是拼凑，有库已包含自己的想法和素材

AI 出的初稿不是终稿，还是要改。但改的是一个已经装着自己想法的草稿，不是空白页。

五、自动加双链

平时写日记，人名、书名、概念全用纯文本，不加链接。然后：

读取 100 日记/2026-09-28.md，找出所有的人名、地名、书名、概念名词。
对每一个实体：
1. 搜索 vault 中是否已有对应的笔记
2. 如果有，把纯文本替换为 [[wikilink]]
3. 如果没有，创建一个包含基本信息的实体笔记，然后链接

效果：

改前：今天和老王吃了个饭，聊了聊塔勒布的新书
改后：今天和 [[老王]] 吃了个饭，聊了聊 [[塔勒布]] 的新书

AI 做得比人彻底：可能会漏掉一个人名，它不会；可能忘了库里已经有某个概念的笔记，它会搜到。

手动十几分钟的事，变成几秒钟。

十、常见坑

九个，每一个都有代价。

坑 1：库放在实时同步目录里

iCloud、坚果云、OneDrive 这类双向实时同步的目录，和 Obsidian 同时读写同一批文件，会冲突。

结果是生成一堆 笔记名 (冲突副本 2026-09-28).md，严重时文件内容错乱。

正确做法：库放在本地普通目录，同步用官方 Sync、Git，或者定时单向拷贝到移动硬盘。

坑 2：一上来设计完美体系

还没写够五十条笔记，先花三个小时研究文件夹结构和标签体系。

结果是两周内放弃。体系撑不住现实，改又懒得改，最后不写了。

笔记系统应该从笔记里长出来。

坑 3：一上来装二十个插件

侧边栏挤满图标，快捷键冲突，启动变慢，笔记没写几篇。

起步只装日记和模板两个核心插件，用两个月再说。

坑 4：用文件夹做主题分类

建一个「AI」文件夹、一个「投资」文件夹——然后「用 AI 做量化交易」这篇不知道该放哪。

文件夹管生命周期，标签管主题，双链管关系。三者职责别混。

坑 5：把 PDF、Word、音频直接放进库

库会迅速膨胀到几个 G，搜索变慢，AI 读起来也浪费上下文。

库内只放 Markdown。原始 PDF、录音放在库外面，需要时把关键内容摘录成 .md 放进来。

坑 6：同一个概念三种叫法

一条笔记写「RAG」，一条写「检索增强生成」，一条写「retrieval augmented generation」。

AI 搜「RAG」只命中一条。

做法：库根目录放 glossary.md 术语表，统一用词。老笔记可以让 AI 批量统一。

坑 7：人的笔记和 AI 产出混在一起

时间一长，分不清哪段是自己写的原始记录、哪段是 AI 生成的。

后果：引用时不知道该不该信；AI 重写时可能把原始记录也一起改了。

做法：文件夹分开，或者文件名加 _ai- 前缀，并在 CLAUDE.md 里写明两边的修改权限。

坑 8：没有备份

库是纯文本，单篇很小，但整个文件夹丢了就是全丢。

三条腿：本地 + 移动硬盘冷备 + Git 或官方同步。最忌讳只有一份。

坑 9：用 Git 时不忽略 workspace 文件

用 Git 管理库的时候，.obsidian/workspace.json 和 .obsidian/workspace-mobile.json 这两个文件记录的是窗口布局，每次打开 Obsidian 都会变。

不忽略的话，每次 git status 都有一堆噪音，把真正的改动淹掉。

# .gitignore
.obsidian/workspace.json
.obsidian/workspace-mobile.json

其他配置文件（插件列表、主题）可以纳入版本控制，方便多台机器同步。

十一、问题答疑

1. Obsidian 免费吗？

个人使用免费。商用需要授权，官方同步（Sync）和发布（Publish）是付费的。日常记笔记，免费版完全够。

2. 和 Notion 比怎么选？

看要什么。要数据库、协作、看板，选 Notion；要本地、长跑、不怕厂商跑路、AI 能直接读，选 Obsidian。

两个可以一起用——Obsidian 当主库，Notion 只做发布出口。

3. 笔记要不要分类？

别纠结分类，纠结链接。分类是树，链接是网。真正会用到的检索方式是「上次那篇写过啥」，那是链接干的活。

4. 附件图片放哪？

专门建一个 04 附件/，别跟笔记混着放。设置 → 文件与链接 → 附件默认位置 → 指定文件夹。

5. 库会不会越来越大、越来越卡？

纯文本本身很小。卡一般是两个原因：附件图片太多（几百 MB 起）、插件装太多。定期清理没用的附件。

6. 手机上能编辑吗？

能，但手机端建议只记不整理。灵感来了记一句，回头在电脑上归位。手机上折腾结构，效率极低。

7. 怎么备份？

三条腿：本地 + 移动硬盘冷备 + Git 或官方同步。最忌讳只有一份。

用 Git 的话，动手前先看一眼挂载情况。动盘之前先 diskutil list，成本 2 秒，代价可能很大。

8. 要不要学双链、图谱？

图谱基本是装饰，当体检工具每周扫一眼就够。双链有用，但用在自己真的会回头找的地方。别为了「织网」而织网。

9. AI 整理笔记，会不会把东西改坏？

会，如果没设边界。三条防线：

• CLAUDE.md 里写死「不可以删除已有内容、不可以修改原始记录」
• 整理 prompt 里加「只添加结构，不删除任何内容」
• 用 Git 管理库，出错一条命令回退

第三条最实在。有了 Git，才敢让 AI 碰几十个文件。

10. 一定要用 AI 吗？

不一定。只用 Obsidian 本身，已经比大部分云笔记强。

AI 只是把「整理」这件需要纪律的事接了过去。如果本来就不整理、也不觉得痛，那不需要。

11. 上向量数据库吗？

40 万字以内不需要。个人知识库到这个量级，AI 直接读 Markdown 就够。

12. AI 是不是就能自动建好整个知识库了？

不能。AI 能整理，不能判断。

什么值得记、什么观点是对的、哪条笔记该留下——这些决定只能自己做。AI 做的是把已有的东西归类、关联、检索。

整理可以外包，判断不能。

最后

总的来说 Obsidian 笔记就是一个本地文件加上 AI 技术手段处理的知识库，说是一个项目也不为过！

Obsidian 非常值得学习使用，颠覆我对笔记软件的认知。

Obsidian 上手不难，难的是先想清楚拿它干什么。

第二大脑不只是一个说法。这个库确实做成了一件事——

它把「觉得自己很努力」，变成了一个能核对的数。

核对完不一定好看。但难看的数，才有用。

三条建议，照着做就行：

一，先建目录，用数字编号；二，每个目录写一篇入口笔记；三，日记先写起来，别的以后再说。

剩下的就是往里填。填着填着会发现，这个库开始像自己了。

AI 那部分也一样——先让它做一件最小的事（周报），跑顺了再交更多。别一上来就把整个库交出去。

本文基本以 Claude Code 为例，Codex、OpenCode 也是可以，其他 DeepSeek 各类模型也可以的。

如果你已经有仓库，有一定使用经验，推荐你让 AI 参考这个项目改进你的知识库，或者直接使用

https://github.com/AgriciDaniel/compass

本文第八、九章关于 AI 与知识库的部分，参考了花叔的《Obsidian + Claude Code：用 AI 重建你的第二大脑》（橙皮书系列）：https://github.com/alchaincyf/obsidian-ai-orange-book

#Obsidian #笔记入门 #AI

本文 AI 辅助创作结合个人使用经验而成，如果文章对你有帮助，欢迎点赞、收藏、关注！

我是想风，@xaiwind，一个关注出海与 AI 的创作者。每天进步一点，我们终会到达目的地！

往期优质文章：

• 万字长文 ｜超详细的 GitHub 教程，从入门到精通
  https://x.com/xaiwind/status/2104039563719262546
• 超详细 Codex 上手教程，从入门到精通
  https://x.com/xaiwind/status/2102738292580225350