Jevgrep 是一个可选的远程智能体发现工具,通过命令 jg 在明确限定的源文档范围内执行搜索。它适用于用户明确要求使用 Jevgrep 并指定了源文档根目录的场景。
用途与定位 Jevgrep 用于在技能目录、wiki 页面或图源文档中进行发现式检索。它搜索通用 UTF-8 源文本,包括 Markdown 或 JSON,但不遍历图边、不查询数据库二进制文件,也不负责图的重建。现有检索路径仍保持权威:技能选择使用目录元数据搜索,定义和穷尽匹配使用精确搜索/LSP,工作区检索使用 zvec-grep,图关系使用 Graphify 的 query/path/explain。
主要能力
- 在明确限定的源根目录下执行远程智能体检索。
- 支持三种源表面:技能(如 /path/to/jeo-skills/.agent-skills 或单个技能文件夹)、wiki(如 /path/to/chosen-vault/wiki 或相关子树)、图源(如 /path/to/project/.mex/context 或源树)。
- 提供本地预览命令
jg files -- /path/to/chosen-vault/wiki,打印文件计数和目录分组,不显示文件名、片段或密钥审计。 - 提供包装器
jeo-skill explore,支持--dry-run生成惰性执行计划,以及--allow-remote门控实际远程执行。 - 默认限制:8 次提供方请求、24,000 输出字节、并发 1、超时 120 秒;包装器传递
--no-cache禁用上游答案缓存读写。可选边界参数包括--max-requests、--max-output-bytes、--timeout。
使用方式
- 冻结源与远程边界:命名查询、现有根目录、配置的提供方、排除项和请求/输出边界。需单独批准将符合条件的源内容和查询发送给该提供方,并注意可能产生费用。保存的凭据不等于数据同意。将密钥、个人原始源、生成的图和数据库文件排除在根目录之外或明确排除。优先使用更窄的根目录。
- 本地检查安装,认证留给用户:验证现有 jg 二进制文件的版本/帮助信息,不进行网络调用。经批准的安装命令为
npm install -g @dzhng/jevgrep@0.8.0。仅在安装批准后显示此操作,不要因搜索请求而自动执行。用户私下操作上游 jg 认证。绝不收集、打印或自动化 API 密钥输入。认证会覆盖保存的配置;搜索使用保存的提供方配置,而非环境变量中的 API 密钥/模型/端点覆盖。jg doctor会进行真实提供方调用并可能产生费用,它不是本地先决条件或自动连接检查。 - 远程执行前本地预览:使用
jg files -- /path/to/chosen-vault/wiki进行无提供方的计数预览。使用包装器生成惰性执行计划,例如jeo-skill explore "Which skill handles vault source citations?" --root /path/to/jeo-skills/.agent-skills --dry-run。如果链接的 CLI 未升级,可使用源码检出路径:python3 /path/to/jeo-skills/.agent-skills/jeo-skill/scripts/jeo-skill.py explore "..." --root ... --dry-run。Dry-run 不执行 Jevgrep 调用、认证、安装或提供方检查,仅是计划,不是检索证据或凭据有效的确认。 - 仅执行已批准的计划:在明确批准源/查询/费用并完成现有上游提供方设置后,运行例如
jeo-skill explore "Which skill handles vault source citations?" --root /path/to/jeo-skills/.agent-skills --exclude '*/raw/**' --allow-remote。--allow-remote是包装器门控,不是上游 jg 标志或持久授权。--hidden和可重复的--exclude仅在批准了更宽范围时可用。请求/时间边界不保证货币上限;输出裁剪和上游--max-source-bytes限制的是渲染输出,而非源上传。 - 用原生证据验证片段:阅读有界返回的片段,仅打开回答所需的引用源部分。在断言定义、精确出现、技能元数据和关系之前,通过其原生路径验证。空、截断或失败的智能体输出不是缺失或穷尽清单的证明。
适用场景
- 用户明确要求使用 Jevgrep 在指定技能目录中查找技能。
- 用户明确要求使用 Jevgrep 搜索指定 wiki 或子树。
- 用户明确要求使用 Jevgrep 在指定图源文档中追踪信息。
限制
- 不遍历图边、不查询数据库二进制文件、不负责图的重建。
- 不自动选择 Jevgrep;需要用户明确请求。
- 不收集、打印或自动化 API 密钥输入。
- 不保证货币上限。
- 上游在此固定版本中没有 JSON 输出、MCP 服务器、search-stdin、include 或 limit 标志。
- 错误时需报告命令、失败和未解决结果,不得静默切换提供方、安装/认证、扩大根目录、以新披露重试或声称回退回答了原始查询。
参考 上游:https://github.com/dzhng/jevgrep 固定版本:https://github.com/dzhng/jevgrep/tree/679a0351206a99ef3e4f23e930a8529e78607ecd(v0.8.0,npm @dzhng/jevgrep@0.8.0,MIT) 包装器:../jeo-skill/scripts/jeo-skill.py explore