SA 主动整备 PRD (Active Prep Strategy)

1. 业务愿景 (Business Vision)

“人未到，环境已就绪”。通过监听会议日程，在会议开始前由 AI 自动完成会议室的环境调节（空调、新风、灯光），赋予物理空间“主动整备”的体感，显著降低用户进入房间后的不适感。

2. 空间整备数据模型 ( $T_{p r e p}$ Model)

系统在执行计算前，需从多个异构系统提取并清洗数据。

2.1 空间物理属性取数逻辑

面积 (Area)：
- 优先从“业务中台-物理空间维护”获取 floor_area。
- 若为空，则按 推算面积 = Capacity * capacity_area_factor (默认系数 2.5) 计算。
人数 (Capacity) 推算与清洗：
- 来源：调用“会议预约系统”接口获取该会议的预定人数字段。
- 清洗规则：
  - 若返回单一数字 (如 10)：直接使用。
  - 若返回区间 (如 10-20)：取最大值 (20)，遵循“整备从严”原则。
  - 若字段为空 / 无效：使用系统默认值（默认 8 人，对应全局参数 DEFAULT_CAPACITY）。

2.2 温感采集原则 (Sensing Unification)

SSOT 唯一真相：主动整备 Agent 严禁直接扫描物理设备温感。必须读取空间级逻辑感知点位。
整备黄金三要素 (HVAC Required Keys)：
- hvac_power: 空调开关 (W)
- hvac_target_temp: 设定目标温度 (W)
- env_indoor_temp: 室内实时温度 (R) - 此为自检自闭环的唯一数据源。
失效降级：若映射点位离线，整备算法自动跳过该房间并记录异常轨迹。

3. 智能算法策略 (Intelligence Strategy)

为了保证全域认知一致，主动整备 Agent 严格遵循 《空间语义管理 PRD》 中定义的季节性调节策略与物理预测模型。

逻辑载体：Agent 依据当前月份，从 《空间语义管理 PRD §11.3.1》 中拉取运行模式、目标温度（ $T_{c o m f o r t}$ ）及环境影响系数（ $λ_{e n v}$ ）。
计算逻辑：预触发时间 $T_{p r e p}$ 的计算模型定义如下：

T_{p r e p} = (| T_{c u r r} - T_{c o m f o r t} | \times λ_{e n v} \times \frac{A r e a}{20}) + B u f f e r

(注： $A r e a$ 为空间纳管的物理面积属性； $λ_{e n v}$ 与 $T_{c o m f o r t}$ 取自空间环境策略表)

4. 核心流程图 (Flowcharts)

整备流程分为“后台扫描”与“交互执行”两个子流程。

4.1 扫描与触发判定 (Scanning & Trigger Decision)

4.2 执行与交互闭环 (Execution & Interaction Loop)

5. 消息协同与触达中心 (Message Collaboration)

为了保证服务的可扩展性，Agent 不直接调用底层 IM 接口，而是对接统一的 “消息管理系统”。

5.1 消息调度与渠道配置 (Dispatch & Channels)

参数化配置：Agent 侧负责组装 Json 载荷，具体通道（如：微信公众号、企业微信、系统内消息中心）由消息调度中心根据管理员配置实时路由。
MVP 默认通道：微信公众号 (WeChat Official Account)。

5.2 微信模板消息映射 (Template Mapping)

模板字段	映射业务内容	示例
`first.DATA`	状态标题	🚀 空间整备：您的会议室已就绪
`keyword1.DATA`	会议主题	2026 Q2 战略对齐会
`keyword2.DATA`	会议时间	14:00 - 16:00
`keyword3.DATA`	会议地点	305/中型会议室
`remark.DATA`	动态描述	当前温感 28℃，AI 已为您启动预冷至 24℃。
`url / miniprogram`	落地页跳转	跳转至整备落地页

5.3 落地页链接参数

pages/space-agent/index?room_id=${room_id}&meeting_id=${meeting_id}&action=active_prep

6. 管理后台配置项 (Admin Configuration)

6.1 空间级配置 (Space Settings)

功能开关：控制单个房间的主动整备状态。
执行模式：选择 AUTO (场景A) 或 CONFIRM (场景B)。
自定义 Lambda：支持针对特定空间（如顶层西晒位）覆盖全局配置。

6.2 全局调度配置 (Global Settings)

调度频率：默认 5min。
消息渠道：定义渠道触发，mvp版本实现微信公众号（公司测试环境）。
沉默期设置 (Quiet Period)：默认 30min。
- 逻辑定义：在任务取消、整备完成或用户点击“暂不整备”后的 30 分钟内，该房间不再重复触发扫描触发。防止由于预定单微调或频繁交互导致的“交互指令轰炸”或“硬件频繁开关”。

7. 数据库逻辑模型 (Logical DB Model)

7.1 全局算法参数表 (`sys_global_parameter`)

DEFAULT_CAPACITY: 默认人数 (8)
CAPACITY_AREA_FACTOR: 面积折算系数 (2.5)
SCAN_WINDOW: 扫描窗口 (60min)
QUIET_PERIOD: 沉默期时间 (30min)

7.2 季/月整备策略表 (`sys_prep_policy`)

数据源：该表字段及具体业务预设数值已统一迁移至 《空间语义管理 PRD §9.6》 进行资产化管理。Agent 运行时仅执行只读调用。

7.3 空间扩展属性表 (`biz_space_extra_attr`)

space_id: PK
floor_area: Float
related_sensors: JSON (温感能力插件映射)
custom_lambda: Float

8. 与 Master Agent 协同：辅助日报指标 (Daily Metrics)

整备动作必须计入 Action Log，并在 《数字员工日报》 中汇总展示：

整备成功率：指令成功下发次数 / 预期整备次数。
能效贡献度：通过感知会议取消并及时关停设备节省的预估电量。
用户认可度：纠偏按钮（Cancel）或“暂不”的点击率。

9. 待解决与深调项 (Open Questions)

9.1 物理安全拦截：逻辑合规校验 (Logic Constraint)

核心逻辑：主动整备 Agent 不执行 物理量程计算。AI 仅依据 [空间逻辑映射] 绑定的 SSOT 信号定义 进行合规性校验。
校验准则：若目标 SSOT 信号量程为 $[18, 26]$ ，则 AI 拒绝下发任何超出此范围的指令。
职责划分：
- AI 层：负责“结论对正”（目标值符合 SSOT 定义）。
- 自控平台 (Control Platform)：负责“物理对齐”（点位背后的物理设备分发、兼容性校验与反馈闭环）。

9.2 深度调节面板渲染 (已解耦)

设计决议：深度调节面板已从"预设模板"模式迁移为 "空间逻辑映射纯数据驱动" 模式。面板不再依赖「UI Profile」配置。
渲染规则：面板按语义的数据类型（bool/enum/number）自动渲染对应交互组件，无需管理员预设面板样式。
详见：SA_空间控制面板设计.md。

9.3 空间物模型与动态渲染 (Space AI Object Model)

已实现：该方向已在 v1.0 面板引擎 中落地。面板基于空间逻辑映射的语义列表，按数据类型自动生成交互组件，实现了"一套代码适配全场景"。
详见：SA_空间控制面板设计.md §2-3。

附录

季/月度环境策略表

多消费者说明：该策略表同时服务于整备 Agent（T_prep 计算）和面板 hvac_target_temp 组件（快捷预设展示），由 temp-presets.json 承载只读副本。

开始月份	结束月份	激活状态	运行模式	$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	-	-	-	-	-	-

SA 主动整备 PRD (Active Prep Strategy) ​

1. 业务愿景 (Business Vision) ​

2. 空间整备数据模型 (Tprep Model) ​

2.1 空间物理属性取数逻辑 ​

2.2 温感采集原则 (Sensing Unification) ​

3. 智能算法策略 (Intelligence Strategy) ​

4. 核心流程图 (Flowcharts) ​

4.1 扫描与触发判定 (Scanning & Trigger Decision) ​

4.2 执行与交互闭环 (Execution & Interaction Loop) ​

5. 消息协同与触达中心 (Message Collaboration) ​

5.1 消息调度与渠道配置 (Dispatch & Channels) ​

5.2 微信模板消息映射 (Template Mapping) ​

5.3 落地页链接参数 ​

6. 管理后台配置项 (Admin Configuration) ​

6.1 空间级配置 (Space Settings) ​

6.2 全局调度配置 (Global Settings) ​

7. 数据库逻辑模型 (Logical DB Model) ​

7.1 全局算法参数表 (sys_global_parameter) ​

7.2 季/月整备策略表 (sys_prep_policy) ​

7.3 空间扩展属性表 (biz_space_extra_attr) ​

8. 与 Master Agent 协同：辅助日报指标 (Daily Metrics) ​

9. 待解决与深调项 (Open Questions) ​

9.1 物理安全拦截：逻辑合规校验 (Logic Constraint) ​

9.2 深度调节面板渲染 (已解耦) ​

9.3 空间物模型与动态渲染 (Space AI Object Model) ​

附录 ​

季/月度环境策略表 ​