# @conformetry/validation 中文文档

规范地址：https://npmcn.com/package/%40conformetry/validation/

版本：0\.0\.77
npm 元数据更新时间：2026-11-10T14:26:37.689Z
中文译文更新时间：2026-11-10T15:29:10.980Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40conformetry/validation
原文对照：https://npmcn.com/package/%40conformetry/validation/?lang=original
项目主页：https://github.com/organizzolini/codebase/tree/main/projects/ic-suite/conformetry/conformetry-validation#readme
源码仓库：https://github.com/organizzolini/codebase

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

- 包体积（解压后）：48.1 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：5 个
- 首次发布：2026-10-04T22:26:37.126Z
- 最新版本发布：2026-11-10T14:26:37.290Z
- 近 30 天下载量：9179（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：75（近 12 个月 75 个）

## 中文简介

模板匹配、存在验证和相容性验证

## 安装

```sh
npm install @conformetry/validation
```

也可以使用：`pnpm add @conformetry/validation`、`yarn add @conformetry/validation`、`bun add @conformetry/validation`

## README

# \* 校正

[![npm](https://img.shields.io/npm/v/@conformetry/validation?logo=npm&label=npm)](https://www.npmjs.com/package/@conformetry/validation)

用于 [调和](https://npmcn.com/package/%40conformetry/conformetry-cli/README.md)数字 : 它匹配实例到模板, 检查已声明的文件存在, 路径 向请求延期的验证人提交的每份文件,以及副本 回来的是什么.

```bash
npm install --save-dev @conformetry/validation
```

## 使用量

```ts
import { ValidationService } from "@conformetry/validation";

const result = validationService.validate({
  instances, // from DiscoveryService.findInstances
  templates, // from DiscoveryService.collectTemplate
  languageNames: ["typescript"], // optional filter
  threshold: 0.9, // optional run-level conformance floor
});
// → { ok, fileResults, checkedPaths, scores, unmatched }
```

来电者传来的情况 用于扫描工作空间的软件包 `project.json` 从生成器名称后缀中提取的文件和推断范围 通用软件包取决于一个寄存器的布局.

## 检查顺序

1.  **文件已经存在.** 首先检查每个匹配的模板声明文件, 不管它的延伸。 无法比较缺失的文件并报告 一次比每一种语言都更清晰, 见 [`@conformetry/languages`](https://npmcn.com/package/%40conformetry/conformetry-languages/README.md),其 `FilesService` 拥有那个传球.
2.  **文档比较.** 每个验证员只看到其文件: 申请延期.

没有匹配模板的事例在内容旁报告 差异而不是跳过,所以一个报告既涵盖“此文件是错误的” 和"孔径无法分辨 这条路径是由什么产生的".

## 分数

每个匹配实例的分数是其模板的分数,以及 当它达到极限时,它就会消失, 要不然就是发电机,要不然就是跑道,要不然就是完美的 `1`。 。 。 .

记分 **在此之前** 相去相减. 复制决定哪个模板 开始吧 _打印_ 共享文件的发现, 这是一个报告问题; 分数 解答一个实例如何尊重自己的模板,从而崩溃 报告不得改变.

`ok` 实值 `false` 当任何情况低于其阈值时,或 实例根本不匹配模板 —— 未匹配的路径没有模板 所以没有门槛可以原谅.

## 语言分辨率

运行需要哪些语言 [`@conformetry/languages`](https://npmcn.com/package/%40conformetry/conformetry-languages/README.md)问题是,不是 这个包裹. `LanguagesService` ,询问哪个引擎声称 扩展运行模板声明,其答案是 `validate` 发送过来。 没有语言要求的扩展名会被逐行比较 文本倒转,所以没有模板文件不受限制.

不再有需求进口商品。 这个机制购买了安装时间 - 倒计时使每一次跑步都需要 软件包,不管它是什么 `loadLanguageModule` 选项随它而去。 取舍相取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取取 与之相对应的替代品记录在 [ADR 0006 (韩语)](https://npmcn.com/documentation/adr/0006-hold-every-conformetry-language-in-one-package.md)。 。 。 .

## 出口

`ValidationService`, (中文(简体) ), `ValidationDeduplicationService`, (中文(简体) ), `ValidationFindingsService`, (中文(简体) ), `ValidationScoringService`, (中文(简体) ), `ValidationModule`, (中文(简体) ), 编辑 `RunValidationArguments`, (中文(简体) ), `RunValidationResult`,以及 `InstanceFileResults` 类型.

## 测试

```bash
nx run conformetry-validation:vitest
```

## 许可证

麻省理工学院——见 [自由主义](https://npmcn.com/LICENSE)。 。 。 .

## \* 调和

这个项目源于 [巢-服务-项目](https://npmcn.com/configuration/conformetry-templates/nestjs-service-project) 符合模板.

## 常见问题

### @conformetry/validation 是什么？

模板匹配、存在验证和相容性验证

### 如何安装 @conformetry/validation？

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

### @conformetry/validation 支持 TypeScript 吗？

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

### @conformetry/validation 支持 ESM 还是 CommonJS？

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

### @conformetry/validation 可以商用吗？

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

### @conformetry/validation 的下载量有多少？

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

### @conformetry/validation 还在维护吗？

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