RTFM (rtfm-ai) - 开源 AI 代理上下文检索层

技能简介

RTFM（Retrieve The Forgotten Memory）是一款面向 AI 编程代理的开源本地化检索增强工具，专为 Claude Code、Cursor、Codex、Claude Desktop 等 MCP 客户端设计。它能在 30 秒内把整个项目（代码、文档、PDF、ADR、Obsidian Vault、法律条文、研究论文）索引到单一 SQLite 文件，让 AI 代理通过 rtfm_search 替代盲目 grep 的循环查找，从海量语料中精确定位目标段落。

作者因编写 ~50 页法国税法文章时遭遇"Claude Code 在 2,000 份法律语料中反复 grep、生成虚构引用"的问题而开发此工具——核心论点是：模型不笨，瓶颈在检索。RTFM 用渐进式披露（先看 300 token 元数据，再按需扩展）取代一次性上下文灌入，配套 OpenTelemetry GenAI 语义、NotebookLM 集成、跨项目 memory 快照等功能，并以 pip install rtfm-ai + Claude Code /plugin install rtfm@roomi-fields 一键部署。

核心能力

• 多格式解析：支持代码（AST-aware）、Markdown（header 解析）、法律 XML（BOFiP）、LaTeX、PDF（轻量 pdftext / 完整 marker-pdf）、Obsidian Vault、NotebookLM JSON 旁车等 50 行内可扩展的自定义解析器
• AST 级代码索引：文件版本历史无限保留，代码/文档按结构化 token 切分，支持语义图谱（file/code 双向链接）
• 混合检索：默认 FTS5 全文检索，可挂 FastEmbed ONNX（~85 MB）启用语义 + 混合搜索；评分透明，可解释
• Claude Code 插件：通过 /plugin marketplace add roomi-fields/claude-plugins 安装，零 pip、零依赖、自动 CLAUDE.md 注入、首次 prompt 时增量索引
• 跨项目 memory 索引：自动快照 ~/.claude/projects/*/memory/ 目录，SessionEnd hook 自动同步；~/.rtfm/memory.db 跨 18 个项目同时生效
• Obsidian Vault 原生支持：rtfm vault 自动检测 vault、解析 [[wikilinks]]，生成 _rtfm/index.md、graph.md（Mermaid）、corpus/ 等导航文件
• MCP 协议原生：rtfm-serve 暴露 rtfm_search / rtfm_expand 工具，可挂 Cursor / OpenAI Agents / 自定义代理

安装配置

1. Claude Code 方式（推荐）：/plugin marketplace add roomi-fields/claude-plugins → /plugin install rtfm@roomi-fields，无需 pip
2. 手动方式（其他 MCP 客户端）：pip install rtfm-ai（Python ≥3.10），rtfm init 初始化，配置 MCP client 指向 rtfm-serve
3. 可选扩展：/rtfm:install-embeddings（FastEmbed ONNX）、/rtfm:install-pdf（pdftext 50MB）、/rtfm:install-pdf-full（marker-pdf + CPU torch ~1.5 GB）

使用步骤

1. 在项目根目录执行 rtfm init，生成 .rtfm/library.db（本地索引库）
2. 输入任务描述，Claude Code 自动调用 rtfm_search 返回 Top 结果（每条 ~300 token 元数据）
3. 代理通过 rtfm_expand(source, target_section) 按需展开指定段落，无需读全文
4. 重新发起 prompt 时增量索引新文件；rtfm history 查看任意文件的历史演变
5. 执行 rtfm memory --install-hook 开启 SessionEnd 自动快照，所有 Claude 项目 memory 自动归档

适用场景

• 大型代码库导航：>1k 文件、跨多个服务的 monorepo，需要在代码 + ADR + 文档间快速定位
• 法律 / 监管文档处理：欧盟法规 BOFiP、行业规范、企业合规文本（2,000+ 文件规模）
• 学术 / 研究项目：LaTeX 论文、PDF 综述、文献笔记的多格式索引与引用
• Obsidian Vault 长尾检索：1,700+ 笔记的个人知识库，wikilink 关系网查询
• 跨项目 memory 复用：同时维护 5+ 个 Claude Code 项目，需要共享 OAuth/Auth 等决策记忆

适用人群

• 用 Claude Code / Cursor / Codex 处理 ≥5 个并行任务的资深开发者
• 法律合规、研究分析、技术文档团队中需要"找得到"胜过"写得快"的用户
• 个人 / 团队 Obsidian Vault 达到 500+ 笔记、希望用 AI 检索代替手工 index 文件的知识管理者

工作原理

RTFM 把项目内容按格式解析为结构化 token，存入单一 SQLite 文件；FTS5 全文索引为默认底座，可叠加 FastEmbed ONNX 启用语义 + 混合检索。代理先调 rtfm_search 拿到 300 token 的元数据（路径 / 摘要 / 评分），再按需 rtfm_expand 展开具体段落——这是"渐进式披露"模式，相比一次性灌入几万 token 上下文，token 成本可降低 ~51%、完成时间更长 ~60%（基于官方 B10 法国税法文章基准）。

官方链接

• PyPI：https://pypi.org/project/rtfm-ai/
• GitHub：https://github.com/roomi-fields/rtfm
• Claude Code Marketplace：https://github.com/roomi-fields/claude-plugins
• 配套 NotebookLM MCP：https://github.com/roomi-fields/notebooklm-mcp
• 许可证：MIT（免费 / 本地 / 开源）