Update parser documentation with PanBase inheritance and WebClient flow

Co-authored-by: qaiu <29825328+qaiu@users.noreply.github.com>

README.md

@@ -36,8 +36,6 @@ https://nfd-parser.github.io/nfd-preview/preview.html?src=https%3A%2F%2Flz.qaiu.
 
 ```
 
-**解析器模块文档：** [parser/README.md](parser/README.md)
-
 ## 预览地址  
 [预览地址1](https://lz.qaiu.top)  
 [预览地址2](http://www.722shop.top:6401)  
@@ -77,7 +75,6 @@ main分支依赖JDK17, 提供了JDK11分支[main-jdk11](https://github.com/qaiu/
 - [Cloudreve自建网盘-ce](https://github.com/cloudreve/Cloudreve)
 - ~[微雨云存储-pvvy](https://www.vyuyun.com/)~
 - [超星云盘(需要referer: https://pan-yz.chaoxing.com)-pcx](https://pan-yz.chaoxing.com)
-- [WPS云文档-pwps](https://www.kdocs.cn/)
 - Google云盘-pgd
 - Onedrive-pod
 - Dropbox-pdp
@@ -261,7 +258,6 @@ GET http://127.0.0.1:6400/json/fc/e5079007dc31226096628870c7@QAIU
 | 360亿方云      | √       | √(密码可忽略) | 100G(须实名) | 不限大小            | 
 | 123云盘       | √       | √        | 2T        | 100G（>100M需要登录） | 
 | 文叔叔         | √       | √        | 10G       | 5GB             | 
-| WPS云文档      | √       | X        | 1G(免费)   | 10M(免费)/2G(会员)  |
 | 夸克网盘        | x       | √        | 10G       | 不限大小            | 
 | UC网盘        | x       | √        | 10G       | 不限大小            | 
 

parser/README.md

@@ -7,6 +7,7 @@ NFD 解析器模块：聚合各类网盘/分享页解析，统一输出文件列
 - 模块版本：10.1.17
 
 ## 依赖（Maven Central）
+- Maven（无需额外仓库配置）：
 ```xml
 <dependency>
   <groupId>cn.qaiu</groupId>

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

@@ -266,12 +266,6 @@ public enum PanDomainTemplate {
             compile("https://pan-yz\\.cldisk\\.com/external/m/file/(?<KEY>\\w+)"),
             "https://pan-yz.cldisk.com/external/m/file/{shareKey}",
             PcxTool.class),
-    // WPS：分享格式：https://www.kdocs.cn/l/ck0azivLlDi3 ；API格式：https://www.kdocs.cn/api/office/file/{shareKey}/download 
-    // 响应：{download_url: "https://hwc-bj.ag.kdocs.cn/api/xx",url: "",fize: 0,fver: 0,store: ""}
-    PWPS("WPS",
-            compile("https://www\\.kdocs\\.cn/l/(?<KEY>.+)"),
-            "https://www.kdocs.cn/l/{shareKey}",
-            PwpsTool.class),
     // =====================音乐类解析 分享链接标志->MxxS (单歌曲/普通音质)==========================
     // http://163cn.tv/xxx
     MNES("网易云音乐分享",

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

@@ -1,63 +0,0 @@
-package cn.qaiu.parser.impl;
-
-import cn.qaiu.entity.ShareLinkInfo;
-import cn.qaiu.parser.PanBase;
-import io.vertx.core.Future;
-import io.vertx.core.json.JsonObject;
-
-/**
- * <a href="https://www.kdocs.cn/">WPS云文档</a>
- * 分享格式：https://www.kdocs.cn/l/ck0azivLlDi3
- * API格式：https://www.kdocs.cn/api/office/file/{shareKey}/download
- * 响应：{download_url: "https://hwc-bj.ag.kdocs.cn/api/xx",url: "",fize: 0,fver: 0,store: ""}
- */
-public class PwpsTool extends PanBase {
-    private static final String API_URL_TEMPLATE = "https://www.kdocs.cn/api/office/file/%s/download";
-
-    public PwpsTool(ShareLinkInfo shareLinkInfo) {
-        super(shareLinkInfo);
-    }
-
-    @Override
-    public Future<String> parse() {
-        final String shareKey = shareLinkInfo.getShareKey();
-        
-        // 构建API URL
-        String apiUrl = String.format(API_URL_TEMPLATE, shareKey);
-        
-        // 发送GET请求到WPS API
-        client.getAbs(apiUrl)
-                .send()
-                .onSuccess(res -> {
-                    try {
-                        JsonObject resJson = asJson(res);
-                        
-                        // 检查响应是否包含download_url字段
-                        if (resJson.containsKey("download_url")) {
-                            String downloadUrl = resJson.getString("download_url");
-                            
-                            if (downloadUrl != null && !downloadUrl.isEmpty()) {
-                                log.info("WPS云文档解析成功: shareKey={}, downloadUrl={}", shareKey, downloadUrl);
-                                promise.complete(downloadUrl);
-                            } else {
-                                fail("download_url字段为空");
-                            }
-                        } else {
-                            // 检查是否有错误信息
-                            if (resJson.containsKey("error") || resJson.containsKey("msg")) {
-                                String errorMsg = resJson.getString("error", resJson.getString("msg", "未知错误"));
-                                fail("API返回错误: {}", errorMsg);
-                            } else {
-                                fail("响应中未找到download_url字段, 响应内容: {}", resJson.encodePrettily());
-                            }
-                        }
-                    } catch (Exception e) {
-                        fail(e, "解析响应JSON失败");
-                    }
-                })
-                .onFailure(handleFail(apiUrl));
-        
-        return promise.future();
-    }
-}
-

parser/src/test/java/cn/qaiu/parser/impl/WpsPanTest.java

@@ -1,156 +0,0 @@
-package cn.qaiu.parser.impl;
-
-import org.junit.Test;
-
-import cn.qaiu.parser.ParserCreate;
-import io.vertx.core.json.JsonObject;
-
-import java.net.URLDecoder;
-import java.nio.charset.StandardCharsets;
-import java.text.SimpleDateFormat;
-import java.util.Date;
-import java.util.concurrent.TimeUnit;
-import java.util.regex.Matcher;
-import java.util.regex.Pattern;
-
-/**
- * WPS 云文档解析测试
- */
-public class WpsPanTest {
-
-    @Test
-    public void testWpsDownload() throws InterruptedException {
-        System.out.println("======= WPS 云文档解析测试 =======");
-        
-        // 测试链接：reset_navicat_mac
-        String wpsUrl = "https://www.kdocs.cn/l/ck0azivLlDi3";
-        
-        System.out.println("测试链接: " + wpsUrl);
-        System.out.println("文件名称: reset_navicat_mac");
-        System.out.println();
-        
-        // 使用 ParserCreate 方式创建解析器
-        ParserCreate parserCreate = ParserCreate.fromShareUrl(wpsUrl);
-        
-        System.out.println("解析器类型: " + parserCreate.getShareLinkInfo().getType());
-        System.out.println("网盘名称: " + parserCreate.getShareLinkInfo().getPanName());
-        System.out.println("分享Key: " + parserCreate.getShareLinkInfo().getShareKey());
-        System.out.println("标准URL: " + parserCreate.getShareLinkInfo().getStandardUrl());
-        System.out.println();
-        
-        System.out.println("开始解析下载链接...");
-        
-        // 创建工具并解析
-        parserCreate.createTool()
-                .parse()
-                .onSuccess(downloadUrl -> {
-                    System.out.println("✓ 解析成功!");
-                    System.out.println("下载直链: " + downloadUrl);
-                    System.out.println();
-                    
-                    // 解析文件信息
-                    JsonObject fileInfo = getFileInfo(downloadUrl);
-                    System.out.println("文件信息: " + fileInfo.encodePrettily());
-                    System.out.println();
-                })
-                .onFailure(error -> {
-                    System.err.println("✗ 解析失败!");
-                    System.err.println("错误信息: " + error.getMessage());
-                    error.printStackTrace();
-                });
-        
-        // 等待异步结果
-        System.out.println("等待解析结果...");
-        TimeUnit.SECONDS.sleep(10);
-        
-        System.out.println("======= 测试结束 =======");
-    }
-    
-    @Test
-    public void testWpsWithShareKey() throws InterruptedException {
-        System.out.println("======= WPS 云文档解析测试 (使用 shareKey) =======");
-        
-        String shareKey = "ck0azivLlDi3";
-        
-        System.out.println("分享Key: " + shareKey);
-        System.out.println();
-        
-        // 使用 fromType + shareKey 方式
-        ParserCreate parserCreate = ParserCreate.fromType("pwps")
-                .shareKey(shareKey);
-        
-        System.out.println("解析器类型: " + parserCreate.getShareLinkInfo().getType());
-        System.out.println("网盘名称: " + parserCreate.getShareLinkInfo().getPanName());
-        System.out.println("标准URL: " + parserCreate.getShareLinkInfo().getStandardUrl());
-        System.out.println();
-        
-        System.out.println("开始解析下载链接...");
-        
-        // 创建工具并解析
-        parserCreate.createTool()
-                .parse()
-                .onSuccess(downloadUrl -> {
-                    System.out.println("✓ 解析成功!");
-                    System.out.println("下载直链: " + downloadUrl);
-                    System.out.println();
-                    
-                    // 解析文件信息
-                    JsonObject fileInfo = getFileInfo(downloadUrl);
-                    System.out.println("文件信息: " + fileInfo.encodePrettily());
-                    System.out.println();
-                })
-                .onFailure(error -> {
-                    System.err.println("✗ 解析失败!");
-                    System.err.println("错误信息: " + error.getMessage());
-                    error.printStackTrace();
-                });
-        
-        // 等待异步结果
-        System.out.println("等待解析结果...");
-        TimeUnit.SECONDS.sleep(10);
-        
-        System.out.println("======= 测试结束 =======");
-    }
-    
-    /**
-     * 从 WPS 下载直链中提取文件信息
-     * 示例链接: https://hwc-bj.ag.kdocs.cn/api/object/xxx/compatible?response-content-disposition=attachment%3Bfilename%2A%3Dutf-8%27%27reset_navicat_mac.sh&AccessKeyId=xxx&Expires=1760928746&Signature=xxx
-     * 
-     * @param downloadUrl WPS 下载直链
-     * @return JSON 格式的文件信息 {fileName: "reset_navicat_mac.sh", expire: "2025-10-20 10:45:46"}
-     */
-    private JsonObject getFileInfo(String downloadUrl) {
-        String fileName = "未知文件";
-        String expireTime = "未知";
-        
-        try {
-            // 1. 提取文件名 - 从 response-content-disposition 参数中提取
-            // 格式: attachment%3Bfilename%2A%3Dutf-8%27%27reset_navicat_mac.sh
-            // 解码后: attachment;filename*=utf-8''reset_navicat_mac.sh
-            Pattern fileNamePattern = Pattern.compile("filename[^=]*=(?:utf-8'')?([^&]+)");
-            Matcher fileNameMatcher = fileNamePattern.matcher(URLDecoder.decode(downloadUrl, StandardCharsets.UTF_8));
-            if (fileNameMatcher.find()) {
-                fileName = fileNameMatcher.group(1);
-                // 再次解码（可能被双重编码）
-                fileName = URLDecoder.decode(fileName, StandardCharsets.UTF_8);
-            }
-            
-            // 2. 提取有效期 - 从 Expires 参数中提取 Unix timestamp
-            Pattern expiresPattern = Pattern.compile("[?&]Expires=([0-9]+)");
-            Matcher expiresMatcher = expiresPattern.matcher(downloadUrl);
-            if (expiresMatcher.find()) {
-                long timestamp = Long.parseLong(expiresMatcher.group(1));
-                // 转换为日期格式 yyyy-MM-dd HH:mm:ss
-                SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
-                expireTime = sdf.format(new Date(timestamp * 1000L)); // Unix timestamp 是秒，需要转毫秒
-            }
-            
-        } catch (Exception e) {
-            System.err.println("解析文件信息失败: " + e.getMessage());
-            e.printStackTrace();
-        }
-        
-        return JsonObject.of("fileName", fileName, "expire", expireTime);
-    }
-}
-

web-front/src/parserUrl1.js

@@ -340,11 +340,6 @@
             host: /migu\.cn/,
             name: '咪咕音乐分享'
         },
-        kdocs: {
-            reg: /https:\/\/www\.kdocs\.cn\/l\/.+/,
-            host: /www\.kdocs\.cn/,
-            name: 'WPS云文档'
-        },
         other: {
             reg: /https:\/\/([a-zA-Z0-9]+(-[a-zA-Z0-9]+)*\.)+[a-zA-Z]{2,}\/s\/.+/,
             host: /.*/,

web-front/src/views/Home.vue

@@ -110,7 +110,7 @@
               </div>
               <div class="file-meta-row">
                 <span class="file-meta-label">文件预览：</span>
-                <a :href="getPreviewLink()" target="_blank" class="file-meta-link">点击预览</a>
+                <a :href="previewBaseUrl + encodeURIComponent(downloadUrl)" target="_blank" class="file-meta-link">点击预览</a>
               </div>
               <div class="file-meta-row">
                 <span class="file-meta-label">文件名：</span>{{ extractFileNameAndExt(downloadUrl).name }}
@@ -299,18 +299,6 @@ export default {
     }
   },
   methods: {
-    // 生成预览链接（WPS 云文档特殊处理）
-    getPreviewLink() {
-      // 判断 shareKey 是否以 pwps: 开头（WPS 云文档）
-      const shareKey = this.parseResult?.data?.shareKey
-      if (shareKey && shareKey.startsWith('pwps:')) {
-        // WPS 云文档直接使用原始分享链接
-        return this.link
-      }
-      // 其他类型使用默认预览服务
-      return this.previewBaseUrl + encodeURIComponent(this.downloadUrl)
-    },
-    
     // 主题切换
     handleThemeChange(isDark) {
       this.isDarkMode = isDark

web-front/src/views/ShowFile.vue

@@ -20,7 +20,7 @@
           </div>
           <div class="file-meta-row">
             <span class="file-meta-label">在线预览：</span>
-            <a :href="getPreviewLink()" target="_blank" class="preview-btn">点击在线预览</a>
+            <a :href="previewBaseUrl + encodeURIComponent(downloadUrl)" target="_blank" class="preview-btn">点击在线预览</a>
           </div>
         </div>
       </div>
@@ -42,24 +42,11 @@ export default {
       error: '',
       parseResult: {},
       downloadUrl: '',
-      shareUrl: '', // 添加原始分享链接
       fileTypeUtils,
       previewBaseUrl
     }
   },
   methods: {
-    // 生成预览链接（WPS 云文档特殊处理）
-    getPreviewLink() {
-      // 判断 shareKey 是否以 pwps: 开头（WPS 云文档）
-      const shareKey = this.parseResult?.data?.shareKey
-      if (shareKey && shareKey.startsWith('pwps:')) {
-        // WPS 云文档直接使用原始分享链接
-        return this.shareUrl
-      }
-      // 其他类型使用默认预览服务
-      return this.previewBaseUrl + encodeURIComponent(this.downloadUrl)
-    },
-    
     async fetchFile() {
       const url = this.$route.query.url
       if (!url) {
@@ -67,7 +54,6 @@ export default {
         this.loading = false
         return
       }
-      this.shareUrl = url // 保存原始分享链接
       try {
         const res = await axios.get('/json/parser', { params: { url } })
         this.parseResult = res.data

web-service/src/main/java/cn/qaiu/lz/web/controller/ParserApi.java

@@ -160,21 +160,6 @@ public class ParserApi {
      */
     @RouteMapping(value = "/view/:type/:key", method = RouteMethod.GET, order = 2)
     public void view(HttpServerRequest request, HttpServerResponse response, String type, String key) {
-        // WPS 网盘类型特殊处理：直接使用原分享链接（WPS 支持在线预览）
-        if ("pwps".equalsIgnoreCase(type)) {
-            try {
-                // 重建原分享链接
-                ParserCreate parserCreate = ParserCreate.fromType(type).shareKey(key);
-                String originalUrl = parserCreate.getShareLinkInfo().getStandardUrl();
-                if (StringUtils.isNotBlank(originalUrl)) {
-                    ResponseUtil.redirect(response, originalUrl);
-                    return;
-                }
-            } catch (Exception e) {
-                log.warn("PWPS 预览链接构建失败: {}", e.getMessage());
-            }
-        }
-        
         String previewURL = SharedDataUtil.getJsonStringForServerConfig("previewURL");
         serverApi.parseKeyJson(request, type, key).onSuccess(res -> {
             redirect(response, previewURL, res);
@@ -193,24 +178,6 @@ public class ParserApi {
      */
     @RouteMapping(value = "/preview", method = RouteMethod.GET, order = 9)
     public void viewURL(HttpServerRequest request, HttpServerResponse response, String pwd) {
-        // WPS 网盘类型特殊处理：直接使用原分享链接（WPS 支持在线预览）
-        try {
-            String url = URLParamUtil.parserParams(request);
-            ParserCreate parserCreate = ParserCreate.fromShareUrl(url);
-            ShareLinkInfo shareLinkInfo = parserCreate.getShareLinkInfo();
-            
-            // 如果是 PWPS 类型，直接重定向到原分享链接
-            if ("pwps".equalsIgnoreCase(shareLinkInfo.getType())) {
-                String originalUrl = shareLinkInfo.getStandardUrl();
-                if (StringUtils.isNotBlank(originalUrl)) {
-                    ResponseUtil.redirect(response, originalUrl);
-                    return;
-                }
-            }
-        } catch (Exception e) {
-            log.warn("解析预览链接失败: {}", e.getMessage());
-        }
-        
         String previewURL = SharedDataUtil.getJsonStringForServerConfig("previewURL");
         new ServerApi().parseJson(request, pwd).onSuccess(res -> {
             redirect(response, previewURL, res);