zvec-ai/zvec-grep

它解決的問題

zvec-grep (zg) 提供了一個統一的、以本地為首的搜尋層，讓人類與 AI 代理都能在原始碼、文件和結構化資料中找到資訊。它解決了大型工作區中搜尋效率低下的問題——關鍵字搜尋（如 grep）過於僵化，而純語意搜尋又可能不精確，進而減少代理尋找正確證據所需的工具呼叫次數與 token 數量。

如何運作

它將三種不同的搜尋方法整合到單一介面中：

1. Ripgrep：用於精確的文字與正規表示式比對。
2. BM25：用於傳統的詞彙排序。
3. 向量搜尋：基於語意的發現。

使用者可將工作區本地索引化，並透過 CLI 使用此工具，或透過 Model Context Protocol (MCP) 將其整合至 AI 代理（如 Claude Code 或 OpenCode）。預設情況下，資料與索引都保留在本地機器上。

適用對象

• 開發者：希望擁有一個強大、多模式的搜尋工具來處理本地檔案。
• AI 代理開發者：希望為其代理提供高精度的檢索工具，以在複雜的程式碼庫或文件集之間導航。
• 重視資料隱私的使用者：需要以本地為首的索引與嵌入模型。

主要特色

• 混合搜尋：結合語意、詞彙與正規表示式搜尋，平衡發現性與精確度。
• 代理就緒：內建代理整合，讓代理能自主決定何時以及如何搜尋。
• 以本地為首：將檔案、索引與模型保留在使用者的機器上。
• 多格式支援：能處理原始碼與散文，同時保留結構與原始位置資訊。
• 效能優化：減少代理的模型上下文雜訊與工具呼叫頻率。