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 代理创建者：希望为其代理提供高精度检索工具，以导航复杂的代码库或文档集。
• 重视数据隐私的用户：需要本地优先的索引和嵌入模型。

主要亮点

• 混合搜索：结合语义、词汇和正则搜索，平衡发现能力与精确度。
• 代理就绪：内置对代理的支持，使其能自主决定何时以及如何搜索。
• 本地优先：将文件、索引和模型保留在用户机器上。
• 多格式支持：可处理源代码和散文，同时保留结构和源位置信息。
• 性能优化：减少代理的模型上下文噪声和工具调用频率。