为什么编码代理总抓错代码文件jevgrep 如何靠一句话定位相关文件与源码上下文【免费下载链接】jevgrepFind code by asking what it does. A CLI for coding agents that uses Jev to discover relevant files and source context.项目地址: https://gitcode.com/gh_mirrors/je/jevgrep你有没有遇到过这种情况让 Claude Code、Codex 这类编码代理修改一段陌生代码它却翻遍了一堆不相干的文件读了半天上下文最后改错了地方问题往往出在「找文件」这一步。jevgrep命令为jg正是为解决这个问题而生的自然语言代码搜索 CLI向仓库问一句它做了什么它就能用 Jev 模型判断相关性返回相关文件、阅读线索和逐字源码摘录让编码代理一步到位拿到所需上下文并因此降低编码代理的整体成本。痛点编码代理为什么总抓错文件编码代理处理陌生任务时相当一部分开销花在找到正确的文件上。传统方式有两个坑关键词搜索如 ripgrep只认字面你搜retry但真正的实现可能叫backoff、scheduleRedelivery一个词都对不上纯靠代理自己猜它只能顺着目录名和文件名推断猜错一次就多读一堆无关文件token 白烧还可能被像但不相关的代码带偏。结果就是抓错文件 → 读错上下文 → 改错代码 → 反复重试成本翻倍。原理一句话完成仓库级导航jevgrep 的思路是与其让代理大海捞针不如先问一句自然语言。工作流分三步提问jg 数据库连接在哪里创建、池化和关闭 ./srcJev 判断相关性jevgrep 按目录层级遍历仓库用文件夹元数据和文件内容预览决定往哪深入用 Jev 模型在文件夹、文件、声明三个层面判断相关性——而不是先上传整棵树返回源码上下文输出先是摘要和紧凑文件列表接着是带行号的逐字源码块最后是详细的声明与调用位置。Python 和 TypeScript/JavaScript 支持声明解析其他文本走有界源码片段回退。关键设计细节见 docs/architecture.md通过相关性标准保留文件没有固定的只给前 2 名上限避免漏掉真正相关文件无法自信摘录时仍保留文件位置作为阅读线索部分发现会如实报告不硬凑检索到的源码对代理而言只是数据不是指令实现与验证决策仍归调用方代理所有。核心检索逻辑在 packages/core/src/retrieve.ts输出渲染在 apps/cli/src/render.ts。快速上手三步完成安装与接入要求 Node.js 22macOS 或 Linux以及 Vercel AI Gateway、TypeSafe、OpenRouter 或 OpenCode Zen 之一的密钥。npm install -g dzhng/jevgrep # 1. 安装 CLI jg auth # 2. 选择供应商并保存密钥 jg skill # 3. 给编码代理安装配套技能⚠️ 注意只装 CLI 并不会教会你的编码代理用它jg skill这一步必须执行。安装器会自动检测 Claude Code、Codex、OpenCode 等代理并询问安装位置加--global可用户级安装。技能文件说明了调用方式与输出含义见 skills/jevgrep/SKILL.md。之后随时提问即可jg 鉴权在哪里在请求到达处理器之前被检查 . jg 哪些测试覆盖了请求超时时的重试行为 .更细的参数并发控制、缓存开关、不完整结果处理见 apps/cli/README.md。输出长什么样一次典型输出录制的真实示例见 specs/done/jevgrep/assets/stdout-example.txt大致是Jevgrep: 3 relevant files. - src/backend/events.ts — implementation, caller, test... - src/telemetry.ts — implementation, caller, test... - tests/telemetry.test.ts — implementation, caller, test... Source block src/telemetry.ts lines 1-7: 3: recordEvent(name: string) { 4: return { name, recorded: true }; ... End context.摘要在前、源码紧随其后代理早看到有用的东西。每条路径都标注了角色实现方/调用方/测试等和行号线索代理可直接顺着读而不是拿到一份待办清单去盲目翻。实测同等任务完成率成本降约 30%官方在 10 个 Python SWE-bench 任务上做了对照完整数据见 evals/results/total-cost-2026-09-28.md 与 evals/results/relevance-threshold-2026-09-27.md指标无 jevgrep 基线有 jevgrep任务完成数8/108/10编码代理成本Sol$7.62$5.44↓28.6%含 Jev 的总成本$7.62$5.66↓25.8%一句话总结同样的智能更低的编码代理成本。需要说明的是这是 10 个调优任务的测量结果不是每个仓库必然省钱的保证速度对比另有 evals/results/speed-2026-09-28.md。何时该用 jevgrep何时不该用✅该用你知道需要什么行为但不知道代码在哪尤其是跨多个陌生文件的问题❌不必用你已经知道精确符号或路径时直接读文件或跑一次 ripgrep 搜索就够了——jevgrep 的价值在跨越陌生文件的自然语言问题。另外两点提醒搜索会把符合条件的源码内容发往jg auth选定的供应商默认过滤遵循忽略文件并排除隐藏、依赖/构建、二进制和明显含凭据的文件但这不是敏感信息必然被清除的保证请选好搜索根目录。小结编码代理抓错文件本质是自然语言意图与字面关键词之间的断层。jevgrep 用一句话补上这个断层用 Jev 在文件夹/文件/声明三层判断相关性而非死盯关键词返回带行号的逐字源码与声明位置让代理拿着证据干活实测在同等 8/10 完成率下编码代理成本降低约 25%–30%。如果你想深入了解检索、解析、缓存与失败处理的取舍推荐按顺序读 docs/architecture.md 和实现记录 specs/done/jevgrep/README.md。装一个jg让下一次编码代理的找文件环节少浪费一半 token。【免费下载链接】jevgrepFind code by asking what it does. A CLI for coding agents that uses Jev to discover relevant files and source context.项目地址: https://gitcode.com/gh_mirrors/je/jevgrep创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
