# @agentreins/core 中文文档

规范地址：https://npmcn.com/package/%40agentreins/core/

版本：0\.8\.1
npm 元数据更新时间：2026-11-07T14:29:25.296Z
中文译文更新时间：2026-11-07T22:15:01.816Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40agentreins/core
原文对照：https://npmcn.com/package/%40agentreins/core/?lang=original
项目主页：https://fredarcito.github.io/reins/
源码仓库：https://github.com/fredarcito/reins

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

- 包体积（解压后）：105 kB，27 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：1 个
- 首次发布：2026-11-04T20:29:11.244Z
- 最新版本发布：2026-11-07T14:29:25.093Z
- 近 30 天下载量：2762（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

框架-不可知的归宿核心:架构检查,医生,报告和适配器合同.

## 安装

```sh
npm install @agentreins/core
```

也可以使用：`pnpm add @agentreins/core`、`yarn add @agentreins/core`、`bun add @agentreins/core`

## README

# @ agentreins/ 核心

框架不可知引擎 [**绳子**](https://www.npmjs.com/package/@agentreins/cli): 建筑规则,基线, `architecture.yml` 装载器,报告,撞击分析,医生规则,模块注释和适配器合同.

## 你不安装这个包

它与CLI。 在项目中使用指针(节点22或更新):

```bash
npm install -D @agentreins/cli @agentreins/adapter-js
npx reins install
npx reins init
```

见 [@ agentreins/ cli (英语)](https://www.npmjs.com/package/@agentreins/cli) 为快速开始.

## 里面的东西

-   **规则**数字 : `layer-direction` (仅从本身和下面各层进口一层), `domain-boundary` (域外代码只导入其公共 API), `no-cycles`,以及 `integrity` (计划的变化和不断增长的基线可见一斑)。 信件指定规则、原因和定律,并可在 `architecture.yml`。 。 。 .
-   **基线**:今天的违章行为被冻结了,所以只有新的违章行为才会失败;排序,没有时间戳,在拉请求中干净的diff.
-   **`architecture.yml` 装填器**:验证计划,并报告其出场路径的每一个问题,全部同时报告. 未知的密钥是错误: 类型不能默通 .
-   **影响分析** (单位:千美元)`impactOf`: 倒转 `scope`。它将适配器的导入边缘与域合并:谁消费一个文件(按域组),它会绕过一个公共的 API 导入,而 API 将文件中断更改会被触碰 。 权力 `reins impact`。 。 。 .
-   **三角信号** (单位:千美元)`scopeSignals`, (中文(简体) ), `suggestLevel`: 将文件列表转换为最小任务级别( c)`small` 编号 : `medium` 编号 : `large`) (中文(简体) ). 同样的阈能 `reins scope` 医生的 `triage-mismatch`,所以代理所宣布的就是 diff 所衡量的.
-   **报告**:文本和JSON(表 `schema` 数字),每个发现都有其规则,理由和固定.
-   **医生**: 后面的工作流程规则 `reins doctor` (旅行对diff,笔记本,模块笔记, `AGENTS.md` 大小)和进度笔记本解析器和一行一时编辑器后面 `reins progress`。 。 。 .
-   **模块注释**: 解析,路径 – 注释检索(`notesFor`),从导入图中起草(`draftNote`),和从git历史(英语:`rankStaleNotes`) (中文(简体) ).
-   **审计积压**: 后面的本地发现文件 `reins audit` ——解析,渲染,状态变化.
-   **球形匹配**:它自己的配对者(`*`, (中文(简体) ), `**`, (中文(简体) ), `?`, (中文(简体) ), `{a,b}`),用于地层,域和公共API. 没有光荣的依赖.

核心从不读取源文件, 也不知道框架: 它只看到 `{ from, to, kind }` 导入边,由语言适配器计算。 所有框架或语言( TypeScript, Vite, Next) 都生活在适配器中 [@ agentreins/ 适应器- js](https://www.npmjs.com/package/@agentreins/adapter-js)。 。 。 .

## 写入适配器

适配器只导入合同的切入点 :

```js
import { CONTRACT_VERSION, validateAdapter, validateEdges, normalizeGraph, matchesAny } from '@agentreins/core/contract';
```

合同的版本(`reins.contract: 1` 在适配器中 `package.json`; CLI拒绝不匹配的:

-   **`detect(repoPath)`** ——这个适配器适用于回波吗? 返回时 `true`,一个预设名称或没有.
-   **`graph(repoPath, config)`** ——导入边: `{ from, to, kind }` 类型 `static`, (中文(简体) ), `dynamic` (单位:千美元)`import()`和 `type` (仅类型),外加文件列表,出入口和警告. 规则应该跳过的一种边缘是球队的召唤(`ignore_kinds` 规则,不是适配器的. **永远不要无声地掉入边缘**:未解决的别名必须成为警告,或 `check` 绿地穿过一个洞.
-   **`GraphResult` 可添加 `barrels` 财务报告和审定财务报表 `uses`** 每个进口商通过再出口桶真正使用的东西,所以 `init` 可以分辨哪个文件夹拥有什么和 `impact` 可以把进口商算在桶后作为真实文件的消费者。 可选:规则只需要 `edges`。 。 。 .
-   **`evaluate(edges, config, graph)`** 备选框架规则,需要的不仅仅是边缘(文件内容、指令); `next-server-client` 合并为同一报告和基线.
-   **`presets`, (中文(简体) ), `suggestPreset`, (中文(简体) ), `loadPreset`** - 备选启动计划 `reins init` (层,域从何而来. 没有他们 `check` 同样的工作; `init` 只是要求手写 `architecture.yml`。 。 。 .

合同记载于 [文件/适应合同](https://github.com/fredarcito/reins/blob/main/docs/adapter-contract.md)。命名第三方适配器 `reins-adapter-<language>`;CLI从 `adapter: <language>` 内 `architecture.yml`。 。 。 .

## 学多点

-   [项目现场](https://fredarcito.github.io/reins/)
-   [重置文档](https://github.com/fredarcito/reins#readme)
-   [`architecture.yml` 参考文献](https://github.com/fredarcito/reins/blob/main/docs/architecture-yml.md)
-   [适应合同](https://github.com/fredarcito/reins/blob/main/docs/adapter-contract.md)

## 许可证

麻省理工学院

## 常见问题

### @agentreins/core 是什么？

框架-不可知的归宿核心:架构检查,医生,报告和适配器合同\.

### 如何安装 @agentreins/core？

在项目目录运行 npm install @agentreins/core，或使用 pnpm add / yarn add / bun add。

### @agentreins/core 支持 TypeScript 吗？

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

### @agentreins/core 支持 ESM 还是 CommonJS？

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

### @agentreins/core 需要什么版本的 Node\.js？

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

### @agentreins/core 可以商用吗？

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

### @agentreins/core 的下载量有多少？

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

### @agentreins/core 还在维护吗？

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