# @hanzo/appearance 中文文档

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

版本：0\.2\.15
npm 元数据更新时间：2026-11-12T23:25:35.530Z
中文译文更新时间：2026-11-17T08:09:55.692Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：213 kB，33 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：react \>=19\.2\.8
- 首次发布：2026-08-08T05:03:03.413Z
- 最新版本发布：2026-11-12T23:25:35.303Z
- 近 30 天下载量：18736（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：23（近 12 个月 23 个）

## 中文简介

一个人自己对汉藏设计系统的阅读——主题,类型大小,密度,角,口音——存储,应用和可调整.

## 安装

```sh
npm install @hanzo/appearance
```

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

## README

# @hanzo/出现

一个外观面板:主题,文本大小,尺度,密度,面相,阿拉伯面相, 宽度,角和口音,每人存储并应用于整个产品.

```tsx
import { Appearance } from '@hanzo/appearance'

<Appearance />
```

将启动脚本添加到 `<head>` 所以,第一张画已经正确,没有 当JS运行时

```tsx
import { bootScript } from '@hanzo/appearance/state'

<script dangerouslySetInnerHTML={{ __html: bootScript() }} />
```

`<Hanzo>` 从 `@hanzo/ui` 将个人的选择应用在挂载上,手将 主题。 一个挂起自己的 Gui 提供者的电话的主机 `useAppearance()` 一次在它的根并经过 `useScheme()` 作为 `defaultTheme`。 。 。 .

## Knobs, 不是主题

`@hanzo/design` 发表 `--type-scale`, (中文(简体) ), `--type-ratio`, (中文(简体) ), `--density`, (中文(简体) ), `--radius-scale`, (中文(简体) ), `--font-sans`, (中文(简体) ), `--font-arabic` 编辑 `--primary` 编号 : `--accent` 和每个坡道 `tokens/*.css` 读取它们。 偏好设置几个数字和一个颜色 而不是重复一个比例表,所以后面添加的rung是免费覆盖的.

阿拉伯语是自己的轴线(`arabic`数字 : `kufi`, (中文(简体) ), `sans` 或者说 `plex`因作禅画无阿拉伯语. 写着 `--font-arabic`,该设计是 sans, 单和 serif 堆叠所有名称 首先,它所命名的同伴 将每个阿拉伯字母置于任何面孔之下 拉丁语从不碰它.

口音是家庭:填充物,其上读取的墨水(设计为黑色或 白色的,以更相左者为准)和加深它的悬浮,都来源于 一个颜色由 `vars()`主题是一个类, `light` 编号 : `t_light` 或者说 `dark` 编号 : `t_dark`,彩绘在 `<html>` 在两个词汇.

## 第一幅画

`apply()` 保持它画在下面 `hanzo.appearance.painted`,以及 `bootScript()` 在任何捆绑运行前 完全重放 这算不上什么, 所以它不会落后 `vars()`。 。 。 . `bootScript({ base })` 绘制安装 在从未应用过设备上默认.

## 选择的地方

四层,最狭小的,以轴取胜的评分轴: `install < org < person (everywhere) < person (this org)`。人物的分层 保存在IAM中(`/v1/iam/preferences`成员 `appearance`)并缓存于 设备,所以一个汉藏起源的选择 到达另一个.

## 那个作曲家

一个人的作曲行为是一张唱片,每个作曲家都读过 (单位:千美元)`@hanzo/ui/chat`是因为 `Composer`),由面板上最后一行所写:

```ts
import { useComposing, writeComposing } from '@hanzo/appearance'

useComposing() // { send?: 'enter' | 'mod', chips?: boolean, model?: boolean, mode?: boolean }
writeComposing({ send: 'mod' }) // ⌘/Ctrl+Enter sends, Enter breaks the line
```

缺少一个无人设定的轴, 而表面本身的默认保存( Chat 打开) 没有芯片或模式, Dev 和两种模式; 模式选择器关闭直到关闭 (电话) 它保存在装置下面 `hanzo.composer`中,以 `hanzo:composer` 并保存在IAM 旁边的外观 `composer` 成员 `/v1/iam/preferences`,所以它跨越一个域。 画作 无: 没有文档 knob, 没有头脚本 .

## 常见问题

### @hanzo/appearance 是什么？

一个人自己对汉藏设计系统的阅读——主题,类型大小,密度,角,口音——存储,应用和可调整\.

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

在项目目录运行 npm install @hanzo/appearance，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（\>=19\.2\.8）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

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

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

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

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

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

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

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

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

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

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

