# @haiilo/catalyst-tokens 中文文档

规范地址：https://npmcn.com/package/%40haiilo/catalyst-tokens/

版本：14\.16\.0
npm 元数据更新时间：2026-11-10T08:54:04.477Z
中文译文更新时间：2026-11-17T06:18:54.071Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40haiilo/catalyst-tokens
原文对照：https://npmcn.com/package/%40haiilo/catalyst-tokens/?lang=original
项目主页：https://github.com/haiilo/catalyst#readme
源码仓库：https://github.com/haiilo/catalyst

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

- 包体积（解压后）：47.8 MB，128 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2022-03-07T15:39:37.089Z
- 最新版本发布：2026-11-10T08:54:03.955Z
- 近 30 天下载量：5821（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：270（近 12 个月 31 个）

## 中文简介

催化剂设计系统的设计标志

## 安装

```sh
npm install @haiilo/catalyst-tokens
```

也可以使用：`pnpm add @haiilo/catalyst-tokens`、`yarn add @haiilo/catalyst-tokens`、`bun add @haiilo/catalyst-tokens`

## README

# 催化器:托肯斯

[![Tokens: build & test](https://github.com/haiilo/catalyst/actions/workflows/tokens.yml/badge.svg)](https://github.com/haiilo/catalyst/actions/workflows/tokens.yml)

这个项目包含了催化剂设计系统的所有设计代号.

正在使用 [亚马逊风格词典](https://amzn.github.io/style-dictionary/#/)。 。 。 .

> 样式词典是一个构建系统,允许您定义样式一次, in 任何平台或语言的消费方式。 一个可以创建和 编辑您的样式, 一个命令将这些规则导出到所有地方 你需要它们 - iOS, Android, CSS, JS, HTML,草图文件,风格 文档,或者任何你能想到的。 它通过下列途径作为CLI提供: npm,但如果想要扩展,也可以像普通节点模块一样使用 它的功能.

## 开始

安装 `@haiilo/catalyst-tokens` 在您的 Node.js 驱动的应用程序中 [npm 软件包](https://www.npmjs.com/package/@haiilo/catalyst-tokens)数字 :

```shell
npm install @haiilo/catalyst-tokens
```

## 捐款

如果您想要在此寄存器中添加或更新符号, 请确保 遵守设计符号结构 [设计符号结构](https://amzn.github.io/style-dictionary/#/tokens?id=design-token-structure)。 。 。 .

### 软件包管理

该项目正在使用 [无](https://www.npmjs.com/) 作为包管理器. 这个 如果您想要在项目中添加新的依赖关系,则特别重要 未提供更新 `package-lock.json`。这将导致 CI 构建到 失败。 如果软件包锁中的依赖性不匹配其中的依赖性 `package.json`, (中文(简体) ), npm 将在 CI 构建中出错退出, 而不是更新软件包 锁上锁.

### 构建

运行 `npm run build` 建设工程. 建造的文物将存放在 页:1 `dist` 目录。 人工活性将在下列基础上自动生成: 定义的输出配置 `config.js`。 。 。 .

### 出版

库可通过运行发布 `npm publish`然而,偏好 新版图书馆的出版方式是通过CI设置. 新版本 自动发布到 [无](https://www.npmjs.com/package/@haiilo/catalyst-tokens) 当推出一个新的时 标记在主分支上。 要简化此进程, 您可以使用以下 npm 命令 :

-   **npm 运行释放: major** 发布新的 _主要_ 版本
-   **npm 运行发布: 小于** 发布新的 _小声_ 版本
-   **npm 运行释放: patch** 发布新的 _补丁_ 版本

这些命令将自动增加版本编号 `package.json` 财务报告和审定财务报表 `package-lock.json`,输入已修改的文件,创建一个 对应的 git 标记, 将所有东西推到远程分支 。 这样就可以了 自动发布一个新的库版本.

## 许可证

该许可证可在下列地点的主要存放处获得: [自由主义](https://github.com/haiilo/catalyst/blob/main/LICENSE) 文档.

## 常见问题

### @haiilo/catalyst-tokens 是什么？

催化剂设计系统的设计标志

### 如何安装 @haiilo/catalyst-tokens？

在项目目录运行 npm install @haiilo/catalyst-tokens，或使用 pnpm add / yarn add / bun add。

### @haiilo/catalyst-tokens 支持 TypeScript 吗？

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

### @haiilo/catalyst-tokens 支持 ESM 还是 CommonJS？

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

### @haiilo/catalyst-tokens 可以商用吗？

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

### @haiilo/catalyst-tokens 的下载量有多少？

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

### @haiilo/catalyst-tokens 还在维护吗？

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

