@dzhng/jevgrep

中文文档
0.8.5发布于 2026/10/18MITES Module构建来源已验证近 30 天下载 2.7万

编码代理件的内容意识源检索

中文使用文档

Jevgrep (英语:jg(中文(简体) )

询问仓库问题并获取相关文件位置加逐字记录来源 节选. Jevgrep 帮助一个编码代理开始不熟悉的多文件工作 ; 代理人仍然拥有执行和核查权.

在macOS,Linux,或Windows上需要节点.js 22或更新. 安装和认证 :

npm install --global @dzhng/jevgrep
jg auth
jg doctor
jg "How are telemetry events recorded and sent?" ./my-project

auth 请您选择一个提供者或自定义端点,然后将其密钥保存在 只有所有者配置文件 。 运行 jg --help 用于支持的提供者名称。 搜索 使用该提供者直到您再次运行 auth . doctor 以合成输入核实访问,并指定选定的提供者或 端点主机 . 当提供者拒绝请求时,医生会报告HTTP状态及其 可用时错误消息 。 工作钥匙仍然缺乏模式访问或付费 ; 在替换密钥之前遵循提供者的解释。 已保存的密钥 原始反应机构被排除在诊断产出之外。 如果一个提供者回响 带有插入分隔符的密钥,其消息被省略. 对于无人看管的设置,将密钥从您的秘密管理器管道到:

jg auth --provider opencode --stdin

管道设置需要两种选择。 让交通通过你自己 TypeSafe 兼容网关,在 auth 并进入其基地 URL和型号ID,或明确通过两者:

jg auth --provider custom --base-url https://gateway.example.com/typesafe/v1 --model gateway/jev-2 --stdin

自定义终点必须使用 https://· ; http://localhost 财务报告和审定财务报表 http://127.0.0.1 被接受为本地代理。 Auth 和博士只命名端点主机, 绝不 钥匙 保存的端点和模型是缓存身份的一部分, 所以自定义 答案与预设提供者的答案和其他端点分开.

自定义基础 URL 只必须包含方案、 主机和可选路径 : no 嵌入式证书、查询字符串或片段。 Jevgrep 附录 /systemone 改为 将保存的密钥作为 Bearer 符号发送 .

Jevgrep的布尔问题以 noul 问 题 无 criteria请求和答复很少:

{
  "model": "your-model",
  "state": "source context",
  "questions": { "q": { "type": "noul", "instructions": "Relevant?" } }
}
{ "answers": { "q": { "type": "noul", "noul": 0.9 } } }

返回每个问题的答案,并附带一个有限的 noul 0到1之间的数值. 这些答案不需要 probabilities 也没有 confidence。需要的服务器 criteria.true 并返回 HTTP 422 与这些请求不符。 运行 jg doctor 在搜索寄存器前对自定义网关.

全权证书保存在 $XDG_CONFIG_HOME/jevgrep/credentials.json,或 ~/.config/jevgrep/credentials.json。 。 。 . 在 Windows 上,配置默认为 %APPDATA%\jevgrep 缓存到 %LOCALAPPDATA%\jevgrep。 。 。 . XDG_CONFIG_HOME 财务报告和审定财务报表 XDG_CACHE_HOME 独立覆盖各自地点 当设置为绝对路径时; 相对值被忽略并使用平台默认值. Windows忽略了POSIX文件模式,因此这些文件依赖于用户配置文件的访问控制. 没有提供者的现有保存记录仍然意味着Vercel,没有迁移. API- key, endpoint, 和模型环境覆盖被忽略; 仅限用户 配置的环境密钥必须运行 auth 。 没有自动倒置或 每个搜索提供者覆盖 。 搜索向保存的服务发送符合条件的源 . 运行 jg files ./project 首先查看根所生成的文件和字节 符合条件,以及每个过滤器跳过多少路径;它不需要密钥而发送什么. 添加 --list 以查看合格的相对路径,引用和排序。 删除一个 您不打算发送的路径, 重复预览 --exclude 并使用 搜索内容相同。 不完整的预览只列出所看到的路径 在限制或中断之前;搜索时间内容检查可以排除更多内容. 评价答案在当地缓存; jg --help 描述缓存控件.

对于缓慢或不稳定的连接,请尝试 jg "question" ./project --concurrency 4 (或 1 请求序列化。 所有搜索阶段的默认限制为32, 包括复试。 等待槽不会消耗请求的超时,并且 排队源在上传前重新验证 。 这能控制运输压力, 非关联阈值或缓存身份.

一份不完整的搜索报告 一个已消毒、未修复的提供者出错 它的问题很重要,可以区分HTTP故障、超时和连接故障. 通过分拆恢复的批量故障不用作诊断. 这个 已报告的货币限制有助于调整下个运行。 仅经过验证的评价 答案被缓存:提供者错误和最终的搜索结果永远不会被存储. 连接后重运行恢复失败的工作, 并重用有效 答复; --no-cache 额外绕过这些有效的缓存答案.

受约束的资源限度是大型或正在改变的树木的后盾. 他们仍然 可见为 discovery incomplete 财务报告和审定财务报表 Issue: "resource_limit",但结果 只包含这些问题 成功退出 所以贝壳和编码代理 对于失败的命令, 请不要错误使用部分输出 。 供应商和其他 业务问题保留了不完整的退出状态.

摘要首先列出档案和申报地点,然后选定 来源. 地点是读取线索,不是核对表。 (一) 标出摘录; --max-source-bytes 0 包括所有选定的源。 不完全的结果仍然可以 有用吗? 读取它提供的东西,然后用普通的工具来填补具体的空白. 应用程序输出到 stdout ; jg 不创建报表文件.

代理技能

安装 CLI 只是代理设置的一半: 安装技能也.

将犬科技能安装到您的编码代理工作的工程中 :

jg skill

安装者检测您的编码代理( Claude Code、 Codex、 OpenCode 和 并询问安装地点. jg skill 还接受 --agent NAME (可重复), --global,以及 --yes;这些选项来自 技能水平,哪个 与会代表. jg skill 安装 jevgrep 技能来自此仓库 main 分支与 npm 生命周期脚本已禁用, 并且需要节点22.20+和 npm/npx 有被绑定安装器的网络访问. 重运行 jg skill 要刷新 该技能无需等待 npm 新的发布。 安装器过境 依赖仍然是外部信任的界限.

安装该技能不配置提供者密钥 .

搜索不安装技能或编辑代理配置 。 只有一个明确 技能安装命令引用安装器。 技术指导代理 在进一步发现前读取返回的摘录,跳过冗余搜索 已经知道需要的背景,并诚实地处理不完整的结果.

没有内置升级命令 。 使用 npm install --global @dzhng/jevgrep@latest 升级CLI,然后重运行 jg skill 以更新代理的副本。 这个 安装者记录 GitHub 源码和技能路径 skills-lock.json重新运行 jg skill 在另一台机器上或修改了节点安装后.

见 仓库 关于建筑,官方 基准证据和发展。 Jevgrep是麻省理工学院的许可.

版本与发布记录

@dzhng/jevgrep 共发布 20 个版本,首次发布于 2026/09/27;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.8.5latest2026/10/1826 天前
0.8.42026/10/1826 天前
0.8.32026/10/1826 天前
0.8.22026/10/1826 天前
0.8.12026/10/1826 天前
0.8.02026/10/021 个月前

关于 @dzhng/jevgrep 的常见问题

@dzhng/jevgrep 是什么?

编码代理件的内容意识源检索

如何安装 @dzhng/jevgrep?

在项目目录运行 npm install @dzhng/jevgrep,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 jg,可以用 npx jg 直接运行。

@dzhng/jevgrep 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/dzhng__jevgrep 是否存在。

@dzhng/jevgrep 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@dzhng/jevgrep 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@dzhng/jevgrep 可以商用吗?

@dzhng/jevgrep 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@dzhng/jevgrep 的下载量有多少?

根据 npm 官方下载统计,@dzhng/jevgrep 在 2026/10/13 – 2026/11/11 这 30 天内被下载 27,164 次,日均约 905 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dzhng/jevgrep 还在维护吗?

最新版本 0.8.5 发布于 2026/10/18(26 天前);至今共发布 20 个版本,其中过去 12 个月发布了 20 个;首次发布于 2026/09/27。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。