AENET.cloud PUBLIC GATEWAY
K.PUBLIC.GATEWAY
ENไทย中文
system-detail K.PUBLIC.SYSTEM

ui-contract

UI Contract

公共 UI 结构的唯一事实来源——页面、导航、组件、坐标、状态、动效、颜色、排版与语言——由 Web 和 Swift 渲染器共同消费。

状态: active 最后更新: 2026-08-16

系统 ID

ui-contract

状态

active

架构层级

  • L2 公共应用（UI 契约）

输入

  • 设计令牌（design/）、发布清单（release/）、语言文件

输出

  • Web 与 Swift 渲染器消费的 UI 契约 JSON

公共接口

  • ui-contract/manifest.json + 契约 JSON + schemas/

连接的系统

安全边界

仅公共 UI 结构。它绝不是 AENET Core 的事实来源，也不携带任何私有数据。

数据方向

设计/发布来源 → UI 契约 → 渲染器（Web、Swift）。单向、公开。

是什么

让每个公共页面成为一个系统的渲染器，使 Web 与 Swift 保持一致，更新绝不破坏访客会话。

为什么

两个渲染器（Web + Swift）曾经有分歧风险。UI Contract 通过一个 JSON 事实来源加上发布兼容性与回滚解决。

如何

设计/发布来源 → UI 契约 → 渲染器（Web、Swift）。单向、公开。

  • 定义页面、导航、组件、坐标、状态、动效、颜色、排版与语言契约
  • 提供用于验证的模式
  • 支持带兼容性检查的版本化发布
  • 用同一 JSON 驱动 Web 与 Swift 渲染器

示例

同一页面模型（ui-contract/pages.json + blocks.json）由 Web 外壳与 Swift UI 共同渲染，使两个表面保持一致。

输入

  • 设计令牌（design/）、发布清单（release/）、语言文件

输出

  • Web 与 Swift 渲染器消费的 UI 契约 JSON

依赖

aenet-cloud-publicxgridrgbm

生命周期

  • UI 契约 v1
  • 统一 UI 契约（v0.5）
  • 弹性 UI + 版本化发布

使用场景

  • Web 与 Swift 渲染相同的页面模型
  • 发布兼容性在不破坏会话的情况下把关更新
  • 数据状态防止失败区块清空页面

限制

  • 仅公共 UI 结构——绝非核心事实
  • 渲染器必须与受支持的模式主版本兼容

连接的系统

  • AENET Cloud Public — AENET 生态系统的对公入口与观察层。它只发布经过净化的快照、静态页面、公共 API 和匿名流量通道——仅此而已。
  • Public Time — AENET Cloud Public 的公共时间服务。它以明确的质量提供规范 UTC，并且在未经验证的原子源之前绝不声称原子验证。
  • RGBM — AENET 公共 UI 的语义颜色角色系统。组件引用角色（导航、操作、洞察、守卫、系统、警告）——绝不引用原始颜色名称。
  • Visit Memory — AENET 访客的设备本地连续性：偏好语言、最近路径、访问次数与阅读进度——仅存储在浏览器中，绝不识别个人身份。
  • XGRID — AENET 公共 UI 的自适应空间网格系统：桌面 12 / 平板 8 / 移动 1 列，内容自适应尺寸，1920x1080 画布仅作为设计参考。

人们常问的问题

这些问题由本页内容解答。

  • 什么是 AENET UI Contract？
  • Web 与 Swift 如何保持一致？
  • UI 契约定义了哪些内容？
  • 版本化发布如何保护访客会话？

证据

仅已验证状态——本页内容均非预测。

  • ui-contract/manifest.json
  • ui-contract/*.json
  • docs/UI_CONTRACT.md
  • docs/RESILIENT_UI.md
  • docs/RELEASE_COMPATIBILITY.md

下一步