@botharness/pixel-avatar

中文文档
0.10.2发布于 2026/10/09MITTypeScriptES Module近 30 天下载 4941

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

中文使用文档

@ botharness/ 像素-avatar

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

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。 。 。 .
  • pixelAvatarSvg(recipe, { turns, classPrefix }):可选的预先交接头转动和钻机层级(<prefix>-body, (中文(简体) ), -head, (中文(简体) ), -face, (中文(简体) ), -gaze, (中文(简体) ), -blink)用于CSS动画.
  • pixelAvatarSvg(recipe, { mouthLayers: true, speechMouthVersion: 2 }):保存/闭塞/半开/开口语音层,并有全开口的奉承. 奥米 speechMouthVersion (或使用) 1)为原圆开口. 第2版只会改变开口层,包括每个头部转弯;被接受的半开口,闭口和被保存的面相依然相同. 这是一个只渲染的演讲艺术版本,而不是存储的食谱迁移. pixelFigure 选择相同。 文本间隔和层层不透明与消费者在一起.

版本与发布记录

@botharness/pixel-avatar 共发布 12 个版本,首次发布于 2026/10/05;过去 12 个月发布了 12 个版本。

版本发布日期距今
0.10.2latest2026/10/0930 天前
0.10.12026/10/0930 天前
0.10.02026/10/0930 天前
0.9.02026/10/0930 天前
0.8.02026/10/0930 天前
0.7.02026/10/0930 天前

关于 @botharness/pixel-avatar 的常见问题

@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 和提交记录判断。