llm-wiki

EN · A Claude Code plugin that turns your reading into a queryable personal wiki — powered entirely by Claude, zero dependencies.

中文 · 一个 Claude Code 插件，把你阅读的文章、论文、笔记，自动沉淀为可检索的个人知识库。零外部依赖，Claude 全程驱动。

Inspired by Andrej Karpathy's LLM Wiki pattern.

---

How It Works · 工作原理

The system has three layers. Raw sources never change. Claude owns the wiki layer entirely.

系统分三层。原始资料永不改动。Wiki 层由 Claude 全权维护。

graph TD
    subgraph Input["📥 Input Layer · 输入层"]
        A[📄 Articles · 文章]
        B[📑 Papers · 论文]
        C[📝 Notes · 笔记]
        D[📊 Any text file · 任意文本]
    end

    subgraph Sources["🗄️ sources/  —  Immutable · 不可变"]
        E[Raw files · 原始文件\nNever modified · 永不修改]
    end

    subgraph Wiki["🧠 wiki/  —  Claude-maintained · Claude 维护"]
        F[concepts/ · 概念页\nIdeas, frameworks, methods]
        G[entities/ · 实体页\nPeople, tools, papers]
        H[insights/ · 洞察页\nCross-document synthesis]
        I[index.md · 目录\nContent catalog]
        J[log.md · 日志\nAppend-only history]
    end

    subgraph Output["💬 Query · 查询"]
        K[Ask anything · 自然语言提问\nAnswers with citations · 带引用回答]
    end

    A & B & C & D --> |"/ingest"| E
    E --> |"wiki-ingest-agent"| F & G & H
    F & G & H --> I
    I --> K

---

Data Flow · 数据流

How a single /ingest call becomes structured knowledge:

一次 /ingest 调用如何变成结构化知识：

flowchart LR
    S([📄 Source file\n源文件]) --> R[Read · 读取]
    R --> X{Extract · 提取}

    X --> C[Concepts\n概念]
    X --> E[Entities\n实体]
    X --> I[Insights\n洞察]

    C & E & I --> CHK{Page exists?\n页面已存在?}
    CHK -- No · 否 --> NEW[Create new page\n新建页面]
    CHK -- Yes · 是 --> UPD[Update existing\n更新已有页面]

    NEW & UPD --> SRC[Add ## Sources\n添加来源引用]
    SRC --> IDX[Update index.md\n更新目录]
    IDX --> LOG[Append log.md\n追加日志]
    LOG --> DONE([✅ Done · 完成])

---

Commands · 命令

Command · 命令	Type · 类型	Description · 说明
/wiki-init	Setup · 初始化	Scaffolds wiki structure in current project · 在当前项目创建完整 wiki 骨架
/ingest <file>	Agent · 自主摄入	Autonomous agent extracts and stores knowledge · 自主 Agent 提取知识并写入 wiki
(ask anything)	Auto · 自动感知	Claude reads wiki before answering knowledge questions · 问问题时自动检索 wiki
/lint	Health check · 健康检查	Reports orphans, stale links, missing citations · 报告孤立页、失效链接、缺失引用

---

Wiki Health Checks · 健康检查项

What /lint verifies on every run:

graph LR
    L(["/lint"]) --> A["🔴 E001\nStale index entries\n失效目录条目"]
    L --> B["🔴 E002\nMissing Sources sections\n缺失来源引用"]
    L --> C["🟡 W001\nOrphan pages\n孤立页面"]
    L --> D["🟡 W002\nContradictions\n潜在矛盾"]

    A & B --> ERR[Errors · 错误\nMust fix · 必须修复]
    C & D --> WARN[Warnings · 警告\nShould fix · 建议修复]

Lint reports only — never auto-fixes. You decide what to change.

/lint 只报告，不自动修改。修什么由你决定。

---

Install & Quickstart · 安装与快速上手

Install · 安装

/plugin install JulyanXu/llm-wiki

Quickstart · 快速开始

# 1. One-time setup in your project · 在项目中一次性初始化
/wiki-init

# 2. Put any file in sources/ and ingest it · 将文件放入 sources/ 并摄入
cp ~/Downloads/karpathy-essay.md sources/
/ingest sources/karpathy-essay.md

# 3. Ask questions naturally · 自然语言提问（自动感知，无需手动触发）
# "What do I know about RAG?"
# "我了解的 Transformer 注意力机制是什么？"
# "Summarize what I've learned about scaling laws"

# 4. Periodically check wiki health · 定期检查 wiki 健康状态
/lint

---

Project Layout · 项目结构

your-project/
├── CLAUDE.md          ← Wiki schema (auto-generated) · Wiki 规范（自动生成）
├── index.md           ← Content catalog · 内容目录
├── log.md             ← Append-only ingest history · 追加式摄入日志
├── sources/           ← Raw files, never modified · 原始资料，永不修改
└── wiki/
    ├── concepts/      ← Ideas, frameworks, methods · 概念、框架、方法
    ├── entities/      ← People, tools, papers · 人物、工具、论文
    └── insights/      ← Cross-document synthesis · 跨文档综合洞察

---

Design Principles · 设计原则

Principle · 原则	Why it matters · 为什么重要
Zero dependencies · 零依赖	No vector DBs, no external APIs. Works anywhere Claude Code runs. · 无向量数据库，无外部 API。哪里有 Claude Code 哪里就能用。
Sources are immutable · 原始资料不可变	Wiki is a derived layer. Originals are always there to re-check. · Wiki 是派生层，原始资料永远可以回溯验证。
Every page cites its source · 每页必须标注来源	Prevents hallucination drift across ingest cycles. · 防止多次摄入后知识与原文偏离。
Lint reports, never auto-fixes · 只报告不自动修复	Knowledge curation is a human judgment call. · 知识整理是人的判断，工具只提供信息。

---

License · 许可证

MIT © Julyan