feat(timeline): 校准 profile 绑定

- Timeline model 加 calibration_profile 字段
- 打轴保存时写入当前校准文件名
- 凹图运行时校验 timeline 记录的 profile 与当前是否一致，
  不一致警告（30f vs 31f 会导致帧级漂移）

Author: Windsland52

aao/app.py

@@ -241,6 +241,7 @@ def _on_profile_saved(self, filename: str) -> None:
         try:
             self._calibration_data = calibration.load(filename)
             self._profile_name = filename
+            self.editor_page.set_profile(filename)
         except (OSError, ValueError):
             logger.exception("校准 %s 加载失败", filename)
         if self._controller is not None:
@@ -282,6 +283,7 @@ def _build_ui(self) -> None:
         self.farm_page.busy_changed.connect(self._set_busy)
 
         self.editor_page = EditorWindow()  # 打轴编辑器（已接入 canvas + 地图选点）
+        self.editor_page.set_profile(self._profile_name)
         self._editor = self.editor_page  # 供热键 mark_action
         self.calib_page = CalibrationPage()
         self.settings_page = SettingsPage()

aao/timeline/editor_window.py

@@ -59,6 +59,7 @@ def __init__(self):
         self._current_frame = 0  # 实时帧（由外部更新）
         self._align_mode = False  # False=打轴（游标不跟随），True=对轴（游标跟实时帧）
         self._candidates: list[str] = []  # 候选干员/装置列表
+        self._profile_name = ""  # 当前校准 profile 文件名（由 MainWindow 注入）
 
         self.canvas = TimelineCanvas()
         self.canvas.node_clicked.connect(self._on_canvas_node_clicked)
@@ -430,11 +431,16 @@ def _on_open(self):
         self._refresh_table()
         self.lbl_status.setText(f"已加载 {len(self.timeline.actions)} 个动作")
 
+    def set_profile(self, profile_name: str) -> None:
+        """注入当前校准 profile 文件名（打轴帧数依赖此 profile，保存时写入 timeline）。"""
+        self._profile_name = profile_name
+
     def _on_save(self):
         path, _ = QFileDialog.getSaveFileName(self, "保存时间轴", "", "JSON (*.json)")
         if not path:
             return
         self.timeline.map_code = self.edit_map.text().strip()
+        self.timeline.calibration_profile = self._profile_name
         self._collect_candidates()
         save_timeline(self.timeline, path)
         self.lbl_status.setText(f"已保存到 {path}")

aao/timeline/model.py

@@ -89,15 +89,19 @@ class Timeline:
     actions: list[TimelineAction] = field(default_factory=list)
     name: str = ""  # 用户可读名称
     candidates: list[str] = field(default_factory=list)  # 候选干员/装置名
+    calibration_profile: str = ""  # 打轴时用的校准 profile 文件名
 
     def to_dict(self) -> dict[str, Any]:
-        return {
+        d: dict[str, Any] = {
             "map_code": self.map_code,
             "coordinate": self.coordinate,
             "name": self.name,
             "candidates": self.candidates,
             "actions": [a.to_dict() for a in self.actions],
         }
+        if self.calibration_profile:
+            d["calibration_profile"] = self.calibration_profile
+        return d
 
     @classmethod
     def from_dict(cls, d: dict[str, Any]) -> Timeline:
@@ -106,6 +110,7 @@ def from_dict(cls, d: dict[str, Any]) -> Timeline:
             coordinate=d.get("coordinate", "frame"),
             name=d.get("name", ""),
             candidates=d.get("candidates", []),
+            calibration_profile=d.get("calibration_profile", ""),
             actions=[TimelineAction.from_dict(a) for a in d.get("actions", [])],
         )
 

custom/action/executor.py

@@ -90,18 +90,29 @@ def _execute(self, context: Context, params: dict) -> CustomAction.RunResult:
 
         # 优先 timeline_path（从文件加载，文件内含 map_code），兼容显式 timeline 数组
         timeline_path = params.get("timeline_path")
+        tl_calib = ""
         if timeline_path:
             tl = self._load_timeline_file(timeline_path)
             if tl is None:
                 return CustomAction.RunResult(success=False)
             raw_actions = tl.get("actions", [])
             map_code = params.get("map_code") or tl.get("map_code", "")
+            tl_calib = tl.get("calibration_profile", "")
         else:
             raw_actions = params.get("timeline", [])
             map_code = params.get("map_code", "")
 
         calib_file = params.get("calibration") or config.DEFAULT_CALIBRATION
 
+        # 校验：timeline 记录的校准 profile 与当前使用的是否一致（帧数偏差会导致漂移）
+        if tl_calib and tl_calib != calib_file:
+            logger.warning(
+                "⚠ 校准 profile 不匹配：timeline 用的是 %s，当前运行用的是 %s。"
+                "帧数可能不同（如 30f vs 31f），会导致时间轴漂移！",
+                tl_calib,
+                calib_file,
+            )
+
         if not raw_actions or not map_code:
             logger.error("缺少参数: 需要 timeline_path 或 (timeline + map_code)")
             return CustomAction.RunResult(success=False)