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

sync_state_machine/domain/contract/api_handler.py

@@ -48,20 +48,38 @@ async def api_get_contract(client: ApiClient, contract_id: str) -> ContractRespo
     return ContractResponse.model_validate(response["data"])
 
 
-async def api_create_contract(client: ApiClient, data: Dict[str, Any], push_id: str) -> Dict[str, Any]:
+async def api_create_contract(
+    client: ApiClient,
+    data: Dict[str, Any],
+    push_id: str,
+    *,
+    steps: List[Dict[str, Any]] | None = None,
+) -> Dict[str, Any]:
     """POST /contract/create - 创建合同（异步）"""
     validated_data = ContractCreate.model_validate(data)
-    request_data = {"push_id": push_id, "data": validated_data.model_dump(exclude_none=True)}
+    request_data = {"push_id": push_id, "data": validated_data.model_dump(exclude_none=True), "steps": steps or []}
     response = await client.request("POST", "/contract/create", data=request_data)
     if response.get("code") != 200:
         raise Exception(f"Failed to create contract: {response.get('message', 'Unknown error')}")
     return response
 
 
-async def api_update_contract(client: ApiClient, data_id: str, data: Dict[str, Any], push_id: str) -> Dict[str, Any]:
+async def api_update_contract(
+    client: ApiClient,
+    data_id: str,
+    data: Dict[str, Any],
+    push_id: str,
+    *,
+    steps: List[Dict[str, Any]] | None = None,
+) -> Dict[str, Any]:
     """PUT /contract/update - 更新合同（同步）"""
     validated_data = ContractUpdate.model_validate(data)
-    request_data = {"push_id": push_id, "biz_id": data_id, "data": validated_data.model_dump(exclude_none=True)}
+    request_data = {
+        "push_id": push_id,
+        "biz_id": data_id,
+        "data": validated_data.model_dump(exclude_none=True),
+        "steps": steps or [],
+    }
     response = await client.request("PUT", "/contract/update", data=request_data)
     if response.get("code") != 200:
         raise Exception(f"Failed to update contract: {response.get('message', 'Unknown error')}")
@@ -194,7 +212,12 @@ class ContractApiHandler(BaseApiHandler):
             
             # 调用 API（直接调用顶层函数）
             push_id = self._generate_push_id()
-            response = await api_create_contract(self.api_client, request_data, push_id)
+            response = await api_create_contract(
+                self.api_client,
+                request_data,
+                push_id,
+                steps=self._get_request_steps(node),
+            )
             if self.poll_mode == "sync":
                 created_id = self._extract_created_id_from_response(response)
                 if not created_id:
@@ -232,10 +255,12 @@ class ContractApiHandler(BaseApiHandler):
 
             # 过滤出需要更新的字段（排除空值、未变化的字段）
             origin_data = node.get_origin_data() or {}
+            force_steps_update = self._steps_changed(node)
             update_data = self._filter_update_data(
                 new_data=data,
                 original_data=origin_data,
                 schema=ContractUpdate,
+                force_full_schema=force_steps_update,
             )
             
             # 如果没有需要更新的字段，降级 action 并返回跳过
@@ -257,10 +282,17 @@ class ContractApiHandler(BaseApiHandler):
                 return TaskResult.failed(node_id=node.node_id, error="Missing biz_id for update")
             
             # 调用 API
-            response = await api_update_contract(self.api_client, biz_id, update_data, push_id)
+            response = await api_update_contract(
+                self.api_client,
+                biz_id,
+                update_data,
+                push_id,
+                steps=self._get_request_steps(node),
+            )
             
             # 检查响应状态（更新接口是同步的）
             if response.get("code") == 200:
+                self._mark_approval_snapshot_synced(node)
                 return TaskResult.success(node_id=node.node_id)
             else:
                 return TaskResult.failed(