# @oods/tokens 中文文档

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

版本：0\.11\.3
npm 元数据更新时间：2026-11-02T02:09:02.182Z
中文译文更新时间：2026-11-02T02:18:11.438Z
软件包许可：Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40oods/tokens
原文对照：https://npmcn.com/package/%40oods/tokens/?lang=original
项目主页：https://oods-foundry.com/
源码仓库：https://github.com/kneelinghorse/OODS-Foundry

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

- 包体积（解压后）：5.4 MB，28 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.0\.0
- 运行依赖：0 个
- 首次发布：2026-09-26T12:19:05.456Z
- 最新版本发布：2026-11-02T02:09:01.924Z
- 已发布版本数：25（近 12 个月 25 个）

## 中文简介

为OODS Foundry设计标记：其品牌在浅色，深色和高对比度主题中的CSS变量和JavaScript值。

## 安装

```sh
npm install @oods/tokens
```

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

## README

# @oods /令牌

OODS组件使用的CSS变量和JavaScript令牌值。内置包包含发货品牌及其光，暗和高对比度范围。没有运行MCP服务器。

## 安装

```sh
npm install @oods/tokens
```

## 第一个结果

在基于绑定器的应用中，只需要导入一次样式表，然后在文档中选择一个作用域：

```js
import '@oods/tokens/css';
document.documentElement.dataset.brand = 'A';
document.documentElement.dataset.theme = 'light';
```

在CSS中使用语义角色：

```css
body {
  background: var(--sys-surface-canvas);
  color: var(--sys-text-primary);
}
```

对于JavaScript值：

```js
import tokens from '@oods/tokens';
console.log(tokens.cssVariablesByScope.A.light['--oods-sys-surface-canvas']); // oklch(1 0 286)
```

作用域适用于任何元素，而不仅仅是文档：一个有自己的面板 `data-brand` 和 `data-theme` 获得该品牌和主题的角色，因此黑暗预览可以坐在一个明亮的页面。

样式表还声明了三种字体的标记名称：Geist、Geist Mono和DM Sans。他们的文件传送过来 `dist/fonts` 从旁边的样式表加载，永远不要从网络；浏览器只会为使用家族的文本获取一个。Vite用样式表复制它们；Esbuild需要一个加载器(`--loader:.woff2=file`)，并webpack一个资源规则 `.woff2`.

`cssVariablesByScope` 保存每个品牌和主题的每个变量，并解析其值，以其全名为关键字，以 `--oods-`． 样式表使用短名称： `--oods-sys-surface-canvas` 在JavaScript中是值 `var(--sys-surface-canvas)` 需要下 `data-brand="A"` 和 `data-theme="light"`.

`@oods/tokens/brands` 导出此构建中的品牌。 `@oods/tokens/tailwind` 导出构建的JSON令牌有效负载；它不会为您安装或配置顺风。

要将您的颜色代币转换为OODS Foundry品牌，请使用 `brand_create` 通过 `@oods/foundry` 它已经发货了 `QUICKSTART.md`． 为该品牌生成的应用带有一个单独的样式表，其中包含自定义作用域。

## 限制

生成的应用锁定生成它们的OODS版本；要升级，请重新生成应用程序或将所有四个引脚移到一起。这些包与本地MCP服务器是分开的， `@oods/foundry`.

## 许可证

Apache License 2.0。看到 [许可证](https://cdn.jsdelivr.net/npm/@oods/tokens@0.11.3/LICENSE) 和 [请注意](https://cdn.jsdelivr.net/npm/@oods/tokens@0.11.3/NOTICE)． Geist、Geist Mono和DM Sans字体文件采用SIL开放字体许可证1.1，颜色校准源自Radix Colors (`dist/radix-calibration.json`)受MIT授权；“通知”带有这些许可以及文件的来源。生成的输出属于其用户；已安装的包依赖项保留其自己的许可证。

## 常见问题

### @oods/tokens 是什么？

为OODS Foundry设计标记：其品牌在浅色，深色和高对比度主题中的CSS变量和JavaScript值。

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

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

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

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

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

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

### @oods/tokens 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

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

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

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

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