ory/lumen

Save 30% token costs when using Claude Code, Codex, OpenCode for free - with open source, local semantic search. Works for small and large codebases and monorepos! Enterprise-ready and fully compliant via Ollama and SQLite-vec.

解决的问题

AI 编码代理在处理大型代码库时常常遇到困难，因为它们试图读取整个文件，这既慢又昂贵。Lumen 提供了一个本地语义搜索引擎，作为这些代理的地图，使它们能够只检索与任务相关的特定函数、类型或模块。

工作原理

Lumen 作为一个 MCP（模型上下文协议）服务器，位于你的代码库和 AI 代理（如 Claude Code、Cursor 或 Codex）之间。它使用 Merkle 树来检测文件更改，并且只重新索引已修改的内容。它使用原生 AST 或 tree-sitter 将代码解析为语义块，使用本地模型（通过 Ollama 或 LM Studio）将这些块转换为向量嵌入，并将它们存储在带有 sqlite-vec 的本地 SQLite 数据库中。当代理需要信息时，它会查询此索引以找到相关的代码片段，而不是读取整个文件。

适用人群

使用 AI 编码代理并希望降低 API 成本、提高响应时间、保持高质量代码生成而无需将代码库发送到云端的开发者。

亮点

零云隐私： 所有索引和嵌入都在本地机器上进行。
显著的效率提升： 基准测试显示，在各种编程语言中，成本降低高达 39%，会话完成速度提高 53%。
增量索引： 使用 Merkle 树差异检测确保只重新处理更改的文件，使大型项目的更新几乎即时。
广泛的语言支持： 支持 12 种语言族，包括 Go、Python、TypeScript、Rust 和 Java。
Git 工作树感知： 自动在 Git 工作树之间共享索引数据，避免冗余处理。