增加了项目侧关于steps的处理。允许保存和提取steps信息。

sync_state_machine/domain/preparation/api_handler.py

@@ -102,7 +102,13 @@ class PreparationApiHandler(BaseApiHandler):
                 continue
             
             origin_data = node.get_origin_data() or {}
-            update_data = self._filter_update_data(node_data, origin_data, PostPreparation)
+            force_steps_update = self._steps_changed(node)
+            update_data = self._filter_update_data(
+                node_data,
+                origin_data,
+                PostPreparation,
+                force_full_schema=force_steps_update,
+            )
             if not update_data:
                 reason = f"No physical diff found for preparation {node.data_id} despite strategy update request (Normalization Discrepancy)."
                 print(f"  [WARNING] [preparation] {reason}")
@@ -123,7 +129,14 @@ class PreparationApiHandler(BaseApiHandler):
                 continue
             
             try:
-                await api_update_preparation(self.api_client, update_model, push_id, biz_id)
+                await api_update_preparation(
+                    self.api_client,
+                    update_model,
+                    push_id,
+                    biz_id,
+                    steps=self._get_request_steps(node),
+                )
+                self._mark_approval_snapshot_synced(node)
                 results.append(TaskResult.success(node_id=node.node_id))
             except Exception as e:
                 results.append(TaskResult.failed(node_id=node.node_id, error=str(e)))
@@ -143,11 +156,18 @@ class PreparationApiHandler(BaseApiHandler):
 
 # ========== 静态 API 函数 ==========
 
-async def api_update_preparation(client, data: PostPreparation, push_id: str, biz_id: str) -> None:
+async def api_update_preparation(
+    client,
+    data: PostPreparation,
+    push_id: str,
+    biz_id: str,
+    *,
+    steps: List[Dict[str, Any]] | None = None,
+) -> None:
     """
     PUT /preparation_nodes - 更新里程碑数据
     """
-    request_data = {"push_id": push_id, "biz_id": biz_id, "data": data.model_dump(exclude_unset=True)}
+    request_data = {"push_id": push_id, "biz_id": biz_id, "data": data.model_dump(exclude_unset=True), "steps": steps or []}
     response = await client.request(method="PUT", endpoint="/preparation_nodes", data=request_data)
     if response.get("code") != 200:
         raise Exception(f"API error: {response.get('message', 'Unknown error')}")