# @eternl/tools 中文文档

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

版本：0\.55\.0
npm 元数据更新时间：2026-11-10T15:47:35.721Z
中文译文更新时间：2026-11-14T01:14:06.678Z
软件包许可：BUSL-1\.1

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

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

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

- 包体积（解压后）：202 kB，116 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：@scure/base 2\.4\.0，@noble/hashes 2\.4\.0
- 首次发布：2026-02-12T12:03:47.320Z
- 最新版本发布：2026-11-10T15:47:35.505Z
- 近 30 天下载量：2622（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：102（近 12 个月 102 个）

## 中文简介

共享用于日志助手、基础公用设施和 Bech32 助手的工具包

## 安装

```sh
npm install @eternl/tools
```

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

## README

# @eternl/ 工具

共享用于日志和常见数据帮助的公用软件包.

## 安装

```bash
npm install @eternl/tools
```

## 包含模块

-   `@eternl/tools/log`
    -   结构化控制台助手 : `el`, (中文(简体) ), `sl`, (中文(简体) ), `warn`, (中文(简体) ), `error`, (中文(简体) ), `json`
-   `@eternl/tools/lib/array`
    -   阵列公用事业
-   `@eternl/tools/lib/bech32`
    -   Bech32 编码/解码助手和共享 `PREFIX_BECH32` 常数
-   `@eternl/tools/lib/crc8`
    -   CRC-8 校验和帮助
-   `@eternl/tools/lib/hex`
    -   十六进制和字节转换助手
-   `@eternl/tools/lib/id`
    -   身份证公用事业
-   `@eternl/tools/lib/json`
    -   安全 JSON 变换助手
-   `@eternl/tools/lib/math`
    -   数字帮助函数
-   `@eternl/tools/lib/number`
    -   数字格式化帮助
-   `@eternl/tools/lib/sleep`
    -   Async 计时助手
-   `@eternl/tools/lib/string`
    -   串接公用事业
-   `@eternl/tools/lib/time`
    -   时区助手

## 使用量

```sh
import { el, sl, json }      from '@eternl/tools/log'
import { encodeBech32 }      from '@eternl/tools/lib/bech32'
import { sleep }             from '@eternl/tools/lib/sleep'
import { now }               from '@eternl/tools/lib/time'

console.log(el('addressBookStore'), sl('loadAddressBook'), json({ ok: true }))
console.log(encodeBech32('pool', Buffer.from('ab'.repeat(28), 'hex')))
await sleep(50)
console.log(now())
```

## 出口

-   根导出再出口 `@eternl/tools/log` 和工具模块 `@eternl/tools/lib/*`。 。 。 .
-   `@eternl/tools/log` 输出 : `json`, (中文(简体) ), `el`, (中文(简体) ), `er`, (中文(简体) ), `sl`, (中文(简体) ), `warn`, (中文(简体) ), `error`。 。 。 .
-   `@eternl/tools/lib/*` 按模块输出特定特性的公用功能.

## 许可证

商业来源许可证1.1(`BUSL-1.1`) (中文(简体) ).

额外使用赠款 : `None`。 。 。 . 商业用途需要从塔斯滕昆斯特获得单独的许可证. 联系人 : [https://tastenkunst.com/ (中文(简体) )](https://tastenkunst.com/)

## 常见问题

### @eternl/tools 是什么？

共享用于日志助手、基础公用设施和 Bech32 助手的工具包

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

在项目目录运行 npm install @eternl/tools，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@scure/base（2\.4\.0）、@noble/hashes（2\.4\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

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

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

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

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

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

@eternl/tools 使用 BUSL-1\.1 许可。声明的许可为 BUSL-1\.1，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

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

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

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

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