# @adobe/spectrum-tokens 中文文档

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

版本：15\.7\.0
npm 元数据更新时间：2026-11-11T19:59:30.332Z
中文译文更新时间：2026-11-11T20:01:20.116Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：3.5 MB，147 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2020-01-08T21:57:18.212Z
- 最新版本发布：2026-11-11T19:59:29.984Z
- 近 30 天下载量：43074（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：364（近 12 个月 39 个）

## 中文简介

Spectrum, Adobe 设计系统的设计符号

## 安装

```sh
npm install @adobe/spectrum-tokens
```

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

## README

# 光谱键

> **生成了遗留输出 .** `@adobe/spectrum-tokens` 来源于 [`packages/design-data`](https://npmcn.com/package/%40adobe/design-data/) 并保留给现有的 npm 消费者. `schemas/` 财务报告和审定财务报表 `naming-exceptions.json` 生成副本(来源: [`design-data-spec/schemas`](https://npmcn.com/package/%40adobe/design-data-spec/schemas/) 财务报告和审定财务报表 [`design-data/naming-exceptions.json`](https://npmcn.com/package/%40adobe/design-data/naming-exceptions.json)) (中文(简体) ). 不要在这个软件包上新建工具;见 `.ai/rules/legacy-tokens.md`。 。 。 .

设计令牌主要是用于存储设计决定并被以某种方式分配的名-值对,产品可以跨设计工具和编码语言. 这些值类型被表示为数据,包括间隔,颜色,打字,对象样式,动画等. 这些可以代表由设计定义的任何东西:以颜色为RGB值,以不透明为数字,以动画易用功能为Bezier坐标. 它们被用来代替硬码值,以确保所有产品体验的灵活性和统一性.

设计符被直接整合到我们的组件库,UI工具包和Spectrum XD插件中. 它们涵盖了平台尺度,色彩主题,组件状态等各种选项. 我们还向团队提供各种标志性类型,如果他们没有使用Spectrum组件库,可以直接在产品内使用.

## 开始

跟着单曲 [设置指南](https://npmcn.com/package/README.md#setup-monorepo-locally)。 。 。 .

## 设计 数据验证

月球任务运行 Rust `design-data` CLI 反对 `src/` 财务报告和审定财务报表 `schemas/`数字 :

-   `moon run tokens:validateDesignData` - JSON Schema (Layer 1) + 目录规则 (Layer 2)
-   `moon run tokens:verifyDesignDataSnapshot` - 与上文相同,与 `snapshots/validation-snapshot.json` (更新时间: `design-data migrate snapshot` 当产出发生变化时)

从有 Rust 可用的 repo 根也可以运行 `cargo run -p design-data-cli --manifest-path sdk/Cargo.toml -- validate ./packages/tokens/src --schema-path ./packages/tokens/schemas`。 。 。 .

## 从上次发布时生成 Diff

这个 `pnpm generateDiffResult` 脚本将构建工程并比较 `dist` 目录,带有Spectrum Tokens的最后发行版本。 它将生成一个报告,其中包含添加的令牌,被删除的令牌,有值变化的令牌,以及有潜在名称变化的令牌. 脚本无法保证正确的名称更改;它比较了新的指使和被删除的指使,看是否有相同的值,很可能是指使名称更改.

## 版本

这个项目使用 [语义版本( semver)](https://semver.org/)它还利用 [常规武器委员会](https://www.conventionalcommits.org/en/v1.0.0/) 财务报告和审定财务报表 [语义释放](https://semantic-release.gitbook.io/semantic-release/) 使用 GitHub 动作实现发布进程的自动化.

### 主要、次要和补丁标准

#### 补丁

x.x.n+1的释放用于错误修正和补丁.

-   错误修正
-   类型
-   错误

示例: 符号名称从 `detail-margin-top-mulitplier` 改为 `detail-margin-top-multiplier` 修补拼写错误.

#### 次要

x.n+1.0 发布是用于新的符和特征.

-   添加新符号
-   故意更改一个值
-   在适用的情况下添加折旧元数据和别名的新令牌

#### 少校

n+1.0.0 释放用于打破变化.

-   删除令牌
-   更改符号值类型( 例如, 从颜色到维度; 任何会打破预想特定数据类型的解析器)

## 折旧

### 计划更改代号

名称被更改的托肯会先被标记为被贬值,而用新名称创建出一新符;被贬值的符后会成为新符的别名. 最后,被贬损的道具最终会被取出,如果有足够的时间通知各小组,很可能在下个大发布会中被取出. 所需时间尚待确定.

### 用于折旧跟踪的控件属性

-   `deprecated` (boolean):将一个符号标记为已贬值
-   `deprecated_comment` (字符串):提供上下文说明为何该符被贬值和移徙指导
-   `renamed` (字符串):对于 1:1 个符号替换,指定应该使用的新符号名称

当一个符号重新命名时 :

1.  设定 `deprecated: true` 在旧的标志上
2.  添加 `renamed: "new-token-name"` 指定替换
3.  更新 `deprecated_comment` 必要时提供额外背景
4.  旧的代号 `value` 通常应为新符号的别名

## 释放

所有承诺合并或推向 `main` 分支将作为稳定版本与 `latest` 标签在 [国家预防机制](https://www.npmjs.com/package/@adobe/spectrum-tokens?activeTab=versions)所有承诺合并或推进 `next`,或 `next-major` 将按分支中的承诺类型(突破性更改、特性、错误修复)更新版本编号,并将其与 `next` 标签.

详情可参见此 [示例工作流程](https://semantic-release.gitbook.io/semantic-release/recipes/release-workflow/distribution-channels)。 。 。 .

## Spectrum Tokens 11.x.x和 12.x.x.x

从开始 `@adobe/spectrum-tokens` v12.0.0,本项目使用更高效的代币列表. 此前在v11.x.x中,每个可能的组合组件选项都被用来定义符号,导致一个不必要的大量符号列表. 然而,在从旧系统向较新的系统迁移组件的工作正在进行中,v12.0.0和今后的版本将在 `latest` 标签。 要安装,请使用脚本 :

```
pnpm add @adobe/spectrum-tokens
```

或者说

```
npm install --save @adobe/spectrum-tokens
```

如果您需要使用更古老、更完整的成套代币, 并同时发布 v12.x.x , 而此迁移正在开发中, 您可以使用 [`@adobe/spectrum-tokens-depreacated`](https://www.npmjs.com/package/@adobe/spectrum-tokens-deprecated) 软件包,这是存档的 `@adobe/spectrum-tokens@11.8.0`。 。 。 .

## 脚本类型和 `$schema`

托肯斯现在有了 `$schema` 与定义类型有关的属性 `schemas/token-types/` 目录。 即使是这些被作为正常发行的一部分而发行的,也不应该被认为是正式的API. 计划进行调整,在设计工具和工作流程中进一步整合数据。 理想的情况是,设计者能够编写出新的信使和管理所有数据的种类.

## 常见问题

### @adobe/spectrum-tokens 是什么？

Spectrum, Adobe 设计系统的设计符号

### 如何安装 @adobe/spectrum-tokens？

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

### @adobe/spectrum-tokens 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adobe\_\_spectrum-tokens 是否存在。

### @adobe/spectrum-tokens 支持 ESM 还是 CommonJS？

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

### @adobe/spectrum-tokens 可以商用吗？

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

### @adobe/spectrum-tokens 的下载量有多少？

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

### @adobe/spectrum-tokens 还在维护吗？

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