2026 AI 空间智能体 - 空间语义管理 PRD (v3.8)

版本: v3.8
日期: 2026-04-28
状态: 空间级感知归一化版
目标: 构建统一的"空间语义管理"子中心，实现从物理碎片到空间真相的跃迁。

0. 架构导航：脑（空间）与手（设备）的辩证关系

在空间智能体系统中，我们必须严格区分"空间级"与"设备级"两种语义逻辑。这不仅是 UI 的区别，更是 AI 思考逻辑的解耦。

0.1 核心对照表

维度	设备语义 (Device Level) - "手"	空间语义 (Space Level) - "脑"
核心定位	原子执行终端（物理实体资产）	逻辑统一容器（空间真相 SSOT）
交互粒度	精准微操 / 报修	主动整备 / 意图控制
典型例句	"帮我关下305会议室左边靠窗的空调。"	"帮我把 305 会议室的空调关了。"
屏蔽逻辑	屏蔽了品牌、协议的通信差异。	屏蔽了物理设备数量、碎片化的细节。
信号来源	设备能力透视 (Device Capability) 对应自控平台-产品品类-逻辑信号	空间逻辑映射 (Space Logic Mapping) 对应自控平台-空间树节点-逻辑信号（待建设）
代偿逻辑	原子底座：不具备全局决策权。	逻辑进化：支持通过"自动扫描"将唯一设备能力直接"升维"为空间大脑。

0.2 开发者共识 (Dev Guide)

空间级感知归一化：当 AI 需要获取 305 的温度时，它不应该去扫描并计算 3 台空调的回风温度，而应该直接向空间逻辑点位（单一逻辑真相 SSOT）索取。
逻辑加工权：空间点位的数值是如何得来的（是平均值、加权值还是真实传感器值），由自控平台负责加工。AI 侧只将其作为"官方口径"使用。
逻辑代偿 (Logical Compensation)：由于本项目旨在降低实施成本，我们不强求自控平台（CP）为每个房间都建立虚拟逻辑点位。AI 平台通过 "重新扫描装载" 机制，将唯一的"手"自动提炼为"脑"，实现能力的逻辑代偿。
剪枝与去重原则：在设备控制场景中，若一个点位已升维至"脑（空间层）"，则必须在上下文中剪掉其作为"手（设备层）"的属性入口，确保 Agent 认知路径的唯一性。
职能边界：设备语义管理解决"能不能动"的问题；空间语义管理解决"怎么想才专业"的问题。

1. 核心设计理念

1.1 物理与语义解耦

系统不对物联平台原有物理数据做侵入式修改，而是在 AI 层通过"语义增强"建立映射：

物理层: 维护真实的设备 ID、物模型属性、拓扑关系。
语义层: 叠加别名 (Alias)、基础权重 (Weight)、默认标记，让 AI 听懂"VIP室"、"那个灯"等口语指令。

1.2 核心设计准则

强空间依赖 (No Space, No Device): 任何设备接入前，其所属的空间路径必须已通过 AI 纳管。
数据治理策略: 仅展示 IoT 平台已配置"安装位置"的资源，倒逼物理源头数据的规范性。
空间原生优先 (Native First)：AI 优先匹配由自控平台在 空间树节点 定义的"逻辑点位"来实现群控或状态感知。
资产自动升维 (Asset Elevation)：在缺乏 CP 原生逻辑信号时，系统通过智能算法将空间内唯一资产的能力自动升维为"空间真相"。这让 AI 平台具备了对底层基础能力的自动补齐与逻辑对齐能力。
空间感知归一化 (Perception Unification)：空间级映射不仅是为了群控 (W)，更是为了确立空间的"代表性感知状态 (R)"。AI 侧只将其视作该空间的"单一逻辑真相 (SSOT)"，从而屏蔽物理碎片化噪声。

1.3 核心术语表 (Terminology)

NOTE

空间资产 (Space Assets): 管理地理容器（项目、楼层、房间），为业务提供拓扑支撑。 语义别名 (Alias): AI 识别实体的自然语言凭证，支持冗余别称。 同步异常 (Anomaly): 由于物理层变动导致语义映射断裂的各种不一致状态。

1.4 AI 语义层与业务系统分歧澄清

为了保障 AI 智能体的架构纯粹性，系统严格遵循以下分工原则：

资产实体中心化 (Entity-Centric): 空间的别名标签、物理权重是其固有属性集合，必须在 AI 空间中心进行中心化管理。只有这样，AI 才能在处理"预定、控制、报修"等不同跨领域任务时，对同一个物理实体保持统一的认知。
决策逻辑主权 (Intelligence Sovereignty): 业务系统（如会议系统）仅负责其职能内的"资源可用性（物理执行）"。用户偏好、业务权重评分等属于 AI 层面的"决策逻辑"，严禁下沉至业务系统，以防止严重的逻辑耦合。
适配器原则 (AI-as-an-Adapter): AI 空间层作为"大脑"，负责适配各业务系统的标准化 API。不应强求业务系统针对 AI 语义（如增加标签、MCP 支持等）进行侵入式改造，以降低长期维护与系统迁移的成本。

2. 管理模块概述 (Management Overview)

2.1 空间管理模块 (Space Hub)

空间管理是所有资产的"底盘"。通过引入 IoT 项目空间的拓扑树，在 AI 系统中建立具备父子继承关系的地理容器。

2.2 核心特性

物理路径补全: 引入任一子节点，系统自动追溯并拉取完整的祖先路径。
级联递归展示: 侧边树选择任意中间层级，列表应穿透显示下属所有房间/设备容器。
语义权重: 管理空间的重要性（Weight），辅助 AI 进行意图优先级判断。

3. 一致性管控逻辑 (Consistency Governance)

AI 层数据长效生存的基石。系统遵循 "列表防御性停用，抽屉阶梯式对账" 的分层治理原则。

3.1 异常感知准则 (Detection Rules)

任何物联层字段（名称、路径、标识符）与 AI 层底账不一致时，触发 [⚠️ 同步异常] 标识。

强制策略: 一旦触发异常，AI 状态强制锁定为 ⚪ 已停用。系统在向量库中临时下线该资源，直至异常闭环。

3.2 阶梯式采纳与闭环 (Stepped Adoption)

当多项异常复合出现时（如：物理名称变了 + 空间也移了），系统按以下优先级处理：

级别 1：熔断级 (Orphan)

判定: 物联平台已物理删除该实体。
策略: 彻底熔断。抽屉内所有配置项设为 disabled。
操作: 禁用所有编辑及采纳按钮，仅保留 [彻底移除]。
🚨 级联移除限制: 系统执行"彻底移除"前，必须检查该节点是否包含子节点（子空间/房间）。若存在未移除的子节点，系统应中断操作并提示"请先清理下层级资源"，严禁产生逻辑孤儿。

级别 2：采纳项 (Auto-Sync Items)

范围: 包含 名称变更、空间/路径迁移。
逻辑: 支持"一键采纳"。
- 位置自动闭环: 若涉及空间迁移且目标空间未纳管，系统会自动完成路径引入，无需用户跨页面操作。
- 容纳人数 (Capacity)：该数值由 系统源头（如飞书会议室资源管理）同步获取，UI 界面强制置灰只读，不接受人工定义，以确保跨系统数据一致性。
- 部分同步: 若同时存在属性漂移，点击采纳仅同步名称/路径。

3.3 交互 UI 规范

主列表: 极简显示，统一提示为"同步异常"。新增复选框与批量操作工具栏。
详情抽屉: 提供 Diff 对比清单，显式展示"物理层变动内容"。
危险操作: 移除空间时，需调用 弹窗 (Custom Confirm Modal) 二次确认。
批量安全性 (Batch Safety): 批量执行"生效"时，自动跳过处于任何异常状态的项。对于空间资产，若未配置至少一个 AI 别名，亦会被跳过。

4. 全链路业务流程 (Business Process)

4.1 系统上线纳管生命周期

4.2 关键逻辑：双层状态模型

系统舍弃简单的"开关"逻辑，采用 "实体生命周期 + 插件化能力" 的双层结构：

AI 实体生效状态 (Global Lifecycle Status):
- 作用: 决定该空间资源是否被向量化引擎拉取。
- 状态: 🟢生效 (Active) / ⚪停用 (Disabled)。
- 独立性: 与具体能力配置无关。若设为"停用"，该空间在 AI 面前相当于"不存在"。
空间能力插件 (Capability Plugins):
- 会议预定能力 (Meeting): [基础设施] 决定 AI 是否可推荐该空间用于预约。详见 §8。
- 设备能力透视 (Device Insight): [基础设施] 自动感知的物理设备支撑背景，仅供审计参考。详见 §9。
- 空间逻辑映射 (Logic Mapping): [业务扩展] 空间的灵魂。定义了意图如何下发、真相从何处获取。详见 §10。
- 主动整备配置 (Active Prep): [扩展能力] 空间的后台静默任务开关。控制系统是否在会议前自动调节环境。详见 §11。

5. 空间管理主界面 (Space Management UI)

5.1 界面总览：布局

主界面采用 [系统导航] - [空间层级树] - [资源工作区] 的三栏结构，实现物理空间到 AI 纳管资源的直观映射。

text

+----------------+--------------------------+-------------------------------------------------------------------------------------------+
| [APP NAV]      | [ 物理空间层级树       ] |  首页 / 空间资源管理 / 金螳螂 / 1楼                                                      |
+----------------+--------------------------+-------------------------------------------------------------------------------------------+
|                |                          |                                                                                           |
|  [🏢] 空间管理 |  v 21默认项目            | [ 工作区: 已选节点及其下级资源列表 ]                                                       |
|  (Active)      |    v 金螳螂  <Selected    |                                                                                           |
|                |      v 1楼               | 筛选: [ 空间类型 v ]  搜索: [ 别名... ]  [ + 引入 IoT 空间资源 ]                          |
|  [💡] 设备管理 |        305培训室         |                                                                                           |
|                |        ...               | [ 已选 2 项 ] [ 批量生效 ]  [ 批量失效 ] (仅在有勾选项时显示此操作栏)                     |
|                |      > 4楼               | +---------------------------------------------------------------------------------------+ |
|                |    > 北楼                | | [v] | 原始名称   | 上层空间     | 类型     | AI 别名       | AI状态 | 异常   | 操作列   | |
|                |                          | |-----|------------|--------------|----------|---------------|--------|--------|----------| |
|                |                          | | [x] | 1楼大厅    | 金螳螂/1楼   | 楼层空间 | [大厅]        | 🟢生效 | -      | 配置|失效| |
|                |                          | | [ ] | 305培训室  | 金螳螂/1楼   | 会议室   | [305会议室]   | 🟢生效 | ⚠️变更 | 处理|失效| |
|                |                          | | [x] | 北楼1楼    | 北楼         | 楼层空间 | (空)          | ⚪停用 | -      | 配置|生效| |
|                |                          | | [ ] | 储藏室A    | 金螳螂/1楼   | 房间     | [杂物间]      | ⚪停用 | 💀已删 | 查看     | |
|                |                          | +---------------------------------------------------------------------------------------+ |
+----------------+--------------------------+-------------------------------------------------------------------------------------------+

5.2 关键交互说明

级联递归检索 (Recursive Retrieval): 在侧边栏点击任意节点，列表页不仅显示当前节点，还必须级联显示其下所有深度的子空间节点。
上层空间显式路径 (Parent Path Column): 由于采用了递归展示，列表必须提供"上层空间"列，标明每个节点的父级路径（如：金螳螂 / 1楼），防止在扁平化列表中产生位置歧义。
中间树 (Tree): 基于已引入AI IOT, 展示AI IoT 平台的物理拓扑结构，叶节点（会议室/房间）也须在树中显示。

5.3 关键状态说明

分层状态模型 (Layered Status Model):
【层1：AI 生效状态 (Global Lifecycle)】
- [🟢 生效中 (Active)]: 该空间实体被纳入 AI 管理，向量化引擎将同步其别名。
- [⚪ 已停用 (Disabled)]: 管理员手动/策略停用。模型库彻底屏蔽此空间，AI 不再感知其存在。
- 注：同步异常（如：物联信息丢失 💀）会强制触发此状态。
【层2：分项能力状态 (Capability Plugins)】
- 每个已开启的插件（如 会议预定、控制策略）拥有独立的业务状态：
  - 挂载中: 插件存在即代表业务功能上线。
  - 手动移除: 管理员点击 [x] 彻底切断该项 AI 关联。
- 注：用户还可选择在抽屉内触发 彻底移除，清除所有表数据。
【轴2：同步异常 (底层感知)】
- [-]: 正常，无变化。
- [⚠️ 物理变更 (Metadata Changed)]: 大一统的复合状态提示。当底层 IoT 名称和/或路径发生变更时触发。点击 [处理] 操作打开侧边抽屉，会显式标注变更明细。注意：此状态为警告级别，不影响现有设备的底座控制，AI 纳管状态（如 🟢生效中）保持不变。
- [💀 物联信息丢失 (Orphan)]: 最严重的破坏性状态。IoT 端已将该节点彻底物理删除。触发该状态时，系统会强制将其 AI 状态置为 ⚪已停用 防止幽灵调用，并锁定状态禁止再次开启。列表页只能执行 [查看] 与彻底 [移除]。
操作列双按钮设计:
- [配置] / [处理]: 打开右侧配置抽屉。当同步异常为 ⚠️物理变更 时文字切换为"处理"（蓝色高亮）。
- [生效] / [失效]: 直接在列表行内切换 AI 状态。仅在同步异常非 💀物联信息丢失 时显示。
  - ⚠️ 生效前置校验: 点击 [生效] 时，若该空间的 AI 别名为空，系统拦截并报错。确保被纳管空间至少有一个语义入口。

6. 资产纳管引入 (Onboarding)

点击 [+ 引入 IoT 空间资源] 唤起弹窗。采用 "固定左树 + 动态右表" 的设计。

双重过滤: 右侧列表的数据源，同时受顶部 [类型筛选] 和左侧 [区域树]（同物联平台-物理空间树）的交集控制。
去重逻辑: 已引入的资源在弹窗中置灰或不显示。
确认引入：点击 "确认引入" 按钮，引入 AI空间数据

text

+-----------------------------------------------------------------------------------+
|  从 IoT 平台引入空间资源                                                  [ X ]   |
+-----------------------------------------------------------------------------------+
|  💡 温馨提示：引入特定空间时，系统将自动同步引入其在物联平台中的所有上级节点。            |
+-----------------------------------------------------------------------------------+
|  类型筛选: [ 会议室 v ]    搜索: [ 305                  ] Q                       |
+--------------------------+--------------------------------------------------------+
|  [ 区域筛选树 ]          |  [ 待引入资源列表 ]                                    |
|                          |                                                        |
|  v 21默认项目            |  [x]  名称         所属路径        类型                |
|    v 金螳螂              |  ----------------------------------------------------  |
|      v 1楼               |  [x]  305会议室    金螳螂/1楼      会议室              |
|      > 4楼               |  [ ]  401大会议室  金螳螂/4楼      会议室              |
|    > 北楼                |  [ ]  VIP接待室    北楼/1楼        会议室              |
|                          |                                                        |
|  (点击节点可过滤右侧)    |  * 列表内容 = (类型匹配) AND (属于左侧选中区域)        |
+--------------------------+--------------------------------------------------------+
|                                                      [ 取消 ]   [ 确定引入 (1) ]  |
+-----------------------------------------------------------------------------------+

6.1 引入逻辑细节 (Auto-Parent Sync)

自动同步父节点 (Auto-Parent Import):
- 行为: 勾选引入任意空间节点（如：1号楼/305会议室）时，系统必须自动在后台检查并同时引入其所有的父代路径节点（1号楼、园区等）。
- 初始状态隔离: 所有通过引入操作新建的资产节点（包含目标节点与补全的父节点），其 初始 AI 状态必须强制默认为 ⚪已停用 (Disabled)。管理员需进入抽屉完成语义配置后手动开启，实现"安全冷启动"。
别名初始化规则: 自动带入的节点， 初始化 AI 别名 固定为该空间的"物理名称"。无论是否冲突（如多个"机房"），引入阶段均允许存在。初始状态默认为 ⚪已停用。
弱校验原则: 为了降低运维复杂度，系统不再对别名执行强查重拦截。同音字或同名空间在向量检索阶段将通过相似度评分与权重（Base Weight）综合调节。
列表刷新: 引入成功后，高亮新增行，并同步更新左侧侧边栏的 AI 空间树。

7. 空间配置详情抽屉 (Drawer Detail)

点击列表中的 [配置] 按钮，右侧滑出抽屉。除了常规配置，这里也是解异常闭环的唯一入口。

text

+---------------------------------------------------------------+
|  空间配置详情                                          [ X ]  |
+---------------------------------------------------------------+
|                                                               |
|  [ 业务开关: 🟢 AI 纳管生效中 ]   [ 彻底移除资源 (Danger) ]     |
|                                                               |
|  == 基础信息 ==                                                |
|  [⚠️ 发现底层物理变更]   (若无变更则不显示此警告框)              |
|  (更新详情: IoT端 名称修改为"305直播间"; 路径转移至"1楼")        |
|  [ 采纳 IoT 更新 ] (点击后报错标签消除，AI物理信息自动同步)       |
|                                                               |
|  物理名称:  305会议室 (旧)                                     |
|  物理路径:  金螳螂 / 3楼 (旧)                                  |
|                                                               |
|  == AI 语义增强 ==                                            |
|  基础权重:  Low [-----O-----] High  (0.5 - 普通权重)          |
|             (0.1: 低频勿扰, 0.5: 普通权重, 1.0: 核心地标)      |
|                                                              |
|  语义别名:  [ 305会议室 x ] [ VIP室 x ] [ 三楼大的 x ]          |
|             (回车添加 Tag。 建议依据上方变更信息调整别名)        |
|                                                               | 
|  == 空间能力集成 ==                        [ + 添加能力 v ]     |
|                                          | 💡 空间逻辑映射  |   |
|                                          | 🚀 智能整备     |   |
|  (会议预定、设备能力透视由系统自动静默装载，无需手动添加)        |
|  +-------------------------------------------------------------+
|  | [基础设施] 📅 会议预定 (Meeting)           [ (ON) ]          |
|  +-------------------------------------------------------------+
|  | [基础设施] 📡 设备能力透视 (Insight)       [ (ON) ]          |
|  +-------------------------------------------------------------+
+---------------------------------------------------------------+
|                                      [ 取消 ]   [ 保存生效 ]  |
+---------------------------------------------------------------+

7.1 处理闭环与更新逻辑

多维变更Diff展示：如果发生物理变更，详细展示名称、空间路径、空间类型 的新旧对比。
防御性状态保持与异常消警: 当产生 [⚠️物理变更] 异常时，管理员点击 [采纳 IoT 更新] 后，系统自动更新底层物理属性。
- ⚠️ 状态防诈尸机制：如果采纳前该空间因异常被降级为"已停用"或原本就是"已停用"，采纳后严格保持"已停用"状态不变，需用户确认无误后手动拨动开关生效，防止未配好别名的空间意外暴露。
- 路径递归补全与自动跳转：如果设备的"物理路径"发生了跨区移动，系统在采纳该路径前，会检查目标路径是否纳管，若未纳管则递归式静默创建所有缺失层级。重点：一旦发生空间跃迁，系统会自动重定位并展开左侧树的全新位置，保持用户的处理连贯性。
- AI 路径自动重构: 物理路径重构后，所有依赖该路径构建的向量化字符串都会被系统自动触发重写。
- 人工责任转移: 采纳更新后，强提示管理员人工核对 语义别名 框内是否还遗留有矛盾的别称。
降级只读模式: 若该资源处于 [💀物联信息丢失] 的异常状态下，整个配置抽屉内的配置组件将强制进入全局 ReadOnly (只读) 状态，隐藏"采纳"及"保存"等按钮，防止死链数据的修改。
规则冷启动: 引入资源时采用强规则策略：
- 别名初始化: 直接截取 IoT [原始名称] 填充为默认别名。
- 无感录入: 抽屉内增加别名时，自动拦截本资源内的完全重复，但不再拦截跨空间的同名情况（依靠大模型的上下文与 Base Weight 判断）。

7.2 AI 语义增强

权重定义与 UI 认知映射 (Base Weight):

保持底层存储 0.1~1.0 数值模型不变，默认值为 0.50，UI 加强业务定性标签降低理解门槛：
- 0.1 - 0.3 (次级排他)：极弱存在感区域（如管道井、天台），AI 在泛化意图猜测时尽最大可能避开该项。
- 0.4 - 0.7 (普通权重)：常规会议室、办公区，无需特意干扰（默认取 0.5）。
- 0.8 - 1.0 (核心地标)：大堂中庭、总裁办等敏感区域。当有员工说"去大厅"，只要无长上下文限定，算法总是倾向匹配给权重最高的那个"大厅"。
保存生效: 提交所有变动并更新数据库，通过触发器同步刷新向量库 (Vector DB) 数据切片。

7.3 空间能力集成概览

空间能力采用"基础设施自动装配 + 业务扩展手动挂载"双机制。本期包含：

📅 会议预定能力 — [基础设施] 由外部会议系统同步结果自动装配。详见 §8
📡 设备能力透视 — [基础设施] 系统根据资产自动装配。自动感知的物理设备支撑背景。详见 §9
💡 空间逻辑映射 — [业务扩展] 需管理员手动挂载并定义。用于实现精准的群控与意图承接。详见 §10
🤖 智能整备能力 — [扩展能力] 见 §11

交互规则：

装配策略 (Auto-Provisioning)：
- 基础设施型（会议 / 透视）：系统检测到相关资产后自动静默装配。
- 业务扩展型（映射 / 整备）：需管理员在 [+ 添加能力] 菜单中手动挂载，支持移除。
固定排序：能力卡片始终按 会议预定 → 设备能力透视 → 空间逻辑映射 → 智能整备 的固定顺序排列。
外部点击关闭：点击下拉菜单以外的区域，菜单自动折叠。

8. 分项能力：会议预定 (Meeting Reservation)

IMPORTANT

Agent 调度逻辑详见：SA_空间预约_Agent设计.md

8.1 卡片原型

text

+-------------------------------------------------------------+
| [基础设施] 📅 会议预定 (Meeting)           [ (ON) ]           |
|-------------------------------------------------------------|
| 容纳人数:    15 人                                           |
| 支持设备:    [投影仪] [电视机] [视频终端]                     |
|                                                             |
| 💡 该数据同步自"自有会议系统"                                 |
+-------------------------------------------------------------+

8.2 对接策略

全渠道清退: 响应架构演进，AI 空间侧不再维护飞书/钉钉等外部源的 1:1 映射。
单一数据契约: 所有空间能力挂载均通过"自有会议预定系统"进行中转。
只读感知: 后台管理端仅提供该能力的"挂载开关"，具体的房间物理参数（人数/设备）仅供展示核对，不提供二次编辑权限。

8.3 自动装配与治理规则 (Auto-Provisioning Governance)

会议预定已归入基础设施能力，遵循与控制/感知一致的自动装配策略，不再使用"建议挂载"流程。

装配触发：系统检测到空间已完成内部会议系统对接后，自动静默装配 meeting 能力卡片。
入口约束：[+ 添加能力] 菜单不再出现 会议预定 项。
生命周期：会议卡片不可移除，仅保留 is_enabled 业务开关（ON/OFF）。
数据口径：capacity、equipment 等字段均为会议系统同步只读，空间侧不允许人工改写。
异常治理：当会议系统对接失效或字段缺失时，卡片保留并展示异常态，待上游恢复后自动回补。

9. 分项能力：设备能力透视

IMPORTANT

Agent 调度逻辑详见：SA_设备控制_Agent设计.md

9.1 卡片原型

text

## 9. 分项能力：设备能力透视 (Device Insight)

### 9.1 卡片原型 (v3.7)

```text
+-------------------------------------------------------------+
| [基础设施] 📡 设备能力透视 (Device Insight)      [ (ON) ]     |
|-------------------------------------------------------------|
| 💡 指引：系统自动感知的物理设备兵力分布，作为配置参考。         |
|                                                             |
| [ ▶ 点击展开/收起下属设备支撑详情 (共 2 个意图已纳管) ]           |
|                                                             |
|   - 设定目标温度 (Temp Set):                                 |
|     - [305 空调(左)] -> SupplyAirTempSet                     |
|     - [305 空调(右)] -> SupplyAirTempSet                     |
|                                                             |
|   - 室内实时温度 (Indoor Temp):                               |
|     - [305 空调(左)] -> ReturnAirTemp                        |
|     - [305 墙面温控器] -> IndoorTemp                          |
+-------------------------------------------------------------+

9.2 逻辑说明

自动装配：只要空间下存在已纳管设备，该卡片即自动出现。
授权开关 (Control Auth)：该卡片的 ON/OFF 状态直接决定 AI 是否有权操控本空间下的物理设备。
- ON (授权)：即使未配置"空间逻辑映射"，AI 也会通过扫描此处感知到的物理设备，执行 "聚合兜底 (Aggregation Fallback)" 控制。
- OFF (去权)：AI 将被禁止操作该空间下任何未建立原生逻辑映射的物理设备。
只读性：该卡片内容完全由系统感知生成，管理员不可修改明细，仅可以调整 switch 开关。
资产联动 (Asset Deep-link)：卡片中展示的物理设备名称支持点击，点击后将自动在新窗口打开该设备的"设备语义管理"页面，并自动执行"过滤定位 + 开启配置抽屉"的一体化联动逻辑。

10. 分项能力：空间逻辑映射 (Space Logic Mapping)

IMPORTANT

核心定义：该能力是 AI 运营官的"群控主路径"与"感知归一枢纽"。管理员通过将标准语义绑定至空间树逻辑点位，确立空间的 单一逻辑真相 (SSOT)。 架构价值：将碎片化的物理设备（手）封装为统一的空间大脑（脑），AI 无需理解底层算法（如平均温计算），只需调用空间的官方逻辑信号。

10.1 卡片原型 (业务扩展 · 手动挂载)

text

+-------------------------------------------------------------+
| 💡 空间逻辑映射 (Logic Mapping)        [ (ON) ]              |
|-------------------------------------------------------------|
| 💡 指引：在此确立空间的"逻辑真相"。点击"重新扫描"以同步物理映射。 |
|                                                             |
| == 语义映射清单 (Semantic Mapping List) ==                   |
|                                                             |
|  标准语义            | 空间逻辑点位 (Space Logic Point)       |
|---------------------|---------------------------------------|
| 1. [空调开关 v]      | [ 305会议室空调群控开关 ]    [ 🗑️ ]     |
| 2. [设定温度 v]      | [ 🔗 物理资产: 305空调 ]      [ 🗑️ ]     |
| 3. [风速调节 v]      | [ 点击选择逻辑信号...     ]    [ 🗑️ ]     |
|                                                             |
| [ + 添加语义映射 ]      [ 🚀 重新扫描装载设备代偿 ]                    |
+-------------------------------------------------------------+

10.2 逻辑点位选择弹窗原型 (v3.11 多源版)

点击"空间逻辑点位"输入框时触发。支持在"空间群控信号"与"物理资产升维"之间切换。

text

+----------------------------------------------------------------------------+
|  选择空间逻辑信号                                                   [ X ]  |
+----------------------------------------------------------------------------+
|  源切换： [ (•) 空间群控信号 ]   [ ( ) 物理资产升维 (Device Elevation) ]      |
|----------------------------------------------------------------------------|
|  [ 搜索信号名称或标识符...          ] [ 查询 ]                              |
|                                                                            |
|  [ 空间级逻辑点位 (Space Logic) ]                                           |
|  归属空间  | 信号名称                       | 标识符        | 点位类型 (Type) |
|  ----------|------------------------------|--------------|---------------|
|  305会议室  | 空间空调群控开关               | AC_GROUP_PWR | Bool (RW)     |
|  305会议室  | 空间室内实时温度               | AC_ROOM_TEMP | Float (R)     |
|                                                                            |
|  -- 或 --                                                                  |
|                                                                            |
|  [ 物理资产升维 (待选资产点位) ]                                             |
|  品类      | 设备名称   | 标准语义     | 信号标识符        | 点位类型 (Type) | 操作    |
|  ---------|-----------|--------------|------------------|---------------|--------|
|  分体空调  | 305空调    | 空调设定温度 | hvac_target_temp | Float (RW)    | [ 选择 ]|
|  分体空调  | 305空调    | 室内实时温度 | env_indoor_temp  | Float (R)     | [ 选择 ]|
|  环境面板  | 墙面控制器  | 室内实时温度 | env_indoor_temp  | Float (R)     | [ 选择 ]|
|                                                                            |
+----------------------------------------------------------------------------+
|                                                           [ 取消 ] [ 确定 ] |
+----------------------------------------------------------------------------+

10.3 "重新扫描装载"逻辑定义 (Rescan Algorithm)

初始状态：引入空间资源后，映射清单默认为空。
清空代偿：点击"重新扫描"时，系统将自动识别并删除当前空间所有 标记为"物理资产升维" 的映射记录（即由系统代偿生成的记录）。手动添加的"群控点位"映射予以保留。
语义汇总：扫描空间下所有设备已维护的标准语义 Key ( $S_{k}$ )。
智能判定原则：
- Case A ( $N = 1$ )：若语义 $S_{k}$ 在该空间下仅有 1 台设备拥有，自动创建映射并绑定该点位，同时将其标记为"物理资产升维"。
- Case B ( $N > 1$ )：若语义 $S_{k}$ 有多台设备拥有，创建映射项但点位留空，引导用户手动指定群控信号。
- Case C ( $N = 0$ )：不处理。

10.4 数据Schema与持久化说明

字段名称	内部标识符	数据类型	说明
标准语义Key	`semantic_key`	String	引用标准语义库标识
逻辑点位信号	`signal_name`	String	绑定的点位名称 (群控信号或物理设备名)
物理升维标记	`is_auto_promoted`	Boolean	True: 由重新扫描生成的代偿记录; False: 管理员手动绑定的群控记录

10.3 核心交互逻辑

引导文案 (Guidance)：明确"配置区（指挥部）"与"透视区（前线）"的职能区别与优先级关系。
选择器交互：
- 左树：默认定位并选中当前编辑的空间节点。
- 右表：展示当前选中空间节点下的所有逻辑信号。
- 自动过滤：点位搜索结果将依据语义属性（R/W）自动过滤。
调度优先级 (Priority Strategy)：
- 原生优先 (Native First)：AI 优先匹配此处绑定的空间逻辑点位。
- 聚合兜底 (Aggregation Fallback)：若未配置原生映射，则根据"透视区"感知的物理设备进行并发控制或状态聚合。

11. 分项能力：智能整备 (Active Preparation)

IMPORTANT

Agent 调度逻辑详见：SA_主动整备_Agent设计.md

作为后台静默执行类 Agent 的物理配置底座，决定该空间是否参与"扫单整备"计划。

11.1 卡片原型与配置

text

+-------------------------------------------------------------+
| 🤖 智能整备 (Active Prep)          [ (ON) ]  [ 移除 ]         |
|-------------------------------------------------------------|
| 执行逻辑: [确认后执行 v]  (会前先询问，用户确认后自动调温)     |
|                                                             |
| == 环境调节策略 ==                                            |
|                                                             |
| 📅 当前月份策略: 4月 · 过渡季 (3-5月未启用整备)               |
|                                                             |
| 🌡️ 调节强度系数:                                             |
|   • 全局默认: 5.0 (基于6-9月制冷策略)                        |
|   • 本空间覆写: [ 1.0 v]  (可选，留空则使用全局默认)          |
|                                                             |
|   💡 说明: 系数越大，提前开始整备的时间越早                    |
|          - 数值小: 临近会议才开始调温                         |
|          - 数值大: 提前更长时间开始调温                       |
|                                                             |
| ✅ 能力检查: 所需语义映射均已配置，可正常工作                  |
|                                                             |
| 💡 依赖能力: 设备控制 + 环境感知 + 会议预定                     |
+-------------------------------------------------------------+

11.2 逻辑依赖检查 (阻断式)

整备开关是否可开启，由「空间逻辑映射」中黄金三要素的绑定状态决定。不满足时 switch 置灰不可操作。

黄金三要素：hvac_power、hvac_target_temp、env_indoor_temp 三个标准语义必须在空间逻辑映射卡片中完成点位绑定。
阻断规则：任一个未绑定 → switch 置灰 + 红底提示"整备依赖缺失：请先在空间逻辑映射中配置 xxx"。
模式解释：
- 自动执行：会前自动调温，完成后通知。
- 确认后执行：会前先询问，用户确认后执行。

11.3 空间环境策略与预设值 (Environmental Policy)

TIP

【空间环境策略与预设值】 MVP 阶段由 Dify 配置中心维护，管理后台只读展示与引用。

11.3.1 季/月度环境策略表

开始月份	结束月份	激活状态	运行模式	$T_{c o m f o r t}$	$T_{s t r o n g}$	$T_{e c o}$	$λ_{e n v}$	Buffer
11	2	ON	制热	22℃	26℃	20℃	6	10
6	9	ON	制冷	24℃	16℃	26℃	5	5
3	5	OFF	-	-	-	-	-	-

11.4 参数覆盖 (Parameter Override)

全局默认系数：来源于当前月份命中的策略表行（只读），显示为"全局默认"。
本空间覆写系数：空间级可选参数，用于覆盖全局默认系数。留空则使用全局默认值。
生效系数：若配置覆写则取覆写值，否则取全局默认值。
业务含义：系数越大，表示提前开始整备的时间越早。数值小表示临近会议才开始调温，数值大表示提前更长时间开始调温。

11.5 空间控制面板 (纯数据类型驱动)

深度调节面板已从"预设模板"模式迁移为纯数据类型驱动模式。面板内容由空间逻辑映射的语义列表自动渲染，不再依赖「UI Profile」配置。详见 SA_空间控制面板设计.md。

11.5.1 面板数据链路

空间逻辑映射（每条映射记录）
  ├─ semantic_key → 关联标准语义库 → icon、name
  ├─ data_type → 决定渲染组件（bool→switch / enum→选项列表 / number→滑块）
  ├─ role → 分组归类（RW→可操作能力 / RO→环境感知）
  ├─ value → 当前实时值（自控平台同步）
  ├─ range/step → number 量程与步长
  ├─ options → enum 可选列表
  └─ unit → 数值单位（P2 接入自控平台 unit 字段）

11.5.2 主动整备自检 (阻断式)

自检由 checkPrepDependencies() 在运行时执行，结果为阻断式——不满足条件时整备开关直接置灰。

状态	判定条件	UI 表现
逻辑就绪	黄金三要素均已绑定	switch 可操作，可正常开启整备
映射缺失	任意黄金要素未在空间逻辑映射中配置	switch 置灰 + 红底提示：整备依赖缺失

黄金三要素：hvac_power（空调开关）、hvac_target_temp（设定目标温度）、env_indoor_temp（室内实时温度）。

12. 技术实现与数据模型

12.1 向量化策略 (One-to-Many Vectorization)

采用拆分存储策略，一条 SQL 实体记录对应多条 Vector DB 记录，以覆盖不同的自然语言表达。

ETL 触发: 用户点击配置抽屉的 [保存生效]。
拆分逻辑: 遍历 aliases 数组（含原名、全路径名、人工别名）。
前置属性 (Pre-Filter Fields)：
- entity_type: SPACE 或 DEVICE。
- cap_tags: 该实体拥有的能力标签数组（如 ["meet", "control"]）。
存储示例:
- vec("305会议室") -> Payload: { "ref_id": "SP01", "entity_type": "SPACE", "cap_tags": ["meet"] }
- vec("金螳螂/1楼/305会议室") -> Payload: { "ref_id": "SP01", "entity_type": "SPACE", "cap_tags": ["meet"] }
- vec("VIP室") -> Payload: { "ref_id": "SP01", "entity_type": "SPACE", "cap_tags": ["meet"] }

12.2 数据一致性与冲突检查

弹性校验: 空间与设备别名不再强制全局唯一。系统支持多个资源共享相同别名，具体匹配逻辑下沉至 Agent 推理层。
后端存储: 保存时仅执行格式校验，不再报错冲突。

12.3 实体基础表 (`ai_entities` - Space)

字段	类型	必填	说明
`id`	UUID	Yes	AI 系统主键
`iot_ref_id`	String	Yes	IoT 平台原始 ID (SpaceID)
`type`	Enum	Yes	`SPACE`
`ai_status`	Enum	Yes	`ACTIVE`, `DISABLED`
`sync_error`	Enum	No	`CHANGED`, `ORPHAN`
`base_weight`	Float	Yes	默认 0.50
`aliases`	JSON	Yes	字符串数组 `["别名1", "别名2"]`
`capabilities`	JSON	No	插件能力配置容器 (含 is_enabled 开关状态)

12.4 空间插件能力配置 (`capabilities`)

Meeting Plugin (Key: meeting)

json

{
  "platform": "internal",
  "config": {
    "sync_at": "2026-04-09 10:00:00",
    "capacity": 15,
    "equipment": ["投影仪", "电视机"],
    "is_synced": true
  }
}

Control Plugin (Key: control)

用于定义该空间是否允许 AI 执行控制指令。

json

{
  "is_enabled": true,                // 空间级控制总关 (Policy Guard)
  "description": "允许 AI 对此空间执行灯光/空调调节"
}

Sensing Plugin (Key: sensing)

json

{
  "is_enabled": true,
  "source_mode": "SPACE_NATIVE_FIRST",        // 优先使用空间原生点位，无映射时才从设备聚合
  "native_mappings": [                        // [新增] 空间节点直连的逻辑信号映射
    { "semantic_key": "env_indoor_temp", "property": "rm_305_temp_r" }
  ],
  "single_source_of_truth": true
}

Active Prep Plugin (Key: active_prep)

json

{
  "is_enabled": true,
  "config": {
    "run_mode": "CONFIRM",         // AUTO | CONFIRM
    "env_lambda": 6.5,             // 空间级修正系数
    "last_run_at": "2026-04-13 14:00:00"
  }
}

2026 AI 空间智能体 - 空间语义管理 PRD (v3.8) ​

0. 架构导航：脑（空间）与 手（设备）的辩证关系 ​

0.1 核心对照表 ​

0.2 开发者共识 (Dev Guide) ​

1. 核心设计理念 ​

1.1 物理与语义解耦 ​

1.2 核心设计准则 ​

1.3 核心术语表 (Terminology) ​

1.4 AI 语义层与业务系统分歧澄清 ​

2. 管理模块概述 (Management Overview) ​

2.1 空间管理模块 (Space Hub) ​

2.2 核心特性 ​

3. 一致性管控逻辑 (Consistency Governance) ​

3.1 异常感知准则 (Detection Rules) ​

3.2 阶梯式采纳与闭环 (Stepped Adoption) ​

级别 1：熔断级 (Orphan) ​

级别 2：采纳项 (Auto-Sync Items) ​

3.3 交互 UI 规范 ​

4. 全链路业务流程 (Business Process) ​

4.1 系统上线纳管生命周期 ​

4.2 关键逻辑：双层状态模型 ​

5. 空间管理主界面 (Space Management UI) ​

5.1 界面总览：布局 ​

5.2 关键交互说明 ​

5.3 关键状态说明 ​

6. 资产纳管引入 (Onboarding) ​

6.1 引入逻辑细节 (Auto-Parent Sync) ​

7. 空间配置详情抽屉 (Drawer Detail) ​

7.1 处理闭环与更新逻辑 ​

7.2 AI 语义增强 ​

7.3 空间能力集成概览 ​

8. 分项能力：会议预定 (Meeting Reservation) ​

8.1 卡片原型 ​

8.2 对接策略 ​

8.3 自动装配与治理规则 (Auto-Provisioning Governance) ​

9. 分项能力：设备能力透视 ​

9.1 卡片原型 ​

9.2 逻辑说明 ​

10. 分项能力：空间逻辑映射 (Space Logic Mapping) ​

10.1 卡片原型 (业务扩展 · 手动挂载) ​

10.2 逻辑点位选择弹窗原型 (v3.11 多源版) ​

10.3 "重新扫描装载"逻辑定义 (Rescan Algorithm) ​

10.4 数据Schema与持久化说明 ​

10.3 核心交互逻辑 ​

11. 分项能力：智能整备 (Active Preparation) ​

11.1 卡片原型与配置 ​

11.2 逻辑依赖检查 (阻断式) ​

11.3 空间环境策略与预设值 (Environmental Policy) ​

11.3.1 季/月度环境策略表 ​

11.4 参数覆盖 (Parameter Override) ​

11.5 空间控制面板 (纯数据类型驱动) ​

11.5.1 面板数据链路 ​

11.5.2 主动整备自检 (阻断式) ​

12. 技术实现与数据模型 ​

12.1 向量化策略 (One-to-Many Vectorization) ​

12.2 数据一致性与冲突检查 ​

12.3 实体基础表 (ai_entities - Space) ​

12.4 空间插件能力配置 (capabilities) ​

2026 AI 空间智能体 - 空间语义管理 PRD (v3.8)

0. 架构导航：脑（空间）与手（设备）的辩证关系

0.1 核心对照表

0.2 开发者共识 (Dev Guide)

1. 核心设计理念

1.1 物理与语义解耦

1.2 核心设计准则

1.3 核心术语表 (Terminology)

1.4 AI 语义层与业务系统分歧澄清

2. 管理模块概述 (Management Overview)

2.1 空间管理模块 (Space Hub)

2.2 核心特性

3. 一致性管控逻辑 (Consistency Governance)

3.1 异常感知准则 (Detection Rules)

3.2 阶梯式采纳与闭环 (Stepped Adoption)

级别 1：熔断级 (Orphan)

级别 2：采纳项 (Auto-Sync Items)

3.3 交互 UI 规范

4. 全链路业务流程 (Business Process)

4.1 系统上线纳管生命周期

4.2 关键逻辑：双层状态模型

5. 空间管理主界面 (Space Management UI)

5.1 界面总览：布局

5.2 关键交互说明

5.3 关键状态说明

6. 资产纳管引入 (Onboarding)

6.1 引入逻辑细节 (Auto-Parent Sync)

7. 空间配置详情抽屉 (Drawer Detail)

7.1 处理闭环与更新逻辑

7.2 AI 语义增强

7.3 空间能力集成概览

8. 分项能力：会议预定 (Meeting Reservation)

8.1 卡片原型

8.2 对接策略

8.3 自动装配与治理规则 (Auto-Provisioning Governance)

9. 分项能力：设备能力透视

9.1 卡片原型

9.2 逻辑说明

10. 分项能力：空间逻辑映射 (Space Logic Mapping)

10.1 卡片原型 (业务扩展 · 手动挂载)

10.2 逻辑点位选择弹窗原型 (v3.11 多源版)

10.3 "重新扫描装载"逻辑定义 (Rescan Algorithm)

10.4 数据Schema与持久化说明

10.3 核心交互逻辑

11. 分项能力：智能整备 (Active Preparation)

11.1 卡片原型与配置

11.2 逻辑依赖检查 (阻断式)

11.3 空间环境策略与预设值 (Environmental Policy)

11.3.1 季/月度环境策略表

11.4 参数覆盖 (Parameter Override)

11.5 空间控制面板 (纯数据类型驱动)

11.5.1 面板数据链路

11.5.2 主动整备自检 (阻断式)

12. 技术实现与数据模型

12.1 向量化策略 (One-to-Many Vectorization)

12.2 数据一致性与冲突检查

12.3 实体基础表 (`ai_entities` - Space)

12.4 空间插件能力配置 (`capabilities`)