当前位置：首页 > news >正文

观测-执行-结果三元组设计

news 2026/8/7 23:29:45

该types.py文件定义了一个用于“翻译器”模块（版本 0.2）的核心数据契约，其核心功能是构建一个观测-执行-结果的闭环学习框架。它通过定义一系列数据类（Data Class）来标准化不同层级（效果层、关系层）间的数据交互格式，为后续的机器学习或强化学习模型提供结构化的输入和输出。

核心数据结构解析

文件定义了四个主要的数据类和一个枚举，其关系与作用如下表所示：

类/枚举名	核心作用	关键属性/方法说明
`ObservationSource`(枚举)	标识观测数据的来源层级。	`EFFECT_LAYER`: 来自效果层；`RELATION_LAYER`: 来自关系层。
`EffectObservation`(数据类)	封装从效果层观测到的系统状态向量。	包含`spectral_shift`（谱偏移）、`entropy_oscillation`（熵震荡）等6个核心指标。`to_array()`方法将其转换为列表，便于模型输入。
`ActionParameters`(数据类)	封装在关系层执行的控制动作参数。	包含`threshold`（阈值）、`hold_duration`（维持时长）等4个可调参数。`to_dict()`方法将其转换为字典。
`Outcome`(数据类)	记录执行`ActionParameters`后产生的结果。	包含`success`（是否成功）、`delta_phase`（相位变化量）等关键结果指标和原始数据快照。
`Triple`(数据类)	将一次完整的交互封装为一个经验样本。	组合了`obs`（观测）、`action`（执行）、`outcome`（结果），并附加`weight`（样本权重）用于优先级学习。

代码示例与交互流程

以下代码展示了如何创建这些数据对象并构建一个完整的经验样本：

# 导入定义的数据类 from AFT.GuicangLayer.modules.translator_v0_2.types import ( EffectObservation, ActionParameters, Outcome, Triple, ObservationSource ) # 1. 模拟从效果层接收到观测数据 current_obs = EffectObservation( spectral_shift=0.15, entropy_oscillation=2.3, phase_lock_freq=50.0, lambda2=0.02, sri=0.85, sdi=0.12, source=ObservationSource.EFFECT_LAYER #明确数据来源 ) print(f"观测向量: {current_obs.to_array()}") # 转换为模型输入格式 # 2. 根据观测，策略模型生成要执行的动作参数 decided_action = ActionParameters( threshold=0.7, hold_duration=5.0, tighten_coefficient=1.2, relax_coefficient=0.8 ) print(f"动作参数: {decided_action.to_dict()}") # 转换为字典，便于序列化或传递 # 3. 执行动作后，系统反馈结果 execution_result = Outcome( success=True, delta_phase=-0.05, convergence_time=3.2, raw_metrics={"overshoot": 0.1, "settling_time": 2.9} # 可包含任意原始指标 ) # 4. 将本次交互封装为一个经验三元组，用于后续模型训练 experience = Triple( obs=current_obs, action=decided_action, outcome=execution_result, weight=1.0 # 初始权重，可根据结果重要性调整 ) # 此时，`experience` 对象可以被存入经验回放缓冲区 (Replay Buffer) print(f"经验样本时间戳: {experience.timestamp}")

设计要点与用途

标准化接口：通过强类型的数据类，确保了“效果层”与“关系层”之间，以及模型与执行环境之间数据格式的统一，降低了模块耦合度。
可序列化：每个核心数据类都提供了to_array()或to_dict()方法，方便将对象转换为基本数据类型，用于网络传输、持久化存储或送入神经网络。
闭环学习支持：Triple类的设计直接支持强化学习中的(state, action, reward, next_state)经验存储模式。这里的obs对应state，action保持不变，outcome包含了reward（可从delta_phase等推导）和next_state的部分信息。
扩展性：使用dataclass和typing模块（如Optional,Dict,Any）使得数据结构清晰且易于扩展。例如，Outcome.raw_metrics字段可以灵活存储任何额外的评估指标。