# @epilot/validators 中文文档

规范地址：https://npmcn.com/package/%40epilot/validators/

版本：0\.0\.30
npm 元数据更新时间：2026-11-10T09:30:24.342Z
中文译文更新时间：2026-11-13T19:44:31.349Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40epilot/validators
原文对照：https://npmcn.com/package/%40epilot/validators/?lang=original

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

- 包体积（解压后）：89.3 kB，19 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=10
- 运行依赖：2 个
- 首次发布：2021-03-15T11:04:17.130Z
- 最新版本发布：2026-05-14T15:11:41.056Z
- 近 30 天下载量：17643（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：25（近 12 个月 6 个）

## 中文简介

共享输入验证器,regex图案,以及跨epilot Journey应用程序使用的AJV schema关键词.

## 安装

```sh
npm install @epilot/validators
```

也可以使用：`pnpm add @epilot/validators`、`yarn add @epilot/validators`、`bun add @epilot/validators`

## README

# @ epilot/ 验证器

共享输入验证器,regex图案,以及跨epilot Journey应用程序使用的AJV schema关键词.

## 安装

```sh
yarn add @epilot/validators
```

## 使用量

```ts
import {
  functionalValidators,
  regExpStatments,
  schemaKeywords,
  IBAN_Specifications
} from '@epilot/validators'
```

每个出口都提供:

| 导出 | 说明 |
| --- | --- |
| `functionalValidators` | 回调式验证器 : `iban`, (中文(简体) ), `birth_date`, (中文(简体) ), `future_date_14`。 。 。 . |
| `regExpStatments` | 命名为regex图案(电子邮件,名称,德国日期,电话等). |
| `schemaKeywords` | AJV相容自定义 JSON Schema 关键词. |
| `IBAN_Specifications` | 国家规格 `iban` 软件包. |

## 发展

```sh
yarn install
yarn start       # tsdx watch — rebuild on change
yarn build       # tsdx build — produces dist/
yarn test        # tsdx test
yarn lint        # eslint
```

`dist/` 被点燃了。 这个 `prepack` 脚本在任何文字之前自动重建 `npm publish` 编号 : `npm pack`,所以新鲜的取出 从不需要手动 `yarn build` 在释放之前.

## 释放

**CI 不发布此软件包 .** 这个 `publish` 任务在 [.gitlab-ci.yml (英语)](https://npmcn.com/package/%40epilot/validators/.gitlab-ci.yml)。按下标签 **没有** 启动释放 版本会从开发商的机器上手动凸出并发布.

### 为什么

这个 `@epilot` npm组织有2FA的写作。 无人看管的GitLab跑者无法提供检察官办公室,因此CI的出版品被封存在登记册上,装有403个. 在npm-org级别配置一个服务账户式的代号之前,出版是人的步骤.

### 切开释放

1.  上来吧 `master` 拥有一棵干净的工作树和最新的拉力.
2.  弹出版本, 重生 `CHANGELOG.md`、承诺、标记和推:
    
    ```sh
    yarn release
    ```
    
    这个运行 `prerelease` (lint + 测试),然后 `standard-version`,则 `postrelease` (单位:千美元)`git push && git push --tags`) (中文(简体) ). 没错 **没有** 发布.
3.  确保您作为用户登录到 npm , 并拥有出版权 `@epilot/validators`数字 :
    
    ```sh
    npm whoami       # confirm the right user
    npm login        # only if needed
    ```
    
4.  发布 :
    
    ```sh
    npm publish
    ```
    
    -   `prepack` 重建 `dist/` 从源.
    -   2FA检察官办公室的提示.
    -   关于成功与否,新版本登入了登记册;步骤2所推入的标记现在是它的犬形标记.

### 如果你忘记了第四步

标签存在,但没有发布版本. 要么:

-   运行 `npm publish` 被标记为犯罪,或
-   运行 `yarn release` 再来一次(它会撞到下一个补丁)并公布.

npm不允许重印同版本,因此如果一个发布半完成,起伏并重印.

## 常见问题

### @epilot/validators 是什么？

共享输入验证器,regex图案,以及跨epilot Journey应用程序使用的AJV schema关键词\.

### 如何安装 @epilot/validators？

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

### @epilot/validators 支持 TypeScript 吗？

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

### @epilot/validators 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @epilot/validators 需要什么版本的 Node\.js？

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

### @epilot/validators 可以商用吗？

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

### @epilot/validators 的下载量有多少？

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

### @epilot/validators 还在维护吗？

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