# @hanzo/tokens 中文文档

规范地址：https://npmcn.com/package/%40hanzo/tokens/

版本：1\.1\.3
npm 元数据更新时间：2026-11-13T00:41:08.455Z
中文译文更新时间：2026-11-17T08:32:26.309Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：453 kB，72 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-03-22T22:21:32.109Z
- 最新版本发布：2026-11-13T00:41:08.265Z
- 近 30 天下载量：13212（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 9 个）

## 中文简介

Hanzo UI的设计符号:颜色、间隔、光度、打字、主题

## 安装

```sh
npm install @hanzo/tokens
```

也可以使用：`pnpm add @hanzo/tokens`、`yarn add @hanzo/tokens`、`bun add @hanzo/tokens`

## README

# @hanzo/托肯斯

汉藏设计符号的单一真理来源——颜色,半径,类型, 间距 - **每个** 表面。 反应读取 TypeScript; 非反应表面( a) Gitea分叉,一个Go仪表板,一个Argo CD分叉)嵌入了生成的CSS. 一个编辑 到处宣传.

花佐的染色体为单色:一色通过不透明阶梯,默认为暗色. 铬中只有各州(`--state-error`, (中文(简体) ), `--state-warning`, (中文(简体) ), `--state-online`, (中文(简体) ), `--state-success`) (中文(简体) ). 类型为" Zen"+" Zen"单",出自@hanzo/font.

数据是一个例外,范围是: `src/data.ts` 是二十六个调色板 十二步胡同( s)`--data-<hue>-<step>`) 对于一个人的颜色——一个选择选项的 标记,一个 kanban 列,一个对象的图标平板,一个外形的初始,一个图表序列. 从来不是按钮,边框或焦点环. 21个可摘的二十个 hu和所有5个中性为Radix Clors天平; `hueOf(seed)` 选择 唱片的呼声来自一个稳定的字符串散列, 所以唱片保持它的颜色任何地方 它被绘制或导入.

## 输油管

```
src/theme.ts   ──gen-css──▶  dist/colors.css   ──▶  @hanzo/design/tokens/colors.css ──▶ styles.css
 (the source)                dist/tokens.css    ──▶  @hanzo/brand/styles/variables.css ──▶ git/ci/cd
```

-   **`src/theme.ts`** 持有每种颜色的符号( e)`dark` → `:root`, (中文(简体) ), `light` → `.light`\+ 半径/ 类型/ 间距 `scale`。数值是原始 CSS 字符串,所以 `var()` 参考书目仍为参考书目,所排放的捆绑是消费者 已经上船了 这是编辑一个值的 ONE 位置 .
-   **`scripts/gen-css.mjs`** 读取已建 `dist/theme.mjs` 并发出:
    -   `dist/colors.css` ——只使用彩色符号(`@hanzo/tokens/css/colors`; 计 数 合同 `@hanzo/design` 换了.
    -   `dist/tokens.css` ——颜色+半径+类型+间隔+数据调色板 (单位:千美元)`@hanzo/tokens/css`; 何为 `@hanzo/brand` 为 Go 表面重现 .
    -   `dist/data.css` 单是数据调色板(`@hanzo/tokens/css/data`) (中文(简体) ). 不进去 colors.css,其设计重排为铬合同.
-   `@hanzo/ui` 编曲 `data.css` 输入主题.cs,以及每个符号 软件包声明 @ hanzo/ deign' set 尚未发货 — 因此添加了一个符号 在此到达组件之前, 设计组下一次复制它.
-   `themes.ts` 编号 : `colors.ts` 是 JavaScript 消费者的解析平坦视图 无法调试 `var()`镜像 `theme.ts`。 。 。 .

## 重新生成

```bash
pnpm --filter @hanzo/tokens gen-css
```

流程:编辑 `src/theme.ts` → `gen-css` → `@hanzo/design` 财务报告和审定财务报表 `@hanzo/brand` 牵出 下个生成的 CSS `gen`编号 :`build` – gi / ci / cd 把它捡起来. `gen-css` 运行为 `build` (和 `prepublish`),所以出版的包 总是船 当前 CSS.

## 常见问题

### @hanzo/tokens 是什么？

Hanzo UI的设计符号:颜色、间隔、光度、打字、主题

### 如何安装 @hanzo/tokens？

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

### @hanzo/tokens 支持 TypeScript 吗？

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

### @hanzo/tokens 支持 ESM 还是 CommonJS？

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

### @hanzo/tokens 可以商用吗？

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

### @hanzo/tokens 的下载量有多少？

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

### @hanzo/tokens 还在维护吗？

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

