1. 项目定位与用途
zvec-grep（zg）是面向人类开发者与AI Agent的本地优先工作区搜索工具，由zvec-ai开发，底层基于zvec统一整合ripgrep关键词搜索、BM25排序与向量语义搜索三种能力，提供统一的搜索接口。支持通过命令行直接使用，也可为AI Agent、MCP客户端提供标准化搜索能力，覆盖代码、文档、结构化数据等多类型内容的检索需求。
项目档案开源项目
zvec-ai/zvec-grep 是什么？用途、安装与使用指南
zvec-ai/zvec-grep：zvec-grep（zg）是本地优先的工作区搜索工具，统一整合ripgrep关键词搜索、BM25排序与向量语义搜索能力，既支持人类开发者命令行使本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
zvec-grep（zg）是本地优先的工作区搜索工具，统一整合ripgrep关键词搜索、BM25排序与向量语义搜索能力，既支持人类开发者命令行使用，也可为AI Agent提供标准化搜索接口，默认本地存储保障用户隐私。
中文项目介绍
zvec-grep（简称zg）是由zvec-ai开发的本地优先工作区搜索工具，底层基于zvec统一整合ripgrep关键词搜索、BM25排序与向量语义搜索三种能力，为人类开发者与AI Agent提供统一的搜索接口。
它解决了传统工作区搜索中关键词精确匹配与语义模糊搜索能力割裂、多格式内容（代码、文档、结构化数据）解析支持不足的问题，减少搜索时的工具调用次数与上下文开销，同时默认本地存储数据保障用户隐私。
适用场景包括本地工作区代码/文档混合搜索、AI Agent辅助代码理解与问题排查、通过MCP协议为支持MCP的客户端提供搜索能力等，支持macOS、Linux与Windows系统。
详细信息与使用说明
2. 解决的问题
传统工作区搜索工具普遍存在关键词精确匹配与语义模糊搜索能力割裂、多格式内容解析支持不足的问题，导致开发者与AI Agent搜索时需要多次调用不同工具、消耗大量上下文。zvec-grep通过统一搜索接口、混合排序能力与多格式内容解析，减少搜索时的工具调用次数与上下文开销，同时默认本地存储数据保障用户隐私。
3. 适用场景
1. 本地工作区代码、文档、结构化数据的混合搜索；2. AI Agent对接工作区搜索能力，辅助代码理解、问题排查与需求实现；3. 通过MCP协议为支持MCP的客户端（如各类AI开发工具）提供标准化搜索能力；4. 需要保障数据隐私的本地化搜索需求场景。
4. 安装方式
项目要求Node.js 22及以上版本，支持两种安装方式：1. 全局安装命令行工具：执行npm install -g @zvec/zvec-grep即可全局使用zg命令；2. 作为npm依赖集成到Node.js项目中
思维导图
当前仓库信息不足，或结构不够稳定，暂时没有生成可靠的思维导图。
常见问题
zvec-ai/zvec-grep 是做什么的？
zvec-grep（zg）是本地优先的工作区搜索工具，统一整合ripgrep关键词搜索、BM25排序与向量语义搜索能力，既支持人类开发者命令行使用，也可为AI Agent提供标准化搜索接口，默认本地存储保障用户隐私。
zvec-ai/zvec-grep 适合用在什么场景？
zvec-grep（zg）是面向人类开发者与AI Agent的本地优先工作区搜索工具，由zvec-ai开发，底层基于zvec统一整合ripgrep关键词搜索、BM25排序与向量语义搜索三种能力，提供统一的搜索接口。支持通过命令行直接使用，也可为AI Agent、MCP客户端提供标准化搜索能力，覆盖代码、文档、结构化数据等多类型内容的检索需求。
zvec-ai/zvec-grep 如何安装？
项目要求Node.js 22及以上版本，支持两种安装方式：1. 全局安装命令行工具：执行npm install -g @zvec/zvec-grep即可全局使用zg命令；2. 作为npm依赖集成到Node.js项目中
zvec-ai/zvec-grep 如何开始使用？
仓库中未明确给出完整使用步骤，建议结合 README、示例代码或文档章节开始上手。