# @eocrm/design-tokens 中文文档

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

版本：0\.8\.16
npm 元数据更新时间：2026-11-13T12:03:36.207Z
中文译文更新时间：2026-11-13T19:09:19.940Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：68 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2026-11-02T12:11:18.449Z
- 最新版本发布：2026-11-13T12:03:35.649Z
- 近 30 天下载量：4798（2026-10-14 至 2026-11-12，npm 官方下载统计）
- 已发布版本数：27（近 12 个月 27 个）

## 中文简介

共享网络和克特林多平台/构成的EOCRM可视化符号. npm包包含生成的 Sass; Maven 文物包含生成的,强烈的打入的 Compose API. 两者的出版版本都与 `@eocrm/design-system`。 。 。 .

## 安装

```sh
npm install @eocrm/design-tokens
```

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

## README

# @ eocrm/ 设计指针

共享网络和克特林多平台/构成的EOCRM可视化符号. 时间 包中包含生成的 Sass; Maven 文物包含生成的, 强烈打入了 Compose API. 两者的出版版本都与 `@eocrm/design-system`。 。 。 .

**现场操场** (手提箱和部件,从 `main`: [https://eocrm.github.io/design-system/ (中文(简体) )](https://eocrm.github.io/design-system/)

## 网页

软件包在 npmjs 上公开( 无) `.npmrc` 或需要的标志 :

```bash
npm install @eocrm/design-tokens
```

导入光/主题中立的契约和暗主题覆盖:

```scss
@use '@eocrm/design-tokens/styles/tokens.scss';
@use '@eocrm/design-tokens/styles/dark.scss';
```

反应消费者导入编译的 `@eocrm/design-system/styles/global.css` (或 `tokens.css`),不需要此软件包;为 Sass 变量安装 或直接合同.

## Kotlin 多平台和编曲

GitHub套件甚至对公共的Maven套件也需要认证. 对于 本地开发,使用经典的个人访问符 `read:packages`· ; 保留 `gpr.user` 财务报告和审定财务报表 `gpr.key` 在您的用户级别 `~/.gradle/gradle.properties`, (中文(简体) ), 不是在仓库里 在 GitHub 动作中, 允许消费存储器访问 到软件包并使用工作流程 `GITHUB_TOKEN`。 。 。 .

```kotlin
repositories {
    maven {
        url = uri("https://maven.pkg.github.com/eocrm/design-system")
        credentials {
            username = providers.gradleProperty("gpr.user").orNull
            password = providers.gradleProperty("gpr.key").orNull
        }
    }
}

dependencies {
    commonMainImplementation("com.eocrm.design:design-tokens-compose:1.2.3")
}
```

直接使用生成的主题对象 :

```kotlin
import com.eocrm.design.tokens.EocrmDarkTokens
import com.eocrm.design.tokens.EocrmLightTokens

val background = EocrmLightTokens.colors.background
val darkBackground = EocrmDarkTokens.colors.background
val spacing = EocrmLightTokens.dimensions.space4
```

该文物支持了JVM,Android,iOS设备(`iosArm64`),和苹果硅 iOS 模拟器 (`iosSimulatorArm64`) (中文(简体) ). 它故意不发表 情报 `iosX64` 目标.

## 分数

`tokens.json` 可能有一个根 `accents` 键 : `{ "<name>": { "<tokenId>": { "light": "#rrggbb", "dark": "#rrggbb" } } }`每个口音发出a `[data-accent='<name>']` 块来压上每个主题块中的这些符号(光线、强迫黑暗、OS黑暗),以及一个编曲 `Eocrm<Name>LightTokens` 编号 : `Eocrm<Name>DarkTokens` 双人 校验者拒绝:

-   `unknown-accent-token` - 代号id不存在
-   `accent-non-color` - 符号不是颜色
-   `accent-unthemed` - 底牌不是浅/暗的
-   `accent-alias` ——该值是一个别名而不是颜色
-   `invalid-token-value` - 颜色不整齐

## 捐款

`src/tokens.json` 是唯一可编辑符号值的来源。 不编辑 任何在下面的东西 `generated/` 或生成 Kotlin 文件 `compose/src/commonMain`;再生取代它们.

```bash
npm run tokens:validate
npm run tokens:generate
npm run tokens:test
npm run tokens:check
packages/design-tokens/compose/gradlew --no-daemon -p packages/design-tokens/compose jvmTest assemble
```

在源更改的同时提交生成的产出 . `tokens:check` 验证 计划与语义合同, 运行测试, 失败在产生的漂移.

见 [共享设计所有权](https://npmcn.com/package/docs/shared-design-boundary.md) 联 合 国 介于中性符号、 React 组件、 Compose 产品 UI 和 本土平台行为.

## 许可证

[Apache 许可证 2.0](https://npmcn.com/package/%40eocrm/design-tokens/LICENSE)。 。 。 .

## 常见问题

### @eocrm/design-tokens 是什么？

共享网络和克特林多平台/构成的EOCRM可视化符号\. npm包包含生成的 Sass; Maven 文物包含生成的,强烈的打入的 Compose API\. 两者的出版版本都与 @eocrm/design-system。 。 。 \.

### 如何安装 @eocrm/design-tokens？

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

### @eocrm/design-tokens 支持 TypeScript 吗？

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

### @eocrm/design-tokens 支持 ESM 还是 CommonJS？

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

### @eocrm/design-tokens 可以商用吗？

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

### @eocrm/design-tokens 的下载量有多少？

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

### @eocrm/design-tokens 还在维护吗？

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