# @bible-strong/avatar-core 中文文档

规范地址：https://npmcn.com/package/%40bible-strong/avatar-core/

版本：0\.1\.0
npm 元数据更新时间：2026-08-17T16:22:36.052Z
中文译文更新时间：2026-11-08T01:30:25.705Z
软件包许可：AGPL-3\.0-only

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

原始 npm 页面：https://www.npmjs.com/package/%40bible-strong/avatar-core
原文对照：https://npmcn.com/package/%40bible-strong/avatar-core/?lang=original
项目主页：https://github.com/smontlouis/bible-strong-avatar-lab#readme
源码仓库：https://github.com/smontlouis/bible-strong-avatar-lab

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

- 包体积（解压后）：319 kB，30 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.12\.0
- 运行依赖：1 个
- 首次发布：2026-08-17T16:22:35.471Z
- 最新版本发布：2026-08-17T16:22:35.780Z
- 近 30 天下载量：10627（2026-10-08 至 2026-11-06，npm 官方下载统计）
- 已发布版本数：1（近 12 个月 1 个）

## 中文简介

独立运行时间 圣经 强程序外观.

## 安装

```sh
npm install @bible-strong/avatar-core
```

也可以使用：`pnpm add @bible-strong/avatar-core`、`yarn add @bible-strong/avatar-core`、`bun add @bible-strong/avatar-core`

## README

# @bible-strong/avatar-core (英语)

框架独立验证、语义回放和渲染器中性 SVG 场景生成 《圣经》 严正的程序造型 软件包没有反应、 DOM、 Motion 或浏览器存储 依赖性.

## 安装和验证

```sh
pnpm add @bible-strong/avatar-core
```

使用 `parseAvatarDefinition` 对于不信任的JSON文本。 它执行256KiB/深度限制 在对 v1 方案进行校验前, 检测重复对象密钥。 使用 `validateAvatarDefinition` 当数值已经实现时.

```ts
import { parseAvatarDefinition } from '@bible-strong/avatar-core'

const parsed = parseAvatarDefinition(jsonText)
if (!parsed.ok) {
  throw new Error(`${parsed.errors[0].path}: ${parsed.errors[0].message}`)
}
const definition = parsed.value
```

这两种职能都产生一种不加改变的歧视性结果。 成功的价值观被深深地冻结; 错误包括RFC 6901 JSON指针,代码和消息. 承诺的 JSON Schema 作为导出 `@bible-strong/avatar-core/schema`。 。 。 .

较早的放行前出口中的定义可能仍然包含 `standardAnimationSet: 1`; 在兼容性上接受标记,但不添加任何 隐含动画.

## 语义检索和回放

公用电话只使用语义键. `resolveExpression` 财务报告和审定财务报表 `resolveAnimation` 返回已键入错误 用于验证定义中没有的密钥。 每个动画都清晰地出现在 定义,所以JSON仍然是一个假人能够演奏的真理的唯一来源.

```ts
import {
  advanceAvatarPlayback,
  playAvatarAnimation,
  renderAvatarFrame,
} from '@bible-strong/avatar-core'

const started = playAvatarAnimation(definition, 'idle', 0)
if (!started.ok) throw new Error(started.error.message)

const state = advanceAvatarPlayback(definition, started.value, 500, {
  random: () => 0.5,
})
const scene = renderAvatarFrame(definition, state, 500, {
  random: () => 0.5,
  reduceMotion: false,
})
```

`advanceAvatarPlayback` 由单调时间戳驱动并注入的纯状态过渡 随机源. 每一步的时间是过渡,然后保持. `pauseAvatarPlayback` 财务报告和审定财务报表 `resumeAvatarPlayback` 保持确切的进展。 与 `reduceMotion: true`、过渡和环境 动作跳跃确定到目标,而所配置的闪烁仍然有效.

`renderAvatarDefinition` 使静态语义表达. `renderAvatarFrame` 制作一个 动画相框. 两种回路,能见度和已解析的颜色都不创建 DOM 节点.

## 入境点

-   `@bible-strong/avatar-core`:合同,验证,语义目录,回放和场景API.
-   `@bible-strong/avatar-core/schema`: v1 草案 2020-12 JSON Schema.
-   `@bible-strong/avatar-core/geometry`, (中文(简体) ), `/body`, (中文(简体) ), `/surfaces`, (中文(简体) ), `/ambient-motion`: 高级纯度 原始的制作者.

应用程序集成保存在单独的包中 : `@bible-strong/avatar-react` 使用 反应19,同时 `@bible-strong/avatar-web` 将同一定义直接挂入 DOM。 两者 依赖于此软件包,并使用相同的回放和场景执行.

软件包遵循语义版. 虽然它仍然低于 `1.0.0`,打破 API 更改 增量小版本并增量补丁版本.

## 常见问题

### @bible-strong/avatar-core 是什么？

独立运行时间 圣经 强程序外观\.

### 如何安装 @bible-strong/avatar-core？

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

### @bible-strong/avatar-core 支持 TypeScript 吗？

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

### @bible-strong/avatar-core 支持 ESM 还是 CommonJS？

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

### @bible-strong/avatar-core 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.12\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @bible-strong/avatar-core 可以商用吗？

@bible-strong/avatar-core 使用 AGPL-3\.0-only 许可。最严格的 Copyleft：除分发外，通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括，不构成法律意见，请以许可原文为准。

### @bible-strong/avatar-core 的下载量有多少？

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

### @bible-strong/avatar-core 还在维护吗？

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