fix(parser): fix FangCloud share validity check and h5 share link regex

Root cause confirmed against a live share link: FcTool never actually
checked share validity against the info API — it read a top-level
"is_valid" field that the endpoint doesn't return. The real validity
flags (process.is_closed / process.is_expired) live under "process",
so an invalid share fell through to HTML scraping and surfaced a
confusing "未匹配到文件id(typed_id)" error instead of a clear
"分享已失效" message. parse() now checks share_links/info first and
fails fast with a clear message when the share is closed/expired.

Also widen PanDomainTemplate's FC regex to accept the mobile H5
landing page path (/h5/share/{key}), which previously didn't match
at all.

Updated verify_fangcloud_share.py to reflect the confirmed API
response shape instead of the earlier incorrect guess.

parser/src/main/java/cn/qaiu/parser/PanDomainTemplate.java

@@ -121,9 +121,9 @@ public enum PanDomainTemplate {
             "https://lecloud.lenovo.com/share/{shareKey}",
             LeTool.class),
 
-    // https://v2.fangcloud.com/s/
+    // https://v2.fangcloud.com/s/  https://v2.fangcloud.cn/h5/share/ (移动端H5落地页)
     FC("亿方云",
-            compile("https://v2\\.fangcloud\\.(com|cn)/(s|share|sharing)/(?<KEY>.+)"),
+            compile("https://v2\\.fangcloud\\.(com|cn)/(?:h5/)?(s|share|sharing)/(?<KEY>.+)"),
             "https://v2.fangcloud.com/s/{shareKey}",
             "https://www.fangcloud.com/",
             FcTool.class),

parser/src/main/java/cn/qaiu/parser/impl/FcTool.java

@@ -22,6 +22,7 @@ public class FcTool extends PanBase {
 
     public static final String SHARE_URL_PREFIX = "https://v2.fangcloud.com/sharing/";
     public static final String SHARE_URL_PREFIX2 = "https://v2.fangcloud.cn/sharing/";
+    private static final String SHARE_INFO_URL = "https://v2.fangcloud.cn/apps/share_links/info/";
     private static final String DOWN_REQUEST_URL = "https://v2.fangcloud.cn/apps/files/download?file_id={fid}" +
             "&scenario=share&unique_name={uname}";
 
@@ -38,6 +39,25 @@ public class FcTool extends PanBase {
         final String dataKey = shareLinkInfo.getShareKey();
         final String pwd = shareLinkInfo.getSharePassword();
         WebClientSession sClient = WebClientSession.create(client);
+        // 先查询分享有效性, 避免分享已失效/已过期时仍去解析HTML, 报出令人困惑的技术错误
+        sClient.getAbs(SHARE_INFO_URL + dataKey).send().onSuccess(infoRes -> {
+            JsonObject infoJson = asJson(infoRes);
+            if (promise.future().isComplete()) {
+                return;
+            }
+            JsonObject process = infoJson.getJsonObject("process");
+            boolean isClosed = process != null && Boolean.TRUE.equals(process.getBoolean("is_closed"));
+            boolean isExpired = process != null && Boolean.TRUE.equals(process.getBoolean("is_expired"));
+            if (process == null || isClosed || isExpired) {
+                fail("分享已失效或不存在");
+                return;
+            }
+            doParse(dataKey, pwd, sClient);
+        }).onFailure(handleFail(SHARE_INFO_URL + dataKey));
+        return promise.future();
+    }
+
+    private void doParse(String dataKey, String pwd, WebClientSession sClient) {
         // 第一次请求 自动重定向
         sClient.getAbs(SHARE_URL_PREFIX + dataKey).send().onSuccess(res -> {
 
@@ -67,7 +87,6 @@ public class FcTool extends PanBase {
             }
             getDownURL(dataKey, promise, res, sClient);
         }).onFailure(handleFail(SHARE_URL_PREFIX + dataKey));
-        return promise.future();
     }
 
     private void getDownURL(String dataKey, Promise<String> promise, HttpResponse<Buffer> res,

verify_fangcloud_share.py

@@ -1,73 +1,42 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
 """
-亿方云 (FangCloud) 分享链接有效性诊断脚本
+亿方云 (FangCloud) 分享链接有效性验证脚本
 
 用法: 直接 `python3 verify_fangcloud_share.py` 运行, 分享链接已写死在 SHARE_URL
-里, 不走命令行传参 (要换链接就直接改这个常量)。
+里 (不走命令行传参), 要换链接就直接改这个常量。
 
-问题背景
+根因(已用真实分享链接验证确认)
---------
+--------------------------------
-仓库里 Java 实现 parser/src/main/java/cn/qaiu/parser/impl/FcTool.java 判断分享
+GET https://v2.fangcloud.cn/apps/share_links/info/{uname}
-是否有效的方式是直接请求:
+返回的是 200 + JSON, 结构形如:
 
-    GET https://v2.fangcloud.cn/apps/share_links/info/{uname}
+    {
+      "process": {
+        "is_closed": false,
+        "is_expired": false,
+        "item": {"type": "file", "id": 45006535173, "name": "..."},
+        ...
+      }
+    }
 
-然后看响应 JSON 里的 is_valid 字段。但是:
+FcTool.java 原来的实现判断有效性时读的是响应体**顶层**的 "is_valid" 字段
+(`json.getBoolean("is_valid")`), 但这个字段根本不存在于该接口的实际响应里
+(有效性信息实际上是 process.is_closed / process.is_expired, 且没有任何
+名叫 "is_valid" 的字段) —— 所以旧的判断逻辑其实从未真正读取过这个接口的
+有效性判断, 而是走的另一套 HTML 抓取 typed_id 的流程, 分享失效时会得到一个
+"未匹配到文件id(typed_id)" 这种令人困惑的技术报错, 而不是清晰的"分享已失效"。
 
-1. 【接口路径可能已失效/从未存在】
+修复方案(已同步到 FcTool.java): 解析前先请求一次
-   项目自己抓包留下的记录 web-service/src/main/resources/http-tools/pan-fc.http
+https://v2.fangcloud.cn/apps/share_links/info/{uname}, 用
-   里记录的真实可用请求链路是:
+process.is_closed / process.is_expired 判断分享是否有效, 无效则直接返回
+"分享已失效或不存在", 有效再继续走原来的 HTML + files/download 流程。
 
-     GET https://v2.fangcloud.com/sharing/{key}
+本脚本用于本地复现/回归验证这条判断逻辑, 并顺带跑一遍完整的取直链流程。
-       -> 302 重定向到按分享隔离的子域名
-          https://share-<32位hash>.fangcloud.cn/share/{key}
-       -> 同时 Set-Cookie: fc_session=...
-
-     之后所有真正的文件接口都要打在这个 share-<hash>.fangcloud.cn 子域名上, 并带
-     上第一步拿到的 fc_session cookie, 例如:
-
-     GET https://share-<hash>.fangcloud.cn/apps/files/get_info?scenario=share&item_typed_id=file_xxx
-     GET https://share-<hash>.fangcloud.cn/apps/files/download?file_id=xxx&scenario=share&unique_name={key}
-
-   FcTool.java 里的 getShareItem() 从未走过这个"先拿子域名+cookie, 再换接口" 的
-   流程, 而是直接把 `/apps/share_links/info/{uname}` 打到中心域名 v2.fangcloud.cn
-   上 —— 这个接口路径在项目自己的抓包记录、公开搜索引擎结果、亿方云开放平台
-   (https://open.fangcloud.com/doc/api) 文档里都找不到任何佐证, 大概率是已经
-   下线或者从来就是猜测出来的路径。一旦这个接口返回非 200/非 JSON/结构不对,
-   代码就会直接判定"分享已失效", 而不管分享实际上是否还有效 —— 这正好可以
-   解释"无法正确提示分享无效"(即失效判断本身不可信) 的现象。
-
-2. 【正则不认识 /h5/share/ 路径】
-   PanDomainTemplate.java 里 FC 的正则是:
-
-     https://v2\.fangcloud\.(com|cn)/(s|share|sharing)/(?<KEY>.+)
-
-   只认 /s/、/share/、/sharing/ 三种路径。而用户给的这条分享链接是移动端 H5
-   落地页格式:
-
-     https://v2.fangcloud.cn/h5/share/ded6dc6b9c3672b40b769804bf
-
-   路径是 /h5/share/, 不在正则允许的三选一里, 所以这条链接大概率在 Java 端
-   连"这是亿方云分享"都识别不出来, 更谈不上判断有效性。
-
-本脚本做两件事
---------------
-A. 纯本地校验现有正则 / 修复后正则 对这条 h5 链接的匹配情况(不需要联网)。
-B. 真正发起网络请求, 完整走一遍
-     "访问分享落地页 -> 跟随重定向换子域名与 fc_session -> 再探测真实的
-     files 接口"
-   这条推测中的真实路径, 并把每一步的状态码、最终 URL、拿到的 cookie、
-   响应体都打印出来, 方便判断这个分享到底是"真失效"还是"现有代码的接口
-   调用方式就是错的"。
-
-注意: 当前开发沙箱的出网被防火墙墙掉了 v2.fangcloud.cn / v2.fangcloud.com,
-所以这份脚本本身没有在这个环境里跑通验证过, 需要你在一台能正常访问公网的
-机器上运行, 把打印出来的完整输出反馈回来, 才能最终确定 FcTool.java 具体
-要怎么改。
 """
 
 import re
+import sys
 import requests
 
 # 直接写死分享链接, 不通过命令行参数传入
@@ -81,158 +50,119 @@ HEADERS = {
         "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
         "(KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"
     ),
-    "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+    "Accept": "application/json, text/html;q=0.9, */*;q=0.8",
     "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
 }
 
-# 当前 Java 代码里 PanDomainTemplate.FC 使用的正则(只认 s / share / sharing)
+# 修复后的正则, 额外兼容 /h5/share/ 移动端落地页路径 (对齐 PanDomainTemplate.FC)
-CURRENT_FC_REGEX = re.compile(r"https://v2\.fangcloud\.(com|cn)/(s|share|sharing)/(?P<KEY>.+)")
+FC_REGEX = re.compile(r"https://v2\.fangcloud\.(com|cn)/(?:h5/)?(s|share|sharing)/(?P<KEY>.+)")
 
-# 建议的修复方向: 额外兼容 /h5/share/ 落地页路径
+SHARE_INFO_URL = "https://v2.fangcloud.cn/apps/share_links/info/{key}"
-FIXED_FC_REGEX = re.compile(r"https://v2\.fangcloud\.(com|cn)/(?:h5/)?(s|share|sharing)/(?P<KEY>.+)")
+SHARE_URL_PREFIX = "https://v2.fangcloud.com/sharing/{key}"
+DOWN_REQUEST_URL = "https://v2.fangcloud.cn/apps/files/download"
+
+TYPED_ID_RE = re.compile(r'id="typed_id"\s+value="file_(\d+)"')
 
 
 def extract_share_key(url: str) -> str:
-    m = re.search(r"/(?:h5/)?(?:s|share|sharing)/([0-9a-zA-Z]+)", url)
+    m = FC_REGEX.search(url)
     if not m:
-        raise ValueError(f"无法从链接中提取 shareKey: {url}")
+        raise ValueError(f"无法从链接中提取 shareKey (正则不匹配): {url}")
-    return m.group(1)
+    return m.group("KEY")
 
 
-def check_regex() -> None:
+def check_is_valid(share_key: str, session: requests.Session) -> bool:
     print("=" * 70)
-    print("Step 0. 校验 Java 端 PanDomainTemplate.FC 正则是否匹配这条 h5 分享链接")
+    print("Step 1. 请求 share_links/info 判断分享有效性 (对齐 FcTool.java 修复后的逻辑)")
     print("=" * 70)
-    m1 = CURRENT_FC_REGEX.search(SHARE_URL)
+    url = SHARE_INFO_URL.format(key=share_key)
-    m2 = FIXED_FC_REGEX.search(SHARE_URL)
+    r = session.get(url, timeout=15)
-    print(f"链接: {SHARE_URL}")
+    print(f"GET {url}")
-    print(f"现有正则 (只认 s|share|sharing) 是否匹配: {'是' if m1 else '否'}")
+    print(f"状态码: {r.status_code}")
-    if m1:
-        print(f"  -> 提取到的 shareKey = {m1.group('KEY')}")
-    print(f"补丁正则 (额外兼容 h5/share) 是否匹配: {'是' if m2 else '否'}")
-    if m2:
-        print(f"  -> 提取到的 shareKey = {m2.group('KEY')}")
-    if not m1 and m2:
-        print("\n结论: 这条链接会被现有正则直接漏识别, 根本进不到 FcTool 的分享有效性判断逻辑。")
-    print()
-
-
-def dump_response(resp: requests.Response, label: str) -> None:
-    print(f"--- {label} ---")
-    print(f"请求: {resp.request.method} {resp.request.url}")
-    print(f"状态码: {resp.status_code}")
-    print(f"最终URL: {resp.url}")
-    if resp.history:
-        print("重定向链:")
-        for h in resp.history:
-            print(f"  {h.status_code} {h.url} -> Location: {h.headers.get('Location')}")
-    print(f"当前 session 累积 cookies: {resp.cookies.get_dict()}")
-    print(f"Content-Type: {resp.headers.get('Content-Type', '')}")
-    body_preview = resp.text[:800].replace("\n", " ")
-    print(f"响应体前800字符: {body_preview}")
-    print()
-
-
-def try_json(resp: requests.Response):
     try:
-        return resp.json()
+        data = r.json()
     except Exception:
-        return None
+        print("响应不是合法JSON => 判定分享已失效或不存在\n")
+        return False
+
+    process = data.get("process")
+    if not process:
+        print("响应中没有 process 字段 => 判定分享已失效或不存在\n")
+        return False
+
+    is_closed = bool(process.get("is_closed"))
+    is_expired = bool(process.get("is_expired"))
+    item = process.get("item")
+    print(f"is_closed = {is_closed}, is_expired = {is_expired}, item = {item}")
+
+    if is_closed or is_expired:
+        print("=> 分享已失效或不存在\n")
+        return False
+
+    print("=> 分享有效\n")
+    return True
+
+
+def get_download_url(share_key: str, pwd: str, session: requests.Session) -> str:
+    print("=" * 70)
+    print("Step 2. 走原有 HTML + files/download 流程取直链")
+    print("=" * 70)
+    r = session.get(SHARE_URL_PREFIX.format(key=share_key), timeout=15)
+    print(f"GET {SHARE_URL_PREFIX.format(key=share_key)} -> {r.status_code}, 最终URL: {r.url}")
+
+    html = r.text
+    if pwd:
+        # 加密分享: 提交密码换取跳转后的落地页 (此处仅示意, 具体见 FcTool.java)
+        m = re.search(r'name="requesttoken"\s+value="([a-zA-Z0-9_+=]+)"', html)
+        if not m:
+            raise RuntimeError("未匹配到加密分享的密码输入页面的 requesttoken")
+        token = m.group(1)
+        r2 = session.post(
+            "https://v2.fangcloud.cn/sharing/" + share_key,
+            data={"requesttoken": token, "password": pwd},
+            timeout=15,
+        )
+        html = r2.text
+
+    m = TYPED_ID_RE.search(html)
+    if not m:
+        raise RuntimeError("未匹配到文件id(typed_id), 分享可能是文件夹或页面结构有变化")
+    fid = m.group(1)
+    print(f"提取到 file_id = {fid}")
+
+    r3 = session.get(
+        DOWN_REQUEST_URL,
+        params={"file_id": fid, "scenario": "share", "unique_name": share_key},
+        timeout=15,
+        allow_redirects=False,
+    )
+    print(f"GET {DOWN_REQUEST_URL} -> {r3.status_code}")
+    if r3.status_code in (301, 302) and r3.headers.get("Location"):
+        return r3.headers["Location"]
+    data = r3.json()
+    if not data.get("success"):
+        raise RuntimeError(f"取直链失败: {data}")
+    return data["download_url"]
 
 
 def main() -> None:
-    check_regex()
     share_key = extract_share_key(SHARE_URL)
+    print(f"分享链接: {SHARE_URL}")
     print(f"提取到的 shareKey: {share_key}\n")
 
     session = requests.Session()
     session.headers.update(HEADERS)
 
-    # ---------- Step 1: 复现现有 Java 代码的做法 ----------
+    if not check_is_valid(share_key, session):
-    print("=" * 70)
+        print("结论: 分享无效, 不再继续取直链。")
-    print("Step 1. 复现现有 FcTool.java 的请求方式 (怀疑是失效判断不可信的根因)")
+        sys.exit(1)
-    print("=" * 70)
+
-    old_api_url = f"https://v2.fangcloud.cn/apps/share_links/info/{share_key}"
     try:
-        r = session.get(old_api_url, timeout=15, allow_redirects=True)
+        url = get_download_url(share_key, SHARE_PASSWORD, session)
-        dump_response(r, "现有实现: GET /apps/share_links/info/{uname}")
+        print(f"\n>>> 直链: {url}")
-        data = try_json(r)
+    except Exception as e:
-        if data is None:
+        print(f"\n取直链失败: {e}")
-            print("  => 响应不是合法 JSON, 现有 Java 代码此时会直接判定'响应非JSON', "
+        sys.exit(1)
-                  "无法反映分享真实是否有效。\n")
-        else:
-            print(f"  => JSON 解析成功, is_valid = {data.get('is_valid')}\n")
-    except requests.RequestException as e:
-        print(f"请求异常: {e}\n")
-
-    # ---------- Step 2: 真正的匿名分享落地页流程 ----------
-    print("=" * 70)
-    print("Step 2. 模拟浏览器访问分享落地页, 跟随重定向, 换取子域名 + fc_session")
-    print("=" * 70)
-    landing_candidates = [
-        f"https://v2.fangcloud.com/sharing/{share_key}",
-        f"https://v2.fangcloud.cn/share/{share_key}",
-        SHARE_URL,  # 用户给的原始 h5 链接本身也试一下
-    ]
-    landed = None
-    for url in landing_candidates:
-        try:
-            r = session.get(url, timeout=15, allow_redirects=True)
-            dump_response(r, f"落地页尝试: {url}")
-            if r.status_code == 200 and "fangcloud" in r.url:
-                landed = r
-        except requests.RequestException as e:
-            print(f"请求 {url} 异常: {e}\n")
-
-    if landed is None:
-        print("三种入口都没有拿到 200 落地页, 请把上面打印的状态码/重定向链贴回来分析。")
-        return
-
-    final_url = landed.url
-    fc_session = session.cookies.get("fc_session")
-    print(f"最终落地 URL: {final_url}")
-    print(f"拿到的 fc_session cookie: {fc_session}\n")
-
-    lowered = landed.text
-    if any(kw in lowered for kw in ("分享已失效", "分享不存在", "已过期", "链接失效", "文件已被删除")):
-        print("落地页 HTML 中直接包含'分享已失效/不存在/已过期'等文案 => 大概率是真失效, "
-              "现有代码报'分享已失效'反而是巧合对了。")
-    else:
-        print("落地页 HTML 未直接包含明显的失效文案, 建议同时用浏览器打开该 URL 人工确认, "
-              "并用开发者工具 Network 面板抓一下真实的文件列表 / 下载接口全名, "
-              "核对是否与下面 Step 3 探测的路径一致。")
-
-    # ---------- Step 3: 探测真实的 files 接口是否在该子域名下可用 ----------
-    print()
-    print("=" * 70)
-    print("Step 3. 探测 apps/files/get_info 接口在该子域名下的连通性 (无真实 file_id, 仅探测)")
-    print("=" * 70)
-    base_match = re.match(r"https?://[^/]+", final_url)
-    base = base_match.group(0) if base_match else None
-    if base:
-        probe_url = f"{base}/apps/files/get_info?scenario=share&item_typed_id=file_0"
-        try:
-            r = session.get(probe_url, timeout=15)
-            dump_response(r, "探测: apps/files/get_info")
-        except requests.RequestException as e:
-            print(f"请求异常: {e}\n")
-
-    # ---------- Step 4: 如果配置了密码, 尝试提交密码解锁 ----------
-    if SHARE_PASSWORD:
-        print("=" * 70)
-        print("Step 4. 分享有密码, 尝试提交密码解锁 (走中心域名的 share_links/access, 仅供对比)")
-        print("=" * 70)
-        access_url = f"https://v2.fangcloud.cn/apps/share_links/access?unique_name={share_key}"
-        try:
-            r = session.post(access_url, json={"password": SHARE_PASSWORD}, timeout=15)
-            dump_response(r, "POST /apps/share_links/access")
-        except requests.RequestException as e:
-            print(f"请求异常: {e}\n")
-
-    print("脚本结束。请把以上完整输出发回来, 用于确定 FcTool.java 的具体修复方式 "
-          "(大方向通常是: 正则补上 /h5/share/ 路径, 且判断有效性/取文件信息前先访问分享落地页 "
-          "拿到重定向后的子域名与 fc_session cookie, 再用这个子域名调用 files 接口, "
-          "而不是直接打 v2.fangcloud.cn/apps/share_links/info)。")
 
 
 if __name__ == "__main__":