Skip to content

感知层主控

系统概览

感知层主控模块(ADR-071/162/166)。整合呼吸、眨眼、视线追踪、口型同步、重心微动等 所有感知子模块,提供统一的感知激活/禁用/pin 接口。是感知层的状态中心,维护活跃上下文 数据(Map<modelId, Context>),供 perception-observer 消费。

核心职责

  • perception.ts — 感知子模块聚合、状态读写、激活/禁用/pin 管理。

对外 API(节选)

  • interface PerceptionState — 感知层全局状态。
  • activatePerception(modelId?) — 激活指定模型(或全部)的感知。
  • deactivatePerception(modelId?) — 禁用感知。
  • pinPerception(modelId) / unpinPerception(modelId) — Pin/取消 Pin 模型(外最多可见数管控)。
  • getPerceptionState() / setPerceptionState(state) — 状态读写。
  • enableAllPerception() / disableAllPerception() — 全局使能/禁用。

与其他子系统关系

  • 子模块:perception-gaze.ts(视线)、perception-blinking.ts(眨眼)、 perception-breathing.ts(呼吸)、perception-expression.ts(表情)、 perception-lipsync.ts(口型)、perception-balance.ts(重心)。
  • 消费方:perception-observer.ts(逐帧施加感知修正)。
  • 共享类型:perception-shared.ts
  • 骨骼仲裁:bone-override-store

不变量

  • 感知层统一入口(ADR-071),所有子模块通过本模块聚合。
  • pin 机制:外最多可见其他实例数(mediumMaxOthers)管控多模型同屏感知预算。