zvec-grep

本地工作区一句话搜代码和文档，人和 AI 都能用

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署搜索知识 🍴 复刻 260 🐛 待处理 91 👀 关注 14

GitHub ↗

GitHub 星标 ★ 4239

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源免费，无在线服务

项目预览

项目数据

分类搜索知识

开发团队zvec-ai

GitHubhttps://github.com/zvec-ai/zvec-grep

定价模式🏷️完全免费

价格说明开源免费，无在线服务

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议Apache-2.0

主要语言Rust

技术栈/模型ai-agents,bm25,cli,code-search,full-text-search,local-first,mcp,ripgrep,semantic-search,vector-search

GitHub 星标★ 4239

上线时间2026-07-10 00:00:00

代码更新2026-11-06

仓库体积75.6 MB

本站数据更新2026-11-06

维护状态活跃

收录时间2026-09-22

浏览次数2

项目介绍

zvec-grep 是一个用 Rust 编写的本地优先搜索工具，面向开发者和 AI Agent 场景，目标是在整个工作区里做统一检索。它把传统全文搜索（BM25、ripgrep 式代码搜索）与向量检索、语义搜索结合起来，既能按关键词精确命中代码和文档，也能按语义找到相关片段。项目提供 CLI 和 MCP 接口，方便人类直接在终端使用，也方便 AI Agent 通过 MCP 协议调用，把本地工作区变成可被模型检索的知识库。相比把代码或文档上传到云端索引，它强调数据留在本地、无需联网，适合对隐私和延迟敏感的场景。核心能力包括：跨文件全文检索、代码搜索、语义/向量检索、本地索引、面向 Agent 的检索接口。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-09-22 · 当前星标 ★ 4239

技术标签

ai-agents bm25 cli code-search full-text-search

使用教程

⚠ 本教程由 AI 依据该项目 README 整理；原始文档不完整，部分步骤为通用流程推断，实际安装请以项目官方文档为准。

难度：入门约 10 分钟部署方式：命令行工具 5 步

⚠ 该项目 README 未提供完整安装说明，以下步骤为通用流程，请以官方文档为准。

环境要求

可用的 Node.js / npm 环境（项目通过 npm 包 @zvec/zvec-grep 分发）
一个本地工作区或文件目录，用于建立本地索引
本地磁盘空间，用于存放索引文件
无需联网：项目为本地优先设计，数据不需要上传云端

安装与启动步骤

1检查 Node 环境

项目以 npm 包形式发布，先确认本机已装 Node.js 与 npm，能正常输出版本号即可。
```
node -v
npm -v
```
2安装 zvec-grep

从 npm 安装官方包 @zvec/zvec-grep，全局安装后即可在任意目录调用命令行工具。
```
npm install -g @zvec/zvec-grep
```
3进入工作区

切换到你要检索的本地代码或文档根目录，索引会围绕该目录构建，请改成自己的真实路径。
```
cd /your/workspace
```
4准备示例数据

README 第 1 节标题为 Set up a sample bookshelf，节选未给出具体命令，请对照完整 README 执行。
5执行本地检索

在终端用 CLI 搜索，或让 AI Agent 通过 MCP 协议调用；具体子命令与参数请以官方 README 为准。