# @drkmttr/adhere 中文文档

规范地址：https://npmcn.com/package/%40drkmttr/adhere/

版本：0\.25\.0
npm 元数据更新时间：2026-11-11T16:41:14.831Z
中文译文更新时间：2026-11-12T20:19:05.105Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：1.2 MB，153 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：2 个
- 首次发布：2026-09-23T00:21:00.138Z
- 最新版本发布：2026-11-11T16:41:14.294Z
- 近 30 天下载量：9480（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 33 个）

## 中文简介

根据Jev的判断.

## 安装

```sh
npm install @drkmttr/adhere
```

也可以使用：`pnpm add @drkmttr/adhere`、`yarn add @drkmttr/adhere`、`bun add @drkmttr/adhere`

## README

# 坚持

  
非决定性规则的线条. 由TypeSafe AI提供动力.  
  
[![](https://img.shields.io/website?url=https%3A%2F%2Fdm.sh%2Fadhere%2Fgetting-started%2F&up_message=healthy&logo=readme&logoColor=%23dddddd&label=docs&labelColor=%23000000)](https://dm.sh/adhere/)   ![](https://img.shields.io/npm/dm/%40drkmttr%2Fadhere?style=flat&logo=github&labelColor=%23181926&color=%23000000)   [![](https://img.shields.io/npm/v/%40drkmttr%2Fadhere)](https://www.npmjs.com/package/@drkmttr/adhere)

  

规则的插件 普通插件无法检查, 如“ 商业逻辑应该 或“模块应该暴露一个 小API" (小API). 您可以将一条规则写为 Markdown 文件, 其代码可以显示 :

````md
---
description: A third-party API going offline should not also take our app down.
---

Our APIs should not depend on a third-party API on a critical path. The
user-facing side should be unaffected if it goes offline, and ingestion should
happen in a separate, asynchronous process.

## Should

```ts
// GET /api/restaurants/:zipCode reads only our own database.
export async function findRestaurants(zipCode: string) {
  return db.restaurants.find({ where: { zipCode } });
}
```

## Should not

```ts
// When Google Maps is down, slow, or over quota, so is this endpoint.
export async function findRestaurants(zipCode: string) {
  return googleMaps.findAll({ where: { zipCode } });
}
```
````

遵守询问 [杰维](https://typesafe.ai/),TypeSafe AI的系统一模型,是否 每个文件会打破返回校正概率的每个规则。 坚持 并显示 档案Jev指向。 报告看起来像Oxlint的:

![adhere lint demo](https://github.com/darkmatter/adhere/raw/main/eval/demo.gif)

规则普通的插件可以精确检查, 如禁止的导入或类型 错误,属于那个线圈. [`adhere validate`](https://dm.sh/adhere/validating-rules/) 列出规则 Jev 找到相互矛盾的规则.

## 开始吧

```sh
curl -fsSL https://github.com/darkmatter/adhere/raw/main/scripts/install.sh | sh
adhere login                           # save your TypeSafe AI API key
adhere lint --preset typescript,react  # try the built-in presets on your code
adhere init                            # scaffold .adhere/config.ts and two example rules
adhere rules create                    # write a rule with a coding agent: claude, codex, or omp
```

脚本安装到 `~/.local/bin`。如果你的外壳找不到 `adhere` 之后,将目录添加到您的 `PATH`。 。 。 . `adhere lint` 估计 判断会花费很多 当Stdin和Stdout是终端时, 它在发送前问 任何东西; 否则,或与 `--yes`它不问就发出来 软件包是 `@drkmttr/adhere`数字 : `adhere` npm 是一个不相关的软件包.

## 文档

-   **开始 :** [导言](https://dm.sh/adhere/), (中文(简体) ), [安装](https://dm.sh/adhere/install/), (中文(简体) ), [开始](https://dm.sh/adhere/getting-started/)
-   **规则:** [规则格式](https://dm.sh/adhere/rule-format/), (中文(简体) ), [写好规则](https://dm.sh/adhere/writing-good-rules/), (中文(简体) ), [从您的 repo 生成规则](https://dm.sh/adhere/generate-rules/), (中文(简体) ), [从其他重置中安装规则](https://dm.sh/adhere/install-rules/), (中文(简体) ), [预设](https://dm.sh/adhere/presets/)
-   **用法 :** [阅读报告](https://dm.sh/adhere/reading-the-report/), (中文(简体) ), [配置](https://dm.sh/adhere/config/), (中文(简体) ), [运行中线](https://dm.sh/adhere/running-lint/), (中文(简体) ), [检查代理记录](https://dm.sh/adhere/checking-transcripts/)
-   **验证并改进规则 :** [审定规则](https://dm.sh/adhere/validating-rules/), (中文(简体) ), [现场直播](https://dm.sh/adhere/live-evals/)
-   **高级特性 :** [状态钩和类型识别](https://dm.sh/adhere/state-hooks/), (中文(简体) ), [供应商](https://dm.sh/adhere/providers/), (中文(简体) ), [评论和压制](https://dm.sh/adhere/comments-and-suppressions/)
-   [代理技能](https://dm.sh/adhere/agent-skills/)
-   **参考:** [图标](https://dm.sh/adhere/reference/commands/), (中文(简体) ), [配置文件](https://dm.sh/adhere/reference/config-file/), (中文(简体) ), [缓存](https://dm.sh/adhere/cache/), (中文(简体) ), [如何判断文件](https://dm.sh/adhere/how-a-file-is-judged/)
-   [编写您的 AGENTS.md](https://dm.sh/adhere/compose-agents-md/)

## 捐款和许可证

麻省理工学院. 见 [自由主义](https://npmcn.com/package/%40drkmttr/adhere/LICENSE)。每个 GitHub 版本所附带的可执行文件 跟我来 `LICENSE` 财务报告和审定财务报表 `THIRD_PARTY_NOTICES.txt`,它与任何副本 重新分配。 用于构建、测试或释放检查结果中的粘接符,参见 [捐款额](https://npmcn.com/package/%40drkmttr/adhere/.github/CONTRIBUTING.md)。 。 。 .

## 常见问题

### @drkmttr/adhere 是什么？

根据Jev的判断\.

### 如何安装 @drkmttr/adhere？

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

### @drkmttr/adhere 支持 TypeScript 吗？

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

### @drkmttr/adhere 支持 ESM 还是 CommonJS？

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

### @drkmttr/adhere 可以商用吗？

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

### @drkmttr/adhere 的下载量有多少？

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

### @drkmttr/adhere 还在维护吗？

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