SamurAIGPT/llm-wiki-agent

A personal knowledge base that builds and maintains itself. Drop in sources — Claude (or Codex/Gemini) reads them, extracts knowledge, and maintains a persistent interlinked wiki. Works with Claude Code, Codex, OpenCode, Gemini CLI. No API key needed.

解決的問題

LLM Wiki Agent 將零散的文件(PDF、DOCX 等)轉換為結構化、互連的 Markdown 維基。與在查詢期間檢索原始文本塊的傳統 RAG 系統不同,此工具將知識編譯成持久的頁面,隨時間推移不斷累積與複合,自動建立交叉引用並標記來源之間的矛盾。

工作原理

該系統作為編碼代理(如 Claude Code、Codex 或 Gemini CLI)的技能運行。它使用一組模式文件(如 CLAUDE.md)來指示代理如何維護維基。

當使用者觸發 ingest 命令時,代理會讀取來源文件(透過 markitdown 轉換非 Markdown 文件),並提取知識以建立或更新實體頁面(人物、公司)、概念頁面(想法、框架)和動態概覽。它還使用 NetworkX 和 Louvain 社群檢測構建知識圖譜,生成一個自包含的 graph.html 檔案,用於視覺化顯式維基連結與推斷的語義關係。

適用對象

  • 研究人員:需要從多篇學術論文和報告中綜合資訊的人員。
  • 學生或讀者:想要建立書籍角色與論點主題圖譜的人員。
  • 知識工作者:管理個人知識庫或商業智慧(會議記錄、專案文件)的人員。
  • 競爭分析師:長期追蹤市場趨勢與公司公告的人員。

亮點

  • 持久知識:建立跨會話持久存在的結構化 Markdown 頁面,而不是依賴於瞬時的聊天歷史。
  • 自動綜合:自動生成實體與概念頁面,並更新所有攝取內容的動態概覽。
  • 矛盾檢測:在攝取時標記新舊來源之間的衝突主張。
  • 多格式支援:攝取包括 PDF、DOCX、PPTX、XLSX 和 HTML 在內的多種格式。
  • Obsidian 整合:設計用於與 Obsidian 相容,允許使用者將代理生成的維基作為庫(vault)進行瀏覽。
  • 視覺化知識圖譜:生成知識網路的互動式 HTML 視覺化。