概念
Karpathy LLM Wiki:如何搭建有来源的 AI 知识库
Karpathy LLM Wiki 模式把可信来源、原子知识与维护页面分开,建立让 AI 代理按需读取的知识库。
文章封包
Concepts
正在搭建可由 AI 代理读取、更新并检查来源的本地知识库的中文用户
9 分钟阅读
01
Karpathy LLM Wiki 模式维护可复用的当前答案,不把聊天记录、检索片段或笔记直接当成成品知识。
02
可靠架构会分开原始来源、原子事实、维护页面与按需检索。
03
页面需要保留 source IDs、变旧原因和可检查的修订,而不是静默覆盖。
01
Karpathy LLM Wiki 是什么
Andrej Karpathy 用 LLM Wiki 描述一种把原始知识整理成精选、互相连接页面的模式,让 AI 代理只在需要时加载相关内容。本文把他的公开说明作为可维护来源,不代表 Karpathy 为 Wenlan 背书。
实现上,LLM Wiki 是给 AI 代理使用、也让人能够检查的维护型 AI 知识库。它把文档、对话和文件等来源整理成主题页面,不必反复重放整个资料库或聊天历史。
它不只是让 LLM 自动写一批 Markdown 笔记。真正有用的系统会把原始证据、可复用事实与当前解释分开,保留来源和更新状态;即使读者不安装 Wenlan,这套判断标准也能用来评估自己的知识库。
02
一个可靠 AI 知识库的四层架构
最小可维护架构包含四层:Raw Sources 保存可检查的原始材料;Atomic Knowledge 保存一次决策、纠正或经验;Wiki Pages 汇总当前答案;Schema 与 Index 负责按主题定位所需内容。
常见流程可以概括为 Ingest、Query、Lint:Ingest 注册来源而不急着改写结论;Query 只取当前问题所需的页面和证据;Lint 检查缺失来源、重复、矛盾、过期依赖与不可维护的页面。
- Raw Sources:保存文档、网页、文件和对话等原始材料。
- Atomic Knowledge:保留一个完整事实、决策、经验或纠正及其来源。
- Wiki Pages:把相关证据编成一个可读、可维护的当前答案。
- Schema 与 Index:记录主题、依赖和状态,并只加载相关内容。
03
LLM Wiki 知识库和 RAG 有什么不同
RAG 通常在提问时检索原始片段;LLM Wiki 则维护一个可重复使用的答案、支持它的来源以及需要刷新的状态。知识库可以在底层使用 RAG,但只有检索还不会自动维护结论。
Obsidian 是人拥有的资料库和写作界面,可以承载或查看 Markdown wiki 页面;但开放 vault 给代理读取,并不等于已经处理选择性检索、来源、过期状态和自动修改边界。两者可以配合,不需要互相替代。
- RAG:为这次问题寻找相关来源片段。
- LLM Wiki:维护以后还能复用的答案、引用和刷新状态。
- Obsidian:保留人可读、可编辑的 Markdown 知识面。
- Agent memory:保存工作中可复用的事实和决策,作为页面原料之一。
04
一份最小可用的 LLM Wiki Schema
让固定加载的契约保持精简。CLAUDE.md 或 AGENTS.md 只需说明知识库的用途、不可静默改变的边界,以及需要时才按需加载的操作流程;不要把整个 wiki 或所有维护指令都塞进每次 context。
这是工具无关的信息与维护契约,不强迫特定文件夹或产品存储格式;可以调整名称,但每个边界都应该能够检查。
- 用途与范围:哪些重复问题或决策属于这个 wiki,哪些不属于。
- 不可变来源边界:原始证据放在哪里,以及自动化绝不能改写哪些文件。
- 页面所有权:哪些页面由机器维护、人拥有,或只能通过审核修改。
- 命名与链接规则:稳定主题、别名、页面链接和最小 routing index。
- 引用要求:重要说法必须能够回到可检查来源。
- Ingest、Query、Lint 与维护记录:分开按需加载的流程,加上 append-only 变更记录。
- 过期与审核行为:来源改变、证据冲突或人拥有文字时要如何处理。
精简 client 契约
# LLM Wiki
用途:<这个 wiki 维护的重复决策>
来源:<不可变来源边界>
页面:<所有权、命名、链接、引用>
索引:<最小主题路由;页面按需加载>
流程:ingest | query | lint | review
记录:<append-only 维护记录>
过期规则:<来源改变 -> stale 或 review>05
正式使用前的最小验收测试
文件存在不代表 template 已经可用。先用一个无风险主题做端到端测试,而且必须包含一次来源变更,再导入私人或重要资料。
这套验收可用于文件夹加 prompt、Obsidian 工作流或专门的 LLM Wiki 工具;预期结果是人能检查的证据,不只是一段流畅回答。
- 导入一份无风险来源,确认原始内容没有被改写。
- 回答一个问题,并为重要说法引用来源。
- 运行 lint,确认缺失引用、断链或重复能够被看见。
- 修改来源,再问一次相同问题。
- 确认旧答案进入 stale 或 review,而不是被静默覆盖。
06
如何搭建一个会持续更新的 AI 知识库
先选一个无风险的小主题,不要一开始就导入整个 vault。注册可检查的来源,捕捉一条完整事实,再把相关内容蒸馏成主题页面;随后用同一问题重新检索,并从页面回到 source IDs 检查证据。
发布第一版不是结束。来源改变时,系统应该标记受影响页面、记录 stale reason,并产生可审查的修订;对于人拥有的文字,自动化不应静默覆盖。
Wenlan 五分钟验证流程
/brief <主题>
/recall <问题>
/capture <结论 + 原因>
/handoff
/distill <主题>
/pages <主题>07
如何验证知识库真的可用
不要只看命令是否返回成功。真正的验收是:下一次会话能找回正确内容,人能在聊天之外阅读页面,而且重要说法可以追溯到来源。
如果检查失败,先保留测试内容的低风险范围,修复连接、来源或重复问题,再用同一主题复测;不要靠继续生成更多页面掩盖故障。
- 相同主题可以再次找到刚才保存的事实。
- 页面是可读 Markdown,并显示重要说法对应的 source IDs。
- 后续检索只加载相关页面或来源片段,而不是整个资料库。
- 来源变化会产生可检查的过期原因或修订,不会静默覆盖。
- Lint 能暴露缺失来源、重复、矛盾或过期依赖。
08
Wenlan 如何实现本地 LLM Wiki
Wenlan 把 Sources、Memories 和 Pages 分成三种耐久角色:Sources 保存原始材料,Memories 保存工作中产生的原子事实,Pages 编成有来源的当前解释。本地 daemon 负责检索,Markdown 页面和 git 历史让结果保持可见。
每个蒸馏页面都要保留 source IDs。页面可以随着新证据变旧、刷新或进入审查;memory 在这里是支撑知识库的材料和状态,不是产品的搜索入口。
Wenlan 不要求用户自定义 Page schema。typed Memory fields 与内置 Page 规则已经管理来源、引用、刷新、所有权和审核;上面的 starter schema 是可移植的 client 与流程验收契约。
09
什么时候不需要 LLM Wiki
一次性聊天、很小且长期稳定的文档集,或团队已经维护良好的普通 wiki,不一定需要额外系统。当前代码、测试结果和工具官方文档也始终比知识库里的旧解释更权威。
当多个 AI 工具需要共享同一套检索、来源、交接和审查规则,而且答案会随项目持续变化时,维护型 LLM Wiki 才开始产生独立价值。
搭建可维护的本地 LLM Wiki
用 Wenlan 把来源与工作事实蒸馏成可检查、可刷新、让下一个 AI 会话按需读取的知识页面。
FAQ