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 可视化。