xerj
SHA-256XERJ 是本地 AI 搜索引擎，一条命令自动索引任意文件夹，让编程 Agent 精准检索代码片段，比 grep 省 2.7 倍 Token。
让 AI 一条命令读懂你的数据，检索精准又省 Token
核心功能
- 一条命令自动索引代码、文档、日志、PDF、SQLite、CSV 等各类文件
- 兼容 Elasticsearch API，现有客户端开箱即用
- 混合检索：BM25 关键词 + kNN 向量 + 语义排序
- 内置 Agent 长期记忆，跨会话按语义召回
- 单文件静态二进制，Rust 编写，无需 JVM 或外部服务
避坑指南
- •-insecure 模式会关闭 TLS 加密和身份验证，任何能访问该端口的程序都拥有最高权限，可读写甚至删除全部索引，因此仅限本机单人开发使用，切勿绑定到局域网或公网地址。其次，对于模型早已熟悉的流行开源库收益有限，真正省 Token 的场景是私有代码、内部系统和冷门项目。另外，默认词法嵌入可离线使用，但启用神经嵌入需额外下载约 90MB 模型文件。
适用场景
- 参考编码：索引相近的开源项目，写代码前先检索现成实现方案
- 代码库问答与 RAG：直接返回带行号的代码片段而非整个文件
- 安全审计：跨全部文件类型检索危险调用、密钥和敏感模式
- 日志与故障分析：混合格式日志自动转为可聚合的结构化索引
- Agent 长期记忆：把学到的经验存入记忆空间，下次会话按含义召回
XERJ 是专为编程 Agent 打造的本地 AI 搜索后端。一条 autoindex 命令即可自动扫描任意文件夹——代码、文档、日志、PDF、SQLite 甚至格式混乱的 CSV——生成可查询的索引，用于检索、RAG、安全审计和 Agent 长期记忆。实测显示，使用 XERJ 做参考编码（先索引相近开源项目、检索现成方案再写代码）的 Agent，输出 Token 比 grep 方式少 2.7 倍、比纯记忆方式少 26 倍，且任务完成率相同。相比自行部署 Elasticsearch，XERJ 是单个 Rust 静态二进制、无需 JVM，却保持 ES 接口兼容（1366/1369 一致性测试通过），现有客户端开箱即用。它提供 BM25 + 向量混合检索、基于 tree-sitter 的代码符号定位（精确到文件和行号）、默认离线词法嵌入、原生 MCP 支持，以及 /_memory 记忆空间。最适合私有、内部或冷门代码库等模型没有现成知识的场景。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
运行 curl -fsSL https://xerj.org/get | sh 安装单文件程序
执行 xerj --insecure --data-dir ./data & 启动本地服务（仅限本机单人使用）
运行 xerj init 一键接入 Claude Code 或 Cursor
- 运行 curl -fsSL https://xerj.org/get | sh 安装单文件程序
- 执行 xerj --insecure --data-dir ./data & 启动本地服务（仅限本机单人使用）
- 运行 xerj init 一键接入 Claude Code 或 Cursor
已提供 SHA-256 校验码，下载后可自行核对文件完整性
该校验码提取自 GitHub 官方 Release 页面
SHA256 校验码
557d1f5dc9fbb151035d0e4b5e2da3032f8c3224f54fe235055c1cc70eced25b该校验码提取自 GitHub Release 页面，下载后请自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
删除 xerj 二进制文件（通常位于 ~/.local/bin 或 /usr/local/bin），再删除启动时通过 --data-dir 指定的数据目录。若执行过 xerj init，还需在 Claude Code 或 Cursor 的 MCP 配置中移除 xerj 相关条目。无后台守护进程或系统服务残留，清理即完成。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
5 FAQs