📌 项目地址：xerj-org/xerj | ⭐ 5,408 颗星 | 🔧 Rust | 📜 未标注
项目地址：xerj-org/xerj | 5408 star | Rust
问题在哪
coding agent 理解代码库的方式很笨：用 grep 挨个翻文件，读一个烧一份 token。上下文窗口被无关代码填满，真正要的那几行反而被挤出去。
XERJ 的思路是先把文件夹自动建好索引，之后 agent 直接检索到精确的代码段落，附带 file:line 定位，不用再一行行读。数字上有两个来源：官方的受控研究里，agent 保持 16/16 解决率不变，输出 token 降到原来的约 1/2.7；用户日常报告大约省 5 倍。README 由此得出一个推论：配上它，便宜的小模型可以写出比贵模型更好的代码。
reference coding：先抄作业，再写代码
这是 XERJ 主打的用法，我觉得也是它最值得试的一点。流程是：给 agent 一个任务，它自动下载和任务最接近的开源仓库、建索引，先查别人怎么解决这个问题，然后才动手写自己的代码。相当于每次写代码前都自动做一次开源调研。
上手
最省事的装法是把这段 prompt 直接丢给 agent：
Install XERJ (docs: https://xerj.org/llms.txt), index this project's sources, and set up
reference coding: clone and index the open-source repos closest to what we're building,
and search how they solved a problem before writing code.
也可以自己跑：
curl -fsSL https://xerj.org/get | sh
xerj --insecure --data-dir ./data &
xerj init # 接入 Claude Code/Cursor（MCP + skill），一条命令
xerj autoindex ~/my-project
xerj search "how do we rotate the WAL segment" # 排序后的代码段落，带 file:line
xerj def "euler_to_rotationmatrix" # 跳转到定义：file:line + 函数签名
xerj gain # 统计实际省了多少，是计数不是估算
xerj def 值得单独提一句：直接给出函数定义的位置和签名，这正好补上了 agent 检索之后最常缺的一步。xerj gain 也很实在，不搞估算，把账算给你看。
Windows 安装和手动安装见 README 的 “Install by hand” 一节。
那个 –insecure 得认真看
README 用了一整段讲 --insecure，这个态度值得肯定。说清楚它到底做了什么：
- 关闭 TLS 和 API-key 认证。能碰到这个端口的任何调用者都是超级用户，可以读、删所有索引，包括所有
/_memory命名空间。 - 设计场景是单用户开发机。全新节点只绑定
127.0.0.1，想在别的网卡上明文绑定，程序会直接拒绝启动，除非你显式允许。 - 完整模型在仓库的
docs/SECURITY_MODEL.md。
一句话：多用户机器和共享环境里别裸跑这个模式。
社区玩法
加入方式不太一样：跑一次 XERJ，交一份简短的使用报告，就算加入了。
我的判断
这类“给 agent 加检索层”的项目核心问题只有一个：省的 token 是不是真的。XERJ 至少拿出了受控数据（16/16 持平、2.7 倍输出下降）和 xerj gain 这种可验证的计数方式，比大多数“提升效率 X%”的说法可信。如果你每天在 Claude Code 或 Cursor 里烧 token，花十分钟试一下 xerj init，再用 xerj gain 看看实际数字，值不值当场就有答案。