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

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

版本：0\.11\.39
npm 元数据更新时间：2026-11-07T16:12:15.550Z
中文译文更新时间：2026-11-06T12:19:56.336Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：565 kB，62 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：7 个
- peer 依赖：openai \>=5
- 首次发布：2026-06-17T03:29:17.627Z
- 最新版本发布：2026-11-07T16:12:15.227Z
- 近 30 天下载量：3218（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：61（近 12 个月 61 个）

## 中文简介

开发服务器和AI供应商提供即时意识AI游戏资产.

## 安装

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

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

## README

# `@ai-game-assets/dev`

本地开发服务器,AI供应商,资产存储,以及AI Game States的出品表工具.

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

```sh
npm install -D @ai-game-assets/dev
```

开发期间使用此软件包生成,编辑,推广并构建游戏资产. 制作游戏不需要开发服务器或AI认证.

## 11Labs 语音线

`createElevenLabsAudioProvider()` 默认语音线生成到 11 v4(`eleven_v4`(中文(简体) ) 通过 [文本对语音 API](https://elevenlabs.io/docs/eleven-api/quickstart)设置 `voiceSettings.model` 资产或要求钉入不同的模型,或通过 `voiceLineModel` 以更改其默认值。 语音设置优先于 `audioSettings.model`,然后提供者默认。 明确的遗产和习惯模式仍然得到支持. 生成选项将解析的语音模式保存到 `model` 财务报告和审定财务报表 `voiceSettings.model`。 。 。 . 语音设计,音效,和音乐使用自己的模型.

## 缩放变体

`POST /__ai-assets/scaled-variant-options` 生成来自最接近可用来源的3个候选人,而无需写出PNG或更改清单。 它接受与生成相同的源身份,要求的维度,再生身份,以及缩放方法. 每个候选人包括: `index`, (中文(简体) ), `dataUrl`, (中文(简体) ), `dimensions`选项 `frameGrid`, (中文(简体) ), `method`,以及 `sourceFile`. AI 动画扩展将整张图案表按每个候选人一个请求发送,并附有共享的字符一致性和网格保护指令. 源边距和间隔在生成前被去除;未用单元格保持透明. 失败或已取消的批次从不替换已保存的变体 .

通过 `POST /__ai-assets/scaled-variant` 与 `action: "select"`页:1 `dataUrl`, (中文(简体) ), `candidateSourceFile`,有效 `method`,请求的框架 `width`编号 :`height`,和原始请求身份。 选择验证了维度,源出处和 steal再生请求,只保存所选像素,不再提出AI请求. `generateScaledVariantOptions` 也可以导出用于自定义服务器.

`POST /__ai-assets/scaled-variant` 直接创建,促进所选候选人,上接,或删除一个版本范围分辨率. 请求包括: `assetId`, (中文(简体) ), `versionName`, (中文(简体) ), `sourceFile`, (中文(简体) ), `action`,对于现有变体, `id` 财务报告和审定财务报表 `expectedFile`生成接受 `width`, (中文(简体) ), `height`,以及 `method` (单位:千美元)`nearest`, (中文(简体) ), `resample`,或 `ai-upscale`); 触摸接受一个PNG `dataUrl` 其变相尺寸不变。 宽度/高度描述每个帧或平面,当源是工作表时. 答复包括最新清单和变体。 生成和触摸也返回 `previewDataUrl` 包含已保存的 PNG, 允许在公共文件监视器曝光新 URL 之前立即预览 .

服务器验证图像尺寸和框架几何, 拒绝 stale 更新, 仅读取内部的本地源文件 `assetsDir`,并保存不可改变的PNG. 失败的生成使现有的变体保持不变. 备选文件和元数据保留在生产清单构建中。 被替换的文件被保留,因为其他目标资产或出处可能参考.

严格调整没有 API 证书的作品大小 。 AI 扩展使用 OpenAI 图像编辑 API `OPENAI_API_KEY`;不需要额外的提供者令牌。 默认型号为GPT Image 2.5 Sunburst,质量高并有固定的保存快取. 在API支持的画布上生成较小的目标,并用最近邻居的取样方式调整到要求的精确尺寸。 所编辑的图像的透明度被保留. OpenAI 可改进细节; 使用 `nearest` 用于精确的像素保存。 AI模式下降尺度使用定心平滑再调整大小而无需API调用.

习惯 `AiAssetUpscaleProvider` 执行 `upscale({ image, width, height, frameGrid?, signal })` 然后返回图像字节。 通过它作为 `upscaleProvider` 改为 `createAiAssetDevServer`。 。 。 . `createOpenAiUpscaleProvider({ apiKey?, model?, fetch? })`, (中文(简体) ), `saveScaledVariant`,以及 `resizeScaledSource` 用于自定义服务器。 服务器选择最接近的源头, 通过可选的打包动画工作表 `frameGrid` 向提供者提供元数据,并强制执行精确的输出维度。 非AI重塑每个细胞的活体大小,以防止相框边界外出出出色.

## 常见问题

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

开发服务器和AI供应商提供即时意识AI游戏资产\.

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

在项目目录运行 npm install @ai-game-assets/dev，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ai-game-assets-dev，可以用 npx ai-game-assets-dev 直接运行。

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

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

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

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

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

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

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

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

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

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