# @aurelienbbn/agentlint 中文文档

规范地址：https://npmcn.com/package/%40aurelienbbn/agentlint/

版本：0\.9\.1
npm 元数据更新时间：2026-10-14T17:07:36.478Z
中文译文更新时间：2026-11-07T05:08:08.875Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40aurelienbbn/agentlint
原文对照：https://npmcn.com/package/%40aurelienbbn/agentlint/?lang=original
项目主页：https://github.com/aurelienbobenrieth/agentlint/tree/main/packages/agentlint
源码仓库：https://github.com/aurelienbobenrieth/agentlint

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

- 包体积（解压后）：10.3 MB，57 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.19\.0
- 运行依赖：6 个
- 首次发布：2026-04-09T16:56:30.130Z
- 最新版本发布：2026-10-14T17:07:36.133Z
- 近 30 天下载量：7834（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 23 个）

## 中文简介

确定性结论和明确的编码器判断门

## 安装

```sh
npm install @aurelienbbn/agentlint
```

也可以使用：`pnpm add @aurelienbbn/agentlint`、`yarn add @aurelienbbn/agentlint`、`bun add @aurelienbbn/agentlint`

## README

# 代理林特

[![CI](https://github.com/aurelienbobenrieth/agentlint/actions/workflows/ci.yml/badge.svg)](https://github.com/aurelienbobenrieth/agentlint/actions/workflows/ci.yml) [![npm version](https://img.shields.io/npm/v/@aurelienbbn/agentlint.svg)](https://www.npmjs.com/package/@aurelienbbn/agentlint) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/aurelienbobenrieth/agentlint/blob/main/LICENSE)

** `AGENTS.md` 大部分时间都遵循规则。 agentlint把重要的东西变成一个大门 并保存着每个例外的忠实记录.**

![The agentlint review UI: a queue of findings on the left; on the right, a finding that needs a human decision, the standard's checks, the agent's proposal, and the flagged code with Accept and Request changes.](https://raw.githubusercontent.com/aurelienbobenrieth/agentlint/main/docs/assets/review-hero.png)

特工们将机械部分右转并滑倒在判断上:一个没有一等钥匙的付款呼叫,一个没有回填的倒行柱,一个隐藏了失败的倒行本,一个没有捆绑的读数,在固定中是好的.

| 工具 | 有判决的呼唤 |
| --- | --- |
| 提示 | 叫经纪人记住 |
| 线条 | 只能说"总是错误" |
| 大赦国际审查员 | 每次跑步都说不同的话 |
| 疲倦的人类 | 批准一个大diff 因为测试是绿色的 |
| **代理林特** | 屏蔽直到有人记录原因 |

## 每一个发现都被接受 或者被屏蔽

```text
 repository ──▶ deterministic ──▶ finding + your ──▶ acceptance with     ──▶ gate open
 evidence        detector          standard           reason + authority
                                        │
                                        └── no compatible acceptance ──────▶ gate closed
```

-   **决取相取.** 规则匹配一个代码形状或规范化的Git更改. 没有模型、网络或时钟.
-   **标准旅行与发现**:文本、检查、允许的例子。 特工不依靠召回.
-   **可审查例外情况.** 接受需要理由和正确的权威(`agent` 或者说 `human`(根据规则)。 它住在这里 `.agentlint/acceptances.jsonl`,在 PR diff 中显示,并在代码发生实质性变化时终止:a `eslint-disable` 这需要一个理由,一个权威, 和一个新的审查 当代码移动.
-   **人类决定** 在键盘-第一本地 UI 或 PR 线条中,有代码,标准,以及代理商的并肩提议.

> 开出闸口,是指所报道的扫描范围中每个当前发现都有一个相容的被记录的决定. 它没有证明判决是正确的,也没有证明对未配置的关切问题进行了审查.

没有规则,也没有规定要使用 您的寄存器和插件包拥有标准、 检测器和政策 .

## 安装并运行闸门

让你的经纪人做: 包船代理技能.

```text
Install @aurelienbbn/agentlint and follow its setup skill
(node_modules/@aurelienbbn/agentlint/skills/agentlint/setup/SKILL.md).
```

或以手执之:

```bash
pnpm add -D @aurelienbbn/agentlint
pnpm agentlint init          # creates .agentlint/config.ts
pnpm agentlint rules test    # replays every rule's fixtures
pnpm agentlint check --all   # the gate
```

提交配置,并 `.agentlint/acceptances.jsonl` 当它存在时 每个命令都接受 `--help`。 。 。 .

## 规则是代码形状加标准

```ts
import { defineConfig, defineRule } from "@aurelienbbn/agentlint";

const boundedReads = defineRule({
  lifecycle: "state",
  standard: {
    id: "data/bounded-reads",
    revision: 1,
    title: "Production reads are bounded",
    guidance: { standard: "Reads that scale with production data have an explicit bound or pagination contract." },
  },
  detector: {
    id: "prisma/find-many-without-take",
    version: 1,
    match: { pattern: "$DB.findMany($$$ARGS)", where: { notHas: "take: $_" }, message: "$DB has no explicit bound." },
    fixtures: { mustReport: ["db.users.findMany({})"], mustStaySilent: ["db.users.findMany({ take: 50 })"] },
  },
  binding: { id: "data/bounded-reads", authority: "agent", include: ["src/**/*.ts"] },
});

export default defineConfig({ rules: [boundedReads] });
```

这个 `standard` 已修订政策 `detector` 一个版本的触发器,和 `binding` 你的范围和权威。 A 类 `change` 规则从合并基础来判断 Git diff , 而不是当前代码 .

## 退出代码

| 退出 | 含义 |
| --- | --- |
| `0` | 目前每个发现都有一个兼容的接受 |
| `1` | 一个或多个调查结果尚未解决 |
| `2` | 无效的使用、配置或证据; 内部错误 |

每个命令出口 `2`永远 `1`在内部错误上。 本地语义和CI语义相同.

## 你想怎样?

| 目标 | 开始 | 指南 |
| --- | --- | --- |
| 将反复更正变为规则 | 页:1 `rule-advisor` 技能 | [开始吧](https://github.com/aurelienbobenrieth/agentlint/blob/main/docs/guide/getting-started.md) |
| 写入状态并更改规则 | `defineRule` | [写入规则](https://github.com/aurelienbobenrieth/agentlint/blob/main/docs/guide/writing-rules.md) |
| 关闭一个发现 | `agentlint accept 1 --reason "..."` | [接受情况](https://github.com/aurelienbobenrieth/agentlint/blob/main/docs/guide/acceptance.md) |
| 把下一个发现交给特工 | `agentlint next --format json` | [接受情况](https://github.com/aurelienbobenrieth/agentlint/blob/main/docs/guide/acceptance.md) |
| 做人做决定 | `agentlint review` | [审查](https://github.com/aurelienbobenrieth/agentlint/blob/main/docs/guide/review.md) |
| 打开门前订出一条规则 | `agentlint rules scan --review` | [校正](https://github.com/aurelienbobenrieth/agentlint/blob/main/docs/guide/calibration.md) |
| 门拉请求和代理转弯 | gitHub 动作或一个 `Stop` 钩子 | [CI和钩子](https://github.com/aurelienbobenrieth/agentlint/blob/main/docs/guide/ci.md) |
| 查找命令或旗帜 | `agentlint --help` | [CLI 参考](https://github.com/aurelienbobenrieth/agentlint/blob/main/docs/guide/cli.md) |
| 知道大门能保证什么 |  | [保证](https://github.com/aurelienbobenrieth/agentlint/blob/main/docs/guide/guarantees.md) |

需要的CI检查是真门;本地的钩子是反馈. 在 GitHub 上:

```yaml
steps:
  - uses: actions/checkout@v5
    with: { fetch-depth: 0 } # required: change rules use the merge base
  - uses: actions/setup-node@v5
    with: { node-version: 22 }
  - uses: aurelienbobenrieth/agentlint/action@v0.9.1
```

整个工作流程在 [CI 指南](https://github.com/aurelienbobenrieth/agentlint/blob/main/docs/guide/ci.md)。 。 。 .

## 公共入境点

| 导入 | 出口 |
| --- | --- |
| `@aurelienbbn/agentlint` | `defineConfig`, (中文(简体) ), `defineRule`、规则和配置类型、探测器上下文、改变证据和结果计划、标记错误 |
| `@aurelienbbn/agentlint/testing` | 基于承诺的固定帮助者 |
| `@aurelienbbn/agentlint/contract` | 审查电线合同,包括 `NextResult` |
| `@aurelienbbn/agentlint/calibration` | 校正报告计划和纯辅助工具 |

每一种类型, 计划, 和错误 : [公共 API](https://github.com/aurelienbobenrieth/agentlint/blob/main/docs/guide/api.md)。 。 。 .

## 许可证

[麻省理工学院](https://github.com/aurelienbobenrieth/agentlint/blob/main/packages/agentlint/LICENSE)

## 常见问题

### @aurelienbbn/agentlint 是什么？

确定性结论和明确的编码器判断门

### 如何安装 @aurelienbbn/agentlint？

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

### @aurelienbbn/agentlint 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @aurelienbbn/agentlint 支持 ESM 还是 CommonJS？

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

### @aurelienbbn/agentlint 需要什么版本的 Node\.js？

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

### @aurelienbbn/agentlint 可以商用吗？

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

### @aurelienbbn/agentlint 的下载量有多少？

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

### @aurelienbbn/agentlint 还在维护吗？

最新版本 0\.9\.1 发布于 2026/10/15（24 天前）；至今共发布 23 个版本，其中过去 12 个月发布了 23 个；首次发布于 2026/04/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。