Merge remote-tracking branch 'upstream/prcix9320' into adaptors

# Conflicts:
#	unilabos/devices/liquid_handling/prcxi/prcxi.py

unilabos/devices/liquid_handling/prcxi/prcxi_modules.py

@@ -1,18 +1,16 @@
 from typing import Any, Dict, Optional
 
-from .prcxi import PRCXI9300PlateAdapterSite
+from .prcxi import PRCXI9300ModuleSite
 
 
-class PRCXI9300FunctionalModule(PRCXI9300PlateAdapterSite):
+class PRCXI9300FunctionalModule(PRCXI9300ModuleSite):
     """
     PRCXI 9300 功能模块基类（加热/冷却/震荡/加热震荡/磁吸等）。
 
     设计目标：
-    - 作为一个可以在工作台上拖拽摆放的实体资源（继承自 ItemizedCarrier）。
-    - 顶面存在一个站点（site），可吸附标准板类资源（plate / tip_rack / tube_rack 等），
-      站点的行为参考 `PRCXI9300PlateAdapterSite` 的实现。
-    - 支持注入 `material_info` (UUID 等)，并且在 serialize_state 时做安全过滤，
-      行为与 `PRCXI9300PlateAdapter` 保持一致。
+    - 作为一个可以在工作台上拖拽摆放的实体资源（继承自 PRCXI9300ModuleSite -> ItemizedCarrier）。
+    - 顶面存在一个站点（site），可吸附标准板类资源（plate / tip_rack / tube_rack 等）。
+    - 支持注入 `material_info` (UUID 等)，并且在 serialize_state 时做安全过滤。
     """
 
     def __init__(
@@ -34,21 +32,11 @@ class PRCXI9300FunctionalModule(PRCXI9300PlateAdapterSite):
             size_z=size_z,
             material_info=material_info,
             model=model,
+            category=category,
             **kwargs,
         )
 
-        # 作为一个“可被槽位吸附”的实体，在 PLR 层面上将其视为 plate_adapter，
-        # 这样与已有的槽位/适配器逻辑兼容；模块语义通过 _unilabos_state 中的
-        # category/module_type 表达。
-        try:
-            self.category = "plate_adapter"
-        except Exception:
-            # category 不是硬性要求属性，失败时静默忽略
-            pass
-
         # 记录模块类型（加热 / 冷却 / 震荡 / 加热震荡 / 磁吸）
-        # - 通过工厂函数创建时，会显式传入 module_type
-        # - 通过反序列化（deserialize）创建时，可能没有该字段，此时允许为 None
         self.module_type = module_type or "generic"
 
         # 与 PRCXI9300PlateAdapter 一致，使用 _unilabos_state 保存扩展信息
@@ -63,33 +51,6 @@ class PRCXI9300FunctionalModule(PRCXI9300PlateAdapterSite):
         self._unilabos_state.setdefault("category", category)
         self._unilabos_state["module_type"] = module_type
 
-    def serialize_state(self) -> Dict[str, Dict[str, Any]]:
-        """
-        在父类基础上，增加对 _unilabos_state 的安全序列化，
-        行为与 `PRCXI9300PlateAdapter.serialize_state` 保持一致。
-        """
-        try:
-            data = super().serialize_state()
-        except AttributeError:
-            data = {}
-
-        if hasattr(self, "_unilabos_state") and self._unilabos_state:
-            safe_state: Dict[str, Any] = {}
-            for k, v in self._unilabos_state.items():
-                if k == "Material" and isinstance(v, dict):
-                    safe_material: Dict[str, Any] = {}
-                    for mk, mv in v.items():
-                        # 只保留基本数据类型 (字符串, 数字, 布尔值, 列表, 字典, None)
-                        if isinstance(mv, (str, int, float, bool, list, dict, type(None))):
-                            safe_material[mk] = mv
-                    safe_state[k] = safe_material
-                elif isinstance(v, (str, int, float, bool, list, dict, type(None))):
-                    safe_state[k] = v
-
-            data.update(safe_state)
-
-        return data
-
 
 # ============================================================================
 # 具体功能模块定义