feat(p1): add daily snapshots and fan tracking

Implement P1: seven-metric view snapshots, relation/stat fan snapshots, failure placeholders, resume by daily completion markers, Cookie login warnings, daily SQLite backups, Shanghai daily scheduling, and CLI snapshot/auth-check commands. Real read-only run captured 795/795 videos successfully over 1124s with a verified daily backup.

reaction_board/bilibili/client.py

@@ -18,11 +18,21 @@ from dataclasses import dataclass
 from typing import Any, Mapping, Protocol, Sequence
 
 from .auth import make_headers
-from .models import FavId, FavResource, FolderInfo, InfosResult
+from .models import (
+    FanStat,
+    FavId,
+    FavResource,
+    FolderInfo,
+    InfosResult,
+    LoginState,
+    ViewStat,
+)
 
 BASE = "https://api.bilibili.com"
 DEFAULT_CHUNK = 200
 MAX_CHUNK = 400
+# 视频不可访问/已删除：-404 为旧口径，62002/62012 为当前实测返回。
+VIDEO_UNAVAILABLE_CODES = frozenset({-404, 62002, 62012})
 
 
 class BilibiliError(RuntimeError):
@@ -360,3 +370,64 @@ class BilibiliClient:
                 media_count=count,
             ))
         return out
+
+    # ------------------------------------------------------------ view / fan
+
+    def view(self, aid: int) -> ViewStat:
+        url = f"{BASE}/x/web-interface/view?aid={int(aid)}"
+        payload = self.get_json(url)
+        data = payload.get("data")
+        if not isinstance(data, Mapping):
+            raise BilibiliProtocolError("view data 不是对象")
+        try:
+            return ViewStat.from_api(data)
+        except (TypeError, ValueError) as exc:
+            raise BilibiliProtocolError(f"view 解析失败: {exc}") from exc
+
+    def relation_stat(self, mid: int) -> FanStat:
+        url = f"{BASE}/x/relation/stat?vmid={int(mid)}"
+        payload = self.get_json(url)
+        data = payload.get("data")
+        if not isinstance(data, Mapping):
+            raise BilibiliProtocolError("relation/stat data 不是对象")
+        try:
+            return FanStat.from_api(data)
+        except (TypeError, ValueError) as exc:
+            raise BilibiliProtocolError(f"relation/stat 解析失败: {exc}") from exc
+
+    def check_login(self) -> LoginState:
+        """检查 Cookie 登录态；未配置 Cookie 时不发请求。"""
+        if not self.cookie:
+            return LoginState(
+                is_login=False,
+                mid=None,
+                uname=None,
+                code=0,
+                message="未配置 cookie",
+            )
+        url = f"{BASE}/x/web-interface/nav"
+        try:
+            payload = self.get_json(url, auth=True)
+        except BilibiliAPIError as exc:
+            return LoginState(
+                is_login=False, mid=None, uname=None,
+                code=exc.code, message=exc.message,
+            )
+        except BilibiliError as exc:
+            return LoginState(
+                is_login=False, mid=None, uname=None,
+                code=-1, message=str(exc),
+            )
+        data = payload.get("data") or {}
+        if not isinstance(data, Mapping):
+            raise BilibiliProtocolError("nav data 不是对象")
+        raw_mid = data.get("mid")
+        mid = raw_mid if isinstance(raw_mid, int) and not isinstance(raw_mid, bool) else None
+        uname = data.get("uname")
+        return LoginState(
+            is_login=bool(data.get("isLogin")),
+            mid=mid,
+            uname=str(uname) if isinstance(uname, str) else None,
+            code=0,
+            message=str(payload.get("message") or ""),
+        )