路径归一化：统一 14 个子目录 helper 接口 + 修复 getattr 张冠李戴

新增 _step_path_resolver.py（STEP_DATA_SOURCE 映射表 + _FALLBACK_DIR_TABLE 40+ keys + resolve_subdir / get_step_output_path / resolve_step_widget 三层 API），与 pipeline.get_step_output_dir 互为表里、互不依赖。

pipeline 新增 get_step_output_dir(step_name) 唯一权威接口（class-level _STEP_OUTPUT_DIR_MAP 延迟构造 + 未知 key 回退 work_dir + 调试日志）。

全量重构 src/gui/panels/step*.py（17 个文件）

* 消除全部 os.path.join(wp, "X_subdir") 硬编码（14 个预定义子目录）

* 8 处 getattr(main_window.stepXX_panel, ...) 张冠李戴死代码全部修复（错位属性名 → 通过 STEP_DATA_SOURCE 映射到正确的 main_window 长名属性）

* 删除 step12_viz_panel.py 中 self.step11_ml_panel / step11_panel / step12_panel 死代码块

* 提示文字/标签字典/日志保留原文，仅替换实际路径计算

Smoke test：39 fallback key + 14 路径映射 + 14 step 数字 key + 17/17 panel AST 解析 + 17/17 import 全部就位。

src/gui/panels/step4_sampling_panel.py

@@ -5,6 +5,14 @@ Step4 面板 - 采样点布设
 """
 
 import os
+import sys
+from pathlib import Path
+
+# 路径归一化 helper（与 pipeline.get_step_output_dir 互为表里）
+_HERE = os.path.dirname(os.path.abspath(__file__))
+if _HERE not in sys.path:
+    sys.path.insert(0, _HERE)
+from _step_path_resolver import resolve_subdir
 
 from PyQt5.QtCore import QTimer
 from PyQt5.QtWidgets import (
@@ -186,7 +194,7 @@ class Step4SamplingPanel(QWidget):
             water_mask_path = main_window.step1_panel.output_file.get_path()
         # 备选：扫描 1_water_mask 目录下的 .dat 文件
         if not water_mask_path and self.work_dir:
-            mask_dir = os.path.join(self.work_dir, "1_water_mask")
+            mask_dir = resolve_subdir(self.work_dir, 'water_mask')
             if os.path.isdir(mask_dir):
                 dat_files = [f for f in os.listdir(mask_dir) if f.lower().endswith('.dat')]
                 if dat_files:
@@ -213,7 +221,7 @@ class Step4SamplingPanel(QWidget):
 
         # 3. 自动填充输出路径（绝对路径）
         if self.work_dir:
-            output_path = os.path.join(self.work_dir, "4_sampling", "sampling_spectra.csv")
+            output_path = resolve_subdir(self.work_dir, 'sampling_csv_path')
             os.makedirs(os.path.dirname(output_path), exist_ok=True)
             self.output_file.set_path(output_path.replace('\\', '/'))