标准化语义映射集 (Standard Semantic Vocabulary)
文档说明：本表定义了 AI 空间智能体与物理设备之间的"翻译标准"。所有接入系统的设备，其物理点位必须映射至以下标准语义之一，方可被 AI 识别并控制。
同步规则：本文件需与
js/standard-semantics.js保持同步。
1. 核心设计哲学：Key 即业务协议 (Semantic as Protocol)
本系统不只是简单的"设备联网"，而是通过"语义抽象"实现对物理空间的数字化重构。其核心逻辑链路如下：
- 标准化语义 (Standardized Concept)：本文件定义了
env_indoor_temp等"黄金 Key"。它们是 AI 唯一能听懂的业务语言，代表了物理世界在数字孪生中的语义标准。 - 映射即翻译 (Mapping as Translation)：在《设备语义管理》中，管理员将杂乱的设备物理点位（如 Modbus 寄存器）映射到这些 Key 上。这一步完成了从"物理数据"到"数字资产"的跨越。
- 空间能力挂载 (Capability Mounting)：在《空间语义管理》中，空间通过"能力插件"引用这些 Key。至此，空间具备了感官（Sensing）和肢体（Control）。
- AI 逻辑解耦 (Agentic Decoupling)：Agent 和业务算法（如主动整备 T-prep 模型）仅与标准 Key 交互，实现控算分离。
- 感知场景 (Read)：AI 优先面向"空间资源"索取能力值（如：305 会议室的室内温度），无需感知底层具体是由哪台设备或传感器采集的。
- 控制场景 (Write)：AI 必须明确其操作的具体的设备实例（如：305 会议室的 1 号空调），但下发的控制指令必须对齐标准 Key（如：
hvac_target_temp = 24）。 - 架构闭环：该设备实例的"标称能力"与其在物联平台中的"物理点位/属性 (Attribute)"之对应关系，由后台映射逻辑闭环。这确保了 AI 即使面对不同品牌的空调，其"控场词"永远保持唯一。
结论：
- Key 是唯一真相：如果 Key 定义模糊或映射错误，整个 AI 大脑将面临"失明"或"瘫痪"。
- 架构价值：通过这层强依赖，我们实现了**"一套算法，交付万间房"**的标准化能力，彻底摆脱了传统物联网项目中"一项目一代码"的泥潭。
2. 暖通空调 (HVAC)
| 语义 Key | 语义名称 | 数据类型 | 角色 (Role) | 描述 |
|---|---|---|---|---|
hvac_power | 电源总开关 | Boolean | Both (读写) | 1: 开, 0: 关 |
hvac_mode | 运行模式 | Enum | Both (读写) | Cool, Heat, Vent, Dry |
hvac_target_temp | 设定目标温度 | Float | Both (读写) | 单位: ℃ |
hvac_fan_speed | 风速档位 | Enum | Both (读写) | Auto, Low, Med, High |
fresh_air_level | 新风量/开度 | Float | Both (读写) | 0-100% |
3. 照明 (Lighting)
| 语义 Key | 语义名称 | 数据类型 | 角色 (Role) | 描述 |
|---|---|---|---|---|
light_power | 灯具开关 | Boolean | Both (读写) | 1: 开, 0: 关 |
light_brightness | 亮度调节 | Float | Both (读写) | 0-100 或 0.0-1.0 |
light_color_temp | 色温调节 | Integer | Both (读写) | 单位: Kelvin |
4. 遮阳与幕布 (Shading)
| 语义 Key | 语义名称 | 数据类型 | 角色 (Role) | 描述 |
|---|---|---|---|---|
shade_position | 开启百分比 | Float | Both (读写) | 0: 全闭, 100: 全开 |
shade_action | 动作指令 | Enum | Control (仅控制) | Open, Close, Stop |
5. 环境感知 (Sensing)
| 语义 Key | 语义名称 | 数据类型 | 角色 (Role) | 描述 |
|---|---|---|---|---|
env_indoor_temp | 室内实时温度 | Float | Perception (纯感知) | 单位: ℃ |
env_humidity | 相对湿度 | Float | Perception (纯感知) | 单位: % |
env_co2 | CO2 浓度 | Float | Perception (纯感知) | 单位: ppm |
env_pm25 | PM2.5 浓度 | Float | Perception (纯感知) | 单位: μg/m³ |
env_occupancy | 空间占用 | Boolean | Perception (纯感知) | 1: 有人, 0: 无人 |
env_illuminance | 实时照度 | Float | Perception (纯感知) | 单位: Lux |
6. 设备协同 (Facility Agent)
| 语义 Key | 语义名称 | 数据类型 | 角色 (Role) | 描述 |
|---|---|---|---|---|
fa_fault_code | 故障码 | String | Perception (纯感知) | 设备原始故障代码 |
fa_is_error | 故障状态 | Boolean | Perception (纯感知) | 1: 故障, 0: 正常 |
fa_energy_total | 累计能耗 | Float | Perception (纯感知) | 单位: kWh |
fa_runtime_h | 累计运行时间 | Float | Perception (纯感知) | 单位: h |