# @design-parity/checks 中文文档

规范地址：https://npmcn.com/package/%40design-parity/checks/

版本：1\.18\.0
npm 元数据更新时间：2026-11-07T13:55:34.315Z
中文译文更新时间：2026-11-12T01:57:01.816Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40design-parity/checks
原文对照：https://npmcn.com/package/%40design-parity/checks/?lang=original
项目主页：https://github.com/yschimke/design-parity/tree/main/packages/checks#readme
源码仓库：https://github.com/yschimke/design-parity

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

- 包体积（解压后）：89.6 kB，43 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-06-14T05:42:34.785Z
- 最新版本发布：2026-11-07T13:55:33.991Z
- 近 30 天下载量：4182（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：102（近 12 个月 102 个）

## 中文简介

确定性 a11y + i18n 光谱检查在一个 DesignReference / CatentRender 配对上. 运行时没有模型——只有承诺的规则和门槛.

## 安装

```sh
npm install @design-parity/checks
```

也可以使用：`pnpm add @design-parity/checks`、`yarn add @design-parity/checks`、`bun add @design-parity/checks`

## README

# @ design- parity/ 检查

决定性 **无障碍+国际化** 光谱检查 a `(DesignReference, CandidateRender)` 双人 这些是高价值的 被怀疑的 裁决的结果(见 [文件/文件](https://npmcn.com/package/docs/PRINCIPLES.md) 原则2:目标 细节开发者通常会错过,设计工具不会强制执行.

每张支票都是一张 **纯函数** 表示承诺的阈值和 被俘的语义—— **没有网络呼叫和运行时间的模型** (原则1). 同样的公关总得分.

## 检查

| 函数 | 仁爱 | 它声称的 |
| --- | --- | --- |
| `checkContrast` | `contrast` | WCAG 1.4.3.1.4.6 每个主题的文本对比;失败 AA − `error`,满足 AA 但不是 AAA ~ `info`。 。 。 . |
| `checkTouchTargets` | `a11y` | 交互式目标为:-48dp(物质3);低于24dp的WCAG 2.5.8层 `error`。 。 。 . |
| `checkSemantics` | `a11y` | 互动/图像节点曝光可访问标签/内容描述. |
| `checkTextExpansion` | `i18n` | Pseudolocale 文本增长与可用宽度 = 切变风险(`warn`) (中文(简体) ). |
| `checkLocaleFormatting` | `i18n` | 硬码地币特有货币/日期/标签中的数字字元. |
| `checkRtlMirroring` | `i18n` | 在 RTL; 从右到左文本下必须映射的方向图标 . |
| `checkHardcodedStrings` | `i18n` | 未按键的用户介面文字**选入** ——一个渲染无法证明一个字符串来自资源). |

`runChecks(reference, candidate, config?)` 运行整个套房并返回 调查结果 **a11y 首先是i18n,然后是i18n**各组按重度排序. `runA11yChecks` 编号 : `runI18nChecks` 运行一组.

对比失败保留错误, 除非引用语义树包含 相同的前地/后地对失败相同的阈值。 没错 以设计为主导的匹配被报告为警告 `sharedWithReference: true`页:1 无障碍债务仍然显而易见,而平等并不要求代码有差异 从它的源。 缺失或无法估计的参考文献从不抑制 候选人失败.

## 配置

所有政策都是通过下列途径承诺和压倒一切的: `ChecksConfig` (连续级别, 触控-目标最小,glyph-advance估计,主题,硬码字符串选择入. 默认存在 [`src/thresholds.ts`](https://npmcn.com/package/%40design-parity/checks/src/thresholds.ts) 和编码 WCAG 2.2

-   材料 3 + 标准伪地取向.

背书会让这些把手 **`design-parity.checks.json`** ——文件 `@design-parity/baseline` 写在靴子上。 读起来是决定性的 运行时, 它的调制阈值实际到达引擎( 原则 1) :

-   `loadChecksConfig(path)` 读取、解析和设计验证一个配置文件; 丢出一个可读错误, 如果它缺失, 而不是 JSON, 或 schema- 无效 .
-   `loadChecksConfigOrDefault(path)` - 一样,但是 **缺少** 文件解析为 强制的默认,所以在稳定状态下,没有设置的回放仍然有效。 A 类 目前但无效的文件仍然丢出.
-   `validateChecksConfig(value)` —— 验证一个已分解对象相对于 草案07 [计划](https://npmcn.com/package/%40design-parity/checks/schema/checks-config.schema.json)。 。 。 .

配置形状镜像 `ChecksConfig` 准确的,所以靴子输出验证 并装入没有翻译。 见 [`examples/design-parity.checks.json`](https://npmcn.com/package/examples/design-parity.checks.json)。 。 。 .

### 验证 CLI

`design-parity-validate-checks [path ...]` 验证一个或多个配置文件 在第一个无效的装置上不设零,所以可以打开 CI 默认为 `design-parity.checks.json` 在阴道.

```sh
node packages/checks/dist/cli/validate-checks.js design-parity.checks.json
```

## 查找类型

此软件包引入了专用 `a11y` 财务报告和审定财务报表 `i18n` `FindingKind`单位 `@design-parity/core` 所以判决可以和他们一起做. `contrast` 保持自己的类型( 它带有一个数字比, 并且是标题 a11y) 寻找). 焦点顺序和状态通知空白 **没有** 声称: `SemanticNode` 所以加上这些支票就是合同变更 在核心——跟踪而不是伪造.

## 开发

```sh
npm run build --workspace @design-parity/checks
npm test
```

## 常见问题

### @design-parity/checks 是什么？

确定性 a11y \+ i18n 光谱检查在一个 DesignReference / CatentRender 配对上\. 运行时没有模型——只有承诺的规则和门槛\.

### 如何安装 @design-parity/checks？

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

### @design-parity/checks 支持 TypeScript 吗？

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

### @design-parity/checks 支持 ESM 还是 CommonJS？

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

### @design-parity/checks 可以商用吗？

@design-parity/checks 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @design-parity/checks 的下载量有多少？

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

### @design-parity/checks 还在维护吗？

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