# @ai-game-assets/core 中文文档

规范地址：https://npmcn.com/package/%40ai-game-assets/core/

版本：0\.11\.39
npm 元数据更新时间：2026-11-07T16:11:19.932Z
中文译文更新时间：2026-11-06T09:36:54.655Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：183 kB，42 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-06-17T03:29:15.734Z
- 最新版本发布：2026-11-07T16:11:19.591Z
- 近 30 天下载量：3571（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：61（近 12 个月 61 个）

## 中文简介

用于即时意识AI游戏资产的核心显示和运行时间类型.

## 安装

```sh
npm install @ai-game-assets/core
```

也可以使用：`pnpm add @ai-game-assets/core`、`yarn add @ai-game-assets/core`、`bun add @ai-game-assets/core`

## README

# `@ai-game-assets/core`

引擎中性显示类型,验证,版本帮助器,以及AI Game States的目标分辨率.

[播放空间入侵者演示](https://tzachshabtay.github.io/ai-assets/) • 妇女 [在 npm 上查看此软件包](https://www.npmjs.com/package/@ai-game-assets/core) • 妇女 [阅读全部文档](https://github.com/tzachshabtay/ai-assets#readme)

```sh
npm install @ai-game-assets/core
```

在定义或检查AI资产表时使用此软件包,而不将您的代码与游戏引擎相配合.

## 共享设计器码头

`registerInGameDesignerPanel` 财务报告和审定财务报表 `registerInGameDesignerToggle` 在已安装的设计器之间共享工具栏。 单击一个按钮来切换其面板/工具,或拖动任何工具栏按钮来移动工具栏并一起打开面板. 当所有面板被关闭时,拖动只移动工具栏;打开面板使用该位置. 面板标题也支持拖放, 面板边缘支持调整大小 .

释放后拖放结束,指针取消,丢失捕获,或窗口焦点丢失. 没有按下按钮的移动也清除了在取景口外错过的放出. 运行 `npm run test:dock` 用于浏览器回归测试(安装 Chromium with `npx playwright install chromium` (第一编).

## 缩放变体

`AiAssetVersion.scaledVariants` 包含该源版本的替代分辨率。 每个 `AiAssetScaledVariant` 记录它的ID,不可改变文件,维度,可选框架网格,生成方法,源文件和时间戳. `scaledVariantSource` 保留源几何,即使后来的促销会改变资产的维度。 变体不改变逻辑资产维度或动画定义.

`selectScaledVariant(asset, displaySize, { version?, excludeId?, available? })` 返回最接近可用源或正本的对数比值,偏好对链接的较大分辨率。 显示大小描述工作表的一个框架 . `scaledVariantGeometry` 为请求的框架尺寸创建相容的网格. `assertManifest` 验证变体几何并重复大小. 源促进从新的变种集开始;不活动版本保留了它们的.

## 常见问题

### @ai-game-assets/core 是什么？

用于即时意识AI游戏资产的核心显示和运行时间类型\.

### 如何安装 @ai-game-assets/core？

在项目目录运行 npm install @ai-game-assets/core，或使用 pnpm add / yarn add / bun add。

### @ai-game-assets/core 支持 TypeScript 吗？

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

### @ai-game-assets/core 支持 ESM 还是 CommonJS？

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

### @ai-game-assets/core 可以商用吗？

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

### @ai-game-assets/core 的下载量有多少？

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

### @ai-game-assets/core 还在维护吗？

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