非event卡推送，以及手动查看

lib.py

@@ -3,7 +3,7 @@ import json
 import os
 import sys
 from dataclasses import field, dataclass
-from typing import Optional, Dict, Any, List
+from typing import Optional, Dict, Any, List, Union, TypeVar, Generic, Callable
 
 
 def get_lib_filename(base_name):
@@ -15,26 +15,30 @@ def get_lib_filename(base_name):
         return f"lib{base_name}.so"
 
 
+T = TypeVar("T")
+
+
 @dataclass
 class FetchResultCard:
     text: str = ""
     path: List[str] = field(default_factory=list)
 
     @classmethod
-    def from_dict(cls, data: Dict[str, Any]) -> 'FetchResultCard':
+    def from_dict(cls, data: Dict[str, Any]) -> "FetchResultCard":
         return cls(
             text=data.get("text", ""),
-            path=data.get("path", []),
+            # 兼容 Rust 中 PathBuf 序列化出的路径字符串列表
+            path=[str(p) for p in data.get("path", [])],
         )
 
 
 @dataclass
-class FetchResult:
+class FetchResultEvent:
     event_id: int = 0
     cards: List[FetchResultCard] = field(default_factory=list)
 
     @classmethod
-    def from_dict(cls, data: Dict[str, Any]) -> 'FetchResult':
+    def from_dict(cls, data: Dict[str, Any]) -> "FetchResultEvent":
         return cls(
             event_id=data.get("event_id", 0),
             cards=[
@@ -44,6 +48,95 @@ class FetchResult:
         )
 
 
+@dataclass
+class FetchResultUnlinkedCards:
+    cards: List[FetchResultCard] = field(default_factory=list)
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> "FetchResultUnlinkedCards":
+        return cls(
+            cards=[
+                FetchResultCard.from_dict(card)
+                for card in data.get("cards", [])
+            ],
+        )
+
+
+# 对应 Rust 中的 FetchResult 枚举
+FetchResultType = Union[FetchResultEvent, FetchResultUnlinkedCards]
+
+
+class FetchResult:
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any]) -> FetchResultType:
+        tag = data.get("type")
+        content = data.get("data", {})
+
+        if tag == "Event":
+            return FetchResultEvent.from_dict(content)
+        elif tag == "UnlinkedCard":
+            return FetchResultUnlinkedCards.from_dict(content)
+        else:
+            raise ValueError(f"Unknown FetchResult type: {tag}")
+
+
+@dataclass
+class ApiResultSuccess(Generic[T]):
+    data: T
+
+    @staticmethod
+    def is_ok() -> bool:
+        return True
+
+    @staticmethod
+    def is_err() -> bool:
+        return False
+
+    def unwrap(self) -> T:
+        return self.data
+
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any], parser: Callable[[Any], T] | None = None) -> "ApiResultSuccess[T]":
+        data = parser(data) if parser else data
+        return cls(data=data)
+
+
+@dataclass
+class ApiResultError(Generic[T]):
+    error: str
+
+    @staticmethod
+    def is_ok() -> bool:
+        return False
+
+    @staticmethod
+    def is_err() -> bool:
+        return True
+
+    def unwrap(self) -> T:
+        raise Exception(f"ApiResultError: {self.error}")
+
+    @classmethod
+    def from_dict(cls, data: str) -> "ApiResultError[T]":
+        return cls(error=data)
+
+
+class ApiResult(Generic[T]):
+    @classmethod
+    def from_dict(cls, data: Dict[str, Any], parser: Callable[[Any], T] | None = None) -> ApiResultSuccess[T] | \
+                                                                                          ApiResultError[T]:
+        tag = data.get("type")
+        content = data.get("data", {})
+
+        if tag == "Ok":
+            return ApiResultSuccess.from_dict(content, parser=parser)
+        elif tag == "Err":
+            return ApiResultError.from_dict(content)
+        else:
+            raise ValueError(f"Unknown ApiResult type: {tag}")
+
+
 class SekaiSyncLib:
     def __init__(self):
         self.lib = ctypes.CDLL(os.path.join(os.path.dirname(__file__), get_lib_filename("sekai_sync_lib")))
@@ -79,6 +172,9 @@ class SekaiSyncLib:
         self.lib.fetch_data.argtypes = []
         self.lib.fetch_data.restype = ctypes.c_void_p
 
+        self.lib.refetch_event.argtypes = []
+        self.lib.refetch_event.restype = ctypes.c_void_p
+
         # free_string(s: *mut c_char)
         self.lib.free_string.argtypes = [ctypes.c_void_p]
         self.lib.free_string.restype = None
@@ -122,7 +218,7 @@ class SekaiSyncLib:
         """
         return self.lib.stop()
 
-    def fetch_data(self) -> Optional[FetchResult]:
+    def fetch_data(self) -> None | list[FetchResultEvent | FetchResultUnlinkedCards]:
         # 1. 获取裸指针
         ptr = self.lib.fetch_data()
 
@@ -138,7 +234,26 @@ class SekaiSyncLib:
 
             # 3. 解码并反序列化 JSON
             json_str = json_bytes.decode('utf-8')
-            return FetchResult.from_dict(json.loads(json_str))
+            lst = json.loads(json_str)
+            return [FetchResult.from_dict(item) for item in lst]
+
+        finally:
+            # 4. 无论是否发生 JSON 解析异常，绝对保证释放 Rust 内存！
+            self.lib.free_string(ptr)
+
+    def refetch_event(self) -> ApiResultSuccess[FetchResultEvent] | ApiResultError[FetchResultEvent]:
+        # 1. 获取裸指针
+        ptr = self.lib.refetch_event()
+
+        try:
+            # 2. 将 void_p 转换回 c_char_p 并读取里面的 bytes
+            json_bytes = ctypes.cast(ptr, ctypes.c_char_p).value
+            if not json_bytes:
+                return ApiResultError(error="调用失败")
+
+            # 3. 解码并反序列化 JSON
+            json_str = json_bytes.decode('utf-8')
+            return ApiResult.from_dict(json.loads(json_str), parser=FetchResultEvent.from_dict)
 
         finally:
             # 4. 无论是否发生 JSON 解析异常，绝对保证释放 Rust 内存！