整理配置和代码入口，增加部分测试。

sync_state_machine/datasource/api/handler.py

@@ -44,6 +44,7 @@ class BaseApiHandler(NodeHandler[T]):
         self.api_client: 'ApiClient' = None  # type: ignore  # 由 DataSource 注入
         self.poll_mode: str = "async"  # async | sync
         self._collection: 'DataCollection' = None # type: ignore  # 由 DataSource 注入
+        self.handler_config: Dict[str, Any] = {}
         # 子类在 __init__ 中设置此列表以声明 create/update 中涉及的 Pydantic schema 类；
         # post-check 将只比较这些 schema 覆盖的字段，过滤后端只读的派生字段。
         self.update_schemas: List[type] = []
@@ -63,6 +64,13 @@ class BaseApiHandler(NodeHandler[T]):
     def set_collection(self, collection: 'DataCollection') -> None:
         """设置 Collection（由 DataSource 调用）"""
         self._collection = collection
+
+    def set_handler_config(self, config: Dict[str, Any]) -> None:
+        self.handler_config = dict(config)
+
+    def set_target_project_ids(self, target_project_ids: List[str]) -> None:
+        """默认忽略项目过滤列表，具体子类按需覆盖。"""
+        return
     
     @property
     def node_type(self) -> str: