# @dzhng/jevgrep 中文文档

规范地址：https://npmcn.com/package/%40dzhng/jevgrep/

版本：0\.8\.5
npm 元数据更新时间：2026-10-18T09:35:03.454Z
中文译文更新时间：2026-11-13T02:53:18.859Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40dzhng/jevgrep
原文对照：https://npmcn.com/package/%40dzhng/jevgrep/?lang=original
项目主页：https://github.com/dzhng/jevgrep#readme
源码仓库：https://github.com/dzhng/jevgrep

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：2.7 MB，14 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：2 个
- 首次发布：2026-09-26T16:02:58.441Z
- 最新版本发布：2026-10-18T09:35:03.132Z
- 近 30 天下载量：27164（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

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

## 安装

```sh
npm install @dzhng/jevgrep
```

也可以使用：`pnpm add @dzhng/jevgrep`、`yarn add @dzhng/jevgrep`、`bun add @dzhng/jevgrep`

## README

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

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

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

```sh
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状态及其 可用时错误消息 。 工作钥匙仍然缺乏模式访问或付费 ; 在替换密钥之前遵循提供者的解释。 已保存的密钥 原始反应机构被排除在诊断产出之外。 如果一个提供者回响 带有插入分隔符的密钥,其消息被省略. 对于无人看管的设置,将密钥从您的秘密管理器管道到:

```sh
jg auth --provider opencode --stdin
```

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

```sh
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`**请求和答复很少:

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

```json
{ "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 只是代理设置的一半: 安装技能也.**

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

```sh
jg skill
```

安装者检测您的编码代理( Claude Code、 Codex、 OpenCode 和 并询问安装地点. `jg skill` 还接受 `--agent NAME` (可重复), `--global`,以及 `--yes`;这些选项来自 [技能水平](https://github.com/vercel-labs/skills#install-a-skill),哪个 与会代表. `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` 在另一台机器上或修改了节点安装后.

见 [仓库](https://github.com/dzhng/jevgrep) 关于建筑,官方 基准证据和发展。 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 和提交记录判断。