这篇不讲「笔记要分类」这种正确但没用的话。

讲一个我用了三个月、现在每周只需一句话就能维护的知识库:62 个 .md 文件、139 条有效双链、断链从 27 条降到 1 条、最近一个月手动整理 0 次。

全文约 4500 字,含可直接复制的 AGENTS.md 全文、5 个插件的版本与配置、7 个我踩过的坑。照着做,一个周末能跑起来。


一、先说结论:为什么你的 Obsidian 最后变成了垃圾场

我搭过三次知识库:Notion、飞书文档、Obsidian,全部失败了。复盘之后发现问题不在工具,而是三个动作在互相打架:

  1. 分类动作在跟记录动作抢注意力。 "这条笔记放哪"的犹豫,比写内容本身还费劲,于是你开始攒着不记。
  2. 整理是纯消耗。 整理一小时,产出是"文件夹更整齐了",但下周找东西还是靠搜索。
  3. 知识不会因为你整理而增值。 真正值钱的时刻是:新资料进来之后,旧结论被自动更新、冲突被标出来、相关页面自动补链——这些手动整理永远做不到。

所以这次我换了个模型:不做"整理",做"编译"。

二、换个模型:不整理,编译

这个思路来自 Karpathy 在 2026 年 4 月提出的 LLM Wiki 模式,核心一句话:

原料不可变,LLM 增量编译成 wiki 页,索引与日志随之生长。

它跟大多数人熟悉的 RAG 不是一回事:

维度RAG 问答编译式 wiki
每次提问重新检索原文、现场拼凑读已经编译好的页
成本每次都要重跑一遍编译一次,之后增量更新
页面间冲突各说各话,没人负责编译时当场标出,两边都留
复用答案留在对话里,问完就散答案回填成新页,越用越厚
三个月后还是那一堆原文长出来一个结构化的库

在库里,它长成三层 + 一个索引层:

层目录谁写铁律
原料层 Raw00_收件箱/ 30_资源/ 60_日记/人 + 各种系统只增不改,AI 只读不写
编译层 Wiki20_领域/ 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、甚至半年后你自己回来看,读这个文件就知道该怎么干。

四条铁律,一条都不能妥协:

  1. 原料只增不改。 00_收件箱/、30_资源/、60_日记/ 的内容永不修改。要更正,在编译层写新结论并注 sources。
  2. 编译层 AI 全权。 20_领域/、10_项目/ 可重写、可拆分、可合并,但每篇必须带 compiled / confidence / sources。
  3. 每次编译必须更新索引三件套,然后 git commit。 不做这一步,库会退化成"很多篇好笔记,但没人知道哪篇是新的"。
  4. 禁止 [[文件夹名]]。 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 个,一个都别多装

插件版本解决什么问题
Dataview0.5.68首页「进行中的项目」「最近 7 天动过」自动生成
Omnisearch1.32.0中文全文搜索,比内置分词准
Templater2.26.0模板变量、一键新建
QuickAdd2.33.1全局快速捕获到收件箱
obsidian-git2.43.0每 10 分钟自动提交,误删可回滚

装插件会弹「你是否信任这个仓库的作者?」——这是 Obsidian 检测到库里有第三方插件时的正常提示,不是中毒。选「信任并启用」即可。

十、实测:一条原料进来,到底发生了什么

上周四早上,我把三张现场设备截图丢进收件箱,然后说了一句话:

时间动作
08:313 张截图进 00_收件箱/
08:32一句「整理收件箱」
08:35AI 判断:属于「巡检机器人」领域,但拆成两个主题(通信配置 / 现场排障)
08:36新建 2 页,更新 5 个相关页,补 9 条双链
08:37更新索引三件套,写日志,git commit

一次操作的副作用:笔记 58 → 59,双链 139,断链仍然是 1(那个 [[巡检机器人]] → 闭环 的概念页还欠着)。

这就是"自动升级"的真实体感:你只提供一个粗糙的原料,库自己决定它该长在哪。

十一、踩过的 7 个坑(每个都真实发生)

  1. [[文件夹名]] 会生成空笔记。 我最早在首页写了 10 个"链接到文件夹"的导航,点一下 Obsidian 就新建一个同名空笔记。全库清了 18 处,断链从 27 降到 1。规矩:导航只走 90_索引/索引.md。
  2. 别让 AI 改原料层。 一旦允许它"顺手修正"原文,你就失去了对照物,结论会悄悄漂移,而且找不回来。
  3. 一页超过 2000 字必须拆。 我有一篇 4.9k 字的领域页,混了配置、约束、排障三类内容,AI 每次读它都要浪费大量上下文。拆成两页 + 一个索引页之后,问答命中率明显变高。
  4. 网盘同步 .obsidian/ = 灾难。 OneDrive 会锁配置文件,Obsidian 启动时报"配置损坏",插件设置全丢。要同步只用 Git。
  5. 空库困境:想一次搭完美。 我前两次失败都是因为花了两天设计目录结构,然后一篇没写。正确顺序是:先建 5 个目录,先扔 10 条真实材料进去,让它先跑起来。
  6. Dataview 没装,首页是两坨代码。 首页那两块看板是 Dataview 查询,没装插件会原样显示成代码块,看着像坏了,其实没坏。
  7. 用 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 建起来——顺序别搞反,先立规矩,再往里扔东西。

有问题评论区聊,尤其是"你的库现在多少条断链"这个,我很好奇别人的数字。

Logo

更多推荐