lumen
为AI编程代理提供本地语义代码搜索，优化成本与效率。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：lumen。 它的用途是：为AI编程代理提供本地语义代码搜索，优化成本与效率。 完整的 Skill 内容见：https://321skill.com/skills/lumen/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'在Prometheus代码库中，查找处理指标标签去重逻辑的相关代码。'，Lumen会通过语义搜索快速定位到`tsdb/head.go`文件中处理`series`哈希冲突的片段，而不是让AI代理去读取整个庞大的Go文件，从而节省大量Tokens和等待时间。
介绍
Lumen是一个专为AI编程代理设计的本地语义代码搜索引擎。它解决了AI代理（如Claude Code）在处理大型代码库时需要读取整个文件来寻找相关信息，导致Token消耗高、响应慢、成本高的问题。
Lumen通过嵌入模型（如Ollama）为代码库创建语义索引，当AI代理需要查找代码时，Lumen能快速定位最相关的代码片段，无需读取整个文件。它完全本地运行，无需API密钥或云端服务，仅需一个静态二进制文件和本地嵌入服务器。
它非常适合需要频繁与大型、复杂代码库交互的开发者，尤其是使用AI辅助编程工具（如Claude Code、Cursor）进行代码理解、调试或重构时。
建议在使用前确保本地嵌入服务器（如Ollama）已正确安装并运行，并根据项目规模预留足够的索引构建时间。对于小型或简单项目，其带来的效率提升可能不如大型项目显著。
核心特点
核心区别在于完全本地化运行，无需任何外部API或云服务，保护代码隐私；同时，通过提供语义搜索而非简单关键词匹配，能更精准地理解代码意图，实测可显著降低AI代理的Token消耗和任务完成时间。
注意事项
不适合代码库非常小或结构极其简单的项目，其索引构建和搜索优势可能不明显。
常见问题
Lumen需要联网吗？
不需要。Lumen是完全本地的语义搜索引擎，嵌入模型和数据库都在本地运行。
Lumen支持哪些AI编程工具？
支持Claude Code、Cursor、Codex、OpenCode等主流AI编程代理。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/lumen/raw/index.md 读取 lumen 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/lumen/raw/index.md（查看排版版本）