# @bysages/tokens 中文文档

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

版本：0\.6\.0
npm 元数据更新时间：2026-11-07T06:38:55.694Z
中文译文更新时间：2026-11-09T00:35:32.607Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：195 kB，10 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-09-16T00:04:22.902Z
- 最新版本发布：2026-11-07T06:38:55.527Z
- 近 30 天下载量：1926（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：17（近 12 个月 17 个）

## 中文简介

为 By Sages Elements 所设计符文 — DTCG 源编译为 CSS 变量和 JavaScript : 地表坡道, 从光, 密度级, 主题

## 安装

```sh
npm install @bysages/tokens
```

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

## README

# @ bysages/ tokens

![npm version](https://img.shields.io/npm/v/@bysages/tokens) ![npm downloads](https://img.shields.io/npm/dw/@bysages/tokens) ![npm license](https://img.shields.io/npm/l/@bysages/tokens)

> 由"圣贤元素"的设计标志—— [技术合作组](https://design-tokens.github.io/community-group/format/) 源用样式词典编译为 CSS 自定义属性和类型Script 类型。 系统中唯一允许的视觉值来源.

## 特征

-   🎨 **两级** ——组件实际消耗的原始活字(原始调色板,类型坡道,间隔)和语义符号(地表梯子,墨水,边框,高地,运动)
-   🌗 **主题维度作为数据** ——轻/暗模式,矿坑口音(清华/celadon/zhusha),固定语义颜色(bamboo/ochre/cinnabar/超海洋),4个密度级,对比级,场景预设
-   💡 **发光意识高地** ——从 `--bs-light-x` 编号 : `--bs-light-reach` 部件,从不复制,所以光源也是变量
-   📦 **三项产出** - 编译的样式表(`@bysages/tokens/css`,符号树作为数据(`.`语义层作为JS(`./styles`(中文(简体) )
-   🔤 **有声音的打字法** ——"歌词"标题,"hei-sans"UI染色体,CJK标签跟踪——为"中国×西方"注册的双轨堆

## 安装

```bash
# pnpm
pnpm add @bysages/tokens

# npm
npm install @bysages/tokens

# yarn
yarn add @bysages/tokens

# bun
bun add @bysages/tokens
```

## 快速启动

将编译的样式表一次导入到 app root 上 – 每个符号块作为 CSS 自定义属性 `:root`数字 :

```ts
import "@bysages/tokens/css";
```

然后在任何地方消费标志物——这是合同中的每个组件样式如下:

```css
.card {
  background: var(--bs-color-surface-2);
  border: 1px solid var(--bs-color-border);
  border-radius: var(--bs-radius-lg);
  box-shadow: var(--bs-elevation-1);
  padding: var(--bs-space-4);
}
```

## 重建

符号在构建时编译( I)`node scripts/build.mjs`(三); `pnpm dev` 在软件包根表和再编译中。 单列的消费者读取汇编 `dist`,所以在这里重建 之前,他们的改变 取出新的符号.

## 许可证

-   [麻省理工学院](https://npmcn.com/package/LICENSE) © [圣贤们](https://www.bysages.com/)

## 常见问题

### @bysages/tokens 是什么？

为 By Sages Elements 所设计符文 — DTCG 源编译为 CSS 变量和 JavaScript : 地表坡道, 从光, 密度级, 主题

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

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

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

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

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

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

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

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

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

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

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

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