# @bgord/tools 中文文档

规范地址：https://npmcn.com/package/%40bgord/tools/

版本：1\.6\.18
npm 元数据更新时间：2026-11-06T15:56:09.662Z
中文译文更新时间：2026-11-08T05:36:22.470Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：300 kB，398 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2025-05-31T14:50:29.570Z
- 最新版本发布：2026-11-06T15:56:09.556Z
- 近 30 天下载量：1888（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：184（近 12 个月 111 个）

## 中文简介

清除仓库

## 安装

```sh
npm install @bgord/tools
```

也可以使用：`pnpm add @bgord/tools`、`yarn add @bgord/tools`、`bun add @bgord/tools`

## README

# bgord -- -- 工具

## 配置 :

清除仓库

```
git clone git@github.com:bgord/bgord-tools.git --recurse-submodules
```

安装软件包

```
bun i
```

运行测试

```
./bgord-scripts/test.sh
```

## 文件 :

```
src/
├── age-years.vo.ts
├── age.vo.ts
├── api-key.vo.ts
├── basename.vo.ts
├── batch.ts
├── date-formatter.service.ts
├── date-range.vo.ts
├── day-iso-id.vo.ts
├── day.vo.ts
├── deep-clone-with.ts
├── directory-path-absolute.vo.ts
├── directory-path-relative.vo.ts
├── distance-value.vo.ts
├── distance.vo.ts
├── division-factor.vo.ts
├── duration-ms.vo.ts
├── duration.service.ts
├── email-mask.service.ts
├── email.vo.ts
├── error-normalizer.service.ts
├── etags.vo.ts
├── extension.vo.ts
├── feature-flag-value.vo.ts
├── feature-flag.vo.ts
├── file-path-absolute-schema.vo.ts
├── file-path-relative-schema.vo.ts
├── file-path.vo.ts
├── filename-affix.vo.ts
├── filename-from-string.vo.ts
├── filename.vo.ts
├── height-millimeters.vo.ts
├── height.vo.ts
├── hour-value.vo.ts
├── hour.vo.ts
├── iban-mask.service.ts
├── iban-schema.vo.ts
├── iban.vo.ts
├── image.vo.ts
├── int.vo.ts
├── integer-non-negative.vo.ts
├── integer-positive.vo.ts
├── integer.vo.ts
├── is-plain-object.ts
├── language.vo.ts
├── mean.service.ts
├── mime-registry-entry.vo.ts
├── mime-registry.service.ts
├── mime-value.vo.ts
├── mime.vo.ts
├── mimes.ts
├── minute-value.vo.ts
├── minute.vo.ts
├── money-amount.vo.ts
├── money.vo.ts
├── month-iso-id.vo.ts
├── month.vo.ts
├── multiplication-factor.vo.ts
├── noop.service.ts
├── object-key.vo.ts
├── package-version-schema.vo.ts
├── package-version.vo.ts
├── percentage.service.ts
├── quarter-iso-id.vo.ts
├── quarter.vo.ts
├── random.service.ts
├── repeat.ts
├── revision-value.vo.ts
├── revision.vo.ts
├── rounding-decimal.strategy.ts
├── rounding-decimal.vo.ts
├── rounding-down.strategy.ts
├── rounding-to-nearest.strategy.ts
├── rounding-up.strategy.ts
├── rounding.strategy.ts
├── size-bytes.vo.ts
├── size.vo.ts
├── slug.service.ts
├── sms-body.vo.ts
├── sms-message.vo.ts
├── sum.service.ts
├── telephone-number.vo.ts
├── thousands-separator.service.ts
├── time-zone-offset-value.vo.ts
├── timestamp-value.vo.ts
├── timestamp.vo.ts
├── timezone.vo.ts
├── ts-utils.ts
├── url-with-slash.vo.ts
├── url-without-slash.vo.ts
├── visually-unambiguous-characters-generator.service.ts
├── week-iso-id.vo.ts
├── week.vo.ts
├── weekday-iso-id.vo.ts
├── weekday.vo.ts
├── weight-grams.vo.ts
├── weight.vo.ts
├── year-iso-id.vo.ts
└── year.vo.ts
```

## 常见问题

### @bgord/tools 是什么？

清除仓库

### 如何安装 @bgord/tools？

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

### @bgord/tools 支持 TypeScript 吗？

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

### @bgord/tools 支持 ESM 还是 CommonJS？

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

### @bgord/tools 可以商用吗？

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

### @bgord/tools 的下载量有多少？

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

### @bgord/tools 还在维护吗？

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