概念
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