nvk/llm-wiki

llm‑wiki – 供 AI 代理程式編譯的 LLM 知識庫

這是什麼 – llm‑wiki 是一個開源系統，讓大型語言模型代理程式（Claude、OpenAI Codex、OpenCode、Pi 等）能夠建立、維護並查詢個人或團隊的維基。該維基以結構化且相容於 Obsidian 的資料夾佈局儲存想法、研究、專案和產物，而代理程式可以自動擷取來源、執行平行研究、稽核內容，並將審查過的摘要推進為可交付的專案。

核心概念

• 工作階段 – 可選的每個代理程式記憶體，記錄代理程式在維基工作階段中所做過的事情；可以由使用者個別停用。
• 介面卡 – 一個私有、清單驅動的外掛系統，將擷取和寫入操作路由至特定供應商（例如：網頁、CSV、media‑wiki），同時將身分驗證和副作用保持在嚴格控制之下。
• 研究模式 – 單次查詢、深度多代理程式研究、論文驅動的調查，以及專家方法選擇。
• 匯出檢查點 – docs/knowledge/<slug>/ 快照，包含專案知識的確定性、最小隱私交接。

支援的執行階段

執行階段	如何呼叫	唯讀查詢大小	完整研究大小
Claude Code (原生)	/wiki:… 指令或 @wiki 技能	wiki:query (≈2.8 KB)	@wiki (≈11.7 KB)
OpenAI Codex (市集)	安裝外掛後使用 $wiki-query 或 @wiki	與 Claude 相同	與 Claude 相同
OpenCode (指令檔)	將 SKILL.md URL 加入 opencode.json	wiki-query/SKILL.md	wiki-manager/SKILL.md
Pi / DS4 (本地模型)	./scripts/pi-wiki-query (唯讀) 或 pi --skill …/wiki-manager/SKILL.md (完整)
其他任何 LLM 代理程式	複製 profiles/query-lite/SKILL.md (唯讀) 或 AGENTS.md (完整)

安裝捷徑

• Claude Code – claude plugin install wiki@llm-wiki
• Codex – codex plugin marketplace add nvk/llm-wiki && codex plugin add wiki@llm-wiki
• OpenCode – 將遠端 SKILL.md URL 加入 opencode.json（或在本機 curl）
• Pi – pi --skill path/to/llm-wiki/plugins/llm-wiki-opencode/skills/wiki-manager/SKILL.md

典型工作流程

1. 建立 / 選擇主題 – /wiki:research "nutrition" --new-topic
2. 擷取來源 – /wiki:ingest https://example.com/article 或使用 ingest‑collection 進行大量匯入。
3. 執行研究 – @wiki research "gut‑brain axis" --deep --min-time 2h（生成多個代理程式進行閱讀、摘要和交叉比對）。
4. 查詢編譯的知識 – /wiki:query "How does fiber affect mood?" (唯讀) 或從任何 LLM 使用 wiki-query。
5. 推進摘要 – @wiki audit --project coldcard-threat-model 將審查過的摘要移至交付專案。
6. 匯出檢查點 – v0.24.0 新增了一個指令，可在 docs/knowledge/ 下寫入可重現的快照以供交接。

架構重點

• Claude 優先的單一真相來源 – 標準技能位於 claude-plugin/skills/wiki-manager/SKILL.md。特定執行階段的包裝器（Codex、OpenCode、Pi）會透過同步腳本自動生成。
• 私有介面卡協定 (llm‑wiki‑adapter/v1) – 介面卡宣告意圖、URL 路由和讀寫權限。沒有任何供應商憑證會被硬編碼到維基中；介面卡會強制執行確切的白名單和冪等金鑰。
• 檔案系統中樞 – 維基位於使用者可設定的目錄中（預設為 ~/.config/llm-wiki，備用為 ~/wiki）。該系統完全相容於 Obsidian，因此使用者可以視需要手動編輯筆記。
• 沙盒友善性 – 每個執行階段都有明確記錄的 nono 沙盒政策，確保代理程式擁有所需的最小讀寫權限。

為何重要

• 為 LLM 代理程式提供一個持久且可搜尋的知識儲存庫，而不是無狀態的提示。
• 實現可重現的研究流程：擷取 → 平行分析 → 稽核 → 匯出。
• 跨越主要 LLM 代理程式生態系統（Claude、Codex、OpenCode、本地模型）運作，並具有單一真相來源。

限制 / 注意事項

• 該系統假設主機代理程式可以讀寫維基目錄；沙盒環境必須授予這些權限。
• 完整研究指令具有寫入能力並會修改檔案；當您只需要查詢時，請使用唯讀的 wiki‑query 技能。
• 匯出的檢查點是唯讀的；它們永遠不會自動提交或發佈變更。

哪裡可以了解更多

• 專案網站：https://llm‑wiki.net/
• GitHub 儲存庫：https://github.com/nvk/llm-wiki（請參閱 README.md、CHANGELOG.md 和 tests/ 目錄以進行同步驗證）
• 快速入門範例位於 README 的 Quick Start 部分。