# @botharness/pixel-avatar 中文文档

规范地址：https://npmcn.com/package/%40botharness/pixel-avatar/

版本：0\.10\.2
npm 元数据更新时间：2026-10-09T08:18:21.335Z
中文译文更新时间：2026-11-08T12:11:18.009Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40botharness/pixel-avatar
原文对照：https://npmcn.com/package/%40botharness/pixel-avatar/?lang=original
项目主页：https://github.com/BotHarness/BotPixel
源码仓库：https://github.com/BotHarness/BotPixel

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

- 包体积（解压后）：360 kB，6 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-10-05T08:33:02.395Z
- 最新版本发布：2026-10-09T08:18:21.181Z
- 近 30 天下载量：4941（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

种子,可编辑 32x32 chibi 像素可变的状态符号

## 安装

```sh
npm install @botharness/pixel-avatar
```

也可以使用：`pnpm add @botharness/pixel-avatar`、`yarn add @botharness/pixel-avatar`、`bun add @botharness/pixel-avatar`

## README

# @ botharness/ 像素-avatar

被种子,可被编辑的32×32 chibi像素活体有状态符号,可以被变形.

```ts
import {
  pixelAvatarSvg,
  seededRecipe,
  faceCells,
  pixelSymbolCells,
} from '@botharness/pixel-avatar';

const recipe = seededRecipe('DeepSeekBot');
const svg = pixelAvatarSvg(recipe); // 32×32 viewBox, crisp edges, no ids or scripts
```

-   `seededRecipe(name)`:同名总是给人同样的面相. `createSeededRecipe(namespace)` 造个有自己面相的工厂.
-   `AVATAR_PARTS`, (中文(简体) ), `AVATAR_SWATCHES`, (中文(简体) ), `AVATAR_PRESETS`, (中文(简体) ), `DEFAULT_RECIPE`:编辑所需要的一切.
-   `isPixelAvatarRecipe`, (中文(简体) ), `canonicalRecipe`:验证并规范所保存的食谱.
-   `AVATAR_HAIR_PARTS`, (中文(简体) ), `AVATAR_RANGES`, (中文(简体) ), `detailedRecipe(recipe)`:可选更细的控制. 配方可能携带 `bangs`, (中文(简体) ), `sideHair`, (中文(简体) ), `backHair`, (中文(简体) ), `spacing`, (中文(简体) ), `height` 财务报告和审定财务报表 `hairLength`,所有六或无; `detailedRecipe` 使他们从平地生出 `hair` 因此编辑器可以从屏幕上的内容开始. 食道,没有它们 完全像以前.
-   `AVATAR_SPECIES`, (中文(简体) ), `AVATAR_SPECIES_SWATCHES`, (中文(简体) ), `AVATAR_PIECE_COLORS`, (中文(简体) ), `withSpecies(recipe, species)`:阿凡达物种( `human`, (中文(简体) ), `goblin`与资产版本2相同. `withSpecies` 保持每一个选择, 分裂侧发进入 `sideHair` (左边)和 `rightSideHair`选项 `leftSideHairColor`编号 :`rightSideHairColor`,在屏幕上可以看到左右。 在第二版之前的消费者 拒绝这些食谱 `isPixelAvatarRecipe` 可以显示保存的快照 .
-   `AVATAR_PARTS_V2`, (中文(简体) ), `AVATAR_EXTRA_PARTS`, (中文(简体) ), `hiddenChoices(recipe)`: 第2版增加了精灵,矮人,兽人和花种,盔甲/robe/tunic/cloak服饰,头盔/头饰,可选 `beard`还有一朵花 `petals` 财务报告和审定财务报表 `flowerBase`。 。 。 . `hiddenChoices` 名称保存了当前物种或头饰所保持的但不画的选项,因此编辑器可以这么说而不是丢弃它们.
-   `PixelCustomPart`, (中文(简体) ), `withHeadpiece(recipe, part)`, (中文(简体) ), `customPartId`, (中文(简体) ), `isPixelCustomPart`: 人类自定义部分 `headpiece` 插槽(花牌上方为32×16). 其后地层被引出发后并被上前地层所覆盖,两者都通过转弯来跟随头. 每个单元格 `[x, y, color, tone]`时 `color` 是一个外观颜色槽( n)`hairColor`, (中文(简体) ), `skinColor`, (中文(简体) ), `eyeColor`, (中文(简体) ), `shirtColor`),所以部分重新以"神通"来作颜色,或者固定 `#rrggbb`,以及 `tone` 是钻机遮荫坡道从−2到2的一步(`partToneColor`) (中文(简体) ). 配方穿戴了一部分,将自己的副本嵌入了3版资产. `customPartId` 名称、作者和来源属于消费者的图书馆.
-   `HAIR_PART_SLOTS`, (中文(简体) ), `hairPieceStart(recipe, slot)`, (中文(简体) ), `withCustomPart(recipe, slot, part)`, (中文(简体) ), `wornPart`:画出发片. `bangs`, (中文(简体) ), `leftSideHair`, (中文(简体) ), `rightSideHair` 财务报告和审定财务报表 `backHair` 每一个都取一个自定义部件( 只取前图层) , 在内置部件保存在下面时替换它 。 在头发的部分,a `hairColor` 在0色调时的细胞是活发:它与其余发型完全一样被遮蔽,所以 `hairPieceStart` 将已磨损的内嵌件平整入这种牢房,一份不变的复制件也一样。 其他细胞表现出自己的颜色. 所抽取的发相跟随倒转并被隐藏在头盔或头罩下和花上,像内置发相.
-   `REPLACE_PART_SLOTS`, (中文(简体) ), `replacePartStart(recipe, slot)`: 已绘制 `outfit`, (中文(简体) ), `accessory`, (中文(简体) ), `beard`, (中文(简体) ), `glasses`, (中文(简体) ), `nose`, (中文(简体) ), `cheeks`, (中文(简体) ), `petals` 财务报告和审定财务报表 `flowerBase` 部件(只有前一层)。 所绘制的部分取代了图层中用于分画成像素的内置部分像素,而内置选择则保存在下面. `replacePartStart` 平整了这个食谱中已磨损的内置部分: 在一个音调上完全是一个外观颜色的像素会变成那个色槽,其余的会变成固定的颜色,所以一个不变的拷贝会同样地产生. 画出的脸部从不遮住说话口,画出的脸部从不遮住说话口,只要物种或头饰隐藏了内置的部分,就隐藏在那里. 取代头盔或头罩的从属者 不再隐藏头发.
-   `emptyPartLayer`, (中文(简体) ), `paintPartLayer`, (中文(简体) ), `fillPartLayer`, (中文(简体) ), `mirrorPartX`, (中文(简体) ), `partLayer`, (中文(简体) ), `partCells`, (中文(简体) ), `createCustomPart`:取自密集地层上,有铅笔和擦去的中风,有4个相接相通的洪水填充并镜像穿透了"阿凡达"中线.
-   `partLinePoints`, (中文(简体) ), `partRectPoints`, (中文(简体) ), `gradientPartLayer`, (中文(简体) ), `ditherThreshold`, (中文(简体) ), `noisePartLayer`, (中文(简体) ), `shadePartLayer`:行行(有0°/45°/90°相),矩相(有正方形相),音调梯度为4×4或2×2,命令在起动区域内分化,播下±1个音调噪声,并放出能使每个有色细胞移动一个音调的阴影中风. 所有镜像,以及所有产生出普通的细胞:种子和工具不属于部分.
-   `AVATAR_PIECE_COLORS_V4`, (中文(简体) ), `AVATAR_STRANDS`, (中文(简体) ), `AVATAR_HEADPIECES`, (中文(简体) ), `withPieces`, (中文(简体) ), `withBuiltInHeadpiece`, (中文(简体) ), `builtInHeadpiece`, (中文(简体) ), `headpieceStart`: 资产版 4. 砰,后发和单发 `strand` 每种颜色均取可选颜色(`bangsColor`, (中文(简体) ), `backHairColor`, (中文(简体) ), `strandColor`默认为 `hairColor`就像侧发的颜色 头部插槽有内置头部(耳、角、光环或小头翼)或自定义部分,与任何附属部分一起穿戴。 基座坐落在发后而其余则位于正前;而最远的一面则会藏起头部转动后. `withPieces` 当人类编辑并移动一个现在为头饰的附属物进入空头饰槽时,将一个食谱升级. 保存的食谱从不自行迁移,所以它们像以前一样不断渲染. `headpieceStart` 将已磨损的头部平整成自定义部分开始绘制 .
-   `AVATAR_ANIMAL_SPECIES`, (中文(简体) ), `AVATAR_PATTERNS`, (中文(简体) ), `isAnimalSpecies`: 资产版4中的动物物种. 每个都有一个口袋,一个动物的鼻子和自己的耳朵, 使用皮肤的颜色作为皮毛, 取一个可选的皮毛 `pattern` 被皮毛吸引着 抽签 `pattern` 自定义部分替换内置部分 。 耳机和耳饰保存在动物身上.
-   `faceCells`, (中文(简体) ), `pixelSymbolCells`, (中文(简体) ), `symbolArtCells`: 像素用于 [`@botharness/pixel-morph`](https://npmcn.com/package/%40botharness/morph)。 。 。 .
-   `pixelAvatarSvg(recipe, { turns, classPrefix })`:可选的预先交接头转动和钻机层级(`<prefix>-body`, (中文(简体) ), `-head`, (中文(简体) ), `-face`, (中文(简体) ), `-gaze`, (中文(简体) ), `-blink`)用于CSS动画.
-   `pixelAvatarSvg(recipe, { mouthLayers: true, speechMouthVersion: 2 })`:保存/闭塞/半开/开口语音层,并有全开口的奉承. 奥米 `speechMouthVersion` (或使用) `1`)为原圆开口. 第2版只会改变开口层,包括每个头部转弯;被接受的半开口,闭口和被保存的面相依然相同. 这是一个只渲染的演讲艺术版本,而不是存储的食谱迁移. `pixelFigure` 选择相同。 文本间隔和层层不透明与消费者在一起.

## 常见问题

### @botharness/pixel-avatar 是什么？

种子,可编辑 32x32 chibi 像素可变的状态符号

### 如何安装 @botharness/pixel-avatar？

在项目目录运行 npm install @botharness/pixel-avatar，或使用 pnpm add / yarn add / bun add。

### @botharness/pixel-avatar 支持 TypeScript 吗？

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

### @botharness/pixel-avatar 支持 ESM 还是 CommonJS？

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

### @botharness/pixel-avatar 可以商用吗？

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

### @botharness/pixel-avatar 的下载量有多少？

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

### @botharness/pixel-avatar 还在维护吗？

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