@aura3d/asset-index

中文文档
4.7.0发布于 2026/10/31MITTypeScriptES Module零依赖

搜索,排名,配置文件和适配器开放,许可证明确的3D模型,纹理和HDRI源,与Aura3D验证自动拉候选分辨率。

中文使用文档
文档目录3 节
  1. 公共API
  2. 源适配器
  3. 包边

@aura3d / asset-index

@aura3d/asset-index 拥有搜索,排名,配置文件和源适配器 开放,许可证明确的模型,纹理和HDRI源,加上验证的自动拉 Aura3D的候选分辨率。没有托管目录:只有CLI的目录 aura3d assets resolve 使用这些适配器作为其构建时的一个级别 梯子(项目资产,开源,网格,原始配方)。

公共API

  • FederatedResolver:支持跨配置资产的自然语言查询 源适配器,筛选约束,对候选对象进行排序,并返回 归一化的结果。
  • defaultAdapters:自动拉取使用的零认证验证适配器 联盟通过。
  • AuraCanonicalAsset:解析器共享的规范化资产记录形状 和CLI。
  • scoreAsset, matchesConstraints:确定性排序和约束 帮手。
  • gameAssetProfileDefinitions, evaluateGameAssetProfile:剖面评分 用于面向游戏的资产搜索。
  • animationAssetProfiles, evaluateAnimationAssetProfile:剖面评分 用于面向动画的资产搜索。

源适配器

该包包括Khronos, OS3A, Poly Haven, Poly Pizza, ambientCG, Sketchfab,市场深度链接,策划Aura库和一个 jsdelivery CC0镜像。在4.2.0中删除了托管索引适配器。 键控源或市场源是明确的可选适配器;它们不是 默认情况下被视为自动可拉。

包边

这个包是搜索和解析器层。命令行拉出选中的 候选人通过类型化资产管道,和公共Aura3D路由应该 仍然生成渲染 assets.name 引用而不是原始url或猜测 模型IDs。

版本与发布记录

@aura3d/asset-index 共发布 53 个版本,首次发布于 2026/06/06;过去 12 个月发布了 53 个版本。

版本发布日期距今
4.7.0latest2026/10/312 天前
4.6.22026/10/304 天前
4.6.12026/10/304 天前
4.6.02026/10/304 天前
4.5.02026/10/295 天前
4.3.72026/10/286 天前

关于 @aura3d/asset-index 的常见问题

@aura3d/asset-index 是什么?

搜索,排名,配置文件和适配器开放,许可证明确的3D模型,纹理和HDRI源,与Aura3D验证自动拉候选分辨率。

如何安装 @aura3d/asset-index?

在项目目录运行 npm install @aura3d/asset-index,或使用 pnpm add / yarn add / bun add。

@aura3d/asset-index 支持 TypeScript 吗?

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

@aura3d/asset-index 支持 ESM 还是 CommonJS?

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

@aura3d/asset-index 可以商用吗?

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

@aura3d/asset-index 还在维护吗?

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