AENET.cloud PUBLIC GATEWAY
K.PUBLIC.GATEWAY
system-detail K.PUBLIC.SYSTEM

rgbm

RGBM

AENET 公共 UI 的语义颜色角色系统。组件引用角色(导航、操作、洞察、守卫、系统、警告)——绝不引用原始颜色名称。

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

系统 ID

rgbm

状态

active

架构层级

  • L2 公共应用(视觉)

输入

  • 语义角色定义(design/rgbm.json)

输出

  • 由 CSS 和组件消费的角色令牌

公共接口

  • design/rgbm.json
  • ui-contract/colors.json
  • web/assets/data/rgbm.tokens.json

安全边界

纯客户端设计令牌系统。无数据、无网络、无私有系统。

数据方向

角色 → 令牌 → CSS/组件。仅客户端。

是什么

为每个公共组件提供稳定、语义化的颜色词汇,使颜色含义在主题化后依然成立且一致性可强制。

为什么

原始颜色在组件间漂移并失去意义。RGBM 用携带意图的语义角色(导航、操作、洞察、守卫、系统、警告)替代。

如何

角色 → 令牌 → CSS/组件。仅客户端。

  • 定义语义颜色角色(RGBM.NAVIGATION.BLUE、RGBM.ACTION.GREEN、RGBM.INSIGHT.MAGENTA、RGBM.GUARD.RED、RGBM.SYSTEM.CYAN、RGBM.WARNING.AMBER)
  • 保持 design/rgbm.json 为唯一事实来源
  • 防止组件引用原始颜色名称

示例

需要“成功”含义的组件使用 SUCCESS 角色令牌(design/rgbm.json、web/assets/data/rgbm.tokens.json),而非硬编码颜色。

输入

  • 语义角色定义(design/rgbm.json)

输出

  • 由 CSS 和组件消费的角色令牌

依赖

ui-contractaenet-cloud-public

生命周期

  • RGBM v1(4 角色)
  • RGBM 扩展(6 角色:+ 系统、警告)

使用场景

  • 组件使用角色令牌以获得一致含义
  • 主题与无障碍依赖语义角色

限制

  • 仅角色——组件绝不能硬编码原始颜色
  • 仅视觉系统,无数据语义

人们常问的问题

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

  • 什么是 RGBM?
  • RGBM 定义了哪些颜色角色?
  • AENET 为什么使用语义颜色角色?

证据

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

  • design/rgbm.json
  • ui-contract/colors.json
  • web/assets/data/rgbm.tokens.json

下一步