Nimi

中文

English

中文

English

深色模式

App 互联 ​

app-interconnect-model.md 与 realm-interop-mapping.md 描述 App 怎么接进 Realm，以及 realm 基础协议互操作映射怎么工作。这页是「App 怎么跨进 Realm」的读者视角。

App 怎么连到 Realm ​

路径用途
REST准入合同下的类型化 Realm 读 / 改
WebSocket规范化事件的实时投递

App 通过准入 REST + WS 面连到 Realm；它们不自己发明协议。授权是在准入 token 颁发流下颁发的 bearer token。

App 模式与 Realm 权威 ​

Render-app 读 Realm；extension-app 在准入绑定范围内读写 Realm。

模式Realm 读Realm 写每个世界并发数
render-app是否多个
extension-app是是每个世界至多一个活跃

世界的「至多一个活跃 extension-app」规则就来自这个：如果两个 extension-app 能同时为同一个世界写 Realm 规范化状态，规范化状态就 race。

互操作映射 ​

Realm 互操作映射在 Realm 概念与外部 open-spec 锚（跨协议映射）之间翻译。它桥接：

桥用途
世界状态合同 ↔ 外部状态表征Realm 世界状态需要对外可见时
世界历史合同 ↔ 外部历史表征跨平台历史兼容
Runtime 记忆 ↔ Realm 记忆复制语义
Runtime Agent ↔ Realm Agent身份桥接
通行合同 ↔ 外部通行形状跨协议通行兼容

互操作映射是形式翻译层。它不改 Realm；它把 Realm 投到别的系统能消费的形状上。

阅读场景：App 先读再动 ​

某 render-app 想显示一个世界；后来用户升级到 extension-app 改状态。

  1. render-app 启动。 App 在 render 模式下读 Realm。
  2. 用户想要更多。 用户把关系升级到 extension-app 模式。
  3. App-世界绑定。 Extension-app 绑定到世界（同一时刻一个活跃）。
  4. 修改。 Extension-app 提交类型化 commit 信封做状态修改。
  5. Realm 准入。 每次修改过准入授权矩阵。
  6. 审计 lineage。 每次修改被记下。

从只读到带写的扩展的转换需要显式绑定。没静默特权升级。

阅读场景：实时事件流 ​

某 App 想响应规范化事件发生时。

  1. 订阅。 App 在准入订阅面下打开到 Realm 的 WebSocket 订阅。
  2. 实时投递。 事件 commit 时到达。
  3. App 响应。 准入形状下的类型化事件处理器。
  4. 连接生命周期。 重连、backpressure 等在准入连接合同下。

实时是被准入的；实时可用时 App 不自己发明 polling 协议。

阅读场景：外部系统桥 Realm ​

某外部系统想镜像 Realm 世界历史。

  1. 经互操作映射读。 外部系统在准入互操作映射下读 Realm 历史。
  2. 翻成外部形状。 映射把 Realm 概念投到外部 open-spec 表征。
  3. 外部系统消费。 默认无修改回流，除非准入。

桥默认是单向读。双向桥需要准入双向合同 — 不隐式。

边界总结 ​

关注拥有者
Realm 规范化真相Realm kernel
App 访问 Realm准入 REST + WS 面
App-世界绑定App 授权预设 + 绑定合同
实时投递准入订阅面
外部系统桥Realm 互操作映射
跨协议形状互操作映射桥

来源 ​

Nimi AI open world platform documentation.

Copyright 2026-present Nimi Platform