# @adea-ai/spatial 中文文档

规范地址：https://npmcn.com/package/%40adea-ai/spatial/

版本：0\.114\.1
npm 元数据更新时间：2026-11-03T04:29:45.984Z
中文译文更新时间：2026-11-06T02:42:26.380Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：234 kB，52 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2026-09-30T23:35:10.328Z
- 最新版本发布：2026-11-03T04:29:45.791Z
- 近 30 天下载量：6209（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：87（近 12 个月 87 个）

## 中文简介

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

## 安装

```sh
npm install @adea-ai/spatial
```

也可以使用：`pnpm add @adea-ai/spatial`、`yarn add @adea-ai/spatial`、`bun add @adea-ai/spatial`

## README

# @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 是什么？

场景和资产清单合同加上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 和提交记录判断。