跳转至

License: MIT Rust 1.91+ MCP Rust 2024 Edition GitHub stars

Compendium
AI 原生 PDF 知识编译引擎

将 PDF 文档编译为结构化、可累积、可推理的知识库——为 Cursor、Claude 及其他 MCP 客户端提供长期记忆与推理后端。53 个 MCP 工具，纯 Rust 实现，单二进制部署。

5 分钟快速开始 安装指南 :fontawesome-brands-github: GitHub

核心能力

  • Karpathy 编译器模式

    PDF → 结构化 Markdown，支持 L0 → L1 → L2 → L3 知识金字塔。知识可累积、可解释、可演进，告别一次性 RAG。

    了解更多

  • 三路认知索引

    Tantivy 全文检索 + petgraph 知识图谱 + TF-IDF 向量嵌入，三路检索融合。不光找到内容，更理解上下文关系。

    查看 API

  • :material-ferris:{ .lg .middle } 纯 Rust 实现

    单二进制部署，零外部服务依赖。高性能 FFI 防波堤模式（Breakwater Pattern）——PdfiumEngine → Knowledge Engine 隔离。

    阅读架构

  • 增量编译

    Merkle 哈希检测变更，只编译有改动的 PDF。大规模知识库中保持高性能。

    知识编译指南

  • VLM 视觉理解

    条件性从 Pdfium 本地解析升档到远程 VLM 布局理解。扫描版和图片型 PDF 的 OCR 回退。

    VLM 集成

  • Code Mode

    将 53 个工具的 JSON Schema 开销压缩为 2 个 MCP 工具 + TypeScript API 资源。适合多步 ingest/query 任务流。

    Code Mode

一分钟安装

curl -fsSL https://raw.githubusercontent.com/smile9493/Compendium/main/install.sh | bash

docker pull smile9493/pdf-mcp:latest

git clone https://github.com/smile9493/Compendium.git
cd Compendium/pdf-module-rs
cargo build --release --bin pdf-mcp

快速体验

初始化知识库

compendium kb init ~/my-kb

创建 Karpathy 模板：schema/AGENTS.md（三口令）、wiki/index.md、raw/ 素材目录。

编译第一篇 PDF

用户: 帮我把 paper.pdf 编译到知识库
AI:  [调用 compile_to_wiki 工具]
     → raw/paper.md
     → raw/paper.compile_prompt.md
请阅读提取内容，提炼核心概念...

搜索知识库

用户: 搜索关于 HTTP/2 的知识
AI:  [调用 search_knowledge 工具]
     找到 3 条相关知识：
     1. HTTP/2 多路复用 (score: 0.92)
     2. HTTP/2 头部压缩 (score: 0.85)
     3. HTTP/2 vs HTTP/1.1 对比 (score: 0.78)

社区与资源