zvec-grep路线图解读知识图谱检索、多模态文档搜索与移动端征程【免费下载链接】zvec-grepLocal-first search across your workspace, built for humans and AI agents.项目地址: https://gitcode.com/gh_mirrors/zv/zvec-grepzvec-grep 是一款本地优先local-first的搜索工具把 ripgrep、BM25 和向量检索统一在一个搜索层中同时服务人类和 AI Agent。这篇文章带你完整解读它的官方路线图原生多模态文档搜索、知识图谱检索增强、更易用的本地 GUI以及从 PC 到移动端的征程帮你一次看懂这款工具的未来走向。先认识 zvec-grep为人类与 AI 打造的本地搜索层如果你用 grep 只能找到字面一样的内容而 AI Agent 又常常不知道该翻哪个文件zvec-grep 就是来解决这个问题的。它只需安装一次、索引一次之后人类在终端输入一句自然语言就能拿到按相关度排序的段落并附带精确来源位置AI Agent通过 MCP 协议接入 Codex、Claude Code、Cursor 等由 Agent 自己决定何时搜索无需在提示词里指定工具。下面的演示动图展示了完整流程安装 Agent 集成、为工作区建立本地索引再让 Agent 用 zvec-grep 检索本地证据关键的一点是文件、索引和本地模型都留在你的机器上只有在你明确授权时才会使用远端 Embedding 服务。这套信任模型可以参见架构文档 docs/05-architecture.md。当前已具备的搜索管线混合检索打底理解路线图之前先看看 zvec-grep 今天已经做了什么。检索管线可以概括为工作区 → 文件发现 → 本地索引 → 多路查询 → 紧凑结果它目前提供四种查询路线路线适合场景默认位置参数 /--hybrid自然语言意图 关键词锚点混合排序--fts精确词元走 BM25 排名--vector纯语义相似度检索--rg穷尽式正则/字面匹配无需索引索引侧则已经内置了结构感知的提取器代码按符号、签名和面包屑组织Markdown 按标题分节为后续的图谱与多模态升级打下了数据基础。更多细节见 docs/04-pipeline.md。路线图方向一原生多模态文档搜索PDF、PPT、图片 这是路线图里对用户最直观的一条让 PDF、PowerPoint.ppt/.pptx、HTML、图片等多模态文档成为一等公民的搜索输入。目前这些二进制文档格式在索引时会被跳过见 docs/04-pipeline.md 的格式表而路线图承诺带来四项能力格式感知的提取不再把所有文件拍平成纯文本而是保留结构、版式、元数据和内容关系OCR 视觉语言理解 多模态 Embedding不同格式各取所需扫描件里的文字也能被搜到内容与格式感知的检索策略针对每个查询和来源自动选择更聪明的路线图片作为一等搜索输入现在图片提取器ImageExtractor已存在但默认不纳入索引且要求 Embedding 模型支持图像——未来会成为常规能力。一句话概括以后你不仅能搜代码和 Markdown还能搜会议幻灯片、论文 PDF 和截图里的内容。路线图方向二知识图谱检索——最值得期待的升级 如果说多模态是搜得更多知识图谱就是搜得更聪明。路线图明确将知识图谱构建与图检索列为正式产品方向而非实验特性图谱检索将与现有的BM25、向量搜索、托管 ripgrep互补扩展多路混合检索词汇、向量、图、结构、元数据五类信号并行召回改进查询规划人和 Agent 只表达意图不用手动挑选检索路线改进融合、重排与可解释性同时保证返回给 Agent 的上下文依然紧凑。为什么要加图谱因为很多真实问题比如这个配置项在哪些模块里生效答案分散在多个文件的符号、调用和依赖关系之间。向量检索能找到语义相近的段落而图检索能沿着符号与依赖关系把结构性证据串起来——两者结合跨文件、多跳的问题才能稳定答对。当前的成绩基线zvec-grep 用成对 A/B 基准测试来量化接入前后的差异覆盖编码与通用文本两类任务答案质量、输入 token、工具调用次数、Agent 耗时在真实开源仓库Pylint、Matplotlib、Django的架构理解任务上zg 接入组同样在得分与效率上取得领先完整的测试协议与复现说明见 benchmarks/README.md。路线图的第一优先级就是让这类搜索质量、性能、Agent 上下文评估持续可复现——知识图谱上线后也会用同样的尺子量出真实收益。路线图方向三开箱即用从要配置到装完就能用 第三条方向的目标是让普通用户不再需要理解 CLI提供本地 GUI搜索、工作区管理、索引、模型选择、权限和诊断全部图形化支持更多安装途径平台原生包管理器等不只是 npm首次运行、Agent 发现、模型选择、更新与恢复尽量自动化并提供有用的默认值高级用户仍可保留 CLI 与配置控制只是这些不再是每个人的必经之路。对新手来说这意味着未来可能只是装一下 → 打开应用 → 直接搜而 docs/02-cli.md 里的参数只会成为进阶玩家的可选工具。路线图方向四从 PC 到移动端本地搜索无处不在 这是愿景中最有想象力的一条zvec-grep 要把本地搜索层扩展到iOS 和 Android而不是把手机当作必须依赖云服务的远程客户端。具体包括在 macOS、Windows、Linux 桌面间保持一致的体验针对移动设备的内存、功耗和应用生命周期约束重新适配索引、存储与模型执行桌面与移动端保持同一套 local-first 信任与权限模型——数据在设备上的承诺不因为换了设备而缩水。换句话说在手机上翻项目文档、合同 PDF 时同样可以离线、私密地按语义搜索。护栏四条不会动摇的原则无论路线怎么走官方在 docs/08-roadmap.md 中写死了四条护栏这也是它区别于搜索 SaaS的根本原则含义本地优先是默认任何远端数据传送都必须显式授权隐藏工具选择用户不需要知道底下跑的是 BM25 还是向量但保留有用的控制权召回不牺牲上下文提高召回率不能换来噪声大、过大的 Agent 上下文核心流程不依赖托管服务hosted service 永远不是本地工作流的必需品另外值得一提的是TypeScript/Node.js 主实现之外还有一套独立的 Rust 实现在 rust/ 下并行开发为未来的多平台分发提供了工程储备。现在就上手体验三步开始 路线图再远不妨先感受现状。要求 Node.js 22npm install -g zvec/zvec-grep # 安装 zg index # 为当前工作区建立本地索引 zg --human 我想了解的问题 --limit 3 # 用自然语言搜索Agent 用户则多一步zg install --target agent --yes即可把 MCP 端点接入你的编码代理。Embedding 模型的选择建议读 docs/07-embedding.md按速度、质量、隐私和硬件取舍。写在最后这条搜索之路通向哪里zvec-grep 的路线图其实回答了一个问题当搜索要同时服务人和 AI 时本地搜索层应该长什么样今天混合检索 结构感知索引 本地优先已经能用且可量化地更好明天多模态文档人人可搜、知识图谱补上结构性推理、GUI 让配置消失、移动端让搜索离线随行底线数据始终留在本地上下文始终紧凑。路线图描述的是方向而非承诺的日期优先级会随真实工作负载调整——这正是它邀请你用真实场景去影响它的地方。从知道关键词到只需要 zg这条本地搜索的旅程才刚走到起点。【免费下载链接】zvec-grepLocal-first search across your workspace, built for humans and AI agents.项目地址: https://gitcode.com/gh_mirrors/zv/zvec-grep创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考