跳到主要内容

概念

Karpathy LLM Wiki:如何搭建有来源AI 知识库

Karpathy LLM Wiki 模式把可信来源、原子知识与维护页面分开,建立让 AI 代理按需读取的知识库

Qi-Xuan Lu更新 9 分钟阅读

文章封包

01

Concepts

02

正在搭建可由 AI 代理读取、更新并检查来源的本地知识库的中文用户

03

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,这套判断标准也能用来评估自己的知识库

先安装 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 才开始产生独立价值。

查看 Wenlan 的层级边界

搭建可维护的本地 LLM Wiki

用 Wenlan 把来源与工作事实蒸馏成可检查、可刷新、让下一个 AI 会话按需读取的知识页面。

FAQ

Karpathy LLM Wiki 的核心想法是什么?+
Andrej Karpathy 描述的是一组经过整理、彼此连接,并能由代理按需读取的个人 wiki 页面。重点是维护有用页面及其结构,而不是每次加载没有区分的完整资料库;引用他的说明不代表他为 Wenlan 背书。
LLM Wiki 和 RAG 是同一种东西吗?+
不是。RAG 在提问时检索来源片段;LLM Wiki 维护可复用的答案、引用和刷新状态。LLM Wiki 可以使用 RAG,但检索本身不会维护答案。
Obsidian 可以直接当 AI 知识库吗?+
Obsidian 很适合做人拥有的 Markdown vault 和阅读界面。要让它成为代理可依赖的知识库,还需要选择性检索、来源、过期处理和安全的自动修改边界。
本地 AI 知识库一定要导入所有笔记吗?+
不用。先从一个会重复使用的小主题开始,只注册必要来源并检索最小相关集合。整库注入会增加 token 成本、噪音和过期内容风险。
Wenlan 的蒸馏页面只是摘要吗?+
不是。摘要通常压缩单一来源;蒸馏页面会组合相关事实与来源,保留 source IDs、修订状态和变旧原因,并能随着新证据更新。