@blobz/avatar-core

中文文档
0.1.2发布于 2026/10/26MITTypeScriptES Module零依赖近 30 天下载 1932

决定性,无框架的 SVG blob vatars.

中文使用文档

@ blobz/ avatar- 核心

Blobz背后的无框架,决定性的SVG引擎. 同样的常态 名称和调色板总是在Node.js, Bun,和浏览器中产生相同的可视化.

使用量

import { createAvatar } from "@blobz/avatar-core";

const avatar = createAvatar({
  name: "Janaki",
  palette: ["#f2f1f4", "#7c6cf2"],
  frame: "rounded",
});

avatar.svg; // Complete 80×80 accessible SVG markup
avatar.choices; // Numeric choices that can be saved or edited
avatar.features; // Human-readable choices for a UI

用于与原始兼容 index.html 发电机, makeAvatar 保留 同一位置的 API :

import { makeAvatar } from "@blobz/avatar-core";

const avatar = makeAvatar(
  "Janaki",
  ["#f2f1f4", "#7c6cf2"],
  "circle"
);

手动构建相片

createCustomAvatar 使语义选择直接。 它不使用名称 或名称产生的散列来选择缺失的特性,它验证每个 选择运行时间.

import { createCustomAvatar } from "@blobz/avatar-core";

const avatar = createCustomAvatar({
  palette: ["#ffffff", "#12b76a"],
  frame: "circle",
  choices: {
    shape: "leaf",
    eyes: "distorted",
    look: "centre",
    eyeSpacing: "medium",
    mouth: "wide smile",
    brows: "quizzical",
    mirrored: false,
    faceAngle: 2,
    bodyTilt: -4,
    facePosition: { x: 1, y: 0 },
  },
});

toCustomAvatarChoices 将生成的结果转换为语义格式, 它让编辑器使用生成的面作为自定义的起点。 这个 遗产 choices 选项 createAvatar 保留部分数字 超载.

当前特性空间包含 5,159,700,000 调色板前的组合 变化。 包括21个相声,14个相声,13个相声,8个相声 样式和25个面角。 车体使用柔软的梯度和外侧照明 每张相片都配有亮点.

Faceprint v2 更新添加 uwu 财务报告和审定财务报表 angry 开口取出 tilted 浏览风格. 生成器绘制顺序保持稳定, 但更新的选项计数 更改某些名称的生成口和浏览。 已保存的数字浏览索引 7 现在选择 unibrow; 索引 8 无效。 语义自定义选择 除了去除的外,继续使用其命名样式 tilted 选项.

版本与发布记录

@blobz/avatar-core 共发布 4 个版本,首次发布于 2026/10/12;过去 12 个月发布了 4 个版本。

版本发布日期距今
0.1.2latest2026/10/2613 天前
0.1.12026/10/1326 天前
0.1.02026/10/1227 天前
0.0.0-stage2026/10/1227 天前

关于 @blobz/avatar-core 的常见问题

@blobz/avatar-core 是什么?

决定性,无框架的 SVG blob vatars.

如何安装 @blobz/avatar-core?

在项目目录运行 npm install @blobz/avatar-core,或使用 pnpm add / yarn add / bun add。

@blobz/avatar-core 支持 TypeScript 吗?

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

@blobz/avatar-core 支持 ESM 还是 CommonJS?

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

@blobz/avatar-core 可以商用吗?

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

@blobz/avatar-core 的下载量有多少?

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

@blobz/avatar-core 还在维护吗?

最新版本 0.1.2 发布于 2026/10/26(13 天前);至今共发布 4 个版本,其中过去 12 个月发布了 4 个;首次发布于 2026/10/12。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。