阿里最近开源了一个叫 zg 的本地检索工具,专门为开发者和 AI 智能体设计。简单说就是一个命令行工具,让你在本地代码库里做语义搜索、关键词搜索和混合搜索,而且能直接接入各种主流 AI 编程工具。
为什么需要这个东西?
用过 Claude Code 或 Cursor 的人都知道,当项目代码量一大,让 AI 帮你找某个功能的实现、某个配置的用法,经常会搜不准。要么关键词太死板搜不到,要么搜出来一堆不相关的结果。zg 的思路是把多种检索方式整合到一个工具里:语义检索理解你的意图,关键词检索精确匹配,混合检索两者结合,还有 rg 模式做快速文本搜索。
怎么用?三步搞定:
第一步,安装。一行命令 npm install -g @zvec/zvec-grep 就行。装完之后跑 zg install,它会自动发现你电脑上装了哪些 AI 编程工具——Codex、Claude Code、Cursor、OpenCode 都能识别,然后自动帮你配好 MCP 接口。不用手动改配置文件。
第二步,建索引。进入你的项目目录,跑 zg index,它会用本地的轻量模型对代码和文档做向量编码。整个过程在本地完成,数据不会上传到任何服务器。支持增量更新,改了代码重新跑一次就行。
第三步,开始搜。两种方式:一种是在终端里直接用 zg query 搜索,另一种是在已经连好的 AI 工具里直接提问,Agent 会自动调用 zg 去检索。
能搜什么?不只是代码。支持 C、Go、Java、JavaScript、Python、Rust 等主流编程语言的代码搜索,还支持 Markdown、纯文本、HTML 等文档搜索,CSV、JSON、YAML 等数据文件也能搜。基本上一个项目里能用到的文件类型都覆盖了。
底层用的是阿里自研的 zvec 向量数据库,轻量级嵌入式设计,不需要起服务、不需要守护进程,直接在进程内跑。性能和隐私都兼顾了。
这个工具对经常用 AI 编程的人帮助挺大的。尤其是项目大了之后,AI 搜不准代码上下文是个很常见的痛点,zg 相当于给 AI 加了一个精准的本地搜索引擎。
项目地址:github.com/zvec/zvec
原文来源:QwenDevs
话题来源 @QwenDevs
1000K阅读 ❤️2001 x.com/…↗ 已改写,非原文转载
23 浏览 0 评论
0 反应












