@dotcraft/avatar

中文文档
0.11.1发布于 2026/11/13Apache-2.0TypeScriptES Module零依赖构建来源已验证近 30 天下载 3182

名称衍生出 DotCraft 外观和 React SVG 动画组件

中文使用文档
文档目录4 节
  1. 安装
  2. 变相器
  3. 跟随指针
  4. 收藏

@ dotcraft/ avatar (英语)

从特工名字里调出一个一致的DotCraft同伴 反应组件需要反应19; 软件包根没有反应.

安装

npm install @dotcraft/avatar

变相器

在应用程序中导入样式表一次 .

import { Avatar } from '@dotcraft/avatar/react'
import '@dotcraft/avatar/styles.css'

export function AgentIdentity() {
  return <Avatar name="Reviewer" size={36} label="Reviewer" />
}

导入 deriveAppearance 从 @dotcraft/avatar 当应用程序需要相同时 名称生成的外观没有反应.

跟随指针

useAvatarGaze 将每个元件的相向向向指针。 打开它 只是在阿凡达闲置的时候 过 within 只在元素内部跟踪 reach 设置 在CSS像素中,视线距离阿凡达中心有多远达到极限.

const face = useRef<HTMLSpanElement>(null)
useAvatarGaze(face, { enabled: state === 'idle' })

return <span ref={face}><Avatar name="Reviewer" size={60} state={state} motion="system" /></span>

收藏

外出会填补五个独立的空档: head, (中文(简体) ), face, (中文(简体) ), hand, (中文(简体) ), back,以及 skin每一个 条目 登记 携带稀有(common 改为 legendary),系列,以及 ;共享一个区域的项目从未一起出现。 名称引出每个 插槽的稀有的共享重量,所以传说中的物品是稀有而可及的. 使用 equip(appearance, slot, id) 更改一个位置并澄清相互冲突的位置 目录 用于显示名称、稀有铬颜色和系列标签.

效果属于以下物品: chrome 财务报告和审定财务报表 holographic 换上身体的涂料, 发光的东西脉冲, 和克伊环绕身体。 仅在44px及以上有运动效果 启用; 较小的可视化器使其静态相框, 和可视化器在20px和下放相,手, 覆盖皮肤, 和效果层完全。 该模型在 规格/地貌/avatar-system.md。 。 。 .

见 类型脚本 SDK 引用 联 合 国 现有切入点.

版本与发布记录

@dotcraft/avatar 共发布 47 个版本,首次发布于 2026/09/08;过去 12 个月发布了 47 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.11.1latest2026/11/13今天
0.11.02026/11/111 天前
0.10.52026/11/103 天前
0.10.42026/11/085 天前
0.10.32026/11/076 天前
0.10.22026/11/058 天前

关于 @dotcraft/avatar 的常见问题

@dotcraft/avatar 是什么?

名称衍生出 DotCraft 外观和 React SVG 动画组件

如何安装 @dotcraft/avatar?

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

@dotcraft/avatar 支持 TypeScript 吗?

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

@dotcraft/avatar 支持 ESM 还是 CommonJS?

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

@dotcraft/avatar 可以商用吗?

@dotcraft/avatar 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@dotcraft/avatar 的下载量有多少?

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

@dotcraft/avatar 还在维护吗?

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