端到端新架构骨架：src/new 包入口 + BaseView 接口契约（dispatch_execute 沿父链上溯 run_single_step）

src/new/core/base_view.py

@@ -0,0 +1,77 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+"""
+BaseView —— 模块化新页面的标准接口基类
+
+设计目标：
+1. 继承自 QWidget，保留 PyQt 控件的全部能力。
+2. 剥离对全局 main_window 的直接依赖——所有跨层通讯通过
+   ``dispatch_execute`` 沿 ``self.parent()`` 父链向上查找具备
+   ``run_single_step`` 方法的祖先容器完成。
+3. 声明一组可重写的生命周期空方法（init_ui / get_config /
+   set_config / update_work_directory / update_from_config），
+   子类按需覆盖，避免基类强制绑定具体 UI 形态。
+"""
+
+from PyQt5.QtWidgets import QWidget
+
+
+class BaseView(QWidget):
+    """所有新页面的标准基类"""
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        # 全局推送状态的本地缓存——主窗口通过 update_from_config 写入
+        self.work_dir = None
+        self.pipeline = None
+        # 子类应重写 init_ui 以构建自身 UI
+        self.init_ui()
+
+    # ------------------------------------------------------------------
+    # 生命周期空方法（子类按需重写）
+    # ------------------------------------------------------------------
+    def init_ui(self):
+        """构建 UI——子类必须重写"""
+        pass
+
+    def get_config(self) -> dict:
+        """返回当前步骤的配置字典——子类重写"""
+        return {}
+
+    def set_config(self, config: dict):
+        """根据 config 恢复 UI 状态——子类重写"""
+        pass
+
+    def update_work_directory(self, work_dir: str):
+        """主窗口推送工作目录变更——子类按需重写以联动自动填充"""
+        self.work_dir = work_dir
+
+    def update_from_config(self, work_dir: str, pipeline=None):
+        """主窗口推送全局状态——子类可重写以联动 pipeline 状态"""
+        self.work_dir = work_dir
+        self.pipeline = pipeline
+
+    # ------------------------------------------------------------------
+    # 核心通讯：沿父链向上查找 run_single_step 容器
+    # ------------------------------------------------------------------
+    def dispatch_execute(self, step_id: str, config: dict):
+        """
+        向主窗口请求执行某个步骤。
+
+        实现要点：
+        - 沿 ``self.parent()`` 一路向上爬，直到找到具备
+          ``run_single_step`` 方法的祖先容器。
+        - 找不到则抛出 ``RuntimeError``，便于在迁移早期定位未挂载的面板。
+        """
+        ancestor = self.parent()
+        while ancestor is not None and not hasattr(ancestor, "run_single_step"):
+            ancestor = ancestor.parent()
+
+        if ancestor is not None and hasattr(ancestor, "run_single_step"):
+            ancestor.run_single_step(step_id, config)
+        else:
+            raise RuntimeError(
+                "[BaseView] dispatch_execute 失败：未在父链中找到 "
+                "具备 run_single_step 方法的主窗口容器 "
+                f"（step_id={step_id}）"
+            )