@aura3d/scripting

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

行为附件、运行阶段、脚本上下文数据、行为注册、可视化图验证、图序列化和确定性可视化图执行。

中文使用文档

@aura3d /脚本

运行时行为和可视化图形脚本包(@aura3d/[email protected])。 进口 @aura3d/scripting 直接或使用根 @aura3d/[email protected] 运行时表面;遗产 @aura3d/engine/scripting 子路径在4.0.0中被移除。

@aura3d/scripting 拥有行为附件、行为运行阶段、脚本上下文数据、行为注册、可视化图形验证、图形序列化和确定性可视化图形执行。

公共API

  • Behavior, BehaviorHost, BehaviorRegistry, BehaviorSystem:行为生命周期钩子、主机所有权、工厂查找、更新/固定更新执行和错误捕获。
  • ScriptContext:传递给脚本的结构化运行时上下文。
  • VisualNode, VisualPort, validateNode:节点和端口模式验证,包括bounded any 端口和默认输入值。
  • createVisualNode, listVisualNodeDefinitions, getVisualNodeDefinition确定性可视化脚本节点目录,改编自旧的数学、逻辑、流控制、变量和调试节点表面。
  • VisualGraph, validateGraph, serializeGraph, deserializeGraph图拓扑验证,类型端口,循环拒绝,和确定性序列化。
  • VisualGraphExecutor:依赖顺序图执行,类型输出值,目录节点执行,以及明确的Unity/虚幻可视化脚本声明拦截器。

验证

包括行为阶段、行为附加、场景/ECS脚本集成、图/节点/端口验证、类型值、不匹配诊断、序列化、循环拒绝、确定性执行、目录数学/逻辑/流节点和浏览器脚本移动 tests/unit/workstream5-input-audio-scripting-editor.test.ts, tests/integration/scripting-scene-ecs.test.ts, tests/browser/scripting-browser.spec.ts. 导出和导入一致性由 pnpm verify:exports 和 pnpm verify:imports.

版本与发布记录

@aura3d/scripting 共发布 48 个版本,首次发布于 2026/06/06;过去 12 个月发布了 48 个版本。

版本发布日期距今
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/scripting 的常见问题

@aura3d/scripting 是什么?

行为附件、运行阶段、脚本上下文数据、行为注册、可视化图验证、图序列化和确定性可视化图执行。

如何安装 @aura3d/scripting?

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

@aura3d/scripting 支持 TypeScript 吗?

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

@aura3d/scripting 支持 ESM 还是 CommonJS?

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

@aura3d/scripting 可以商用吗?

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

@aura3d/scripting 还在维护吗?

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