xerj-org/xerj

解決的問題

XERJ 是一個本地 AI 搜尋引擎，旨在防止程式代理因逐行讀取整個檔案而浪費令牌。它讓代理僅能取得所需的精確程式碼片段或文件，大幅降低輸入與輸出的令牌成本，同時維持高程式任務解決率。

運作方式

XERJ 無需手動設定模式，即可自動索引包含程式碼、文件、日誌、PDF 及其他結構化資料（CSV、JSON、SQLite）的資料夾。它使用 tree-sitter 進行 AST 意識的程式碼索引，確保索引的是符號與函數，而非僅僅是平面文字。系統提供與 Elasticsearch API 相容的 REST API，可與現有客戶端與儀表板無縫整合。同時支援 Model Context Protocol (MCP)，可直接作為工具整合至 AI 助手中。

適用對象

主要針對使用 AI 程式代理（如 Claude Code 或 Cursor）的開發者，他們希望減少令牌使用量，並在私人或小眾程式碼庫中提升代理準確度。也適合安全稽核員、日誌分析師，以及開發 RAG 應用的開發者，需要一個輕量、單一二進位搜尋後端。

主要特色

• 參考程式碼：讓代理能索引類似的開源專案，在撰寫新程式碼前找到現有解決方案。
• Elasticsearch 相容：實作 Elasticsearch REST API，可與現有工具無縫整合。
• 零設定自動索引：自動偵測檔案類型，並為任意資料夾建立索引。
• MCP 原生支援：內建對 Model Context Protocol 的支援，方便代理整合。
• 程式碼感知檢索：使用 tree-sitter 索引符號與行號，實現精確的程式碼檢索。
• 混合搜尋：單一查詢支援全文、向量（kNN）與混合搜尋。