fix: make HFZrs6pXKulzS cookie optional

login_helper.py

@@ -1,7 +1,7 @@
 """登录助手 — 解析浏览器导出的 cookies JSON，保存为 session.json。
 
 Cookie 白名单基于 HAR 抓包分析：
-  - pickup-web 所有业务 API 统一使用 9 个 cookie（见 _REQUIRED_COOKIE_NAMES）
+  - 必需 cookie 见 REQUIRED_COOKIE_NAMES，可选 cookie 见 OPTIONAL_COOKIE_NAMES
   - JSESSIONID 仅 portal 主页面需要（加载 pickup 页面时作为 Referer）
   - enable_HFZrs6pXKulz 仅 portal UI 配置，pickup-web 不需要
 """
@@ -13,8 +13,7 @@ import os
 import sys
 
 # 基于 portal-to-pickup-full-flow.har 分析得出的必需 cookie
-# pickup-web (/pickup-web/a/*) 所有业务 API 请求都携带这 10 个 cookie
-# 缺失任何一个都会导致请求失败
+# 导入及会话检查要求以下 9 个 cookie 齐全
 REQUIRED_COOKIE_NAMES: set[str] = {
     # 会话认证（核心 — 缺失则 401/重定向到登录页）
     "jdpt.session.id",
@@ -25,17 +24,19 @@ REQUIRED_COOKIE_NAMES: set[str] = {
     "COUNTY_GRAYLEVEL",
     "ORG_GRAYLEVEL",
     # $_ts 安全框架 token（缺失则 c93l5Fya 校验失败，接口拒绝服务）
-    "HFZrs6pXKulzS",  # 会话级 token，固定不变
     "HFZrs6pXKulzO",  # 组织级 token，固定不变
     "HFZrs6pXKulzP",  # 请求级动态 token，服务端 Set-Cookie 持续更新
     # portal 主页面会话（缺失则无法加载 pickup 页面，fetch_page_resources 失败）
     "JSESSIONID",
 }
 
+OPTIONAL_COOKIE_NAMES: set[str] = {"HFZrs6pXKulzS"}
+ALLOWED_COOKIE_NAMES: set[str] = REQUIRED_COOKIE_NAMES | OPTIONAL_COOKIE_NAMES
 
-def _is_cookie_required(name: str) -> bool:
-    """判断 cookie 是否为 pickup 流程所必需。"""
-    return name in REQUIRED_COOKIE_NAMES
+
+def _is_cookie_allowed(name: str) -> bool:
+    """判断 cookie 是否在导入和保存的白名单中。"""
+    return name in ALLOWED_COOKIE_NAMES
 
 
 def get_session_path() -> str:
@@ -47,16 +48,16 @@ def get_session_path() -> str:
 
 
 def parse_json_and_save(json_text: str) -> int:
-    """解析浏览器导出的 cookies JSON 数组，过滤并保存必需 cookie。
+    """解析浏览器导出的 cookies JSON 数组，过滤并保存白名单 cookie。
 
-    只保存 _REQUIRED_COOKIE_NAMES 白名单中的 cookie（基于 HAR 分析）。
+    只保存 ALLOWED_COOKIE_NAMES 中的 cookie，仅检查 REQUIRED_COOKIE_NAMES 是否齐全。
     返回保存的 cookie 数量。
     """
     raw = json.loads(json_text)
     if not isinstance(raw, list):
         raise ValueError("JSON 必须是数组格式")
 
-    # 过滤目标域名 + 必需 cookie 名称
+    # 过滤目标域名 + 白名单 cookie 名称
     target = "10.4.188.1"
     cookies = []
     seen = set()
@@ -69,7 +70,7 @@ def parse_json_and_save(json_text: str) -> int:
         path = c.get("path", "/")
         if not name:
             continue
-        if not _is_cookie_required(name):
+        if not _is_cookie_allowed(name):
             skipped.append(name)
             continue
         key = (name, domain, path)
@@ -83,7 +84,7 @@ def parse_json_and_save(json_text: str) -> int:
             "path": path,
         })
 
-    # 检查必需 cookie 是否齐全（全部 10 个缺一不可）
+    # 检查必需 cookie 是否齐全（全部 9 个缺一不可）
     found_names = {c["name"] for c in cookies}
     missing = REQUIRED_COOKIE_NAMES - found_names
     if missing: