删除所有外部旧引用

app/services/pattern_service.py

@@ -38,7 +38,7 @@ class PatternService:
                     f"  Timing: {self.app.config.current_test_types[test_type]['timing']}",
                     "info",
                 )
-            self.app.ucd.set_ucd_params(active_config)
+            self.app.signal_service.apply_config(active_config)
 
         elif test_type == "sdr_movie":
             data_range = self.app.sdr_data_range_var.get()
@@ -60,7 +60,7 @@ class PatternService:
             active_config = self.app.config.get_temp_config_with_converted_params(
                 mode=mode, converted_params=converted_params
             )
-            self.app.ucd.set_ucd_params(active_config)
+            self.app.signal_service.apply_config(active_config)
             success = self.app.signal_service.update_signal_format(
                 color_space=self.app.sdr_color_space_var.get(),
                 data_range=data_range,
@@ -92,7 +92,7 @@ class PatternService:
             active_config = self.app.config.get_temp_config_with_converted_params(
                 mode=mode, converted_params=converted_params
             )
-            self.app.ucd.set_ucd_params(active_config)
+            self.app.signal_service.apply_config(active_config)
             success = self.app.signal_service.update_signal_format(
                 color_space=self.app.hdr_color_space_var.get(),
                 data_range=data_range,
@@ -123,7 +123,7 @@ class PatternService:
             raise IndexError(f"pattern 索引越界: {index}")
 
         pattern_param = session.pattern_params[index]
-        if not self.app.ucd.send_current_pattern_params(pattern_param):
+        if not self.app.signal_service.send_pattern_params(pattern_param):
             raise RuntimeError(f"发送 pattern 失败: {index}")
         return pattern_param
 

app/services/ucd_service.py

@@ -176,6 +176,49 @@ class SignalService:
     def current_resolution(self) -> tuple[int, int]:
         return self._dev.current_resolution()
 
+    @property
+    def is_connected(self) -> bool:
+        """UCD 设备是否已打开。供 GUI 做前置校验。"""
+        ctrl = getattr(self._dev, "raw_controller", None)
+        return bool(ctrl and getattr(ctrl, "status", False))
+
+    # -- 过渡期 API（Phase 5）：config 驱动的写入 -----------------
+    # 现有 GUI / Service 通过 ``PQConfig`` 对象描述当次测试参数，
+    # 由 :class:`UCDController.set_ucd_params` 翻译为色彩/Timing/Pattern。
+    # 在配置层重构落地前，这两个方法作为 SignalService 的统一入口，
+    # 让上层不再直接接触 ``self.app.ucd``。
+
+    def apply_config(self, config) -> bool:
+        """按 :class:`PQConfig` 写入色彩 / Timing / 当前 Pattern（不 apply 输出）。"""
+        ctrl = getattr(self._dev, "raw_controller", None)
+        if ctrl is None:
+            raise UcdError("apply_config 暂仅支持 UCD323Device")
+        with self._lock:
+            return bool(ctrl.set_ucd_params(config))
+
+    def send_pattern_params(self, params) -> bool:
+        """以 ``params`` 更新当前 pattern 的参数并 apply。"""
+        ctrl = getattr(self._dev, "raw_controller", None)
+        if ctrl is None:
+            raise UcdError("send_pattern_params 暂仅支持 UCD323Device")
+        with self._lock:
+            return bool(ctrl.send_current_pattern_params(params))
+
+    def apply_and_run(self, config, pattern_params) -> bool:
+        """``set_ucd_params`` + ``set_pattern`` + ``run`` 的复合操作。
+
+        服务于 custom_template_panel 单步流程。
+        """
+        ctrl = getattr(self._dev, "raw_controller", None)
+        if ctrl is None:
+            raise UcdError("apply_and_run 暂仅支持 UCD323Device")
+        with self._lock:
+            if not ctrl.set_ucd_params(config):
+                return False
+            if not ctrl.set_pattern(ctrl.current_pattern, pattern_params):
+                return False
+            return bool(ctrl.run())
+
 
 __all__ = [
     "SignalService",