# @ch-ui/colors 中文文档

规范地址：https://npmcn.com/package/%40ch-ui/colors/

版本：1\.2\.1
npm 元数据更新时间：2025-10-29T21:59:48.566Z
中文译文更新时间：2026-11-09T09:09:39.582Z
软件包许可：Ch Public License

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

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

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

- 包体积（解压后）：823 kB，21 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：1 个
- 首次发布：2024-02-04T18:43:41.804Z
- 最新版本发布：2025-10-29T21:59:48.354Z
- 近 30 天下载量：6546（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 0 个）

## 中文简介

基于 LAB 空间中绘图的螺旋曲线的程序色算法.

## 安装

```sh
npm install @ch-ui/colors
```

也可以使用：`pnpm add @ch-ui/colors`、`yarn add @ch-ui/colors`、`bun add @ch-ui/colors`

## README

# `@ch-ui/colors`

色彩套件导出函数, 帮助生成颜色系统, 绘制弧度, 使 bézier 曲线通过 [确定实验室色彩空间](https://bottosson.github.io/posts/oklab/)它使用 `colorsjs.io` 软件包,用于转换支持的游戏的颜色空间和输出符号.

## 开始

你可能更喜欢通过 `@ch-ui/tokens`,它显示一个更面向使用的大小写 API.

```shell
pnpm add @ch-ui/colors
```

然后,任意使用导出函数 。 下文举例说明.

## 背景情况

大部分项目要么从Tailwind的默认设置中继承颜色,要么由设计师手动选择使用的颜色。 这些方法对有些人是好的,但其他人都想要定制的调色板 _财务报告和审定财务报表_ 也没有时间手动管理他们想要支持的每个游戏中的每一层阴影.

### 通过色彩空间内插

这套软件的主要解决方案基于以下几个假设:

-   a. 调色板的 " 真实形式 " 与特定组别无关,它存在于感官色彩空间中;以及
-   颜色的调色板可以在从黑色开始的路径上作为点来表示,经过一个确定的"键色",以圆柱形模型以白色结束.

为了保持色度(“饱和度”/“色彩度”),使所有其他的遮光线看起来不会明显比密钥颜色更低调,密钥颜色和任意一极之间的路径应该会曲线,因此弧是两个连续的相接曲线,在密钥颜色相会.

### 在兼顾表达美学的同时保持连续性

程序色调板经常会碰到“芥末问题 ” : 在西方文化中,如果只减少黄色的原生阴影的光度,并在UI中使用该阴影,用户和设计者就会发现这些阴影没有吸引力。 基本上,人们喜欢避免任何游戏区.

这样,弧没有突然的不连续,并且可以作为3D空间中平滑和可分化的形状进行推理,这个软件包支持应用 _躯干_ 沿着地轴到贝塞尔曲线 黄色调色板的弧能随着变暗而轻轻地向外转去.

## 常见问题

### @ch-ui/colors 是什么？

基于 LAB 空间中绘图的螺旋曲线的程序色算法\.

### 如何安装 @ch-ui/colors？

在项目目录运行 npm install @ch-ui/colors，或使用 pnpm add / yarn add / bun add。

### @ch-ui/colors 支持 TypeScript 吗？

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

### @ch-ui/colors 支持 ESM 还是 CommonJS？

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

### @ch-ui/colors 需要什么版本的 Node\.js？

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

### @ch-ui/colors 可以商用吗？

@ch-ui/colors 使用 Ch Public License 许可。声明的许可为 Ch Public License，请阅读许可原文确认使用条件。以上为概括，不构成法律意见，请以许可原文为准。

### @ch-ui/colors 的下载量有多少？

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

### @ch-ui/colors 还在维护吗？

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