@adea-ai/spatial

中文文档
0.114.1发布于 2026/11/03Apache-2.0TypeScriptES Module零依赖近 30 天下载 6209

场景和资产清单合同加上Adea工作空间的外壳到引擎空间协议:场景挂载清单,产卵URL助手,场景遥测计划. 纯粹的类型——没有渲染,没有二进制.

中文使用文档

@adea-ai/空间

现场和资产清单合同加空壳对引擎空间协议 为Adea工作空间。 它提供类型,挂载运单,URL帮助器,以及 遥测验证没有渲染引擎,二进制或秘密.

巩固前者 @adea-ai/asset-manifests 财务报告和审定财务报表 @adea-ai/spatial-protocol 软件包,它们总是一起发行;两套软件包都为这个而贬值 软件包.

  • asset-manifests.ts: 已打入场景数据形状 : SceneManifest, (中文(简体) ), SceneZone, (中文(简体) ), SceneStartPosition,指定道具列表,静态-场资产URL.
  • manifests.ts数字 : hqHomeManifest 编号 : hqWorkManifest 挂载常数( 镜像) 发动机的房间布局;发动机是真理的来源.
  • scene-spawn.ts:跨应用程序产卵码/parse和门户URL帮助器.
  • telemetry.ts数字 : ScenePerformanceReport 计划、验证、信封和 导航仪.
  • sim-bridge/ (传教士) @adea-ai/spatial/sim-bridge:嵌入合同 一个单独的Sim代理主机页面。 见下文.
  • data/:跟踪现场清单home/, (中文(简体) ), work/),从 发动机 scenes/sim/assets/; 由 scripts/sync-assets.mjs。 。 。 .

跟踪到的场景数据为 a 公用镜像, 不是每个文件匹配特定私有源的证明 修订或分发包。 特性和有效载荷接受需要分别进行 检查计划包.

东道代理Sim桥@adea-ai/spatial/sim-bridge(中文(简体) )

Schema、验证器和发射合同,用于安装在 iframe. (英语). 它是子路径导出, 因此默认的桌面有效载荷和应用程序捆绑不会 包括它,它没有私人特工Sim或资产代码。 它没有运输 自己: 呼叫通过 MessageEvent- 前后的形状值 postToFrame 编号 : postToHost。 。 。 .

  • 信件 (单位:千美元)messages.ts: 一个已关闭,版本化的集. 要主机的框架 : frame.ready, (中文(简体) ), frame.state, (中文(简体) ), frame.close, (中文(简体) ), frame.error要设定的主机 : host.launch, (中文(简体) ), host.dispose。没有通用呼叫、 eval、 文件系统、 本地RPC 或证书 而严格的有效载荷形状拒绝任何额外的密钥(a) token 页:1. 每个消息只有在发件人来源于确切的许可名单上时才被接受 event.source 是精确的帧( 或父窗口) 窗口, 它的信封带有 每座山数 bridgeId 所发行的主机(createBridgeId,该版本得到支持,以及 它停留在有限的面积、深度、宽度和节点预算范围内(大约2个基B;环形、深和 广泛有效载荷被拒绝而无人行走)。 访问器属性从未读取,以及 每个歧视者都被视为自己的数据属性。 员额从未使用 *。 。 。 .

  • 来源 (单位:千美元)origin.ts: 准确的峡谷 scheme://host[:port] 字符串。 没有 通配符、后缀匹配、路径或 null循环 http: 需要明确 allowLoopbackHttp 选入地方发展. 在许可名单上说在哪里 车架是用来的 这不是官方桌面身份或 权限, 应用程序中既没有本地主机, 也没有嵌入任何值 .

  • 发射 (单位:千美元)launch.ts: 主机询问 Adea 后端启动 (单位:千美元)SimLaunchRequest; 后端检查权限并返回一个有效的一次性代码 最多120秒(SimLaunchGrant,当它僵化时也会被拒绝,因为 或为许可列表以外的框架来源)。 主机发布代码 到边框, 边框在 sim 源头将其交换为只使用 sim 的会话 (单位:千美元)SimSessionExchangeRequest 编号 : SimSessionExchangeResult) (中文(简体) ). 两具尸体都没有 符号 . createLaunchOnce 财务报告和审定财务报表 createLaunchCodeLedger 标定单用途行为 框和后端执行匹配.

  • 发射服务 (单位:千美元)service.ts:两个步骤的后端逻辑,写作对 可注入的港口,没有I/O,端点或储存自己的. createSimLaunchIssuer 检查呼叫器提供 SimEntitlementChecker 并通过 SimLaunchCodeStore· ; createSimSessionExchange 赎回一次,还我 Set-Cookie 与 JSON 机构分开。 模拟来源和应享权利来源 是输入, 从不默认: 不存在或无效的源答案 not_configured 之前 询问应享权利来源,以及除 entitled 未关闭 。 没什么 在此选择应享待遇的来源、存储处或存储方式.

  • 会话饼干 (单位:千美元)cookie.ts: 名称 __Host-adea-sim,与 HttpOnly, (中文(简体) ), Secure, (中文(简体) ), Path=/, (中文(简体) ), SameSite=None, (中文(简体) ), Partitioned,没有 Domain,最多一生一次 一小时 它只授权Sim源的资产,从不授权Adea账户API.

  • 可用性 (单位:千美元)availability.ts: reduceSimLaunch 纯粹的状态机器 (单位:千美元)idle, (中文(简体) ), requesting, (中文(简体) ), awaiting_frame, (中文(简体) ), launching, (中文(简体) ), running, (中文(简体) ), unavailable, (中文(简体) ), offline每一个州都有 attempt数字 : start 开始尝试 N+1 和 a 授予、 帧消息或超时只在它命名当前尝试时才适用, 因此 中断的尝试产生的后期事件不能发射、失败或关闭较新的事件 (薄荷新鲜 bridgeId ). 一个地表 running 仅在 框说 describeSimAvailability 提供真实的副本 查特和德夫没有受到影响.

  • 场景频道 (单位:千美元)scene.ts:输入运行中的引擎 工作空间场景 虚拟视图绘制, 作为完整的快照,然后对引擎确认的最后一次修订,一次修订 飞行,使用 frame.scene.ack 编号 : nack 编号 : perf 回来. createSimSceneFeed 是主机侧并 parseHostSceneMessage 引擎的验证器。 谱: docs/specs/sim-bridge-scene.md。 。 。 .

不属于此软件包:主机条目、后端端点、私人支持 在提供缓存答复之前授权资产的原产地,以及 部署。 这些都是单独的工作.

版本与发布记录

@adea-ai/spatial 共发布 87 个版本,首次发布于 2026/10/01;过去 12 个月发布了 87 个版本。

版本发布日期距今
0.114.1latest2026/11/032 天前
0.114.02026/11/033 天前
0.113.02026/11/033 天前
0.112.02026/10/316 天前
0.111.02026/10/306 天前
0.110.02026/10/307 天前

关于 @adea-ai/spatial 的常见问题

@adea-ai/spatial 是什么?

场景和资产清单合同加上Adea工作空间的外壳到引擎空间协议:场景挂载清单,产卵URL助手,场景遥测计划. 纯粹的类型——没有渲染,没有二进制.

如何安装 @adea-ai/spatial?

在项目目录运行 npm install @adea-ai/spatial,或使用 pnpm add / yarn add / bun add。

@adea-ai/spatial 支持 TypeScript 吗?

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

@adea-ai/spatial 支持 ESM 还是 CommonJS?

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

@adea-ai/spatial 可以商用吗?

@adea-ai/spatial 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@adea-ai/spatial 的下载量有多少?

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

@adea-ai/spatial 还在维护吗?

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