2026 AI 空间智能体 - 标准语义管理 PRD (v1.0)
版本: v1.0 状态: 初始设计版 (结合 MCP 架构建议) 目标: 构建统一的"语义标准库 (Semantic Hub)"，定义全域 AI 意图的关键 Key。它是连接物理 IoT 点位与 AI 业务逻辑的逻辑"中位线"。
1. 核心设计理念
1.1 语义即协议 (Key as Protocol)
系统不再关心物理寄存器地址，而是关心"语义"。所有 Agent、小程序面板、策略引擎（如主动整备）仅面向标准 Key 进行开发。
1.2 控算分离与无参数抽象
- 标准库职能：定义"有什么能力（Key）"、"是什么数据（Type）"、"用于什么（Role）"。
- 默认映射建议 (Auto-Mapping Hint)：在标准库中预置物理层常用标识符（如
hvac_target_temp默认映射SupplyAirTemperatureSet），实现海量物理设备接入时的"零配置"语义对账。 - 物理层职能：定义"具体量程（Min/Max）"、"调节精度（Step）"。
- 优势：标准库保持极度简洁和高复用性，物理层的差异性留在设备映射层处理。
2. 界面布局与导航 (App Layout)
2.1 入口位置
在系统主导航栏（App Nav）最上方新增 "🧬 标准语义" 模块。
2.2 三栏式架构
- 左一栏 (App Nav)：导航图标。
- 左二栏 (Category Tree)：业务分类目录。支持"业务名称 (DisplayName)"与"系统标识符 (Identifier)"双行展示。
- 右侧主工作区 (Main Workspace)：展示对应分类下的标准语义列表。
3. 交互原型 (UI Prototype)
3.1 主界面：标准化语义库 (Semantic Hub)
text
+----------------+--------------------------+-------------------------------------------------------------+
| [APP NAV] | [ 业务分类目录 ] | 首页 / 标准语义管理 / 暖通空调 |
+----------------+--------------------------+-------------------------------------------------------------+
| | | |
| [🧬] 语义标准 | + 新增分类 | [ 工作区: 暖通空调 (标准 Key 列表) ] |
| (Active) | ---------------------- | |
| | . 暖通空调 | 筛选: [ 角色 v ] 搜索: [ 名称/Key... ] [ + 新增标准语义 ] |
| [🏢] 空间管理 | HVAC (Active)| |
| | . 照明系统 | [ 已选 1 项 ] [ 批量生效 ] [ 批量隐藏 ] |
| [💡] 设备管理 | LIGHT | +--------------------------------------------------------+ |
| | . 环境感知 | | [v] | 标准语义 Key | 名称 | 类型 | 角色 | 操作 | |
| | SENSE | |-----|-------------------|----------|---------|------|------| |
| | | | [x] | hvac_target_temp | 设定温度 | Number | RW | 配置 | |
| | | | [ ] | hvac_mode | 运行模式 | Enum | RW | 配置 | |
| | | +--------------------------------------------------------+ |
+----------------+--------------------------+-------------------------------------------------------------+3.2 配置详情抽屉 (Detail Drawer)
text
+---------------------------------------------------------------+
| 标准语义详情: hvac_target_temp [ X ] |
+---------------------------------------------------------------+
| |
| == 核心定义 == |
| 标准 Key: [ hvac_target_temp ] (全局唯一) |
| 语义名称: [ 设定目标温度 ] |
| UI 图标: [ 🔧 (工具) v ] |
| 数据类型: [ Number (数值) v ] |
| 业务角色: [ RW (读写合一) v ] |
| |
| == MCP/LLM 增强描述 (重要) == |
| 描述字段: |
| +---------------------------------------------------------+ |
| | 用于设置或调节暖通空调的目标温度。指令识别关键词包括： | |
| | 温度调到、热一点、冷一点。 | |
| +---------------------------------------------------------+ |
| (该描述将在运行时通过工具元数据喂给 Agent，大幅提升决策鲁棒性) |
| |
| == 资产生态统计 == |
| 已纳管设备: 156 台 (💡 引用了该标准语义的物理设备总数) |
| |
| == 物理映射增强 (快捷配置 - 多品类) == |
| +----------------------------------------------------------+ |
| | 产品品类 | 默认逻辑标识符 | 操作 | |
| |--------------+-----------------------------------+---------| |
| | 空调机组 | SupplyAirTemperatureSet [🔍] | [×]删除 | |
| | 送风机 | FanFrequencyControl [🔍] | [×]删除 | |
| |--------------+-----------------------------------+---------| |
| | [➕ 添加品类映射] | |
| +----------------------------------------------------------+ |
| (💡 每个品类独立绑定默认标识符，设备接入时按实际品类自动匹配) |
| |
+---------------------------------------------------------------+
| [ 取消 ] [ 保存生效 ] |
+---------------------------------------------------------------+4. 功能逻辑与业务准则
4.1 关键字段说明
标准 Key (Semantic Key): 系统识别的唯一标识符。英文字符加下划线。
UI 图标 (Icon): 预置图标库下拉选择（如 Font Awesome）。该图标通过
mapping.semantic_key关联被空间控制面板、移动端小程序等前端消费，展示在列表行前缀。图标仅影响 UI 呈现，不影响语义逻辑。若未配置则不展示图标。业务角色 (Role):
RW: 读写交互。对应自控平台抽象后的 RW 逻辑信号，AI 既能控制也能获取实时状态。RO: 只读感知。对应自控平台抽象后的 R 逻辑信号，AI 仅能获取实时状态。
默认逻辑标识 (Suggested Property ID): 这是实现工程自动化映射的核心。在海量接入场景下，如果自控平台的逻辑点位命名符合此规范，管理后台将自动建立 Mapping，无需人工干预。（注意：此默认映射建议仅对"设备"资产接入生效。因自控平台的空间级群控逻辑点位目前缺乏统一标识规范，如
rm_305_group，因此空间节点的原生能力映射仍需在空间管理中手动绑定。）多品类默认映射表 (Multi-Category Default Props): default_props 字段存储品类 ID 到逻辑标识符的 JSON 映射表。同一个标准语义 Key 可为不同产品品类（如灯具、灯带）分别指定默认逻辑点位，设备接入时根据品类自动匹配。
LLM Description: 这是支持您提到的 MCP 引擎 的核心。它不仅是给人看的注释，更是给 Agent 的"操作手册"。
4.2 变更管控 (MVP 策略)
- 创建权: 仅限超级管理员。
- 编辑拦截: 如果 Key 已被设备关联，则在修改 Key 名称（Identifier）时通过
AIH_UI.customConfirm弹出强警告。 - 安全性: 不允许在后台随意删除 Key。若需移除，需调用专用高级确认模态框，告知潜在的 AI 识别失效风险。
4.3 影响分析与数据统计逻辑
为辅助管理员评估标准 Key 的影响范围，详情页提供实时统计指标：
- 已纳管设备总数 (Managed Devices)：
- 逻辑: 遍历全量设备资产，统计其"设备语义管理"中已绑定且包含当前标准语义 Key 的物理设备去重总数。
- 公式:
Count(Distinct DeviceID WHERE device.mappings.semanticKey == current.key)
4.4 业务分类管理准则 (Category Governance)
- 名码分离 (Name/ID Decoupling)：分类必须具备"人类友好名称"与"系统唯一标识（Identifier）"。Identifier 一经创建不可修改，作为数据库外键与语义项关联。
- 极简视觉：为降低管理负担，分类管理中不再支持自定义图标（Emoji），侧边栏统一采用呼吸圆点指示器。
5. 数据模型 (ai_standard_semantics)
| 字段 | 类型 | 说明 |
|---|---|---|
id | UUID | 主键 |
category | String | 业务分类（HVAC, Light 等） |
semantic_key | String | 标准唯一 Key (如 hvac_power) |
name | String | 中文友好名称 (如"电源总开关") |
data_type | Enum | bool, number, enum |
role | Enum | ro, rw |
default_props | JSON | 多品类默认映射表。键为产品品类 ID，值为格式化的逻辑点位标识符。如 {"bulb":"灯具-照明开关 (LightSwitch)","strip":"灯带-电源开关 (StripSwitch)"} |
llm_desc | Text | 面向 Agent 的语义描述与执行参考 |
status | Boolean | 生效/停用状态 |
6. 初始迁移数据预览
系统上线后应内置以下基础语义包（源于原 标准化语义映射集.md）：
- HVAC:
hvac_power(RW),hvac_mode(RW),hvac_target_temp(RW) ... - Lighting:
light_power(RW, icon:fa-lightbulb),light_brightness(RW, icon:fa-sun),light_color_temp(RW, icon:fa-temperature-low) ... - Sensing:
env_indoor_temp(RO),env_indoor_humi(RO),env_co2(RO),env_occupancy(RO) ...
附录
自控平台
| 自控说明 | 截图 |
|---|---|
| 产品品类 |  |
| 产品品类-逻辑信号 |  |
| 设备实例 |  |