1. 從零建庫的真實(shí)痛點(diǎn)為什么你的筆記越記越亂先說一個我觀察到的普遍現(xiàn)象大多數(shù)人記筆記的路徑是「收藏夾 → 文件夾 → 吃灰」。看到一篇好文章存下來學(xué)到一個新概念記兩行過兩周想找翻遍文件夾也找不到最后干脆重新問 AI。問題不在于你不夠勤奮而在于傳統(tǒng)筆記是「樹狀分類」而知識本身是「網(wǎng)狀關(guān)聯(lián)」。LLM Wiki 這個思路來自 Andrej Karpathy 在 2024 年提出的一個觀點(diǎn)不要讓 AI 每次查詢都重新檢索原文而是讓它一次性讀完、提煉、結(jié)構(gòu)化把知識編譯成 Wiki 頁面。下次查詢直接讀它自己寫好的精煉內(nèi)容——交叉引用已經(jīng)寫好矛盾已經(jīng)標(biāo)記綜合判斷已經(jīng)完成。說白了就是讓 AI 替你讀文檔、寫筆記、做索引你只負(fù)責(zé)審核。這套方法要落地需要三個東西配合一個能讀寫文件、執(zhí)行命令的 AI Agent 執(zhí)行引擎一份定義「怎么建 Wiki」的規(guī)則文件也就是 Skill一個能可視化瀏覽知識網(wǎng)絡(luò)的展示層。我選的是 Obsidian 作為知識載體Hermes 風(fēng)格的 Skill 組織方式作為參照而讓 Agent 穩(wěn)定跑起來的關(guān)鍵是先把模型調(diào)用的入口統(tǒng)一掉——這就是 TaoToken 在這篇里要解決的問題。適合誰看有大量 PDF/網(wǎng)頁/文檔需要消化的人、想搭個人技能知識庫但被目錄結(jié)構(gòu)勸退的人、已經(jīng)在用 Obsidian 但筆記不成體系的人。整篇按「建庫 → 攝入 → 驗(yàn)證」的完整流程走每一步都給可復(fù)制的配置和命令跟著做就能出一個能檢索、能召回的知識庫。2. TaoToken 前置準(zhǔn)備統(tǒng)一 Key 讓 Agent 穩(wěn)定調(diào)用模型在動手建庫之前得先解決一個容易被忽略但很致命的問題Agent 建庫過程中會高頻調(diào)用模型——目錄規(guī)劃、條目抽取、索引生成、交叉引用檢查每一步都是幾十上百次請求。如果 Key 管理混亂、模型入口不統(tǒng)一跑到一半報個 401 或者連接失敗整個建庫流程就斷了。TaoToken 在這里的角色是「統(tǒng)一入口」一個 Key 覆蓋多種模型Base URL 固定Agent 的配置文件里只寫一份憑證不用在多個平臺之間來回切換。對建庫這種長流程任務(wù)來說穩(wěn)定性比什么都重要。先拿 Key。打開控制臺創(chuàng)建 API Key地址是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 創(chuàng)建后復(fù)制保存后面配置文件里要用。拿到 Key 之后你需要記住三個核心參數(shù)這是后面所有配置的基礎(chǔ)參數(shù)值說明Base URLhttps://taotoken.net/api所有請求的統(tǒng)一入口不加 UTMAPI Key控制臺創(chuàng)建的那串只寫一份全局復(fù)用Model ID按需選擇建庫推薦長上下文模型如果你用的是 Claude Code 這類編碼 Agent 來做建庫還需要走一遍接入配置。接入文檔在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 里面有各客戶端的詳細(xì)步驟。想先驗(yàn)證模型能不能正常對話可以直接用模型對話頁面測一下 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。這里有個我踩過的坑要提醒很多人建庫失敗不是 Skill 寫錯了而是 Agent 的模型配置里 Base URL 寫成了帶路徑的完整地址導(dǎo)致請求 404。記住 Base URL 就是https://taotoken.net/api不要自己拼/v1/chat/completions之類的后綴客戶端會自己處理。另外如果你的建庫任務(wù)是長期、批量的比如幾百份 PDF 要持續(xù)攝入建議用 Coding Plan 而不是按次調(diào)用成本更可控地址在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。建庫是個持續(xù)過程不是一次性任務(wù)這點(diǎn)后面維護(hù)章節(jié)還會講。3. 可復(fù)制配置Skill 文件、目錄結(jié)構(gòu)與元數(shù)據(jù)這一節(jié)是整篇的核心所有配置都能直接復(fù)制。先講 Skill 文件的寫法再講目錄結(jié)構(gòu)最后給元數(shù)據(jù)模板。3.1 寫 llm-wiki Skill 文件Skill 本質(zhì)上就是一個 Markdown 文件放在 Agent 能讀到的 skills 目錄下。它的作用是告訴 Agent「建 Wiki 的方法論」。沒有這個文件Agent 會零零散散建一堆 markdown不成體系。下面是我實(shí)際在用的llm-wiki.md核心內(nèi)容你可以直接復(fù)制改領(lǐng)域# Skill: llm-wiki ## Domain 個人技能知識庫聚焦嵌入式、AI 工程、工具鏈。 ## Architecture wiki/ ├── SCHEMA.md # 規(guī)則書 ├── index.md # 內(nèi)容目錄 ├── log.md # 操作日志只追加 ├── raw/ # 第一層原始材料不可修改 │ ├── articles/ │ ├── papers/ │ └── assets/ ├── entities/ # 第二層實(shí)體頁面 ├── concepts/ # 第二層概念頁面 ├── comparisons/ # 第二層對比分析 └── queries/ # 第二層問題答案 ## Page Rules - 每個頁面必須有 YAML frontmatter - 每個頁面至少 2 個出站 [[wikilink]] - 標(biāo)簽必須來自 SCHEMA 標(biāo)簽庫 - 超過 200 行必須拆分 - 只在 2 來源出現(xiàn)的關(guān)鍵概念才建獨(dú)立頁面 ## Ingest Flow 1. 捕獲源文件到 raw/ 2. 討論要點(diǎn) 3. 檢查已有頁面避免重復(fù) 4. 寫頁面正文 YAML 交叉引用 5. 更新 index.md 和 log.md 6. 匯報變更3.2 目錄初始化命令Skill 寫好后建庫就是標(biāo)準(zhǔn)化流程。在 Obsidian vault 里選一個目錄作為 Wiki 根然后執(zhí)行mkdir -p wiki/raw/articles wiki/raw/papers wiki/raw/assets mkdir -p wiki/entities wiki/concepts wiki/comparisons wiki/queries touch wiki/SCHEMA.md wiki/index.md wiki/log.md執(zhí)行完tree wiki應(yīng)該看到和 Skill 里定義一致的結(jié)構(gòu)。這一步別偷懶目錄不對后面 Agent 寫入會亂。3.3 元數(shù)據(jù)模板Frontmatter每個 Wiki 頁面開頭必須寫 YAML這是讓 Agent 能做自動化質(zhì)量檢查的基礎(chǔ)--- title: STM32H753 時鐘樹 created: 2026-07-02 updated: 2026-07-02 type: concept tags: [mcu-core, stm32cube] sources: [raw/papers/stm32h753-datasheet.pdf] confidence: high ---字段含義type只能是 entity/concept/comparison/query 四選一tags必須來自 SCHEMA 標(biāo)簽庫不能隨便發(fā)明sources指向 raw 里的原始文件confidence分 high/medium/low標(biāo)記這條知識的可信度。3.4 Agent 客戶端配置片段如果你用 Claude Code 或類似客戶端跑建庫配置文件里要寫全三件套。以 settings 為例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: 你的Key, ANTHROPIC_MODEL: 你的ModelID } }Base URL、Key、Model ID 三個都要寫全缺一個就會報錯。Cline 的 MCP 配置同理在 MCP server 的 env 里把這三個填進(jìn)去。Codex 的auth.json也是同樣的三件套結(jié)構(gòu)。4. 驗(yàn)證請求建庫后確認(rèn)知識條目能被召回建庫不是建完就完事必須做一次檢索驗(yàn)證確認(rèn)知識條目真的能被召回。這一步很多人跳過結(jié)果用的時候才發(fā)現(xiàn)索引是空的。4.1 先驗(yàn)證模型連通性在跑建庫任務(wù)前先用一條 curl 確認(rèn) Key 和 Base URL 沒問題curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的Key \ -H Content-Type: application/json \ -d { model: 你的ModelID, messages: [{role: user, content: 回復(fù) OK}] }返回里有choices字段且內(nèi)容是 OK說明連通正常。如果這里就報錯先別往下走去第 5 節(jié)排障。4.2 讓 Agent 攝入一份文檔把一份 PDF 放進(jìn)wiki/raw/papers/然后給 Agent 下指令讀取 raw/papers/ 下的新文檔按 llm-wiki Skill 的 Ingest Flow 攝入。 先告訴我你發(fā)現(xiàn)了哪些關(guān)鍵概念等我確認(rèn)后再寫頁面。Agent 會先匯報發(fā)現(xiàn)你確認(rèn)方向后它才開始寫。這一步的「討論要點(diǎn)」很關(guān)鍵別讓它直接悶頭寫否則容易建出一堆你不需要的頁面。4.3 檢索驗(yàn)證動作攝入完成后做一次召回測試。在 Obsidian 里打開 Wiki 目錄用搜索或 Dataview 查詢TABLE type, confidence, updated FROM wiki WHERE contains(tags, mcu-core) SORT updated DESC如果能看到剛攝入的頁面且[[wikilink]]能點(diǎn)擊跳轉(zhuǎn)說明索引和交叉引用都生效了。再打開 Graph View應(yīng)該能看到新頁面和已有頁面之間的連線——孤島頁面說明交叉引用沒寫夠需要讓 Agent 補(bǔ)。4.4 檢查 log.md 和 index.md最后確認(rèn)兩個文件log.md里應(yīng)該有這次攝入的追加記錄index.md里應(yīng)該新增了頁面條目。這兩個是 Wiki 的導(dǎo)航樞紐缺了它們知識庫就是一堆散文件。5. 本篇常見錯排查401、連接失敗與索引為空建庫過程中最容易卡在幾個固定報錯上這里逐個對照。報錯一401 Unauthorized最常見的原因是 Key 沒寫對或者帶了多余空格。檢查配置文件里的ANTHROPIC_API_KEY確認(rèn)是從控制臺完整復(fù)制的。如果 Key 確認(rèn)沒問題還報 401檢查是不是把 Base URL 和 Key 寫反了位置。報錯二local proxy failed / 連接失敗這個通常出現(xiàn)在客戶端配置里 Base URL 寫錯的情況。確認(rèn)寫的是https://taotoken.net/api不要加/v1后綴也不要加 UTM 參數(shù)。有些客戶端會自動拼路徑你只需要給根地址。報錯三reading choices 報錯 / 返回結(jié)構(gòu)異常如果返回里讀不到choices字段多半是 Model ID 寫錯了。去控制臺確認(rèn)你用的模型 ID 拼寫大小寫敏感。另外確認(rèn)請求體里model字段和配置里的一致。報錯四OAuth 相關(guān)報錯Claude Code 這類客戶端如果走了 OAuth 流程而不是 API Key會報 OAuth 錯誤。解決辦法是在配置里顯式指定 API Key 模式把三件套Base URL Key Model ID寫全不要依賴默認(rèn)的登錄態(tài)。報錯五索引為空 / 檢索召回不到建完庫搜不到內(nèi)容先檢查index.md有沒有被更新。如果 Agent 寫了頁面但沒更新 index說明 Skill 里的 Ingest Flow 第 5 步?jīng)]執(zhí)行到位。讓 Agent 重新跑一遍「更新導(dǎo)航」步驟。另外檢查頁面的tags是不是用了 SCHEMA 之外的野標(biāo)簽Dataview 查詢按標(biāo)簽過濾時野標(biāo)簽會導(dǎo)致召回失敗。報錯六交叉引用全是孤島Graph View 里頁面之間沒有連線說明[[wikilink]]沒寫夠。Skill 里要求每頁至少 2 個出站鏈接讓 Agent 做一次 Lint 檢查把孤立頁面列出來補(bǔ)鏈接。排障時如果拿不準(zhǔn)直接去接入文檔對照配置 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。文檔里有各客戶端的完整配置示例比對著改最快。6. 長期維護(hù)與下一步讓知識庫持續(xù)進(jìn)化建好 Wiki 只是起點(diǎn)維護(hù)才是讓它「越用越聰明」的關(guān)鍵。LLM Wiki 的維護(hù)工具鏈主要靠定期 Lint 和知識更新兩個動作。定期 Lint 讓 Agent 檢查四類問題孤立頁面沒有任何頁面鏈接到它、斷鏈[[wikilink]]指向不存在的頁面、過期內(nèi)容90 天未更新且源文件已變化、野標(biāo)簽用了 SCHEMA 之外的標(biāo)簽。跑一次 Lint 的指令很簡單對 wiki/ 做一次 Lint列出孤立頁面、斷鏈、過期內(nèi)容和野標(biāo)簽先別改等我確認(rèn)。知識更新則是當(dāng)新文檔出現(xiàn)時的處理流程新文檔 → 讀 → 對比已有頁面 → 更新/新建/標(biāo)記矛盾 → 更新 index 和 log。這里有個重要原則如果新信息和舊信息沖突不要直接覆蓋而是標(biāo)記contradictions: [page-name]兩方觀點(diǎn)都保留等人審核。知識庫的價值在于可追溯覆蓋掉舊觀點(diǎn)等于丟掉了判斷依據(jù)。如果你的建庫是長期持續(xù)的比如每周都有新文檔要攝入用 Coding Plan 比按次調(diào)用更劃算地址在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。建庫不是一次性任務(wù)選對計(jì)費(fèi)方式能省不少。最后說一個實(shí)用技巧Obsidian 的 Graph View 是你判斷知識庫健康度的最好工具。健康的 Wiki 應(yīng)該是一張密密麻麻的網(wǎng)每個點(diǎn)是一個概念每條線是一個關(guān)聯(lián)。如果你看到大量孤立的點(diǎn)說明交叉引用沒做到位回去讓 Agent 補(bǔ)鏈接。這就是 LLM Wiki 和傳統(tǒng)筆記的本質(zhì)區(qū)別——不是樹狀分類而是網(wǎng)狀關(guān)聯(lián)。