Obsidian 从 0 到自动升级:一个会自己生长的知识库(附 AGENTS.md 全文与 7 个坑)
目录
这篇不讲「笔记要分类」这种正确但没用的话。
讲一个我用了三个月、现在每周只需一句话就能维护的知识库:62 个
.md文件、139 条有效双链、断链从 27 条降到 1 条、最近一个月手动整理 0 次。全文约 4500 字,含可直接复制的
AGENTS.md全文、5 个插件的版本与配置、7 个我踩过的坑。照着做,一个周末能跑起来。
一、先说结论:为什么你的 Obsidian 最后变成了垃圾场
我搭过三次知识库:Notion、飞书文档、Obsidian,全部失败了。复盘之后发现问题不在工具,而是三个动作在互相打架:
- 分类动作在跟记录动作抢注意力。 "这条笔记放哪"的犹豫,比写内容本身还费劲,于是你开始攒着不记。
- 整理是纯消耗。 整理一小时,产出是"文件夹更整齐了",但下周找东西还是靠搜索。
- 知识不会因为你整理而增值。 真正值钱的时刻是:新资料进来之后,旧结论被自动更新、冲突被标出来、相关页面自动补链——这些手动整理永远做不到。
所以这次我换了个模型:不做"整理",做"编译"。
二、换个模型:不整理,编译
这个思路来自 Karpathy 在 2026 年 4 月提出的 LLM Wiki 模式,核心一句话:
原料不可变,LLM 增量编译成 wiki 页,索引与日志随之生长。
它跟大多数人熟悉的 RAG 不是一回事:
| 维度 | RAG 问答 | 编译式 wiki |
|---|---|---|
| 每次提问 | 重新检索原文、现场拼凑 | 读已经编译好的页 |
| 成本 | 每次都要重跑一遍 | 编译一次,之后增量更新 |
| 页面间冲突 | 各说各话,没人负责 | 编译时当场标出,两边都留 |
| 复用 | 答案留在对话里,问完就散 | 答案回填成新页,越用越厚 |
| 三个月后 | 还是那一堆原文 | 长出来一个结构化的库 |
在库里,它长成三层 + 一个索引层:
| 层 | 目录 | 谁写 | 铁律 |
|---|---|---|---|
| 原料层 Raw | 00_收件箱/ 30_资源/ 60_日记/ | 人 + 各种系统 | 只增不改,AI 只读不写 |
| 编译层 Wiki | 20_领域/ 10_项目/ 40_学习/ | AI 全权 | 可重写、可拆分、可合并 |
| 规则层 Schema | 根目录 AGENTS.md | 人和 AI 共同迭代 | 把"聊天机器人"变成"wiki 维护员"的关键 |
| 索引层 | 90_索引/ | AI 每次更新 | 索引 / 体检 / 日志三件套 |
原料写错了怎么办?不回去改原文,而是在编译层写一条带 sources 的更正,两个版本同时保留。这样你永远知道"当时为什么这么认为"。
三、第 0 步:先回答一个问题——这个库给谁用
别急着装软件。先花 20 分钟,翻一下你最近一周真实存过的笔记(微信收藏、截图、随手记都算),看它们属于哪一类:
| 你的真实情况 | 该怎么建 | 重点 |
|---|---|---|
| 存了就再没打开过,纯资料仓库 | 只建 30_资源/ + 一个索引页 | 别搞双链,先把"能搜到"解决 |
| 手上同时推进 3 个有截止日的项目 | 以 10_项目/ 为主 | 周记 + 项目页,其他先不建 |
| 有一两个长期负责的方向(比如我的巡检机器人、AGV 调度) | 三层全建(本文方案) | 领域页会一直长,最需要编译 |
判断标准很简单:你有没有"同一件事,三个月后还会回来查"的场景。 有,就值得用编译方案;没有,用文件夹 + 搜索就够,别给自己加任务。
四、第 1 步:装 Obsidian(10 分钟)
- 只从官网
obsidian.md下载。第三方商店里的改版包我见过,插件市场是通的,但版本落后两个大版本。 - 不要把库放在 OneDrive / 百度网盘同步盘里。 网盘会同步
.obsidian/目录,多设备同时打开必冲突,插件配置和快捷键会莫名其妙丢。要备份用 Git(下面会讲)。 - 版本我这台机器是 Obsidian 1.15.0(2026-11 稳定版)。
装完先改三个设置,路径是 设置 → 文件与链接:
| 设置项 | 值 | 为什么 |
|---|---|---|
| 附件默认存放路径 | 950_附件 | 否则图片散落在各目录里 |
| 新建笔记存放位置 | 00_收件箱 | 保证"先捕获、后分类"能落地 |
| 使用 Wiki 链接 | 开 | 双链是 [[ ]],不是 Markdown 链接 |
再顺手把 设置 → 编辑器 → 显示行号 打开,写技术文档时定位方便。
五、第 2 步:骨架——11 个目录,多一个都别建
知识库/
├── 首页.md # 导航 + Dataview 看板
├── AGENTS.md # 宪法:编译规则(最关键的文件)
├── 使用说明.md / 术语表.md / 插件与设置.md
├── 00_收件箱/ # 临时捕获,目标:每周清空
├── 10_项目/ # 有目标、有截止的事
├── 20_领域/ # 长期负责的方向,不结项
├── 30_资源/ # 外部资料快照,只读
├── 40_学习/ # 课程、读书、专题
├── 50_归档/ # 结项、失效的(别删,先归这)
├── 60_日记/ # YYYY-MM-DD.md / YYYY-Www.md
├── 90_索引/ # 索引 / 知识状态 / 编译日志
├── 900_模板/ # 六套模板
└── 950_附件/ # 图片、PDF、表格
数字前缀只为了排序,不用记。整套方案只有一个入口规则:
新东西永远先扔
00_收件箱/,不要分类。
分类是 AI 的活。你一旦开始分类,就等于把"整理"这个动作又背回身上了。
六、第 3 步:立宪——一个 AGENTS.md,把规矩从脑子搬到文件
这是整套方案里最值钱的 30 分钟。
为什么要写成文件,而不是每次在对话里重复一遍提示词?因为提示词会丢,文件在库里。任何一次新的对话、换一个 AI、甚至半年后你自己回来看,读这个文件就知道该怎么干。
四条铁律,一条都不能妥协:
- 原料只增不改。
00_收件箱/、30_资源/、60_日记/的内容永不修改。要更正,在编译层写新结论并注sources。 - 编译层 AI 全权。
20_领域/、10_项目/可重写、可拆分、可合并,但每篇必须带compiled/confidence/sources。 - 每次编译必须更新索引三件套,然后
git commit。 不做这一步,库会退化成"很多篇好笔记,但没人知道哪篇是新的"。 - 禁止
[[文件夹名]]。 Obsidian 会把它当成一个新笔记,点一下就生成空文件(这个坑后面单独讲)。
AGENTS.md 全文(精简可复制版)
# 知识库编译规则(自生长)
## 0. 一句话模型
原料不可变,LLM 增量编译成 wiki,索引与日志随之生长。
## 1. 三层
| 层 | 目录 | 谁写 | 铁律 |
| Raw | 00_收件箱 / 30_资源 / 60_日记 | 人 + 系统 | 不可变,LLM 只读 |
| Wiki | 20_领域 / 10_项目 / 40_学习 | LLM 全权 | 可重写、拆分、合并 |
| Schema | 本文件 | 人与 LLM | 把聊天机器人变成 wiki 维护员 |
| 索引层 | 90_索引 | LLM 每次更新 | index / status / log |
纠正原料的方式:不改原文,在 wiki 层写带 sources 的更正,双方都留。
## 2. 三个操作
### Ingest(摄入)
新原料进 00_收件箱 → 读 → 判断归属(补已有页 / 新建原子页 / 只存档)
→ 写页 → 更新受影响的所有相关页 → 更新索引 → 追加日志 → commit。
一条新原料通常要动 3–15 个页面,不是只写一篇摘要。
### Query(查询)
1. 先读 90_索引/索引.md 找到相关页
2. 深入读页,综合回答,带引用
3. 答案回填:产生新结论就存成 wiki 页,不能只留在对话里
4. 追加一条 query 日志
### Lint(体检,每周一次)
矛盾 / 过时 / 缺页 / 孤儿 / 缺引用 / 数据缺口,六项逐条查。
## 3. 编译页格式
type / status / compiled / confidence / sources / tags
## 4. 原子化
一页一主题,超过 2000 字必须拆分,主页转索引。
## 5. 链接
- 层内层间都用 [[双链]]
- 指向尚不存在的概念允许,但必须登记到索引的「待创建」
- 禁止 [[文件夹名]],导航走索引页
## 6. 索引与日志
- 90_索引/索引.md:内容索引,每次 ingest 更新
- 90_索引/编译日志.md:只追加,格式 `## [YYYY-MM-DD] 类型 | 标题`
- 90_索引/知识状态.md:体检报告
## 7. 规模
索引文件在 ~100 条原料内够用,不需要向量库;超过再加本地检索。
## 8. 触发词
ingest / 整理收件箱 → 摄入
query / 直接提问 → 查询 + 回填
lint / 体检 → 六项检查
拆页 <笔记> → 按 2000 字规则拆分
回填 → 把刚才的回答存成页
写完之后,你只需要对 AI 说一句话:“按 AGENTS.md 整理收件箱”。它自己判断该动哪些页。
七、第 4 步:给每篇笔记一个"契约"
编译层的每篇笔记,frontmatter 不是装饰,是三个抗体:
---
type: 领域 | 项目 | 概念
status: 生长中 | 稳定 | 待验证
compiled: 2026-11-07 # 上次编译日期
confidence: 高 | 中 | 低 # 置信度
sources: # 结论回源
- "[[四信LoRa通讯]]"
- "[[调试记录-海晶光伏-2026-11-06]]"
tags: []
---
compiled用来判断该不该重编译:超过 30 天、且sources里有新原料,就过期了。confidence防编造:没有可靠来源的推断,一律标低,或者正文里写"未经证实"。sources是唯一能让你半年后还敢引用自己笔记的东西。
反面例子是我最早那批笔记:只有 tags,正文写了"现场测试 80ms 会丢包"。三个月后我完全想不起来这个数字是厂商说的还是我测的——最后只能把整段标成待验证,等于作废。
八、第 5 步:索引层三件套
| 文件 | 作用 | 更新时机 |
|---|---|---|
索引.md | 主题地图 + 待创建清单 | 每次 ingest |
知识状态.md | 体检报告:规模、六项检查结果、待补事项 | 每次 lint |
编译日志.md | 只追加的操作流水 | 每次操作 |
日志格式定死,为的是能直接 grep:
grep "^## \[" 90_索引/编译日志.md | tail -5
真实输出:
## [2026-11-07] ingest | 方法页:自动发布可用链路与踩坑
## [2026-11-07] query | 对齐 LLM Wiki 原版,修正三处偏差
## [2026-11-07] restructure | 首次全库编译:三层结构 + 索引层
索引页现在长这样(摘一段真实的):
| 主题 | 页面 | 状态 |
|---|---|---|
| 巡检机器人 | [[巡检机器人]] → 通信 / 工具表 / 闭环 | 生长中 |
| AGV 调度 | [[AGV与FMS调度]] → 评审 / 修复 / 测试 | 生长中 |
| 方法论 | [[LLM Wiki 方法论]] | 稳定 |
为什么不用向量库? 100 条原料、几百页的规模下,一个 5000 字的索引页比向量检索更准,而且你能自己读、自己改。等原料超过 100 条再加本地检索也不迟。
九、第 6 步:让它自己升级——四层自动化
这就是"自动升级"的全部内容。先把话说清楚,哪层真自动、哪层只是省事:
| 层 | 自动化程度 | 触发方式 | 实际耗时 |
|---|---|---|---|
| 内容编译 | 全自动 | 一句「整理收件箱」 | 2–5 分钟 |
| 索引生长 | 全自动 | 编译时同步完成 | 0 |
| 备份提交 | 全自动 | obsidian-git 每 10 分钟 | 0 |
| 健康体检 | 半自动 | 每周一句「体检」 | 3 分钟 |
| 插件更新 | 手动 | 设置里点「检查更新」 | 1 分钟 |
9.1 内容自动编译:一句话,动 3–15 个页面
我现在的真实用法:手机截图 → 微信发给自己 → 转给 AI → 说一句 整理收件箱。
它会:读收件箱 → 判断这条属于哪个主题 → 补已有页或新建原子页 → 更新所有相关页 → 更新索引三件套 → 写日志 → git commit。全程我没有打开过文件夹。
9.2 备份自动提交:obsidian-git 的配置
装 obsidian-git 2.43.0,在 设置 → Git 里把自动提交间隔改成 10 分钟。它写到插件配置里就是这段(可以直接对照):
{
"autoSaveInterval": 10,
"autoCommitMessage": "vault backup: {{date}}",
"commitDateFormat": "YYYY-MM-DD HH:mm:ss",
"disablePush": false,
"autoPushInterval": 0,
"refreshSourceControl": true,
"showStatusBar": true
}
效果:每 10 分钟一次本地提交,误删可以回滚;推到远端(Gitee 私有库)我选择手动,或者在 AI 收尾时一起推——避免自动 push 跟手动 push 抢锁。
9.3 每周体检:六项,缺一项就漏
| # | 检查项 | 典型问题 |
|---|---|---|
| 1 | 矛盾 | 两页结论冲突,没标 > [!warning] 冲突 |
| 2 | 过时 | 新来源推翻旧结论,旧页没更新 |
| 3 | 缺页 | 正文提到的重要概念没有独立页 |
| 4 | 孤儿 | 没有入链的页面(模板除外) |
| 5 | 缺引用 | 编造或无来源的结论 |
| 6 | 数据缺口 | 该查而没查的,标出来等联网补 |
我这周查出来的真实结果:矛盾 0、过时 1、缺页 1、孤儿 5(全是模板,正常)、缺引用 3、数据缺口 2。体检的价值不是分数好看,是让你知道哪三页现在不能信。
9.4 插件:5 个,一个都别多装
| 插件 | 版本 | 解决什么问题 |
|---|---|---|
| Dataview | 0.5.68 | 首页「进行中的项目」「最近 7 天动过」自动生成 |
| Omnisearch | 1.32.0 | 中文全文搜索,比内置分词准 |
| Templater | 2.26.0 | 模板变量、一键新建 |
| QuickAdd | 2.33.1 | 全局快速捕获到收件箱 |
| obsidian-git | 2.43.0 | 每 10 分钟自动提交,误删可回滚 |
装插件会弹「你是否信任这个仓库的作者?」——这是 Obsidian 检测到库里有第三方插件时的正常提示,不是中毒。选「信任并启用」即可。
十、实测:一条原料进来,到底发生了什么
上周四早上,我把三张现场设备截图丢进收件箱,然后说了一句话:
| 时间 | 动作 |
|---|---|
| 08:31 | 3 张截图进 00_收件箱/ |
| 08:32 | 一句「整理收件箱」 |
| 08:35 | AI 判断:属于「巡检机器人」领域,但拆成两个主题(通信配置 / 现场排障) |
| 08:36 | 新建 2 页,更新 5 个相关页,补 9 条双链 |
| 08:37 | 更新索引三件套,写日志,git commit |
一次操作的副作用:笔记 58 → 59,双链 139,断链仍然是 1(那个 [[巡检机器人]] → 闭环 的概念页还欠着)。
这就是"自动升级"的真实体感:你只提供一个粗糙的原料,库自己决定它该长在哪。
十一、踩过的 7 个坑(每个都真实发生)
[[文件夹名]]会生成空笔记。 我最早在首页写了 10 个"链接到文件夹"的导航,点一下 Obsidian 就新建一个同名空笔记。全库清了 18 处,断链从 27 降到 1。规矩:导航只走90_索引/索引.md。- 别让 AI 改原料层。 一旦允许它"顺手修正"原文,你就失去了对照物,结论会悄悄漂移,而且找不回来。
- 一页超过 2000 字必须拆。 我有一篇 4.9k 字的领域页,混了配置、约束、排障三类内容,AI 每次读它都要浪费大量上下文。拆成两页 + 一个索引页之后,问答命中率明显变高。
- 网盘同步
.obsidian/= 灾难。 OneDrive 会锁配置文件,Obsidian 启动时报"配置损坏",插件设置全丢。要同步只用 Git。 - 空库困境:想一次搭完美。 我前两次失败都是因为花了两天设计目录结构,然后一篇没写。正确顺序是:先建 5 个目录,先扔 10 条真实材料进去,让它先跑起来。
- Dataview 没装,首页是两坨代码。 首页那两块看板是 Dataview 查询,没装插件会原样显示成代码块,看着像坏了,其实没坏。
- 用 RAG 的思维用它。 每次都让 AI"重新读一遍原文再回答",那是检索,不是编译。编译的价值在于改一次、所有相关页跟着更新。
十二、什么时候才需要上向量库
| 规模 | 方案 | 理由 |
|---|---|---|
| < 100 条原料 / 几百页 | 索引页 + 全文搜索(Omnisearch) | 你能读懂索引,AI 也能整页读完 |
| 100–1000 条 | 本地混合检索(BM25 + 向量 + LLM 重排) | 索引页开始变长,整页读成本高 |
| > 1000 条 | 专用检索服务,定期重建 | 这时候是工程问题,不是笔记问题 |
我这库现在 33 条原料、62 个 .md 文件,离需要向量库还差得远。提前上向量库,除了让架构图好看,没有收益。
十三、7 天后怎么判断它活了
别用"感觉变好了"这种指标。用这四个:
| 指标 | 健康阈值 | 怎么量 |
|---|---|---|
| 本周新增编译页 | ≥ 3 页 | 编译日志里数 ingest 条数 |
| 断链数 | 不增长 | 体检第 4 项 |
| 收件箱积压 | ≤ 5 条 | 直接数文件 |
| 你手动整理的时间 | ≤ 10 分钟/周 | 记在周记里 |
四条同时满足,说明这套流程真的在替你干活。有一条长期不达标,通常是某条铁律被绕过了——最常见的是第 1 条(原料被改)或第 3 条(忘记更新索引)。
最后
这套东西的成本是 0 元,全部本地,不依赖任何云服务。
唯一硬要求不是技术,是你愿意把"整理"的权限交出去。大部分人卡在这一步:明明知道手动整理没价值,还是忍不住想给文件夹改名。
写这篇的时候我数了一下,这个库从零到现在:33 条原料、62 个文件、139 条双链、1 条断链、0 次手动分类。
如果你也在用 Obsidian,回去先把根目录那个 AGENTS.md 建起来——顺序别搞反,先立规矩,再往里扔东西。
有问题评论区聊,尤其是"你的库现在多少条断链"这个,我很好奇别人的数字。
更多推荐


所有评论(0)