zvec-grep

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

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

开源 free 搜索知识
访问官网 ↗ GitHub ↗ 文档 ↗
GitHub 星标 ★ 3629
维护状态 活跃
是否开源
定价模式 free

项目数据

分类搜索知识
开发团队zvec-ai
所属国家
官网地址
定价模式free
价格说明开源免费,无在线服务
访问状态
是否开源
开源协议Apache-2.0
主要语言Rust
技术栈/模型ai-agents,bm25,cli,code-search,full-text-search,local-first,mcp,ripgrep,semantic-search,vector-search
GitHub 星标★ 3629
30天Star增速
HF 下载量
上线时间2026-07-10 00:00:00
最近更新2026-09-21 00:00:00
维护状态活跃
中文支持
访问方式
移动端支持
综合评分
收录时间2026-09-22
浏览次数0

使用教程

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

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

环境要求

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

安装与启动步骤

  1. 1检查 Node 环境

    项目以 npm 包形式发布,先确认本机已装 Node.js 与 npm,能正常输出版本号即可。

    node -v
    npm -v
  2. 2安装 zvec-grep

    从 npm 安装官方包 @zvec/zvec-grep,全局安装后即可在任意目录调用命令行工具。

    npm install -g @zvec/zvec-grep
  3. 3进入工作区

    切换到你要检索的本地代码或文档根目录,索引会围绕该目录构建,请改成自己的真实路径。

    cd /your/workspace
  4. 4准备示例数据

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

  5. 5执行本地检索

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

如何确认成功

终端能查到 @zvec/zvec-grep 的安装版本、并正常输出工具帮助信息,即表示安装成功。

常见问题

Q:使用它需要把代码上传到云端吗?

A:不需要。项目强调本地优先、数据留在本地,索引和检索都在本机完成,适合隐私和延迟敏感的场景。

Q:它支持哪些检索方式?

A:同时支持传统全文搜索(BM25、ripgrep 式代码搜索)和向量语义检索,既能按关键词精确命中,也能按语义找到相关片段。

Q:AI Agent 怎么接入?

A:项目提供 MCP 接口,Agent 可通过 MCP 协议调用,把本地工作区变成模型可检索的知识库;人类也可直接用 CLI。

Q:安装命令在 README 里没找到怎么办?

A:本教程依据 README 节选推断,安装与使用细节请以仓库中完整的 README / README_CN.md 为准。

注意事项

  • README 节选中未包含完整安装命令与参数说明,实际命令请以仓库官方文档为准。
  • 项目采用 Apache 2.0 许可,商用前建议确认许可条款。
  • 命令行工具名称与子命令未在节选中给出,请勿凭猜测随意传参。

核心亮点

  • Rust 实现,本地索引与检索,无需上传代码,隐私和延迟友好
  • 同时支持 BM25/ripgrep 式关键词搜索与向量语义搜索,兼顾精确和模糊匹配
  • 提供 CLI 和 MCP 接口,AI Agent 可直接接入,适合做本地知识检索层

不足之处

  • 向量检索需要本地嵌入模型或额外配置,首次使用门槛高于纯 grep 工具
  • 项目处于成长阶段,生态集成和长期维护情况待观察

适用场景

  • 开发者在大型代码库中快速定位函数、配置或文档片段
  • AI 编程助手通过 MCP 检索本地仓库上下文,减少幻觉
  • 团队在离线或内网环境中搭建私有代码/文档搜索

替代项目

ripgrep、Sourcegraph、Meilisearch

项目介绍

zvec-grep 是搜索知识领域的开源项目,由 zvec-ai 开发,是 2026 年新上线的项目。

在全站 12,909 个收录项目中,它的 GitHub 星标数(3,629)位列前 30%,在搜索知识分类的 579 个项目里位列前 13%。

项目目前处于活跃维护状态,最近一次代码更新于 2026-09-21。开源免费,无在线服务。

它主要面向的使用场景是:开发者在大型代码库中快速定位函数、配置或文档片段。同类可对比的替代方案包括 ripgrep、Sourcegraph、Meilisearch。

上一篇:docsagent

下一篇:没有了!

同类项目推荐

firecrawl 开源

网页抓取像喝水一样简单,开发者省下整周加班

The web data API to search, scrape, and interact at scale.

★ 182210 2026-08-09
contoso-chat 开源

一键跑通 Azure RAG 应用,从代码到评估部署全流程

This sample has the full End2End process of creating RAG application with Prompty an···

★ 766 2026-08-09
graphify 开源

整个代码库画成一张图,找问题一眼定位

Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable k···

★ 119584 2026-08-09
qiaomu-youtube-ai-podcast 开源

一站式索引AI播客,快速找到有文字稿和总结的节目

AI 播客索引:整理 AI 播客、中文简介、Transcript 状态和总结入口 | Curated AI podcast ···

★ 69 2026-08-09