- 更新版本号: 0.1.5->0.1.6

- Core: Vertx事件循环线程数调整

.devcontainer/devcontainer.json

@@ -1,28 +0,0 @@
-// For format details, see https://aka.ms/devcontainer.json. For config options, see the
-// README at: https://github.com/devcontainers/templates/tree/main/src/java
-{
-  "name": "Java",
-  // Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
-  "image": "mcr.microsoft.com/devcontainers/java:0-17",
-
-  "features": {
-    "ghcr.io/devcontainers/features/java:1": {
-      "version": "none",
-      "installMaven": "true",
-      "installGradle": "false"
-    },
-    "ghcr.io/devcontainers-contrib/features/ant-sdkman:2": {}
-  }
-
-  // Use 'forwardPorts' to make a list of ports inside the container available locally.
-  // "forwardPorts": [],
-
-  // Use 'postCreateCommand' to run commands after the container is created.
-  // "postCreateCommand": "java -version",
-
-  // Configure tool-specific properties.
-  // "customizations": {},
-
-  // Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
-  // "remoteUser": "root"
-}

.gitattributes

@@ -1,21 +0,0 @@
-# GitHub 语言检测配置
-# 设置主要语言为 Java
-*.java linguist-language=Java
-*.vue linguist-language=Vue
-*.js linguist-language=JavaScript
-
-# 排除不需要统计的文件
-target/ linguist-vendored=true
-node_modules/ linguist-vendored=true
-webroot/ linguist-vendored=true
-logs/ linguist-vendored=true
-db/ linguist-vendored=true
-
-# 文本文件使用 LF 换行符，适用于 Linux 和 macOS
-*.sh text eol=lf
-*.service text eol=lf
-
-# Windows 执行的文件使用 CRLF 换行符
-*.bat text eol=crlf
-*.cmd text eol=crlf
-bin/nfd-service-template.xml text eol=crlf

.github/FUNDING.yml

@@ -1,15 +0,0 @@
-# These are supported funding model platforms
-
-github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
-patreon: # Replace with a single Patreon username
-open_collective: # Replace with a single Open Collective username
-ko_fi: # Replace with a single Ko-fi username
-tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
-community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
-liberapay: # Replace with a single Liberapay username
-issuehunt: # Replace with a single IssueHunt username
-lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
-polar: # Replace with a single Polar username
-buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
-thanks_dev: # Replace with a single thanks.dev username
-custom: https://blog.qaiu.top/archives/da-shang-zhuan-yong # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

.github/dependabot.yml

@@ -1,17 +0,0 @@
-version: 2
-updates:
-  - package-ecosystem: "maven"
-    directory: "/"
-    open-pull-requests-limit: 10
-    ignore:
-      # 忽略通过 BOM 管理的 Vert.x 依赖
-      # 这些依赖的版本通过 vertx-dependencies BOM 统一管理
-      # 应该通过更新 pom.xml 中的 vertx.version 属性来更新这些依赖
-      - dependency-name: "io.vertx:vertx-web"
-      - dependency-name: "io.vertx:vertx-codegen"
-      - dependency-name: "io.vertx:vertx-config"
-      - dependency-name: "io.vertx:vertx-config-yaml"
-      - dependency-name: "io.vertx:vertx-service-proxy"
-      - dependency-name: "io.vertx:vertx-web-proxy"
-      - dependency-name: "io.vertx:vertx-web-client"
-

.github/workflows/build.yml

@@ -1,45 +0,0 @@
-name: 编译项目
-
-on:
-  push:
-    branches: [ main, master ]
-    paths-ignore:
-      - 'bin/**'
-      - '.github/**'
-      - '.mvn/**'
-      - '.run/**'
-      - '.vscode/**'
-      - '*.txt'
-      - '*.md'
-  pull_request:
-    branches: [ main, master ]
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    
-    steps:
-    - name: 检出代码
-      uses: actions/checkout@v4
-      
-    - name: 设置 Java 17
-      uses: actions/setup-java@v4
-      with:
-        java-version: '17'
-        distribution: 'temurin'
-        
-    - name: 缓存 Maven 依赖
-      uses: actions/cache@v3
-      with:
-        path: ~/.m2
-        key: ${{ runner.os }}-m2-${{ hashFiles('**/pom.xml') }}
-        restore-keys: ${{ runner.os }}-m2
-        
-    - name: 编译项目
-      run: ./mvnw clean compile
-      
-#    - name: 运行测试
-#      run: ./mvnw test
-      
-    - name: 打包项目
-      run: ./mvnw package -DskipTests

.github/workflows/maven.yml

@@ -1,283 +1,43 @@
-name: Java CI（Maven 构建 + Docker 镜像 + 原生环境打包）
+# This workflow will build a Java project with Maven, and cache/restore any dependencies to improve the workflow execution time
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-java-with-maven
 
+# This workflow uses actions that are not certified by GitHub.
+# They are provided by a third-party and are governed by
+# separate terms of service, privacy policy, and support
+# documentation.
+
+name: Java CI with Maven
+
+# The API requires write permission on the repository to submit dependencies
 permissions:
   contents: write
-  packages: write
 
 on:
-  workflow_dispatch:
   push:
-    tags:
-      - '*'
-    branches-ignore:
-      - '*'
-    paths-ignore:
-      - 'bin/**'
-      - '.github/**'
-      - '.mvn/**'
-      - '.run/**'
-      - '.vscode/**'
-      - '*.txt'
-      - '*.md'
+    branches: [ "main" ]
   pull_request:
-    branches:
-      - "main"
+    branches: [ "main" ]
 
 jobs:
-  # ================================================================
-  # 阶段一：构建前端 + Maven 打包（只执行一次，产物共享）
-  # ================================================================
   build:
-    name: 编译构建
+
     runs-on: ubuntu-latest
+
     steps:
-    - name: 检出代码
-      uses: actions/checkout@v3
-
-    - name: 设置 Node.js 18
-      uses: actions/setup-node@v4
-      with:
-        node-version: '18'
-
-    - name: 设置 JDK 17
+    - uses: actions/checkout@v3
+    - name: Set up JDK 17
       uses: actions/setup-java@v3
       with:
         java-version: '17'
         distribution: 'temurin'
         cache: maven
+    - name: Build with Maven
+      run: mvn -B package --file pom.xml
 
-    - name: 构建前端
-      run: cd web-front && yarn install && yarn run build
-
-    - name: Maven 编译打包
-      run: mvn -B package -DskipTests --file pom.xml
-
-    - name: 更新依赖图谱
+    # Optional: Uploads the full dependency graph to GitHub to improve the quality of Dependabot alerts this repository can receive
+    - name: Update dependency graph
       uses: advanced-security/maven-dependency-submission-action@v3
-      if: github.event_name != 'pull_request'
-      continue-on-error: true
-      with:
-        ignore-maven-wrapper: true
 
-    - name: 分享应用打包目录（供原生包和 Docker 复用）
-      if: github.event_name != 'pull_request'
-      uses: actions/upload-artifact@v4
-      with:
-        name: app-package
-        path: web-service/target/package/
-
-    - name: 分享 bin-zip（供 Docker 复用）
-      if: github.event_name != 'pull_request'
-      uses: actions/upload-artifact@v4
-      with:
-        name: app-bin-zip
-        path: web-service/target/netdisk-fast-download-bin.zip
-
-  # ================================================================
-  # 阶段二-A：Docker 镜像构建（并行）
-  # ================================================================
-  docker:
-    name: Docker 镜像
-    needs: build
-    if: github.event_name != 'pull_request'
-    runs-on: ubuntu-latest
-    steps:
-    - name: 检出代码
-      uses: actions/checkout@v3
-
-    - name: 下载 bin-zip 产物
-      uses: actions/download-artifact@v4
-      with:
-        name: app-bin-zip
-        path: web-service/target/
-
-    - name: 登录 GitHub 容器仓库
-      uses: docker/login-action@v3
-      with:
-        registry: ghcr.io
-        username: ${{ github.actor }}
-        password: ${{ secrets.GITHUB_TOKEN }}
-
-    - name: 设置 QEMU（多平台构建支持）
-      uses: docker/setup-qemu-action@v3
-
-    - name: 设置 Docker Buildx
-      uses: docker/setup-buildx-action@v3
-
-    - name: 生成 Docker 标签
-      id: docker_tag
-      shell: bash
-      run: |
-        tag="$(printf '%s' "${GITHUB_REF_NAME}" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9_.-]+/-/g; s/^-+//; s/-+$//')"
-        if [ -z "$tag" ]; then
-          tag="snapshot"
-        fi
-        echo "tag=$tag" >> "$GITHUB_OUTPUT"
-
-    - name: 构建并推送 Docker 镜像
-      uses: docker/build-push-action@v5
-      with:
-        context: .
-        push: true
-        platforms: linux/amd64,linux/arm64,linux/arm/v7
-        tags: |
-          ghcr.io/${{ github.repository }}:${{ steps.docker_tag.outputs.tag }}
-          ghcr.io/${{ github.repository }}:latest
-
-
-  # ================================================================
-  # 阶段二-B：原生环境打包 Linux + Windows（并行）
-  # ================================================================
-  native-package:
-    name: 原生环境打包 → ${{ matrix.artifact-name }}
-    needs: build
-    if: github.event_name != 'pull_request'
-    strategy:
-      matrix:
-        include:
-          - os: ubuntu-latest
-            artifact-name: netdisk-fast-download-linux-amd64
-          - os: windows-latest
-            artifact-name: netdisk-fast-download-windows-amd64
-    runs-on: ${{ matrix.os }}
-    defaults:
-      run:
-        shell: bash
-
-    steps:
-    - name: 设置 JDK 17
-      uses: actions/setup-java@v3
-      with:
-        java-version: '17'
-        distribution: 'temurin'
-
-    - name: 下载 Maven 构建产物
-      uses: actions/download-artifact@v4
-      with:
-        name: app-package
-        path: web-service/target/package
-
-    # ============================================================
-    # jdeps 分析 → 确定所需 JDK 模块
-    # ============================================================
-    - name: 分析所需 JDK 模块（jdeps）
-      run: |
-        MAIN_JAR="web-service/target/package/netdisk-fast-download.jar"
-        LIB_DIR="web-service/target/package/lib"
-
-        CP=""
-        for jar in "$LIB_DIR"/*.jar; do
-          CP="$CP${CP:+:}$jar"
-        done
-
-        RAW_MODULES=$(jdeps --print-module-deps --ignore-missing-deps --multi-release 17 \
-          --class-path "$CP" "$MAIN_JAR" 2>/dev/null | head -n 1 | tr -d '\r\n' || true)
-
-        if [ -z "$RAW_MODULES" ] || [[ "$RAW_MODULES" == *"Missing"* ]] || [[ "$RAW_MODULES" == *"Error"* ]]; then
-          # ⚠️ 回退列表：若项目新增了需要 java.* / jdk.* 模块的依赖，需同步更新此处
-          RAW_MODULES="java.base,java.logging,java.sql,java.naming,java.management,java.xml,jdk.unsupported,java.net.http,java.instrument,java.security.jgss,java.security.sasl,java.desktop,jdk.crypto.ec"
-          echo "jdeps 分析失败，使用回退模块列表"
-        else
-          # 补上 jdeps 无法检测的反射/SPI依赖
-          RAW_MODULES="$RAW_MODULES,java.desktop,jdk.crypto.ec"
-        fi
-
-        echo "detected modules: $RAW_MODULES"
-        printf 'JDK_MODULES=%s\n' "$RAW_MODULES" >> $GITHUB_ENV
-
-    # ============================================================
-    # jlink 生成精简 JRE
-    # ============================================================
-    - name: 生成精简 JRE（jlink）
-      run: |
-        jlink \
-          --module-path "$JAVA_HOME/jmods" \
-          --add-modules "$JDK_MODULES" \
-          --output "native-package/netdisk-fast-download/jre" \
-          --strip-debug \
-          --compress=2 \
-          --no-header-files \
-          --no-man-pages
-
-        echo "JRE size:"
-        du -sh native-package/netdisk-fast-download/jre || true
-
-        # Windows: 确保 MSVC 运行时 DLL 到位
-        if [[ "$RUNNER_OS" == "Windows" ]]; then
-          JRE_BIN="native-package/netdisk-fast-download/jre/bin"
-          for dll in vcruntime140.dll msvcp140.dll vcruntime140_1.dll; do
-            if [ ! -f "$JRE_BIN/$dll" ] && [ -f "$JAVA_HOME/bin/$dll" ]; then
-              echo "jlink 未包含 $dll，从 JDK 补拷"
-              cp "$JAVA_HOME/bin/$dll" "$JRE_BIN/"
-            fi
-          done
-          echo "=== JRE bin 目录 DLL 清单 ==="
-          ls -la "$JRE_BIN"/*.dll 2>/dev/null || echo "(无 .dll 文件)"
-        fi
-
-    # ============================================================
-    # 组装包目录
-    # ============================================================
-    - name: 组装包目录
-      run: |
-        PKG="native-package/netdisk-fast-download"
-        SRC="web-service/target/package"
-
-        cp "$SRC/netdisk-fast-download.jar" "$PKG/"
-        cp -r "$SRC/lib"         "$PKG/"
-        cp -r "$SRC/resources"   "$PKG/"
-        cp -r "$SRC/webroot"     "$PKG/"
-
-        mkdir -p "$PKG/db"
-        mkdir -p "$PKG/logs"
-
-    # ============================================================
-    # 生成启动脚本
-    # ============================================================
-    - name: 生成启动脚本（Linux）
-      run: |
-        PKG="native-package/netdisk-fast-download"
-        echo '#!/bin/bash' > "$PKG/run.sh"
-        echo 'DIR="$(cd "$(dirname "$0")" && pwd)"' >> "$PKG/run.sh"
-        echo 'cd "$DIR" || exit 1' >> "$PKG/run.sh"
-        echo 'exec "$DIR/jre/bin/java" -Xmx512M -Dfile.encoding=utf-8 -jar "$DIR/netdisk-fast-download.jar" "$@"' >> "$PKG/run.sh"
-        chmod +x "$PKG/run.sh"
-
-    - name: 生成启动脚本（Windows）
-      run: |
-        PKG="native-package/netdisk-fast-download"
-        echo '@echo off' > "$PKG/run.bat"
-        echo 'chcp 65001 > nul' >> "$PKG/run.bat"
-        echo 'pushd %~dp0' >> "$PKG/run.bat"
-        echo '"%~dp0jre\bin\java.exe" -Xmx512M -Dfile.encoding=utf-8 -jar "%~dp0netdisk-fast-download.jar" %*' >> "$PKG/run.bat"
-
-    # ============================================================
-    # 打包为 zip
-    # ============================================================
-    - name: 打包 ZIP（Linux）
-      if: runner.os == 'Linux'
-      run: |
-        cd native-package
-        zip -r "../${{ matrix.artifact-name }}.zip" netdisk-fast-download/
-
-    - name: 打包 ZIP（Windows）
-      if: runner.os == 'Windows'
-      shell: pwsh
-      run: |
-        Compress-Archive -Path native-package/netdisk-fast-download -DestinationPath "${{ matrix.artifact-name }}.zip"
-
-    # ============================================================
-    # 上传产物
-    # ============================================================
-    - name: 上传原生安装包
-      uses: actions/upload-artifact@v4
-      with:
-        name: ${{ matrix.artifact-name }}
-        path: ${{ matrix.artifact-name }}.zip
-
-    - name: 上传到 Release
-      uses: softprops/action-gh-release@v2
-      with:
-        files: ${{ matrix.artifact-name }}.zip
-        tag_name: ${{ github.ref_name }}
-        generate_release_notes: true
+#    - uses: release-drafter/release-drafter@v5
+#      env:
+#        GITHUB_TOKEN: ${{ secrets.ACCESS_TOKEN }}

.gitignore

@@ -29,9 +29,6 @@ target/
 /src/logs/
 *.zip
 sdkTest.log
-app.yml
-app-local.yml
-secret.yml
 
 
 #some local files
@@ -41,55 +38,3 @@ gradlew
 gradlew.bat
 unused.txt
 /web-service/src/main/generated/
-/db
-/netdisk-fast-download/
-/webroot/nfd-front/
-/netdisk-fast-download/webroot/nfd-front/
-package-lock.json
-
-# Maven generated files
-.flattened-pom.xml
-**/.flattened-pom.xml
-
-# Test files
-test-filelist.java
-
-# Temporary files
-*.tmp
-*.temp
-*.log
-*.bak
-*.swp
-*.swo
-*~
-
-# Node.js (if any)
-node_modules/
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-
-# Build artifacts
-*.jar
-*.war
-*.ear
-*.zip
-*.tar.gz
-*.rar
-
-# IDE specific
-.vscode/
-.cursor/
-*.iml
-*.ipr
-*.iws
-
-# Build directories
-**/target/
-**/build/
-**/classes/
-**/out/
-**/${project.build.directory}/
-**/${project.basedir}/target/
-**/${basedir}/target/
-.spec-workflow/

.mvn/wrapper/MavenWrapperDownloader.java

@@ -1,117 +0,0 @@
-/*
- * Copyright 2007-present the original author or authors.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      https://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import java.net.*;
-import java.io.*;
-import java.nio.channels.*;
-import java.util.Properties;
-
-public class MavenWrapperDownloader {
-
-    private static final String WRAPPER_VERSION = "0.5.6";
-    /**
-     * Default URL to download the maven-wrapper.jar from, if no 'downloadUrl' is provided.
-     */
-    private static final String DEFAULT_DOWNLOAD_URL = "https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/"
-        + WRAPPER_VERSION + "/maven-wrapper-" + WRAPPER_VERSION + ".jar";
-
-    /**
-     * Path to the maven-wrapper.properties file, which might contain a downloadUrl property to
-     * use instead of the default one.
-     */
-    private static final String MAVEN_WRAPPER_PROPERTIES_PATH =
-            ".mvn/wrapper/maven-wrapper.properties";
-
-    /**
-     * Path where the maven-wrapper.jar will be saved to.
-     */
-    private static final String MAVEN_WRAPPER_JAR_PATH =
-            ".mvn/wrapper/maven-wrapper.jar";
-
-    /**
-     * Name of the property which should be used to override the default download url for the wrapper.
-     */
-    private static final String PROPERTY_NAME_WRAPPER_URL = "wrapperUrl";
-
-    public static void main(String args[]) {
-        System.out.println("- Downloader started");
-        File baseDirectory = new File(args[0]);
-        System.out.println("- Using base directory: " + baseDirectory.getAbsolutePath());
-
-        // If the maven-wrapper.properties exists, read it and check if it contains a custom
-        // wrapperUrl parameter.
-        File mavenWrapperPropertyFile = new File(baseDirectory, MAVEN_WRAPPER_PROPERTIES_PATH);
-        String url = DEFAULT_DOWNLOAD_URL;
-        if(mavenWrapperPropertyFile.exists()) {
-            FileInputStream mavenWrapperPropertyFileInputStream = null;
-            try {
-                mavenWrapperPropertyFileInputStream = new FileInputStream(mavenWrapperPropertyFile);
-                Properties mavenWrapperProperties = new Properties();
-                mavenWrapperProperties.load(mavenWrapperPropertyFileInputStream);
-                url = mavenWrapperProperties.getProperty(PROPERTY_NAME_WRAPPER_URL, url);
-            } catch (IOException e) {
-                System.out.println("- ERROR loading '" + MAVEN_WRAPPER_PROPERTIES_PATH + "'");
-            } finally {
-                try {
-                    if(mavenWrapperPropertyFileInputStream != null) {
-                        mavenWrapperPropertyFileInputStream.close();
-                    }
-                } catch (IOException e) {
-                    // Ignore ...
-                }
-            }
-        }
-        System.out.println("- Downloading from: " + url);
-
-        File outputFile = new File(baseDirectory.getAbsolutePath(), MAVEN_WRAPPER_JAR_PATH);
-        if(!outputFile.getParentFile().exists()) {
-            if(!outputFile.getParentFile().mkdirs()) {
-                System.out.println(
-                        "- ERROR creating output directory '" + outputFile.getParentFile().getAbsolutePath() + "'");
-            }
-        }
-        System.out.println("- Downloading to: " + outputFile.getAbsolutePath());
-        try {
-            downloadFileFromURL(url, outputFile);
-            System.out.println("Done");
-            System.exit(0);
-        } catch (Throwable e) {
-            System.out.println("- Error downloading");
-            e.printStackTrace();
-            System.exit(1);
-        }
-    }
-
-    private static void downloadFileFromURL(String urlString, File destination) throws Exception {
-        if (System.getenv("MVNW_USERNAME") != null && System.getenv("MVNW_PASSWORD") != null) {
-            String username = System.getenv("MVNW_USERNAME");
-            char[] password = System.getenv("MVNW_PASSWORD").toCharArray();
-            Authenticator.setDefault(new Authenticator() {
-                @Override
-                protected PasswordAuthentication getPasswordAuthentication() {
-                    return new PasswordAuthentication(username, password);
-                }
-            });
-        }
-        URL website = new URL(urlString);
-        ReadableByteChannel rbc;
-        rbc = Channels.newChannel(website.openStream());
-        FileOutputStream fos = new FileOutputStream(destination);
-        fos.getChannel().transferFrom(rbc, 0, Long.MAX_VALUE);
-        fos.close();
-        rbc.close();
-    }
-
-}

.mvn/wrapper/maven-wrapper.properties

@@ -1,2 +0,0 @@
-distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.3/apache-maven-3.6.3-bin.zip
-wrapperUrl=https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar

.run/AppMain.run.xml

@@ -1,15 +0,0 @@
-<component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="AppMain" type="Application" factoryName="Application" nameIsGenerated="true">
-    <option name="MAIN_CLASS_NAME" value="cn.qaiu.lz.AppMain" />
-    <module name="web-service" />
-    <extension name="coverage">
-      <pattern>
-        <option name="PATTERN" value="cn.qaiu.lz.*" />
-        <option name="ENABLED" value="true" />
-      </pattern>
-    </extension>
-    <method v="2">
-      <option name="Make" enabled="true" />
-    </method>
-  </configuration>
-</component>

.vscode/launch.json

@@ -1,18 +0,0 @@
-{
-    "version": "0.2.0",
-    "configurations": [
-        {
-            "type": "java",
-            "name": "Current File",
-            "request": "launch",
-            "mainClass": "${file}"
-        },
-        {
-            "type": "java",
-            "name": "AppMain",
-            "request": "launch",
-            "mainClass": "cn.qaiu.lz.AppMain",
-            "projectName": "web-service"
-        }
-    ]
-}

.vscode/settings.json

@@ -1,5 +1,3 @@
 {
-    "java.compile.nullAnalysis.mode": "automatic",
-    "java.configuration.updateBuildConfiguration": "interactive",
-    "java.debug.settings.onBuildFailureProceed": true
+    "java.compile.nullAnalysis.mode": "automatic"
 }

Dockerfile

@@ -1,22 +0,0 @@
-FROM eclipse-temurin:17-jre
-
-WORKDIR /app
-
-# 安装 unzip
-RUN apt-get update && apt-get install -y unzip && rm -rf /var/lib/apt/lists/*
-
-COPY ./web-service/target/netdisk-fast-download-bin.zip .
-
-RUN unzip netdisk-fast-download-bin.zip && \
-    mv netdisk-fast-download/* ./ && \
-    rm netdisk-fast-download-bin.zip && \
-    chmod +x run.sh && \
-    mkdir -p db logs
-
-COPY ./docker-entrypoint.sh /docker-entrypoint.sh
-RUN chmod +x /docker-entrypoint.sh
-
-EXPOSE 6401
-
-RUN addgroup --system appgroup && adduser --system --ingroup appgroup appuser
-ENTRYPOINT ["/docker-entrypoint.sh"]

README.md

@@ -1,516 +1,162 @@
-# 一款网盘分享链接云解析快速下载服务  
-QQ交流群：1017480890
-<p align="center">
-<a href="https://github.com/qaiu/netdisk-fast-download/actions/workflows/maven.yml"><img src="https://img.shields.io/github/actions/workflow/status/qaiu/netdisk-fast-download/build.yml?branch=main&style=flat"></a>
-<a href="https://www.oracle.com/cn/java/technologies/downloads"><img src="https://img.shields.io/badge/jdk-%3E%3D17-blue"></a>
-<a href="https://vertx-china.github.io"><img src="https://img.shields.io/badge/vert.x-4.5.27-blue?style=flat"></a>
-<a href="https://raw.githubusercontent.com/qaiu/netdisk-fast-download/master/LICENSE"><img src="https://img.shields.io/github/license/qaiu/netdisk-fast-download?style=flat"></a>
-<a href="https://github.com/qaiu/netdisk-fast-download/releases/"><img src="https://img.shields.io/github/v/release/qaiu/netdisk-fast-download?style=flat"></a>
-<a href="https://atomgit.com/QAIU/netdisk-fast-download"><img src="https://atomgit.com/QAIU/netdisk-fast-download/star/badge.svg" alt="AtomGit"></a>
-<a href="https://oosmetrics.com/repo/qaiu/netdisk-fast-download"><img src="https://api.oosmetrics.com/api/v1/badge/achievement/826aa27a-6e59-4de5-b7fa-cd189f484035.svg"></a>
-<p align="center">
-  <a href="https://trendshift.io/repositories/12101" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12101" alt="qaiu%2Fnetdisk-fast-download | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
-</p>
+# netdisk-fast-download
 
-
-![alt text](web-front/img/image.png)
-
-
-
-## 介绍
-> netdisk-fast-download网盘直链解析可以把云盘分享链接转为直链，可广泛应用于各类下载站，资源站，个人博客，图床，APP下载更新，视频点播等领域。支持市面各大主流云盘的文件分享以及文件夹分享链接，已支持蓝奏云/蓝奏云优享/移动云云空间/小飞机盘/亿方云/123云盘/Cloudreve等，支持加密分享，以及部分网盘文件夹分享。  
-
-[官方文档](https://nfd-parser.github.io/)  
-[API接入](https://nfdparser.apifox.cn/)  
-[公益解析，lz站](https://lz.qaiu.top)  
-[公益解析，lz0站](https://lz0.qaiu.top)  
-[专业版](https://189.qaiu.top)  
-  
-
-## 快速开始
-命令行下载分享文件：  
-```shell
-curl -LOJ "https://lz.qaiu.top/parser?url=https://share.feijipan.com/s/Tk1F2kGQ&pwd=1234"  
-```
-或者使用wget:  
-```shell
-wget -O bilibili.mp4 "https://lz.qaiu.top/parser?url=https://share.feijipan.com/s/Tk1F2kGQ&pwd=1234"
-```
-或者使用浏览器[直接访问](https://nfd-parser.github.io/nfd-preview/preview.html?src=https%3A%2F%2Flz.qaiu.top%2Fparser%3Furl%3Dhttps%3A%2F%2Fwww.ilanzou.com%2Fs%2FCDx6xKbT&name=bilibili.mp4&ext=mp4):
-```
-### 调用演示站下载：
-https://lz.qaiu.top/parser?url=https://www.ilanzou.com/s/CDx6xKbT&pwd=1234  
-### 调用演示站预览：
-https://nfd-parser.github.io/nfd-preview/preview.html?src=https%3A%2F%2Flz.qaiu.top%2Fparser%3Furl%3Dhttps%3A%2F%2Fwww.ilanzou.com%2Fs%2FCDx6xKbT&name=bilibili.mp4&ext=mp4  
-
-```
-
-**解析器模块文档：** [parser/README.md](parser/README.md)
-
-**JavaScript解析器文档：** [JavaScript解析器开发指南](parser/doc/JAVASCRIPT_PARSER_GUIDE.md) | [自定义解析器扩展指南](parser/doc/CUSTOM_PARSER_GUIDE.md) | [快速开始](parser/doc/CUSTOM_PARSER_QUICKSTART.md)
-
-**Playground功能：** [JS解析器演练场密码保护说明](web-service/doc/PLAYGROUND_PASSWORD_PROTECTION.md)
-
-
-**注意⚠️小飞机解析有IP限制，多数云服务商的大陆IP会被拦截（可以自行配置代理），和本程序无关**  
-**注意⚠️收到很多用户反馈，小飞机近期封号频繁，请尽可能选择其他网盘分享**  
-**注意⚠️请不要过度依赖 lz.qaiu.top，建议本地搭建或者云服务器自行搭建。请求量过多的话服务器可能会被云盘厂商限制，遇到解析失败的分享链接不要着急提issues，请先检查分享是否有效。**
+[![Java CI with Maven](https://github.com/qaiu/netdisk-fast-download/actions/workflows/maven.yml/badge.svg)](https://github.com/qaiu/netdisk-fast-download/actions/workflows/maven.yml)
+[![jdk](https://img.shields.io/badge/jdk-%3E%3D17-blue)](https://www.oracle.com/cn/java/technologies/downloads/)
+[![vert.x](https://img.shields.io/badge/vert.x-4.4.1-blue)](https://vertx-china.github.io/)
+[![GitHub release (latest by date)](https://img.shields.io/github/v/release/qaiu/netdisk-fast-download)](https://github.com/qaiu/netdisk-fast-download/releases/tag/0.1.6-releases)
 
 ## 网盘支持情况:
-> 20230824 123云盘解析大文件(>100MB)失效，需要登录  
-> 20230722 UC网盘解析失效，需要登录  
+`网盘名称(网盘标识):`
 
-网盘名称-网盘标识:  
+- [蓝奏云 (lz)](https://pc.woozooo.com/)
+  - [ ]  登录, 上传, 下载, 分享
+  - [X]  直链解析
+- [奶牛快传 (cow)](https://cowtransfer.com/)
+  - [ ]  登录, 上传, 下载, 分享
+  - [X]  直链解析
+- [移动云空间 (ec)](https://www.ecpan.cn/web)
+  - [ ]  登录, 上传, 下载, 分享
+  - [X]  直链解析
+- [UC网盘 (uc)](https://fast.uc.cn/)
+  - [ ]  登录, 上传, 下载, 分享
+  - [X]  直链解析
+- [小飞机网盘 (fj)](https://www.feijipan.com/)
+  - [ ]  登录, 上传, 下载, 分享
+  - [X]  直链解析
+- [亿方云 (fc)](https://www.fangcloud.com/)
+  - [ ]  登录, 上传, 下载, 分享
+  - [X]  直链解析
+- [123云盘 (ye)](https://www.123pan.com/)
+  - [ ]  登录, 上传, 下载, 分享
+  - [X]  直链解析
+- [文叔叔 (ws) 开发中](https://www.wenshushu.cn/)
+- [夸克网盘 (qk) 开发中](https://pan.quark.cn/)
 
-- [蓝奏云-lz](https://pc.woozooo.com/)
-- [蓝奏云优享-iz](https://www.ilanzou.com/)
-- [移动云云空间-ec](https://www.ecpan.cn/web)
-- [小飞机网盘-fj](https://www.feijipan.com/)
-- [亿方云-fc](https://www.fangcloud.com/)
-- [123云盘-ye](https://www.123pan.com/)
-- ~[115网盘(失效)-p115](https://115.com/)~
-- [文叔叔-ws](https://www.wenshushu.cn/)
-- [联想乐云-le](https://lecloud.lenovo.com/)
-- [QQ邮箱云盘-qqw](https://mail.qq.com/)
-- [QQ闪传-qqsc](https://nutty.qq.com/nutty/ssr/26797.html)
-- [城通网盘-ct](https://www.ctfile.com)
-- [网易云音乐分享链接-mnes](https://music.163.com)
-- [酷狗音乐分享链接-mkgs](https://www.kugou.com)
-- [酷我音乐分享链接-mkws](https://kuwo.cn)
-- [QQ音乐分享链接-mqqs](https://y.qq.com)
-- [Cloudreve自建网盘-ce](https://github.com/cloudreve/Cloudreve)
-- ~[微雨云存储-pvvy](https://www.vyuyun.com/)~
-- [超星云盘(需要referer: https://pan-yz.chaoxing.com)-pcx](https://pan-yz.chaoxing.com)
-- [飞书云盘-fs](https://www.feishu.cn/)
-- [WPS云文档-pwps](https://www.kdocs.cn/)
-- [汽水音乐-qishui_music](https://music.douyin.com/qishui/)
-- [咪咕音乐-migu](https://music.migu.cn/)
-- Google云盘-pgd
-- Onedrive-pod
-- Dropbox-pdp
-- iCloud-pic
-### 专业版提供
-- 迅雷网盘-xl
-- [夸克云盘-qk](https://pan.quark.cn/)
-- [UC云盘-uc](https://fast.uc.cn/)
-- [移动云盘-p139](https://yun.139.com/)
-- [联通云盘-pwo](https://pan.wo.cn/)
-- [天翼云盘-p189](https://cloud.189.cn/)
+**TODO:**
+  - 登录接口, 文件上传/下载/分享后端接口
+  - 短地址服务
+  - 前端界面(正则规划)
 
-## API接口
+**技术栈:**
+Jdk17+Vert.x4.4.1
+Core模块集成Vert.x实现类似spring的注解式路由API
 
-[api接口文档](https://nfdparser.apifox.cn/)
-  
-### 服务端口
-- **6400**: API 服务端口（建议使用 Nginx 代理）
-- **6401**: 内置 Web 解析工具（个人使用可直接开放此端口）
-
-### 接口说明
-
-#### 1. 302 自动跳转下载
-
-**通用接口**
-```
-GET /parser?url={分享链接}&pwd={密码}
-```
-
-**标志短链**
-```
-GET /d/{网盘标识}/{分享key}@{密码}
-```
-
-#### 2. 获取直链 JSON
-
-**通用接口**
-```
-GET /json/parser?url={分享链接}&pwd={密码}
-```
-
-**标志短链**
-```
-GET /json/{网盘标识}/{分享key}@{密码}
-```
-
-#### 3. 文件夹解析（v0.1.8fixed3+）
+API接口
 
 ```
-GET /json/getFileList?url={分享链接}&pwd={密码}
+网盘标识参考上面网盘支持情况, 括号内是可选内容: 表示当带有分享密码时需要加上密码参数 
+parser接口可以直接解析分享链接: 加密分享需要加上参数pwd=密码; 
+其他接口在分享Key后面加上@密码;
+
+1. 解析并自动302跳转 : 
+    http(s)://your_host/parser?url=分享链接(&pwd=xxx)
+    http(s)://your_host/网盘标识/分享key(@分享密码)
+2. 获取解析后的直链--JSON格式
+    http(s)://your_host/json/网盘标识/分享key(@分享密码)
+3. 特别注意的地方: 
+  - 有些网盘的加密分享的密码可以忽略: 如移动云空间,小飞机网盘
+  - 移动云空间(ec)使用parser?url= 解析时因为分享链接比较特殊(链接带有参数且含有#符号)所以要么对#进行转义%23要么直接去掉# 或者URL直接是主机名+'/'跟一个data参数
+  比如 http://your_host/parser?url=https://www.ecpan.cn/web//yunpanProxy?path=%2F%23%2Fdrive%2Foutside&data=81027a5c99af5b11ca004966c945cce6W9Bf2&isShare=1
+      http://your_host/parser?url=https://www.ecpan.cn/web/%23/yunpanProxy?path=%2F%23%2Fdrive%2Foutside&data=81027a5c99af5b11ca004966c945cce6W9Bf2&isShare=1
+      http://your_host/parser?url=https://www.ecpan.cn/&data=81027a5c99af5b11ca004966c945cce6W9Bf2&isShare=1
 ```
 
-### 使用规则
-
-- `{分享链接}` 建议使用 URL 编码
-- `{密码}` 无密码时省略 `&pwd=` 或 `@密码` 部分
-- `{网盘标识}` 参考支持的网盘列表
-- `your_host` 替换为您的域名或 IP
-
-### 认证参数（v0.2.1+）
-[可以使用在线认证参数加密](https://qaiu.top/nfd-auth.html)
-部分网盘（如夸克、UC）需要登录后的 Cookie 才能解析和下载。可通过 `auth` 参数传递认证信息：
-
-**参数格式**：`auth` 参数值为 AES 加密后的 JSON 字符串，经过 Base64 编码和 URL 编码
-
-**加密方式**：
-- 算法：AES/ECB/PKCS5Padding
-- 密钥：`nfd_auth_key2026`（16字节）
-- 流程：JSON → AES加密 → Base64 → URL编码
-
-**JSON 结构**：
-```json
-{
-  "authType": "cookie",        // 认证类型: cookie/accesstoken/authorization/password/custom
-  "token": "your_cookie_here", // Cookie 或 Token 内容
-  "username": "",              // 用户名（password 类型时使用）
-  "password": "",              // 密码（password 类型时使用）
-  "ext1": "",                  // 扩展字段1（custom 类型时使用）
-  "ext2": ""                   // 扩展字段2（custom 类型时使用）
-}
-```
-
-**网盘认证要求**：
-| 网盘 | 认证要求 | 说明 |
-|------|---------|------|
-| 夸克网盘(QK) | **必须** | 必须配置 Cookie 才能解析 |
-| UC网盘(UC) | **必须** | 必须配置 Cookie 才能解析 |
-| 小飞机网盘(FJ) | 可选 | 大文件（>100MB）需要认证 |
-| 蓝奏优享(IZ) | 可选 | 大文件需要认证 |
-
-**使用示例**：
-```
-GET /parser?url={分享链接}&pwd={密码}&auth={加密后的认证参数}
-```
-
-> 💡 提示：Web 界面已内置认证配置功能，可自动处理加密过程，无需手动构造参数。
-> [可以使用在线认证参数加密](https://qaiu.top/nfd-auth.html)
-
-#### 密钥作用说明
-
-- `server.authEncryptKey`
-  - 作用：用于 `auth` 参数的 AES 加解密
-  - 要求：16位（AES-128）
-
-- `server.donatedAccountFailureTokenSignKey`
-  - 作用：用于“捐赠账号失败计数 token”的 HMAC 签名/验签
-  - 目的：防止客户端伪造失败计数请求
-  - 建议：使用高强度随机字符串，且不要与 `authEncryptKey` 相同
-
-### 特殊说明
-
-- 移动云云空间的 `分享key` 取分享链接中的 `data` 参数值
-- 移动云云空间、小飞机网盘的加密分享可忽略密码参数
-
-### 示例
-
-```bash
-# 302 跳转（通用接口 - 有密码）
-http://your_host/parser?url=https%3A%2F%2Fwww.ilanzou.com%2Fs%2FlGFndCM&pwd=KMnv
-
-# 302 跳转（标志短链 - 有密码）
-http://your_host/d/iz/lGFndCM@KMnv
-
-# 获取 JSON（通用接口 - 无密码）
-http://your_host/json/parser?url=https%3A%2F%2Fwww.ilanzou.com%2Fs%2FLEBZySxF
-
-# 获取 JSON（标志短链 - 无密码）
-http://your_host/json/iz/LEBZySxF
+IDEA HttpClient示例:
 
 ```
+# 解析并重定向到直链
+### 蓝奏云普通分享
+# @no-redirect
+GET http://127.0.0.1:6400/parser?url=https://lanzoux.com/ia2cntg
+### 奶牛快传普通分享
+# @no-redirect
+GET http://127.0.0.1:6400/parser?url=https://cowtransfer.com/s/9a644fe3e3a748
+### 360亿方云加密分享
+# @no-redirect
+GET http://127.0.0.1:6400/parser?url=https://v2.fangcloud.com/sharing/e5079007dc31226096628870c7&pwd=QAIU
 
----
+# Rest请求自动302跳转(只提供共享文件Id):
+### 蓝奏云普通分享
+# @no-redirect
+GET http://127.0.0.1:6400/lz/ia2cntg
+### 奶牛快传普通分享
+# @no-redirect
+GET http://127.0.0.1:6400/cow/9a644fe3e3a748
+### 360亿方云加密分享
+GET http://127.0.0.1:6400/json/fc/e5079007dc31226096628870c7@QAIU
 
 
-### json接口详细说明
+# 解析返回json直链
+### 蓝奏云普通分享
+GET http://127.0.0.1:6400/json/lz/ia2cntg
+### 奶牛快传普通分享
+GET http://127.0.0.1:6400/json/cow/9a644fe3e3a748
+### 360亿方云加密分享
+GET http://127.0.0.1:6400/json/fc/e5079007dc31226096628870c7@QAIU
 
-#### 1. 文件解析：/json/parser?url=分享链接&pwd=xxx  
 
-json返回数据格式示例:  
-`shareKey`:    全局分享key  
-`directLink`:  下载链接  
-`cacheHit`:    是否为缓存链接  
-`expires`:     缓存到期时间  
-
-```json
-{
-  "code": 200,
-  "msg": "success",
-  "success": true,
-  "count": 0,
-  "data": {
-    "shareKey": "lz:xxx",
-    "directLink": "下载直链", 
-    "cacheHit": true,
-    "expires": "2024-09-18 01:48:02",
-    "expiration": 1726638482825
-  },
-  "timestamp": 1726637151902
-}
 ```
-#### 2. 分享链接详情接口 /v2/linkInfo?url=分享链接
-```json
-{
-    "code": 200,
-    "msg": "success",
-    "success": true,
-    "count": 0,
-    "data": {
-        "downLink": "https://lz.qaiu.top/d/fj/xx",
-        "apiLink": "https://lz.qaiu.top/json/fj/xx",
-        "cacheHitTotal": 5,
-        "parserTotal": 2,
-        "sumTotal": 7,
-        "shareLinkInfo": {
-            "shareKey": "xx",
-            "panName": "小飞机网盘",
-            "type": "fj",
-            "sharePassword": "",
-            "shareUrl": "https://share.feijipan.com/s/xx",
-            "standardUrl": "https://www.feijix.com/s/xx",
-            "otherParam": {
-                "UA": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36 Edg/131.0.0.0"
-            },
-            "cacheKey": "fj:xx"
-        }
-    },
-    "timestamp": 1736489219402
-}
-```
-#### 3. 文件夹解析(仅支持蓝奏云/蓝奏优享/小飞机网盘)
-/v2/getFileList?url=分享链接&pwd=分享密码
-
-```json
-{
-  "code": 200,
-  "msg": "success",
-  "success": true,
-  "data": [
-    {
-      "fileName": "xxx",
-      "fileId": "xxx",
-      "fileIcon": null,
-      "size": 999,
-      "sizeStr": "999 M",
-      "fileType": "file/folder",
-      "filePath": null,
-      "createTime": "17 小时前",
-      "updateTime": null,
-      "createBy": null,
-      "description": null,
-      "downloadCount": "下载次数",
-      "panType": "lz",
-      "parserUrl": "下载链接/文件夹链接", 
-      "extParameters": null
-    }
-  ]
-}
-```
-#### 4. 解析次数统计接口 /v2/statisticsInfo
-```json
-{
-    "code": 200,
-    "msg": "success",
-    "success": true,
-    "count": 0,
-    "data": {
-        "parserTotal": 320508,
-        "cacheTotal": 5957910,
-        "total": 6278418
-    },
-    "timestamp": 1736489378770
-}
-```
-
-
 
 # 网盘对比
 
 
-| 网盘名称        | 免登陆下载分享 | 加密分享     | 初始网盘空间    | 单文件大小限制         |
-|-------------|---------|----------|-----------|-----------------|
-| 蓝奏云         | √       | √        | 不限空间      | 100M            | 
-| 移动云云空间(个人版) | √       | √(密码可忽略) | 5G(个人)    | 不限大小            |
-| 小飞机网盘       | √       | √        | 10G       | 不限大小            | 
-| 360亿方云      | √       | √        | 100G(须实名) | 不限大小            | 
-| 123云盘       | √       | √        | 2T        | 100G（>100M需要登录） | 
-| 文叔叔         | √       | √        | 10G       | 5GB             | 
-| WPS云文档      | √       | X        | 5G(免费)   | 10M(免费)/2G(会员)  |
-| 夸克网盘        | x       | √        | 10G       | 不限大小            | 
-| UC网盘        | x       | √        | 10G       | 不限大小            | 
-| 飞书云盘        | √       | X        | 15G       | 不限大小            |
+| 网盘名称       | 可直接下载分享                | 加密分享     | 初始网盘空间    | 单文件大小限制 | 登录接口 |
+|------------|------------------------|----------|-----------|---------|------|
+| 蓝奏云        | √                      | √        | 不限空间      | 100M    | TODO |
+| 奶牛快传       | √                      | X        | 10G       | 不限大小    | TODO |
+| 移动云空间      | √                      | √(密码可忽略) | 5G(个人)    | 不限大小    | TODO |
+| UC网盘       | √                      | √        | 10G       | 不限大小    | TODO |
+| 小飞机网盘      | √                      | √(密码可忽略) | 10G       | 不限大小    | TODO |
+| 360亿方云     | √(试用账号有时间限制企业版需要599续费) | √(密码可忽略) | 100G(须实名) | 不限大小    | TODO |
+| 123云盘      | √                      | √        | 2T        | 100G    | TODO |
+| 文叔叔(TODO)  | √(注意有时间限制)             | √        | 10G       |  5GB    | TODO |
+| 夸克网盘(TODO) | 需要登录                   | √        | 10G       | 不限大小    | TODO |
 
 # 打包部署
 
-## JDK下载（lz.qaiu.top提供直链云解析服务）
-- [阿里jdk17(Dragonwell17-windows-x86)](https://lz.qaiu.top/d/ec/e957acef36ce89e1053979672a90d219n)
-- [阿里jdk17(Dragonwell17-linux-x86)](https://lz.qaiu.top/d/ec/6ebc9f2e0bbd53b4c4d5b11013f40a80NHvcYU)
-- [阿里jdk17(Dragonwell17-linux-aarch64)](https://lz.qaiu.top/d/ec/d14c2d06296f61b52a876b525265e0f8tzxTc5)
-- [解析有效性测试-移动云云空间-阿里jdk17-linux-x86](https://lz.qaiu.top/json/ec/6ebc9f2e0bbd53b4c4d5b11013f40a80NHvcYU)
-
 ## 开发和打包
 
 ```shell
-# 环境要求: Jdk17 + maven;
-mvn clean
-mvn package -DskipTests
+# 环境要求: Jdk17 + maven; 
+mvn clean 
+mvn package
 
 ```
-打包好的文件位于 web-service/target/netdisk-fast-download-bin.zip
-
-## 🚀 快速部署
-
-[![通过雨云一键部署](https://rainyun-apps.cn-nb1.rains3.com/materials/deploy-on-rainyun-cn.svg)](https://app.rainyun.com/apps/rca/store/7273/ssl_?s=ndf)
-
+打包好的文件位于 web-service/target/netdisk-fast-download-x.x.x-bin.zip
 ## Linux服务部署
-
-### Docker 部署（Main分支）
-
-#### 海外服务器Docker部署
-```shell
-# 创建目录
-mkdir -p netdisk-fast-download
-cd netdisk-fast-download
-
-# 拉取镜像
-docker pull ghcr.io/qaiu/netdisk-fast-download:latest
-
-# 复制配置文件（或下载仓库web-service\src\main\resources）
-docker create --name netdisk-fast-download ghcr.io/qaiu/netdisk-fast-download:latest
-docker cp netdisk-fast-download:/app/resources ./resources
-docker rm netdisk-fast-download
-
-# 启动容器
-docker run -d -it --name netdisk-fast-download -p 6401:6401 --restart unless-stopped -e TZ=Asia/Shanghai -v ./resources:/app/resources -v ./db:/app/db -v ./logs:/app/logs ghcr.io/qaiu/netdisk-fast-download:latest
-
-# 反代6401端口
-
-# 升级容器
-docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --cleanup --run-once netdisk-fast-download
-```
-
-#### 国内Docker部署
-```shell
-# 创建目录
-mkdir -p netdisk-fast-download
-cd netdisk-fast-download
-
-# 拉取镜像
-docker pull ghcr.nju.edu.cn/qaiu/netdisk-fast-download:latest
-
-# 复制配置文件（或下载仓库web-service\src\main\resources）
-docker create --name netdisk-fast-download ghcr.nju.edu.cn/qaiu/netdisk-fast-download:latest
-docker cp netdisk-fast-download:/app/resources ./resources
-docker rm netdisk-fast-download
-
-# 启动容器
-docker run -d -it --name netdisk-fast-download -p 6401:6401 --restart unless-stopped -e TZ=Asia/Shanghai -v ./resources:/app/resources -v ./db:/app/db -v ./logs:/app/logs ghcr.nju.edu.cn/qaiu/netdisk-fast-download:latest
-
-# 反代6401端口
-
-# 升级容器
-docker run --rm -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --cleanup --run-once netdisk-fast-download
-```
-
-### 宝塔部署指引 -> [点击进入宝塔部署教程](https://blog.qaiu.top/archives/netdisk-fast-download-bao-ta-an-zhuang-jiao-cheng)
-
-### Linux命令行部署
 > 注意: netdisk-fast-download.service中的ExecStart的路径改为实际路径
 ```shell
 cd ~
-wget -O netdisk-fast-download.zip https://github.com/qaiu/netdisk-fast-download/releases/download/v3.0.2/netdisk-fast-download-bin.zip
-unzip netdisk-fast-download-bin.zip
-cd netdisk-fast-download
+wget -O netdisk-fast-download-0.1.6-bin.zip  https://github.com/qaiu/netdisk-fast-download/releases/download/0.1.6-releases/netdisk-fast-download-0.1.6-bin.zip
+unzip netdisk-fast-download-*-bin.zip 
+cd netdisk-fast-download-*-bin
 bash service-install.sh
 ```
 服务相关命令:  
+1、查看服务状态  
+systemctl status netdisk-fast-download.service
 
-查看服务状态  
-`systemctl status netdisk-fast-download.service`
- 
+2、控制服务  
 启动服务  
-`systemctl start netdisk-fast-download.service`
+systemctl start netdisk-fast-download.service
 
 重启服务  
-`systemctl restart netdisk-fast-download.service`
+systemctl restart netdisk-fast-download.service
 
 停止服务  
-`systemctl stop netdisk-fast-download.service`
+systemctl stop netdisk-fast-download.service
 
 开机启动服务  
-`systemctl enable netdisk-fast-download.service`
+systemctl enable netdisk-fast-download.servic
 
 停止开机启动  
-`systemctl disable netdisk-fast-download.service`
+systemctl disable netdisk-fast-download.servic
 
 ## Windows服务部署
-1. 下载并解压releases版本netdisk-fast-download-bin.zip
-2. 进入netdisk-fast-download下的bin目录
+1. 下载并解压releases版本netdisk-fast-download-0.1.6-bin.zip
+2. 进入netdisk-fast-download-0.1.6-bin目录
 3. 使用管理员权限运行nfd-service-install.bat
 如果不想使用服务运行可以直接运行run.bat
-> 注意: 如果jdk环境变量的java版本不是17请修改nfd-service-template.xml中的java命令的路径改为实际路径
-
-## 相关配置说明
-
-resources目录下包含服务端配置文件 配置文件自带说明，具体请查看配置文件内容，  
-app-dev.yml 可以配置解析服务相关信息， 包括端口，域名，缓存时长等  
-server-proxy.yml 可以配置代理服务运行的相关信息， 包括前端反向代理端口，路径等  
-
-### ip代理配置说明  
-有时候解析量很大，IP容易被ban，这时候可以使用其他服务器搭建nfd-proxy代理服务。
-
-修改配置文件：
-app-dev.yml
-
-```yaml
-proxy:
-  - panTypes: pgd,pdb,pod     # 网盘标识
-    type: http                # 支持http/socks4/socks5
-    host: 127.0.0.1           # 代理IP
-    port: 7890                # 端口
-    username:                 # 用户名
-    password:                 # 密码
-```  
-nfd-proxy搭建http代理服务器 
-参考https://github.com/nfd-parser/nfd-proxy
-
-### 认证信息配置说明
-部分网盘（如123）解析大文件时需要登录认证，可以在配置文件中添加认证信息。
-
-修改配置文件：
-app-dev.yml
-
-```yaml
-### 解析认证相关
-auths:
-  # 123：配置用户名密码
-  ye:
-    username: 你的用户名
-    password: 你的密码
-```
-
-**注意：** 目前仅支持 123（ye）的认证配置。
-
-
-**技术栈:**
-Jdk17+Vert.x4
-Core模块集成Vert.x实现类似spring的注解式路由API
-
-
-## Star History
-
-[![Star History Chart](https://api.star-history.com/svg?repos=qaiu/netdisk-fast-download&type=Date)](https://star-history.com/#qaiu/netdisk-fast-download&Date)
-
-## **免责声明**  
-   - 用户在使用本项目时，应自行承担风险，并确保其行为符合当地法律法规。开发者不对用户因使用本项目而导致的任何后果负责。
-
-## 支持该项目
-开源不易，用爱发电，本项目长期维护如果觉得有帮助, 可以请作者喝杯咖啡, 感谢支持  
-
-本项目的服务器由林枫云提供赞助<br>
-</a>
-<a href="https://www.dkdun.cn/aff/WDBRYKGH" target="_blank">
-<img src="https://www.dkdun.cn/themes/web/www/upload/local68c2dbb2ab148.png" width="200">
-</a>
-</p>
-
-
-
 
+## Docker部署
+TODO

bin/netdisk-fast-download.service

@@ -8,7 +8,7 @@ Wants=network-online.target
 Type=simple
 # User=USER
 # 需要JDK17及以上版本 注意修改为自己的路径
-ExecStart=/root/java/jdk-17.0.2/bin/java -server -Xmx128m -jar /root/java/netdisk-fast-download/netdisk-fast-download.jar
+ExecStart=/root/java/jdk-17.0.2/bin/java -server -Xmx128m -jar /root/java/netdisk-fast-download-0.1.6/netdisk-fast-download-0.1.6.jar
 ExecStop=/bin/kill -s QUIT $MAINPID
 Restart=always
 StandOutput=syslog

bin/nfd-install.sh

@@ -1,86 +0,0 @@
-#!/bin/bash
-set -e
-
-# ----------- 配置区域 ------------
-# JRE 下载目录
-JRE_DIR="/opt/custom-jre17"
-# 使用阿里云镜像下载 JRE（OpenJDK 17）
-JRE_TARBALL_URL="https://mirrors.tuna.tsinghua.edu.cn/Adoptium/17/jre/x64/linux/OpenJDK17U-jre_x64_linux_hotspot_17.0.15_6.tar.gz"
-
-# ZIP 文件下载相关
-ZIP_URL="http://www.722shop.top:6401/parser?url="
-ZIP_DEST_DIR="/opt/target-zip"
-ZIP_FILE_NAME="nfd.zip"
-# --------------------------------
-
-# 创建目录
-mkdir -p "$JRE_DIR"
-mkdir -p "$ZIP_DEST_DIR"
-
-# -------- 检查 unzip 是否存在 --------
-if ! command -v unzip >/dev/null 2>&1; then
-  echo "unzip 未安装，正在安装..."
-
-  if command -v apt-get >/dev/null 2>&1; then
-    apt-get update && apt-get install -y unzip
-  elif command -v yum >/dev/null 2>&1; then
-    yum install -y unzip
-  elif command -v dnf >/dev/null 2>&1; then
-    dnf install -y unzip
-  else
-    echo "不支持的包管理器，无法自动安装 unzip，请手动安装后重试。"
-    exit 1
-  fi
-else
-  echo "unzip 已安装"
-fi
-
-# -------- 下载并解压 JRE --------
-echo "下载 JRE 17 到 $JRE_DIR..."
-curl -L "$JRE_TARBALL_URL" -o "$JRE_DIR/jre17.tar.gz"
-
-echo "解压 JRE..."
-tar -xzf "$JRE_DIR/jre17.tar.gz" -C "$JRE_DIR" --strip-components=1
-rm "$JRE_DIR/jre17.tar.gz"
-echo "JRE 解压完成"
-
-# -------- 下载 ZIP 文件 --------
-ZIP_PATH="$ZIP_DEST_DIR/$ZIP_FILE_NAME"
-echo "下载 ZIP 文件到 $ZIP_PATH..."
-curl -L "$ZIP_URL" -o "$ZIP_PATH"
-
-# -------- 解压 ZIP 文件 --------
-echo "解压 ZIP 文件到 $ZIP_DEST_DIR..."
-unzip -o "$ZIP_PATH" -d "$ZIP_DEST_DIR"
-echo "解压完成"
-
-# -------- 启动 JAR 程序 --------
-echo "进入 JAR 目录并后台运行程序..."
-
-JAR_DIR="/opt/target-zip/netdisk-fast-download"
-JAR_FILE="netdisk-fast-download.jar"
-JAVA_BIN="$JRE_DIR/bin/java"
-LOG_FILE="$JAR_DIR/app.log"
-
-if [ ! -d "$JAR_DIR" ]; then
-  echo "[错误] 找不到 JAR 目录: $JAR_DIR"
-  exit 1
-fi
-
-cd "$JAR_DIR"
-
-if [ ! -f "$JAR_FILE" ]; then
-  echo "[错误] 找不到 JAR 文件: $JAR_FILE"
-  exit 1
-fi
-
-if [ ! -x "$JAVA_BIN" ]; then
-  echo "[错误] 找不到可执行的 java: $JAVA_BIN"
-  exit 1
-fi
-
-# 后台运行，日志记录
-nohup "$JAVA_BIN" -jar "$JAR_FILE" > "$LOG_FILE" 2>&1 &
-
-echo "程序已在后台启动 ✅"
-echo "日志路径: $LOG_FILE"

bin/nfd-service-install.bat

@@ -7,7 +7,7 @@ pushd %~dp0
 set MY_DIR=%~dp0
 set MY_DIR=%MY_DIR:~0,-1%
 
-for /f "delims=X" %%i in ('dir /b %MY_DIR%\netdisk-fast-download.jar') do (
+for /f "delims=X" %%i in ('dir /b %MY_DIR%\netdisk-fast-download-*.jar') do (
     set LAUNCH_JAR=%MY_DIR%\%%i
 )
 

bin/nfd-service-template.xml

@@ -4,7 +4,7 @@
     <name>netdisk-fast-download</name>
     <description>netdisk fast download service</description>
     <executable>java</executable>
-    <arguments> -server -Xmx128m -Dfile.encoding=utf8 -jar ${jar} </arguments>
+    <arguments>-jar ${jar} -server -Xmx128m </arguments>
     <logpath>${dd}\logs</logpath>
     <log mode="roll-by-time">
         <pattern>yyyyMMdd</pattern>

bin/run.bat

@@ -1,11 +1,10 @@
 @echo off && @chcp 65001 > nul
 pushd %~dp0
 set LIB_DIR=%~dp0
-for /f "delims=X" %%i in ('dir /b %LIB_DIR%\netdisk-fast-download.jar') do (
+for /f "delims=X" %%i in ('dir /b %LIB_DIR%\netdisk-fast-download-*.jar') do (
     set LAUNCH_JAR=%LIB_DIR%%%i
 )
 
-set "JAVA_HOME=D:\App\dragonwell-17.0.3.0.3+7-GA"
 "%JAVA_HOME%\bin\java.exe" -Xmx512M -Dfile.encoding=utf8 -jar %LAUNCH_JAR% %*
 
 pause

bin/run.sh

@@ -1,5 +1,6 @@
 #!/bin/bash
 # set -x
-LAUNCH_JAR="netdisk-fast-download.jar"
-exec java -Xmx${JVM_XMX:-512M} ${JVM_OPTS} -jar "$LAUNCH_JAR" "$@"
+LAUNCH_JAR="netdisk-fast-download-0.1.6.jar"
+nohup java -Xmx512M -jar "$LAUNCH_JAR" "$@" >startup.log 2>&1 &
+tail -f startup.log
 

bin/stop.sh

@@ -1,14 +0,0 @@
-#!/bin/bash
-# set -x
-
-# 找到运行中的 Java 进程的 PID
-PID=$(ps -ef | grep 'netdisk-fast-download.jar' | grep -v grep | awk '{print $2}')
-
-if [ -z "$PID" ]; then
-    echo "未找到正在运行的进程 netdisk-fast-download.jar"
-    exit 1
-else
-    # 杀掉进程
-    echo "停止 netdisk-fast-download.jar (PID: $PID)..."
-    kill -9 "$PID"
-fi

core-database/pom.xml

@@ -5,7 +5,7 @@
     <parent>
         <artifactId>netdisk-fast-download</artifactId>
         <groupId>cn.qaiu</groupId>
-        <version>${revision}</version>
+        <version>0.1.6</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
 
@@ -14,12 +14,16 @@
     <properties>
         <java.version>17</java.version>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <slf4j.version>2.0.5</slf4j.version>
+        <commons-lang3.version>3.12.0</commons-lang3.version>
+        <vertx.version>4.4.1</vertx.version>
     </properties>
 
     <dependencies>
         <dependency>
             <groupId>cn.qaiu</groupId>
             <artifactId>core</artifactId>
+            <version>1.0.8</version>
         </dependency>
 
         <!-- https://mvnrepository.com/artifact/com.h2database/h2 -->
@@ -38,7 +42,7 @@
         <dependency>
             <groupId>org.apache.commons</groupId>
             <artifactId>commons-lang3</artifactId>
-            <version>3.18.0</version>
+            <version>3.12.0</version>
         </dependency>
         <dependency>
             <groupId>io.vertx</groupId>
@@ -56,18 +60,6 @@
             <artifactId>vertx-jdbc-client</artifactId>
             <version>${vertx.version}</version>
         </dependency>
-        <dependency>
-            <groupId>com.mysql</groupId>
-            <artifactId>mysql-connector-j</artifactId>
-            <version>9.2.0</version>
-        </dependency>
-        <!--        PG驱动-->
-        <dependency>
-            <groupId>org.postgresql</groupId>
-            <artifactId>postgresql</artifactId>
-            <version>42.7.11</version>
-        </dependency>
-
     </dependencies>
 
 </project>

core-database/src/main/java/cn/qaiu/StartH2DatabaseServer.java

@@ -1,7 +1,7 @@
 package cn.qaiu;
 
 public class StartH2DatabaseServer {
-
-
-
+    public static void main(String[] args) {
+        System.out.println("Hello world!");
+    }
 }

core-database/src/main/java/cn/qaiu/db/ddl/Constraint.java

@@ -21,6 +21,7 @@ public @interface Constraint {
     boolean notNull() default false;
 
     /**
+     * 唯一键约束 TODO 待实现
      * @return 唯一键约束
      */
     String uniqueKey() default "";
@@ -31,7 +32,7 @@ public @interface Constraint {
      */
     String defaultValue() default "";
     /**
-     * 默认值是否是函数 like value=NOW()
+     * 默认值是否是函数
      * @return false 不是函数
      */
     boolean defaultValueIsFunction() default false;

core-database/src/main/java/cn/qaiu/db/ddl/CreateDatabase.java

@@ -1,67 +0,0 @@
-package cn.qaiu.db.ddl;
-
-import cn.qaiu.db.pool.JDBCPoolInit;
-import io.vertx.core.json.JsonObject;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-import java.sql.Connection;
-import java.sql.DriverManager;
-import java.sql.SQLException;
-import java.sql.Statement;
-import java.util.regex.Matcher;
-import java.util.regex.Pattern;
-
-public class CreateDatabase {
-
-    private static final Logger LOGGER = LoggerFactory.getLogger(JDBCPoolInit.class);
-
-    /**
-     * 解析数据库URL，获取数据库名
-     * @param url 数据库URL
-     * @return 数据库名
-     */
-    public static String getDatabaseName(String url) {
-        // 正则表达式匹配数据库名
-        String regex = "jdbc:mysql://[^/]+/(\\w+)(\\?.*)?";
-        Pattern pattern = Pattern.compile(regex);
-        Matcher matcher = pattern.matcher(url);
-
-        if (matcher.find()) {
-            return matcher.group(1);
-        } else {
-            throw new IllegalArgumentException("Invalid database URL: " + url);
-        }
-    }
-
-    /**
-     * 使用JDBC原生方法创建数据库
-     * @param url 数据库连接URL
-     * @param user 数据库用户名
-     * @param password 数据库密码
-     */
-    public static void createDatabase(String url, String user, String password) {
-        String dbName = getDatabaseName(url);
-        LOGGER.info(">>>>>>>>>>> 创建数据库:'{}' <<<<<<<<<<<< ", dbName);
-
-        // 去掉数据库名，构建不带数据库名的URL
-        String baseUrl = url.substring(0, url.lastIndexOf("/") + 1) + "?characterEncoding=UTF-8&useUnicode=true";
-
-        try (Connection conn = DriverManager.getConnection(baseUrl, user, password);
-             Statement stmt = conn.createStatement()) {
-            // 创建数据库
-            stmt.executeUpdate("CREATE DATABASE IF NOT EXISTS " + dbName + " CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci");
-            LOGGER.info(">>>>>>>>>>> 数据库'{}'创建成功 <<<<<<<<<<<<", dbName);
-        } catch (SQLException e) {
-            LOGGER.error("创建数据库失败", e);
-        }
-    }
-
-    public static void createDatabase(JsonObject dbConfig) {
-        createDatabase(
-                dbConfig.getString("jdbcUrl"),
-                dbConfig.getString("username"),
-                dbConfig.getString("password")
-        );
-    }
-}

core-database/src/main/java/cn/qaiu/db/ddl/CreateTable.java

@@ -1,14 +1,11 @@
 package cn.qaiu.db.ddl;
 
-import cn.qaiu.db.pool.JDBCType;
 import cn.qaiu.vx.core.util.ReflectionUtil;
 import io.vertx.codegen.format.CamelCase;
 import io.vertx.codegen.format.Case;
 import io.vertx.codegen.format.LowerCamelCase;
 import io.vertx.codegen.format.SnakeCase;
-import io.vertx.core.Future;
-import io.vertx.core.Promise;
-import io.vertx.sqlclient.Pool;
+import io.vertx.jdbcclient.JDBCPool;
 import io.vertx.sqlclient.templates.annotations.Column;
 import io.vertx.sqlclient.templates.annotations.RowMapped;
 import org.apache.commons.lang3.StringUtils;
@@ -16,7 +13,9 @@ import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 import java.lang.reflect.Field;
-import java.util.*;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Set;
 
 /**
  * 创建表
@@ -24,316 +23,148 @@ import java.util.*;
  * @author <a href="https://qaiu.top">QAIU</a>
  */
 public class CreateTable {
-    public static final Map<Class<?>, String> javaProperty2SqlColumnMap;
-    static {
-        Map<Class<?>, String> map = new HashMap<>();
-        // Java类型到SQL类型的映射
-        map.put(Integer.class, "INT");
-        map.put(Short.class, "SMALLINT");
-        map.put(Byte.class, "TINYINT");
-        map.put(Long.class, "BIGINT");
-        map.put(java.math.BigDecimal.class, "DECIMAL");
-        map.put(Double.class, "DOUBLE");
-        map.put(Float.class, "REAL");
-        map.put(Boolean.class, "BOOLEAN");
-        map.put(String.class, "VARCHAR");
-        map.put(Date.class, "TIMESTAMP");
-        map.put(java.time.LocalDateTime.class, "TIMESTAMP");
-        map.put(java.sql.Timestamp.class, "TIMESTAMP");
-        map.put(java.sql.Date.class, "DATE");
-        map.put(java.sql.Time.class, "TIME");
-
-        // 基本数据类型
-        map.put(int.class, "INT");
-        map.put(short.class, "SMALLINT");
-        map.put(byte.class, "TINYINT");
-        map.put(long.class, "BIGINT");
-        map.put(double.class, "DOUBLE");
-        map.put(float.class, "REAL");
-        map.put(boolean.class, "BOOLEAN");
-
-        javaProperty2SqlColumnMap = Collections.unmodifiableMap(map);
-    }
+    public static Map<Class<?>, String> javaProperty2SqlColumnMap = new HashMap<>();
 
     private static final Logger LOGGER = LoggerFactory.getLogger(CreateTable.class);
-    public static final String UNIQUE_PREFIX = "idx_";
+
+    static {
+        javaProperty2SqlColumnMap.put(Integer.class, "INT");
+        javaProperty2SqlColumnMap.put(Short.class, "SMALLINT");
+        javaProperty2SqlColumnMap.put(Byte.class, "TINYINT");
+        javaProperty2SqlColumnMap.put(Long.class, "BIGINT");
+        javaProperty2SqlColumnMap.put(java.math.BigDecimal.class, "DECIMAL");
+        javaProperty2SqlColumnMap.put(Double.class, "DOUBLE");
+        javaProperty2SqlColumnMap.put(Float.class, "REAL");
+        javaProperty2SqlColumnMap.put(Boolean.class, "BOOLEAN");
+        javaProperty2SqlColumnMap.put(String.class, "VARCHAR");
+        javaProperty2SqlColumnMap.put(java.util.Date.class, "TIMESTAMP");
+        javaProperty2SqlColumnMap.put(java.sql.Timestamp.class, "TIMESTAMP");
+        javaProperty2SqlColumnMap.put(java.sql.Date.class, "DATE");
+        javaProperty2SqlColumnMap.put(java.sql.Time.class, "TIME");
+
+        javaProperty2SqlColumnMap.put(int.class, "INT");
+        javaProperty2SqlColumnMap.put(short.class, "SMALLINT");
+        javaProperty2SqlColumnMap.put(byte.class, "TINYINT");
+        javaProperty2SqlColumnMap.put(long.class, "BIGINT");
+        javaProperty2SqlColumnMap.put(double.class, "DOUBLE");
+        javaProperty2SqlColumnMap.put(float.class, "REAL");
+        javaProperty2SqlColumnMap.put(boolean.class, "BOOLEAN");
+    }
 
     private static Case getCase(Class<?> clz) {
-        return switch (clz.getName()) {
-            case "io.vertx.codegen.format.CamelCase" -> CamelCase.INSTANCE;
-            case "io.vertx.codegen.format.SnakeCase" -> SnakeCase.INSTANCE;
-            case "io.vertx.codegen.format.LowerCamelCase" -> LowerCamelCase.INSTANCE;
-            default -> throw new UnsupportedOperationException();
-        };
-    }
-
-    public static List<String> getCreateTableSQL(Class<?> clz, JDBCType type) {
-        // 获取表名和主键
-        TableInfo tableInfo = extractTableInfo(clz, type);
-
-        // 构建表的SQL语句
-        List<String> sqlList = new ArrayList<>();
-        StringBuilder sb = new StringBuilder(50);
-        sb.append("CREATE TABLE IF NOT EXISTS ")
-                .append(tableInfo.quotationMarks).append(tableInfo.tableName).append(tableInfo.quotationMarks)
-                .append(" ( \r\n ");
-
-        // 处理字段并生成列定义
-        List<String> indexSQLs = new ArrayList<>();
-        processFields(clz, tableInfo, sb, indexSQLs);
-
-        // 去掉最后一个逗号并添加表尾部信息
-        String tableSQL = sb.substring(0, sb.lastIndexOf(",")) + tableInfo.endStr;
-        sqlList.add(tableSQL);
-
-        // 添加索引SQL
-        sqlList.addAll(indexSQLs);
-
-        return sqlList;
-    }
-
-
-    // 修改extractTableInfo方法，处理没有Table注解时默认使用id字段作为主键
-    private static TableInfo extractTableInfo(Class<?> clz, JDBCType type) {
-        String quotationMarks;
-        String endStr;
-        if (type == JDBCType.MySQL) {
-            quotationMarks = "`";
-            endStr = ")ENGINE=InnoDB DEFAULT CHARSET=utf8;";
-        } else {
-            quotationMarks = "\"";
-            endStr = ");";
+        switch (clz.getName()) {
+            case "io.vertx.codegen.format.CamelCase":
+                return CamelCase.INSTANCE;
+            case "io.vertx.codegen.format.SnakeCase":
+                return SnakeCase.INSTANCE;
+            case "io.vertx.codegen.format.LowerCamelCase":
+                return LowerCamelCase.INSTANCE;
+            default:
+                throw new UnsupportedOperationException();
         }
+    }
 
-        String primaryKey = null;
-        String tableName = null;
+    public static String getCreateTableSQL(Class<?> clz) {
+        // 判断类上是否有次注解
+        String primaryKey = null; // 主键
+        String tableName = null; // 表名
         Case caseFormat = SnakeCase.INSTANCE;
-
-        // 判断类上是否有RowMapped注解
         if (clz.isAnnotationPresent(RowMapped.class)) {
             RowMapped annotation = clz.getAnnotation(RowMapped.class);
-            caseFormat = getCase(annotation.formatter());
+            Class<? extends Case> formatter = annotation.formatter();
+            caseFormat = getCase(formatter);
         }
 
-        // 判断类上是否有Table注解
         if (clz.isAnnotationPresent(Table.class)) {
+            // 获取类上的注解
             Table annotation = clz.getAnnotation(Table.class);
-            tableName = StringUtils.isNotEmpty(annotation.value())
-                    ? annotation.value()
-                    : LowerCamelCase.INSTANCE.to(caseFormat, clz.getSimpleName());
+            // 输出注解上的类名
+            String tableNameAnnotation = annotation.value();
+            if (StringUtils.isNotEmpty(tableNameAnnotation)) {
+                tableName = tableNameAnnotation;
+            } else {
+                tableName = LowerCamelCase.INSTANCE.to(caseFormat, clz.getSimpleName());
+            }
             primaryKey = annotation.keyFields();
         }
-
-        // 如果表名仍为null，使用类名转下划线命名作为表名
-        if (StringUtils.isEmpty(tableName)) {
-            tableName = LowerCamelCase.INSTANCE.to(SnakeCase.INSTANCE, clz.getSimpleName());
-        }
-
-        // 如果主键为空，默认使用id字段作为主键
-        if (StringUtils.isEmpty(primaryKey)) {
-            try {
-                clz.getDeclaredField("id");
-                primaryKey = "id";
-            } catch (NoSuchFieldException e) {
-                // 如果没有id字段，不设置主键
-                primaryKey = null;
-            }
-        }
-
-        return new TableInfo(tableName, quotationMarks, endStr, primaryKey, caseFormat, type);
-    }
-
-    // 修改processFields方法，处理索引
-    private static void processFields(Class<?> clz, TableInfo tableInfo, StringBuilder sb, List<String> indexSQLs) {
         Field[] fields = clz.getDeclaredFields();
-        for (Field field : fields) {
-            // 跳过无效字段
-            if (isIgnoredField(field)) {
+        String column;
+        int[] decimalSize = {22, 2};
+        int varcharSize = 255;
+        StringBuilder sb = new StringBuilder(50);
+        sb.append("CREATE TABLE IF NOT EXISTS \"").append(tableName).append("\" ( \r\n ");
+        boolean firstId = true;
+        for (Field f : fields) {
+            Class<?> paramType = f.getType();
+            String sqlType = javaProperty2SqlColumnMap.get(paramType);
+            if (f.getName().equals("serialVersionUID") || StringUtils.isEmpty(sqlType) || f.isAnnotationPresent(TableGenIgnore.class)) {
                 continue;
             }
-
-            // 获取字段名和SQL类型
-            String column = LowerCamelCase.INSTANCE.to(tableInfo.caseFormat, field.getName());
-            String sqlType = javaProperty2SqlColumnMap.get(field.getType());
-
-            // 处理字段注解
-            column = processColumnAnnotation(field, column);
-            int[] decimalSize = {22, 2};
-            int varcharSize = 255;
-            if (field.isAnnotationPresent(Length.class)) {
-                Length length = field.getAnnotation(Length.class);
-                decimalSize = length.decimalSize();
-                varcharSize = length.varcharSize();
+            column = LowerCamelCase.INSTANCE.to(caseFormat, f.getName());
+            if (f.isAnnotationPresent(Column.class)) {
+                Column columnAnnotation = f.getAnnotation(Column.class);
+                //输出注解属性
+                if (StringUtils.isNotBlank(columnAnnotation.name())) {
+                    column = columnAnnotation.name();
+                }
             }
-
-            // 构建列定义
-            sb.append(tableInfo.quotationMarks).append(column).append(tableInfo.quotationMarks)
-                    .append(" ").append(sqlType);
-            appendTypeLength(sqlType, sb, decimalSize, varcharSize);
-            appendConstraints(field, sb, tableInfo);
-            appendPrimaryKey(tableInfo.primaryKey, column, sb);
-
-            // 添加索引
-            appendIndex(tableInfo, indexSQLs, field);
-
-            sb.append(",\n ");
-        }
-    }
-
-    // 判断是否忽略字段
-    private static boolean isIgnoredField(Field field) {
-        return field.getName().equals("serialVersionUID")
-                || StringUtils.isEmpty(javaProperty2SqlColumnMap.get(field.getType()))
-                || field.isAnnotationPresent(TableGenIgnore.class);
-    }
-
-    // 处理Column注解
-    private static String processColumnAnnotation(Field field, String column) {
-        if (field.isAnnotationPresent(Column.class)) {
-            Column columnAnnotation = field.getAnnotation(Column.class);
-            if (StringUtils.isNotBlank(columnAnnotation.name())) {
-                column = columnAnnotation.name();
+            if (f.isAnnotationPresent(Length.class)) {
+                Length fieldAnnotation = f.getAnnotation(Length.class);
+                decimalSize = fieldAnnotation.decimalSize();
+                varcharSize = fieldAnnotation.varcharSize();
             }
-        }
-        return column;
-    }
-
-    // 添加类型长度
-    private static void appendTypeLength(String sqlType, StringBuilder sb, int[] decimalSize, int varcharSize) {
-        if ("DECIMAL".equals(sqlType)) {
-            sb.append("(").append(decimalSize[0]).append(",").append(decimalSize[1]).append(")");
-        } else if ("VARCHAR".equals(sqlType)) {
-            sb.append("(").append(varcharSize).append(")");
-        }
-    }
-
-    // 添加约束
-    private static void appendConstraints(Field field, StringBuilder sb, TableInfo tableInfo) {
-        JDBCType type = tableInfo.dbType;
-
-        if (field.isAnnotationPresent(Constraint.class)) {
-            Constraint constraint = field.getAnnotation(Constraint.class);
-            if (constraint.notNull()) {
-                sb.append(" NOT NULL");
+            sb.append("\"").append(column).append("\"");
+            sb.append(" ").append(sqlType);
+            // 添加类型长度
+            if (sqlType.equals("DECIMAL")) {
+                sb.append("(").append(decimalSize[0]).append(",").append(decimalSize[1]).append(")");
             }
-            String apostrophe = constraint.defaultValueIsFunction() ? "" : "'";
-            if (StringUtils.isNotEmpty(constraint.defaultValue())) {
-                sb.append(" DEFAULT ").append(apostrophe).append(constraint.defaultValue()).append(apostrophe);
+            if (sqlType.equals("VARCHAR")) {
+                sb.append("(").append(varcharSize).append(")");
             }
-            if (constraint.autoIncrement()) {
-                if (type == JDBCType.PostgreSQL) {
-                    // 需要移除字段类型(最后一个单词)
-                    if (field.getType().equals(Integer.class)) {
-                        sb.delete(sb.lastIndexOf(" "), sb.length());
-                        sb.append(" SERIAL");
-                    } else if (field.getType().equals(Long.class)) {
-                        sb.delete(sb.lastIndexOf(" "), sb.length());
-                        sb.append(" BIGSERIAL");
-                    }
-                } else if (field.getType().equals(Integer.class) || field.getType().equals(Long.class)) {
+            if (f.isAnnotationPresent(Constraint.class)) {
+                Constraint constraintAnnotation = f.getAnnotation(Constraint.class);
+                if (constraintAnnotation.notNull()) {
+                    //非空约束
+                    sb.append(" NOT NULL");
+                }
+                String apostrophe = constraintAnnotation.defaultValueIsFunction() ? "" : "'";
+                if (StringUtils.isNotEmpty(constraintAnnotation.defaultValue())) {
+                    //默认值约束
+                    sb.append(" DEFAULT ").append(apostrophe).append(constraintAnnotation.defaultValue()).append(apostrophe);
+                }
+                if (constraintAnnotation.autoIncrement() && paramType.equals(Integer.class) || paramType.equals(Long.class)) {
+                    ////自增
                     sb.append(" AUTO_INCREMENT");
                 }
             }
-        }
-    }
-
-    // 添加主键
-    private static void appendPrimaryKey(String primaryKey, String column, StringBuilder sb) {
-        if (StringUtils.isEmpty(primaryKey)) {
-            return;
-        }
-        if (primaryKey.equalsIgnoreCase(column)) {
-            sb.append(" PRIMARY KEY");
-        }
-    }
-
-    private static void appendIndex(TableInfo tableInfo, List<String> indexSQLs, Field field) {
-        if (!field.isAnnotationPresent(Constraint.class)) {
-            return;
-        }
-
-        Constraint constraint = field.getAnnotation(Constraint.class);
-        if (StringUtils.isEmpty(constraint.uniqueKey())) {
-            return;
-        }
-
-        String indexName = UNIQUE_PREFIX + tableInfo.tableName + "_" + constraint.uniqueKey();
-        String columnName = field.getName();
-
-        // 检查是否已有相同索引名称的索引
-        Optional<String> existingIndex = indexSQLs.stream()
-                .filter(sql -> sql.contains(tableInfo.quotationMarks + indexName + tableInfo.quotationMarks))
-                .findFirst();
-
-        if (existingIndex.isPresent()) {
-            // 如果存在相同索引名称，追加字段到索引定义中
-            String updatedIndex = existingIndex.get().replaceFirst(
-                    "\\(([^)]+)\\)", // 匹配索引字段列表
-                    "($1, " + tableInfo.quotationMarks + columnName + tableInfo.quotationMarks + ")"
-            );
-            indexSQLs.remove(existingIndex.get());
-            indexSQLs.add(updatedIndex);
-        } else {
-            // 如果不存在相同索引名称，创建新的索引
-            String indexSQL = String.format(
-                    "CREATE UNIQUE INDEX %s %s%s%s ON %s%s%s (%s%s%s);",
-                    tableInfo.dbType == JDBCType.MySQL ? "" : "IF NOT EXISTS",
-                    tableInfo.quotationMarks, indexName, tableInfo.quotationMarks,
-                    tableInfo.quotationMarks, tableInfo.tableName, tableInfo.quotationMarks,
-                    tableInfo.quotationMarks, columnName, tableInfo.quotationMarks
-            );
-            indexSQLs.add(indexSQL);
-        }
-    }
-
-    // 表信息类
-    private record TableInfo(
-            String tableName,        // 表名
-            String quotationMarks,   // 引号或反引号
-            String endStr,           // 表尾部信息
-            String primaryKey,       // 主键字段
-            Case caseFormat,         // 命名格式
-            JDBCType dbType          // 数据库类型
-    ) {
-    }
-
-    public static Future<Void> createTable(Pool pool, JDBCType type) {
-        Promise<Void> promise = Promise.promise();
-        Set<Class<?>> tableClasses = ReflectionUtil.getReflections().getTypesAnnotatedWith(Table.class);
-
-        if (tableClasses.isEmpty()) {
-            LOGGER.warn("Table model class not found");
-            promise.complete();
-            return promise.future();
-        }
-
-        List<Future<Object>> futures = new ArrayList<>();
-
-        for (Class<?> clazz : tableClasses) {
-            List<String> sqlList = getCreateTableSQL(clazz, type);
-            LOGGER.info("Class `{}` auto-generate table", clazz.getName());
-
-            for (String sql : sqlList) {
-                try {
-                    pool.query(sql).execute().toCompletionStage().toCompletableFuture().join();
-                    futures.add(Future.succeededFuture());
-                    LOGGER.debug("Executed SQL:\n{}", sql);
-                } catch (Exception e) {
-                    String message = e.getMessage();
-                    if (message != null && message.contains("Duplicate key name")) {
-                        LOGGER.warn("Ignoring duplicate key error: {}", message);
-                        futures.add(Future.succeededFuture());
-                    } else {
-                        LOGGER.error("SQL Error: {}\nSQL: {}", message, sql);
-                        futures.add(Future.failedFuture(e));
-                        throw new RuntimeException(e); // Stop execution for other exceptions
-                    }
+            if (StringUtils.isEmpty(primaryKey)) {
+                if (firstId) {//类型转换
+                    sb.append(" PRIMARY KEY");
+                    firstId = false;
+                }
+            } else {
+                if (primaryKey.equals(column.toLowerCase())) {
+                    sb.append(" PRIMARY KEY");
                 }
             }
+            sb.append(",\n ");
         }
-
-        Future.all(futures).onSuccess(r -> promise.complete()).onFailure(promise::fail);
-        return promise.future();
+        String sql = sb.toString();
+        //去掉最后一个逗号
+        int lastIndex = sql.lastIndexOf(",");
+        sql = sql.substring(0, lastIndex) + sql.substring(lastIndex + 1);
+        return sql.substring(0, sql.length() - 1) + ");\r\n";
     }
 
+    public static void createTable(JDBCPool pool, String tableClassPath) {
+        Set<Class<?>> tableClassList = ReflectionUtil.getReflections(tableClassPath).getTypesAnnotatedWith(Table.class);
+        if (tableClassList.isEmpty()) LOGGER.info("Table model class not fount");
+        tableClassList.forEach(clazz -> {
+            String createTableSQL = getCreateTableSQL(clazz);
+            pool.query(createTableSQL).execute().onSuccess(
+                    rs -> LOGGER.info("\n" + createTableSQL + "create table --> ok")
+            ).onFailure(Throwable::printStackTrace);
+        });
+    }
 }

core-database/src/main/java/cn/qaiu/db/pool/JDBCPoolInit.java

@@ -1,48 +1,39 @@
 package cn.qaiu.db.pool;
 
 import cn.qaiu.db.ddl.CreateTable;
-import cn.qaiu.db.ddl.CreateDatabase;
+import cn.qaiu.db.server.H2ServerHolder;
 import cn.qaiu.vx.core.util.VertxHolder;
-import io.vertx.core.Future;
+import io.vertx.core.Promise;
 import io.vertx.core.Vertx;
 import io.vertx.core.json.JsonObject;
 import io.vertx.jdbcclient.JDBCPool;
-import org.apache.commons.lang3.StringUtils;
+import org.h2.tools.Server;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import java.io.File;
+import java.io.IOException;
+import java.sql.SQLException;
+
 /**
  * 初始化JDBC
  * <br>Create date 2021/8/10 12:04
  *
  * @author <a href="https://qaiu.top">QAIU</a>
  */
-public class JDBCPoolInit implements AutoCloseable {
+public class JDBCPoolInit {
 
     private static final Logger LOGGER = LoggerFactory.getLogger(JDBCPoolInit.class);
-
-    private static final String providerClass = io.vertx.ext.jdbc.spi.impl.HikariCPDataSourceProvider.class.getName();
-
     private JDBCPool pool = null;
     JsonObject dbConfig;
     Vertx vertx = VertxHolder.getVertxInstance();
     String url;
 
-    private final JDBCType type;
-
     private static JDBCPoolInit instance;
 
-    public JDBCType getType() {
-        return type;
-    }
-
     public JDBCPoolInit(Builder builder) {
         this.dbConfig = builder.dbConfig;
         this.url = builder.url;
-        this.type = JDBCType.getJDBCTypeByURL(builder.url);
-        if (StringUtils.isBlank(builder.dbConfig.getString("provider_class"))) {
-            builder.dbConfig.put("provider_class", providerClass);
-        }
     }
 
     public static Builder builder() {
@@ -71,46 +62,86 @@ public class JDBCPoolInit implements AutoCloseable {
         }
     }
 
+
     /**
      * init h2db<br>
      * 这个方法只允许调用一次
      */
-    synchronized public Future<Void> initPool() {
+    public void initPool() {
         if (pool != null) {
             LOGGER.error("pool 重复初始化");
-            return null;
+            return;
         }
 
-        // 初始化数据库连接
-        // 初始化连接池
-        if (type == JDBCType.MySQL) {
-            CreateDatabase.createDatabase(dbConfig);
-        }
-        pool = JDBCPool.pool(vertx, dbConfig);
-        LOGGER.info("数据库连接初始化: URL=" + url);
-        return CreateTable.createTable(pool, type);
+        // 异步启动H2服务
+        vertx.createSharedWorkerExecutor("h2-server", 1, Long.MAX_VALUE)
+                .executeBlocking(this::h2serverExecute)
+                .onSuccess(res->{
+                    LOGGER.info(res);
+                    // 初始化数据库连接
+                    vertx.createSharedWorkerExecutor("sql-pool-init")
+                            .executeBlocking(this::poolInitExecute)
+                            .onSuccess(LOGGER::info)
+                            .onFailure(Throwable::printStackTrace);
+                })
+                .onFailure(Throwable::printStackTrace);
+
+
     }
 
+    private void poolInitExecute(Promise<String> promise) {
+        // 初始化连接池
+        pool = JDBCPool.pool(vertx, dbConfig);
+        CreateTable.createTable(pool, dbConfig.getString("tableClassPath"));
+        promise.complete("init jdbc pool success");
 
+    }
+
+    private void checkOrCreateDBFile() {
+        LOGGER.info("init sql start");
+        String[] path = url.split("\\./");
+        path[1] = path[1].split(";")[0];
+        path[1] += ".mv.db";
+        File file = new File(path[1]);
+        if (!file.exists()) {
+            if (!file.getParentFile().exists()) {
+                if (file.getParentFile().mkdirs()) {
+                    LOGGER.info("mkdirs -> {}", file.getParentFile().getAbsolutePath());
+                }
+            }
+            try {
+                if (file.createNewFile()) {
+                    LOGGER.info("create file -> {}", file.getAbsolutePath());
+                }
+            } catch (IOException e) {
+                LOGGER.error(e.getMessage());
+                throw new RuntimeException("file create failed");
+            }
+        }
+    }
+
+    private void h2serverExecute(Promise<String> promise) {
+        // 初始化H2db, 创建本地db文件
+        checkOrCreateDBFile();
+
+        try {
+            String url = dbConfig.getString("jdbcUrl");
+            String[] portStr = url.split(":");
+            String port = portStr[portStr.length - 1].split("[/\\\\]")[0];
+            LOGGER.info("H2server listen port to {}", port);
+            H2ServerHolder.init(Server.createTcpServer("-tcp", "-tcpAllowOthers", "-tcpPort", port).start());
+            promise.complete("Start h2Server success");
+        } catch (SQLException e) {
+            throw new RuntimeException("Start h2Server failed: " + e.getMessage());
+        }
+    }
 
     /**
      * 获取连接池
      *
      * @return pool
      */
-    synchronized public JDBCPool getPool() {
+    public JDBCPool getPool() {
         return pool;
     }
-
-    /**
-     * 关闭连接池，释放数据库资源
-     */
-    @Override
-    public synchronized void close() {
-        if (pool != null) {
-            pool.close();
-            LOGGER.info("数据库连接池已关闭: URL={}", url);
-            pool = null;
-        }
-    }
 }

core-database/src/main/java/cn/qaiu/db/pool/JDBCType.java

@@ -1,35 +0,0 @@
-package cn.qaiu.db.pool;
-
-import org.apache.commons.lang3.StringUtils;
-
-/**
- * @author <a href="https://qaiu.top">QAIU</a>
- * @since 2023/10/10 14:06
- */
-public enum JDBCType {
-    // 添加驱动类型字段
-    MySQL("jdbc:mysql:"),
-    H2DB("jdbc:h2:"),
-    PostgreSQL("jdbc:postgresql:");
-    private final String urlPrefix; // JDBC URL 前缀
-
-    // 构造函数
-    JDBCType(String urlPrefix) {
-        this.urlPrefix = urlPrefix;
-    }
-
-    // 获取 JDBC URL 前缀
-    public String getUrlPrefix() {
-        return urlPrefix;
-    }
-
-    // 根据 JDBC URL 获取 JDBC 类型
-    public static JDBCType getJDBCTypeByURL(String jdbcURL) {
-        for (JDBCType jdbcType : values()) {
-            if (StringUtils.startsWithIgnoreCase(jdbcURL, jdbcType.getUrlPrefix())) {
-                return jdbcType;
-            }
-        }
-        throw new RuntimeException("不支持的SQL类型: " + jdbcURL);
-    }
-}

core/pom.xml

@@ -5,22 +5,41 @@
     <parent>
         <artifactId>netdisk-fast-download</artifactId>
         <groupId>cn.qaiu</groupId>
-        <version>${revision}</version>
+        <version>0.1.6</version>
     </parent>
     <modelVersion>4.0.0</modelVersion>
+    <version>1.0.8</version>
     <artifactId>core</artifactId>
 
     <properties>
+        <java.version>17</java.version>
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-        <maven.build.timestamp.format>yyMMdd_HHmm</maven.build.timestamp.format>
+        <vertx.version>4.4.1</vertx.version>
+        <org.reflections.version>0.10.2</org.reflections.version>
+        <lombok.version>1.18.12</lombok.version>
+        <slf4j.version>2.0.5</slf4j.version>
+        <commons-lang3.version>3.12.0</commons-lang3.version>
+        <jackson.version>2.14.2</jackson.version>
     </properties>
 
+    <dependencyManagement>
+        <dependencies>
+            <dependency>
+                <groupId>io.vertx</groupId>
+                <artifactId>vertx-dependencies</artifactId>
+                <version>${vertx.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
+        </dependencies>
+    </dependencyManagement>
+
     <dependencies>
         <!--logback日志实现-->
         <dependency>
             <groupId>ch.qos.logback</groupId>
             <artifactId>logback-classic</artifactId>
-            <version>${logback.version}</version>
+            <version>1.4.6</version>
         </dependency>
         <dependency>
             <groupId>org.slf4j</groupId>
@@ -61,48 +80,28 @@
             <artifactId>commons-lang3</artifactId>
             <version>${commons-lang3.version}</version>
         </dependency>
-
+        <dependency>
+            <groupId>commons-beanutils</groupId>
+            <artifactId>commons-beanutils</artifactId>
+            <version>1.9.4</version>
+        </dependency>
         <dependency>
             <groupId>com.fasterxml.jackson.core</groupId>
             <artifactId>jackson-databind</artifactId>
             <version>${jackson.version}</version>
         </dependency>
-        <dependency>
-            <groupId>com.fasterxml.jackson.datatype</groupId>
-            <artifactId>jackson-datatype-jsr310</artifactId>
-            <version>${jackson.version}</version>
-        </dependency>
-
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-            <version>${junit.version}</version>
-            <scope>test</scope>
-        </dependency>
 
     </dependencies>
 
     <build>
-        <resources>
-            <resource>
-                <directory>src/main/resources</directory>
-                <filtering>true</filtering>
-            </resource>
-        </resources>
         <plugins>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-compiler-plugin</artifactId>
-                <version>3.13.0</version>
+                <version>3.8.1</version>
                 <configuration>
-                    <release>${java.version}</release>
-                    <!-- 代码生成器 -->
-                    <annotationProcessors>
-                        <annotationProcessor>io.vertx.codegen.CodeGenProcessor</annotationProcessor>
-                    </annotationProcessors>
-                    <generatedSourcesDirectory>
-                        ${project.basedir}/src/main/generated
-                    </generatedSourcesDirectory>
+                    <source>${java.version}</source>
+                    <target>${java.version}</target>
                 </configuration>
             </plugin>
         </plugins>

core/src/main/java/cn/qaiu/vx/core/Deploy.java

@@ -1,32 +1,22 @@
 package cn.qaiu.vx.core;
 
-import cn.qaiu.vx.core.util.CommonUtil;
+import cn.qaiu.vx.core.util.ConfigConstant;
 import cn.qaiu.vx.core.util.ConfigUtil;
 import cn.qaiu.vx.core.util.VertxHolder;
-import cn.qaiu.vx.core.verticle.HttpProxyVerticle;
-import cn.qaiu.vx.core.verticle.PostExecVerticle;
 import cn.qaiu.vx.core.verticle.ReverseProxyVerticle;
 import cn.qaiu.vx.core.verticle.RouterVerticle;
 import cn.qaiu.vx.core.verticle.ServiceVerticle;
 import io.vertx.core.*;
-import io.vertx.core.dns.AddressResolverOptions;
 import io.vertx.core.json.JsonObject;
 import io.vertx.core.shareddata.LocalMap;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 import java.lang.management.ManagementFactory;
-import java.nio.file.Files;
-import java.nio.file.Path;
 import java.util.Calendar;
 import java.util.Date;
-import java.util.UUID;
-import java.util.List;
-import java.util.concurrent.CopyOnWriteArrayList;
 import java.util.concurrent.locks.LockSupport;
 
-import static cn.qaiu.vx.core.util.ConfigConstant.*;
-
 /**
  * vertx启动类 需要在主启动类完成回调
  * <br>Create date 2021-05-07 10:26:54
@@ -47,52 +37,23 @@ public final class Deploy {
     private Handler<JsonObject> handle;
 
     private Thread mainThread;
-    private final List<Runnable> preShutdownTasks = new CopyOnWriteArrayList<>();
-    private final List<Runnable> postShutdownTasks = new CopyOnWriteArrayList<>();
 
     public static Deploy instance() {
         return INSTANCE;
     }
 
-    public void addPreShutdownTask(Runnable task) {
-        if (task != null) {
-            preShutdownTasks.add(task);
-        }
-    }
-
-    public void addPostShutdownTask(Runnable task) {
-        if (task != null) {
-            postShutdownTasks.add(task);
-        }
-    }
-
-    /**
-     *
-     * @param args 启动参数
-     * @param handle 启动完成后回调处理函数
-     */
     public void start(String[] args, Handler<JsonObject> handle) {
         this.mainThread = Thread.currentThread();
         this.handle = handle;
-
-        if (args.length > 0 && args[0].startsWith("app-")) {
+        if (args.length > 0) {
             // 启动参数dev或者prod
-            path.append("-").append(args[0].replace("app-",""));
+            path.append("-").append(args[0]);
         }
 
-        // 读取yml配置，优先当前目录，其次 resources/ 子目录
-        String configFile = path + ".yml";
-        if (!Files.exists(Path.of(configFile)) && Files.exists(Path.of("resources", configFile))) {
-            path.insert(0, "resources/");
-            LOGGER.info("从 resources/ 目录加载配置: {}", path + ".yml");
-        }
+        // 读取yml配置
         ConfigUtil.readYamlConfig(path.toString(), tempVertx)
                 .onSuccess(this::readConf)
-                .onFailure(err -> {
-                    LOGGER.error("读取配置文件失败: {}", err.getMessage(), err);
-                    LockSupport.unpark(mainThread);
-                    System.exit(-1);
-                });
+                .onFailure(Throwable::printStackTrace);
         LockSupport.park();
         deployVerticle();
     }
@@ -119,7 +80,7 @@ public final class Deploy {
         var calendar = Calendar.getInstance();
         calendar.setTime(new Date());
         var year = calendar.get(Calendar.YEAR);
-        var logoTemplate = """
+        var logoTemplete = """
 
                 Web Server powered by:\s
                  ____   ____              _              _    _   \s
@@ -132,9 +93,9 @@ public final class Deploy {
 
                 """;
 
-        System.out.printf(logoTemplate,
-                CommonUtil.getAppVersion(),
-                "4x",
+        System.out.printf(logoTemplete,
+                conf.getString("version_app"),
+                conf.getString("version_vertx"),
                 conf.getString("copyright"),
                 year
         );
@@ -146,115 +107,37 @@ public final class Deploy {
     private void deployVerticle() {
         tempVertx.close();
         LOGGER.info("配置读取成功");
-        customConfig = globalConfig.getJsonObject(CUSTOM);
+        customConfig = globalConfig.getJsonObject(ConfigConstant.CUSTOM);
 
-        JsonObject vertxConfig = globalConfig.getJsonObject(VERTX);
-        JsonObject vertxOptionsConfig = vertxConfig.copy();
-        if (vertxOptionsConfig.getInteger(EVENT_LOOP_POOL_SIZE, 0) == 0) {
-            vertxOptionsConfig.remove(EVENT_LOOP_POOL_SIZE);
-        }
-        if (vertxOptionsConfig.getInteger("workerPoolSize", 0) == 0) {
-            vertxOptionsConfig.remove("workerPoolSize");
-        }
-        Integer vertxConfigELPS = vertxConfig.getInteger(EVENT_LOOP_POOL_SIZE, 0);
-        var vertxOptions = vertxOptionsConfig.isEmpty() ?
-                new VertxOptions() : new VertxOptions(vertxOptionsConfig);
+        JsonObject vertxConfig = globalConfig.getJsonObject(ConfigConstant.VERTX);
+        Integer vertxConfigELPS = vertxConfig.getInteger(ConfigConstant.EVENT_LOOP_POOL_SIZE);
+        var vertxOptions = vertxConfigELPS == 0 ?
+                new VertxOptions() : new VertxOptions(vertxConfig);
 
-//        vertxOptions.setAddressResolverOptions(
-//                new AddressResolverOptions().
-//                        addServer("114.114.114.114").
-//                        addServer("114.114.115.115").
-//                        addServer("8.8.8.8").
-//                        addServer("8.8.4.4"));
         LOGGER.info("vertxConfigEventLoopPoolSize: {}, eventLoopPoolSize: {}, workerPoolSize: {}", vertxConfigELPS,
                 vertxOptions.getEventLoopPoolSize(),
                 vertxOptions.getWorkerPoolSize());
         var vertx = Vertx.vertx(vertxOptions);
         VertxHolder.init(vertx);
-
-        // 注册 ShutdownHook，确保进程退出时优雅关闭资源
-        Runtime.getRuntime().addShutdownHook(new Thread(() -> {
-            LOGGER.info("JVM shutting down...");
-            runShutdownTasks("before Vert.x close", preShutdownTasks);
-            try {
-                LOGGER.info("Closing Vert.x...");
-                vertx.close().toCompletionStage().toCompletableFuture().get(10, java.util.concurrent.TimeUnit.SECONDS);
-                LOGGER.info("Vert.x closed successfully");
-            } catch (Exception e) {
-                LOGGER.warn("Vert.x close error or timeout", e);
-            } finally {
-                runShutdownTasks("after Vert.x close", postShutdownTasks);
-            }
-        }));
         //配置保存在共享数据中
         var sharedData = vertx.sharedData();
-        LocalMap<String, Object> localMap = sharedData.getLocalMap(LOCAL);
-        localMap.put(GLOBAL_CONFIG, globalConfig);
-        localMap.put(CUSTOM_CONFIG, customConfig);
-        localMap.put(SERVER, globalConfig.getJsonObject(SERVER));
-        WorkerExecutor otherHandleExecutor = vertx.createSharedWorkerExecutor("other-handle");
-        var future0 = otherHandleExecutor.executeBlocking(() -> {
-                    handle.handle(globalConfig);
-                    return "Other handle complete";
-                });
-
-        future0.onSuccess(res -> {
-            otherHandleExecutor.close();
-            LOGGER.info(res);
-            // 部署 路由、异步service、反向代理 服务
-            var future1 = vertx.deployVerticle(RouterVerticle.class, getWorkDeploymentOptions("Router"));
-            var future2 = vertx.deployVerticle(ServiceVerticle.class, getWorkDeploymentOptions("Service"));
-            var future3 = vertx.deployVerticle(ReverseProxyVerticle.class, getWorkDeploymentOptions("proxy", 1));
-
-
-            JsonObject jsonObject = ((JsonObject) localMap.get(GLOBAL_CONFIG)).getJsonObject("proxy-server");
-            if (jsonObject != null) {
-                genPwd(jsonObject);
-                var future4 = vertx.deployVerticle(HttpProxyVerticle.class, getWorkDeploymentOptions("proxy", 1));
-                future4.onSuccess(LOGGER::info);
-                future4.onFailure(e -> LOGGER.error("Other handle error", e));
-                Future.all(future1, future2, future3, future4)
-                        .onSuccess(this::deployWorkVerticalSuccess)
-                        .onFailure(this::deployVerticalFailed);
-            } else {
-                Future.all(future1, future2, future3)
-                        .onSuccess(this::deployWorkVerticalSuccess)
-                        .onFailure(this::deployVerticalFailed);
-            }
-
-        }).onFailure(e -> {
-            otherHandleExecutor.close();
-            LOGGER.error("Other handle error", e);
+        LocalMap<String, Object> localMap = sharedData.getLocalMap(ConfigConstant.LOCAL);
+        localMap.put(ConfigConstant.GLOBAL_CONFIG, globalConfig);
+        localMap.put(ConfigConstant.CUSTOM_CONFIG, customConfig);
+        localMap.put(ConfigConstant.SERVER, globalConfig.getJsonObject(ConfigConstant.SERVER));
+        var future0 = vertx.createSharedWorkerExecutor("other-handle").executeBlocking(bch -> {
+            handle.handle(globalConfig);
+            bch.complete("other handle complete");
         });
-    }
 
-    private static void genPwd(JsonObject jsonObject) {
-        if (jsonObject.getBoolean("randUserPwd")) {
-            var username = UUID.randomUUID().toString().replace("-", "").substring(0, 16);
-            var password = UUID.randomUUID().toString().replace("-", "").substring(0, 16);
-            jsonObject.put("username", username);
-            jsonObject.put("password", password);
-        }
-        LOGGER.info("=============server info=================");
-        LOGGER.info("\nport: {}\nusername: {}\npassword: {}",
-                jsonObject.getString("port"),
-                jsonObject.getString("username"),
-                jsonObject.getString("password"));
-        LOGGER.info("==============server info================");
-    }
+        // 部署 路由、异步service、反向代理 服务
+        var future1 = vertx.deployVerticle(RouterVerticle.class, getWorkDeploymentOptions("Router"));
+        var future2 = vertx.deployVerticle(ServiceVerticle.class, getWorkDeploymentOptions("Service"));
+        var future3 = vertx.deployVerticle(ReverseProxyVerticle.class, getWorkDeploymentOptions("proxy"));
 
-    private static void runShutdownTasks(String stage, List<Runnable> tasks) {
-        if (tasks.isEmpty()) {
-            return;
-        }
-        LOGGER.info("Running {} shutdown tasks: {}", stage, tasks.size());
-        for (Runnable task : tasks) {
-            try {
-                task.run();
-            } catch (Exception e) {
-                LOGGER.warn("Shutdown task failed at stage {}", stage, e);
-            }
-        }
+        CompositeFuture.all(future1, future2, future3, future0)
+                .onSuccess(this::deployWorkVerticalSuccess)
+                .onFailure(this::deployVerticalFailed);
     }
 
     /**
@@ -276,42 +159,6 @@ public final class Deploy {
         var t1 = ((double) (System.currentTimeMillis() - startTime)) / 1000;
         var t2 = ((double) System.currentTimeMillis() - ManagementFactory.getRuntimeMXBean().getStartTime()) / 1000;
         LOGGER.info("web服务启动成功 -> 用时: {}s, jvm启动用时: {}s", t1, t2);
-
-        // 检查是否处于安装引导模式（数据库未配置）
-        Object installMode = VertxHolder.getVertxInstance().sharedData()
-                .getLocalMap(LOCAL).get("installMode");
-        if (Boolean.TRUE.equals(installMode)) {
-            LOGGER.info("系统处于安装引导模式，等待用户完成数据库配置后再启动后置初始化...");
-            return;
-        }
-
-        // 正常模式：部署 PostExecVerticle 执行 AppRun 实现
-        deployPostExec();
-    }
-
-    /**
-     * 部署 PostExecVerticle（执行所有 AppRun 实现）
-     * 安装引导完成后也可手动调用此方法触发后置初始化
-     */
-    public void deployPostExec() {
-        var vertx = VertxHolder.getVertxInstance();
-        var postExecFuture = vertx.deployVerticle(PostExecVerticle.class, getWorkDeploymentOptions("postExec", 2));
-        postExecFuture.onSuccess(id -> {
-            LOGGER.info("PostExecVerticle 部署成功，AppRun 实现执行完成");
-        }).onFailure(e -> {
-            LOGGER.error("PostExecVerticle 部署失败", e);
-        });
-    }
-
-    /**
-     * 重新部署 ServiceVerticle，重新注册因 DB 未就绪而失败的服务到 EventBus
-     * 安装引导完成、DB 初始化后调用
-     */
-    public void redeployServices() {
-        var vertx = VertxHolder.getVertxInstance();
-        vertx.deployVerticle(ServiceVerticle.class, getWorkDeploymentOptions("Service"))
-                .onSuccess(id -> LOGGER.info("ServiceVerticle 重新部署成功，DB 相关服务已注册"))
-                .onFailure(e -> LOGGER.error("ServiceVerticle 重新部署失败", e));
     }
 
     /**
@@ -321,13 +168,13 @@ public final class Deploy {
      * @return Deployment Options
      */
     private DeploymentOptions getWorkDeploymentOptions(String name) {
-        return getWorkDeploymentOptions(name, customConfig.getInteger(ASYNC_SERVICE_INSTANCES));
+        return getWorkDeploymentOptions(name, customConfig.getInteger(ConfigConstant.ASYNC_SERVICE_INSTANCES));
     }
 
     private DeploymentOptions getWorkDeploymentOptions(String name, int ins) {
         return new DeploymentOptions()
                 .setWorkerPoolName(name)
-                .setThreadingModel(ThreadingModel.WORKER)
+                .setWorker(true)
                 .setInstances(ins);
     }
 

core/src/main/java/cn/qaiu/vx/core/annotaions/HandleSortFilter.java

@@ -1,16 +0,0 @@
-package cn.qaiu.vx.core.annotaions;
-
-import java.lang.annotation.*;
-
-@Documented
-@Inherited
-@Target(ElementType.TYPE)
-@Retention(RetentionPolicy.RUNTIME)
-public @interface HandleSortFilter {
-    /**
-     * 注册顺序，数字越大越先注册<br>
-     * 前置拦截器会先执行后注册即数字小的, 后置拦截器会先执行先注册的即数字大的<br>
-     * 值<0时会过滤掉该处理器
-     */
-    int value() default 0;
-}

core/src/main/java/cn/qaiu/vx/core/annotaions/InterceptorConfig.java

@@ -1,23 +0,0 @@
-package cn.qaiu.vx.core.annotaions;
-
-import java.lang.annotation.*;
-
-/**
- * 拦截器配置注解
- * 正则匹配拦截途径
- *
- * @author <a href="https://qaiu.top">QAIU</a>
- */
-@Documented
-@Inherited
-@Target(ElementType.TYPE)
-@Retention(RetentionPolicy.RUNTIME)
-public @interface InterceptorConfig {
-
-    String pattern() default "";
-
-    /**
-     * 注册顺序，数字越大越先注册
-     */
-    int order() default 0;
-}

core/src/main/java/cn/qaiu/vx/core/base/AppRun.java

@@ -1,12 +0,0 @@
-package cn.qaiu.vx.core.base;
-
-import io.vertx.core.json.JsonObject;
-
-public interface AppRun {
-
-    /**
-     * 执行方法
-     * @param config 启动配置文件
-     */
-    void execute(JsonObject config);
-}

core/src/main/java/cn/qaiu/vx/core/base/BaseHttpApi.java

@@ -1,22 +1,9 @@
 package cn.qaiu.vx.core.base;
 
-import cn.qaiu.vx.core.annotaions.HandleSortFilter;
-import cn.qaiu.vx.core.interceptor.AfterInterceptor;
-import cn.qaiu.vx.core.model.JsonResult;
-import cn.qaiu.vx.core.util.ReflectionUtil;
 import io.vertx.core.json.JsonObject;
 import io.vertx.ext.web.RoutingContext;
-import org.reflections.Reflections;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 
-import java.util.Collections;
-import java.util.LinkedHashSet;
-import java.util.Objects;
-import java.util.Set;
-import java.util.stream.Collectors;
-
-import static cn.qaiu.vx.core.util.ResponseUtil.*;
+import static io.vertx.core.http.HttpHeaders.CONTENT_TYPE;
 
 /**
  * 统一响应处理
@@ -26,106 +13,22 @@ import static cn.qaiu.vx.core.util.ResponseUtil.*;
  */
 public interface BaseHttpApi {
 
-    // 需要扫描注册的Router路径
-    Reflections reflections = ReflectionUtil.getReflections();
-    Logger LOGGER = LoggerFactory.getLogger(BaseHttpApi.class);
-
-    default void doFireJsonObjectResponse(RoutingContext ctx, JsonObject jsonObject) {
-        if (!isResponseDone(ctx)) {
-            fireJsonObjectResponse(ctx, jsonObject);
-        }
-        handleAfterInterceptor(ctx, jsonObject);
+    default void fireJsonResponse(RoutingContext ctx, JsonObject jsonResult) {
+        ctx.response().putHeader(CONTENT_TYPE, "application/json; charset=utf-8")
+                .setStatusCode(200)
+                .end(jsonResult.encode());
     }
 
-
-    default <T> void doFireJsonResultResponse(RoutingContext ctx, JsonResult<T> jsonResult) {
-        if (!isResponseDone(ctx)) {
-            fireJsonResultResponse(ctx, jsonResult);
-        }
-        handleAfterInterceptor(ctx, jsonResult.toJsonObject());
+    default <T> void fireJsonResponse(RoutingContext ctx, T jsonResult) {
+        JsonObject jsonObject = JsonObject.mapFrom(jsonResult);
+        fireJsonResponse(ctx, jsonObject);
     }
 
-    default void doFireJsonObjectResponse(RoutingContext ctx, JsonObject jsonObject, int statusCode) {
-        if (!isResponseDone(ctx)) {
-            fireJsonObjectResponse(ctx, jsonObject, statusCode);
-        }
-        handleAfterInterceptor(ctx, jsonObject);
+    default void fireTextResponse(RoutingContext ctx, String text) {
+        ctx.response().putHeader("content-type", "text/html; charset=utf-8").end(text);
     }
 
-
-    default <T> void doFireJsonResultResponse(RoutingContext ctx, JsonResult<T> jsonResult, int statusCode) {
-        if (!isResponseDone(ctx)) {
-            fireJsonResultResponse(ctx, jsonResult, statusCode);
-        }
-        handleAfterInterceptor(ctx, jsonResult.toJsonObject());
+    default void sendError(int statusCode, RoutingContext ctx) {
+        ctx.response().setStatusCode(statusCode).end();
     }
-
-    default Set<AfterInterceptor> getAfterInterceptor() {
-        return AfterInterceptorHolder.INSTANCES;
-    }
-
-    class AfterInterceptorHolder {
-        private static final Set<AfterInterceptor> INSTANCES = loadAfterInterceptors();
-
-        private static Set<AfterInterceptor> loadAfterInterceptors() {
-            Set<Class<? extends AfterInterceptor>> afterInterceptorClassSet =
-                    reflections.getSubTypesOf(AfterInterceptor.class);
-            if (afterInterceptorClassSet == null || afterInterceptorClassSet.isEmpty()) {
-                return Collections.emptySet();
-            }
-            return afterInterceptorClassSet.stream()
-                    .filter(AfterInterceptorHolder::isEnabled)
-                    .sorted(AfterInterceptorHolder::compareOrder)
-                    .map(AfterInterceptorHolder::newInterceptor)
-                    .filter(Objects::nonNull)
-                    .collect(Collectors.collectingAndThen(
-                            Collectors.toCollection(LinkedHashSet::new),
-                            Collections::unmodifiableSet));
-        }
-
-        private static boolean isEnabled(Class<? extends AfterInterceptor> clazz) {
-            HandleSortFilter sort = clazz.getAnnotation(HandleSortFilter.class);
-            return sort == null || sort.value() >= 0;
-        }
-
-        private static int compareOrder(Class<? extends AfterInterceptor> left, Class<? extends AfterInterceptor> right) {
-            return Integer.compare(order(left), order(right));
-        }
-
-        private static int order(Class<? extends AfterInterceptor> clazz) {
-            HandleSortFilter sort = clazz.getAnnotation(HandleSortFilter.class);
-            return sort == null ? 0 : sort.value();
-        }
-
-        private static AfterInterceptor newInterceptor(Class<? extends AfterInterceptor> clazz) {
-            try {
-                return ReflectionUtil.newWithNoParam(clazz);
-            } catch (Exception e) {
-                LOGGER.warn("AfterInterceptor 初始化失败，已跳过: {}", clazz.getName(), e);
-                return null;
-            }
-        }
-    }
-
-    default void handleAfterInterceptor(RoutingContext ctx, JsonObject jsonObject) {
-        if (ctx.response().closed()) {
-            return;
-        }
-        Set<AfterInterceptor> afterInterceptor = getAfterInterceptor();
-        afterInterceptor.forEach(ai -> {
-            try {
-                ai.handle(ctx, jsonObject);
-            } catch (Exception e) {
-                LOGGER.warn("AfterInterceptor 执行失败: {}", ai.getClass().getName(), e);
-            }
-        });
-        if (!isResponseDone(ctx)) {
-            fireTextResponse(ctx, "handleAfterInterceptor: response not end");
-        }
-    }
-
-    default boolean isResponseDone(RoutingContext ctx) {
-        return ctx.response().ended() || ctx.response().closed();
-    }
-
 }

core/src/main/java/cn/qaiu/vx/core/base/DefaultAppRun.java

@@ -1,23 +0,0 @@
-package cn.qaiu.vx.core.base;
-
-import cn.qaiu.vx.core.annotaions.HandleSortFilter;
-import io.vertx.core.json.JsonObject;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-/**
- * 默认的AppRun实现示例
- * <br>Create date 2024-01-01 00:00:00
- *
- * @author <a href="https://qaiu.top">QAIU</a>
- */
-@HandleSortFilter
-public class DefaultAppRun implements AppRun {
-
-    private static final Logger LOGGER = LoggerFactory.getLogger(DefaultAppRun.class);
-
-    @Override
-    public void execute(JsonObject config) {
-        LOGGER.info("======> AppRun实现类开始执行，配置数: {}", config.size());
-    }
-}

core/src/main/java/cn/qaiu/vx/core/handlerfactory/RouterHandlerFactory.java

@@ -5,10 +5,9 @@ import cn.qaiu.vx.core.annotaions.RouteHandler;
 import cn.qaiu.vx.core.annotaions.RouteMapping;
 import cn.qaiu.vx.core.annotaions.SockRouteMapper;
 import cn.qaiu.vx.core.base.BaseHttpApi;
-import cn.qaiu.vx.core.interceptor.BeforeInterceptor;
+import cn.qaiu.vx.core.enums.MIMEType;
 import cn.qaiu.vx.core.model.JsonResult;
 import cn.qaiu.vx.core.util.*;
-import io.netty.handler.codec.http.HttpHeaderValues;
 import io.vertx.core.Future;
 import io.vertx.core.Handler;
 import io.vertx.core.MultiMap;
@@ -20,28 +19,26 @@ import io.vertx.core.json.JsonObject;
 import io.vertx.ext.web.Route;
 import io.vertx.ext.web.Router;
 import io.vertx.ext.web.RoutingContext;
-import io.vertx.ext.web.handler.*;
+import io.vertx.ext.web.handler.BodyHandler;
+import io.vertx.ext.web.handler.CorsHandler;
+import io.vertx.ext.web.handler.StaticHandler;
 import io.vertx.ext.web.handler.sockjs.SockJSHandler;
 import io.vertx.ext.web.handler.sockjs.SockJSHandlerOptions;
 import javassist.CtClass;
 import org.apache.commons.lang3.StringUtils;
 import org.apache.commons.lang3.tuple.Pair;
+import org.reflections.Reflections;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
 import java.lang.annotation.Annotation;
 import java.lang.reflect.InvocationTargetException;
 import java.lang.reflect.Method;
-import java.time.LocalDateTime;
 import java.util.*;
-import java.util.concurrent.atomic.AtomicReference;
 import java.util.stream.Collectors;
 import java.util.stream.Stream;
 
-import static cn.qaiu.vx.core.util.ConfigConstant.ROUTE_TIME_OUT;
-import static cn.qaiu.vx.core.verticle.ReverseProxyVerticle.REROUTE_PATH_PREFIX;
 import static io.vertx.core.http.HttpHeaders.*;
-import static java.time.format.DateTimeFormatter.ISO_LOCAL_DATE_TIME;
 
 /**
  * 路由映射, 参数绑定
@@ -60,11 +57,15 @@ public class RouterHandlerFactory implements BaseHttpApi {
         add(HttpMethod.DELETE);
         add(HttpMethod.HEAD);
     }};
+    // 需要扫描注册的Router路径
+    private static volatile Reflections reflections;
 
     private final String gatewayPrefix;
 
-    public RouterHandlerFactory(String gatewayPrefix) {
+    public RouterHandlerFactory(String routerScanAddress, String gatewayPrefix) {
+        Objects.requireNonNull(routerScanAddress, "The router package address scan is empty.");
         Objects.requireNonNull(gatewayPrefix, "The gateway prefix is empty.");
+        reflections = ReflectionUtil.getReflections(routerScanAddress);
         this.gatewayPrefix = gatewayPrefix;
     }
 
@@ -72,21 +73,24 @@ public class RouterHandlerFactory implements BaseHttpApi {
      * 开始扫描并注册handler
      */
     public Router createRouter() {
-        // 主路由
-        Router mainRouter = Router.router(VertxHolder.getVertxInstance());
-        mainRouter.route().handler(ctx -> {
-            String realPath = ctx.request().uri();
-            if (realPath.startsWith(REROUTE_PATH_PREFIX)) {
-                // vertx web proxy暂不支持rewrite, 所以这里进行手动替换, 请求地址中的请求path前缀替换为originPath
-                String rePath = realPath.replace(REROUTE_PATH_PREFIX, "");
-                ctx.reroute(rePath);
-                return;
-            }
+        Router router = Router.router(VertxHolder.getVertxInstance());
 
-            LOGGER.debug("New request:{}, {}, {}",
+        // 静态资源
+        String path = SharedDataUtil.getJsonConfig("server")
+                .getString("staticResourcePath");
+        if (!StringUtils.isEmpty(path)) {
+            // 静态资源
+            router.route("/*").handler(StaticHandler
+                    .create(path)
+                    .setCachingEnabled(true)
+                    .setDefaultContentEncoding("UTF-8"));
+        }
+
+
+        router.route().handler(ctx -> {
+            LOGGER.debug("The HTTP service request address information ===>path:{}, uri:{}, method:{}",
                     ctx.request().path(), ctx.request().absoluteURI(), ctx.request().method());
             ctx.response().headers().add(ACCESS_CONTROL_ALLOW_ORIGIN, "*");
-            ctx.response().headers().add(DATE, LocalDateTime.now().format(ISO_LOCAL_DATE_TIME));
             ctx.response().headers().add(ACCESS_CONTROL_ALLOW_METHODS, "POST, GET, OPTIONS, PUT, DELETE, HEAD");
             ctx.response().headers().add(ACCESS_CONTROL_ALLOW_HEADERS, "X-PINGOTHER, Origin,Content-Type, Accept, " +
                     "X-Requested-With, Dev, Authorization, Version, Token");
@@ -94,17 +98,11 @@ public class RouterHandlerFactory implements BaseHttpApi {
             ctx.next();
         });
         // 添加跨域的方法
-        mainRouter.route().handler(CorsHandler.create().addRelativeOrigin(".*").allowCredentials(true).allowedMethods(httpMethods));
+        router.route().handler(CorsHandler.create().addRelativeOrigin(".*").allowCredentials(true).allowedMethods(httpMethods));
 
         // 配置文件上传路径
-        mainRouter.route().handler(BodyHandler.create()
-                .setUploadsDirectory("uploads")
-                .setBodyLimit(2L * 1024 * 1024));
+        router.route().handler(BodyHandler.create().setUploadsDirectory("uploads"));
 
-        // 拦截器
-        Set<Handler<RoutingContext>> interceptorSet = getInterceptorSet();
-        Route route0 = mainRouter.route("/*");
-        interceptorSet.forEach(route0::handler);
 
         try {
             Set<Class<?>> handlers = reflections.getTypesAnnotatedWith(RouteHandler.class);
@@ -118,7 +116,7 @@ public class RouterHandlerFactory implements BaseHttpApi {
             for (Class<?> handler : sortedHandlers) {
                 try {
                     // 注册请求处理方法
-                    registerNewHandler(mainRouter, handler);
+                    registerNewHandler(router, handler);
                 } catch (Throwable e) {
                     LOGGER.error("Error register {}, Error details：", handler, e.getCause());
 
@@ -128,13 +126,12 @@ public class RouterHandlerFactory implements BaseHttpApi {
             LOGGER.error("Manually Register Handler Fail, Error details：" + e.getMessage());
         }
         // 错误请求处理
-        mainRouter.errorHandler(405, ctx -> doFireJsonResultResponse(ctx, JsonResult
+        router.errorHandler(405, ctx -> fireJsonResponse(ctx, JsonResult
                 .error("Method Not Allowed", 405)));
-        mainRouter.errorHandler(404, ctx -> {
-            ctx.response().setStatusCode(404).end("404 not found");
-        });
+        router.errorHandler(404, ctx -> ctx.response().setStatusCode(404).setChunked(true)
+                .end("Internal server error: 404 not found"));
 
-        return mainRouter;
+        return router;
     }
 
     /**
@@ -158,13 +155,15 @@ public class RouterHandlerFactory implements BaseHttpApi {
                 method -> method.isAnnotationPresent(SockRouteMapper.class)
         ).toList());
 
+        // 拦截器
+        Handler<RoutingContext> interceptor = getInterceptor();
         // 依次注册处理方法
         for (Method method : methodList) {
             if (method.isAnnotationPresent(RouteMapping.class)) {
                 // 普通路由
                 RouteMapping mapping = method.getAnnotation(RouteMapping.class);
                 HttpMethod routeMethod = HttpMethod.valueOf(mapping.method().name());
-                String routeUrl = getRouteUrl(mapping.value());
+                String routeUrl = getRouteUrl(method.getName(), mapping.value());
                 String url = root.concat(routeUrl);
                 // 匹配方法
                 Route route = router.route(routeMethod, url);
@@ -174,24 +173,17 @@ public class RouterHandlerFactory implements BaseHttpApi {
                     route.consumes(mineType);
                 }
 
-                // 设置默认超时
-                route.handler(TimeoutHandler.create(SharedDataUtil.getCustomConfig().getInteger(ROUTE_TIME_OUT)));
-                route.handler(ResponseTimeHandler.create());
+                // 先执行拦截方法, 再进入业务请求
+                route.handler(interceptor);
                 route.handler(ctx -> handlerMethod(instance, method, ctx)).failureHandler(ctx -> {
-                    if (isResponseDone(ctx)) return;
-                    // 超时处理器状态码503
-                    if (ctx.statusCode() == 503 || ctx.failure() == null) {
-                        doFireJsonResultResponse(ctx, JsonResult.error("未知异常, 请联系管理员"), 503);
-                    } else {
-                        LOGGER.error("路由处理失败", ctx.failure());
-                        String msg = ctx.failure() != null ? ctx.failure().getMessage() : "未知异常";
-                        doFireJsonResultResponse(ctx, JsonResult.error(msg), 500);
-                    }
+                    if (ctx.response().ended()) return;
+                    ctx.failure().printStackTrace();
+                    fireJsonResponse(ctx, JsonResult.error(ctx.failure().getMessage(), 500));
                 });
             } else if (method.isAnnotationPresent(SockRouteMapper.class)) {
                 // websocket 基于sockJs
                 SockRouteMapper mapping = method.getAnnotation(SockRouteMapper.class);
-                String routeUrl = getRouteUrl(mapping.value());
+                String routeUrl = getRouteUrl(method.getName(), mapping.value());
                 String url = root.concat(routeUrl);
                 LOGGER.info("Register New Websocket Handler -> {}", url);
                 SockJSHandlerOptions options = new SockJSHandlerOptions()
@@ -203,7 +195,7 @@ public class RouterHandlerFactory implements BaseHttpApi {
                     try {
                         ReflectionUtil.invokeWithArguments(method, instance, sock);
                     } catch (Throwable e) {
-                        LOGGER.error("WebSocket处理异常", e);
+                        e.printStackTrace();
                     }
                 });
                 if (url.endsWith("*")) {
@@ -218,9 +210,10 @@ public class RouterHandlerFactory implements BaseHttpApi {
     /**
      * 获取并处理路由URL分隔符
      *
+     * @param methodName 路由method
      * @return String
      */
-    private String getRouteUrl(String mapperValue) {
+    private String getRouteUrl(String methodName, String mapperValue) {
         String routeUrl;
         if ("/".equals(mapperValue)) {
             routeUrl = mapperValue;
@@ -236,10 +229,15 @@ public class RouterHandlerFactory implements BaseHttpApi {
      * 配置拦截
      *
      * @return Handler
+     * @throws Throwable Throwable
      */
-    private Set<Handler<RoutingContext>> getInterceptorSet() {
+    private Handler<RoutingContext> getInterceptor() throws Throwable {
         // 配置拦截
-        return getBeforeInterceptor().stream().map(BeforeInterceptor::doHandle).collect(Collectors.toCollection(LinkedHashSet::new));
+        Class<?> interceptorClass = Class.forName(SharedDataUtil.getValueForCustomConfig("interceptorClassPath"));
+        Object handleInstance = ReflectionUtil.newWithNoParam(interceptorClass);
+        Method doHandle = interceptorClass.getMethod("doHandle");
+        // 反射调用
+        return CastUtil.cast(ReflectionUtil.invoke(doHandle, handleInstance));
     }
 
     /**
@@ -261,7 +259,7 @@ public class RouterHandlerFactory implements BaseHttpApi {
         if (handler.isAnnotationPresent(RouteHandler.class)) {
             RouteHandler routeHandler = handler.getAnnotation(RouteHandler.class);
             String value = routeHandler.value();
-            root += (value.startsWith("/") ? value.substring(1) : value);
+            root += ("/".equals(value) ? "" : value);
         }
         if (!root.endsWith("/")) {
             root = root + "/";
@@ -304,52 +302,12 @@ public class RouterHandlerFactory implements BaseHttpApi {
             });
         }
 
-        JsonArray entityPackagesReg = SharedDataUtil.getJsonArrayForCustomConfig("entityPackagesReg");
-
         final MultiMap queryParams = ctx.queryParams();
-        // 解析body-json参数
-        if (HttpHeaderValues.APPLICATION_JSON.toString().equals(ctx.parsedHeaders().contentType().value())) {
-            JsonObject body = ctx.body().asJsonObject();
-            if (body != null) {
-                methodParametersTemp.forEach((k, v) -> {
-                    String typeName = v.getRight().getName();
-                    // 直接绑定 JsonObject 类型参数
-                    if (JsonObject.class.getName().equals(typeName)) {
-                        parameterValueList.put(k, body);
-                    }
-                    // 只解析已配置包名前缀的实体类
-                    else if (CommonUtil.matchRegList(entityPackagesReg.getList(), typeName)) {
-                        try {
-                            Class<?> aClass = Class.forName(typeName);
-                            JsonObject data = CommonUtil.getSubJsonForEntity(body, aClass);
-                            if (!data.isEmpty()) {
-                                Object entity = data.mapTo(aClass);
-                                parameterValueList.put(k, entity);
-                            }
-                        } catch (ClassNotFoundException e) {
-                            LOGGER.error("实体类绑定异常: {}", typeName, e);
-                        }
-                    }
-                });
-            } else {
-                // body 可能是 JsonArray
-                JsonArray bodyArray = ctx.body().asJsonArray();
-                if (bodyArray != null) {
-                    methodParametersTemp.forEach((k, v) -> {
-                        if (JsonArray.class.getName().equals(v.getRight().getName())) {
-                            parameterValueList.put(k, bodyArray);
-                        }
-                    });
-                }
-            }
-        } else if (ctx.body() != null) {
-            queryParams.addAll(ParamUtil.paramsToMap(ctx.body().asString()));
-        }
-
-        // 解析其他参数
         if ("POST".equals(ctx.request().method().name())) {
             queryParams.addAll(ctx.request().params());
         }
+
+        JsonArray entityPackagesReg = SharedDataUtil.getJsonArrayForCustomConfig("entityPackagesReg");
         // 绑定get或post请求头的请求参数
         methodParametersTemp.forEach((k, v) -> {
             if (ReflectionUtil.isBasicType(v.getRight())) {
@@ -362,78 +320,71 @@ public class RouterHandlerFactory implements BaseHttpApi {
                 parameterValueList.put(k, ctx.request());
             } else if (HttpServerResponse.class.getName().equals(v.getRight().getName())) {
                 parameterValueList.put(k, ctx.response());
-            } else if (parameterValueList.get(k) == null
-                    && CommonUtil.matchRegList(entityPackagesReg.getList(), v.getRight().getName())) {
+            } else if (CommonUtil.matchRegList(entityPackagesReg.getList(), v.getRight().getName())) {
                 // 绑定实体类
                 try {
                     Class<?> aClass = Class.forName(v.getRight().getName());
                     Object entity = ParamUtil.multiMapToEntity(queryParams, aClass);
                     parameterValueList.put(k, entity);
                 } catch (Exception e) {
-                    LOGGER.error("参数绑定异常: {}", v.getRight().getName(), e);
-                }
-            } else if (parameterValueList.get(k) == null
-                    && JsonObject.class.getName().equals(v.getRight().getName())) {
-                // 兜底: content-type 非 application/json 时尝试从 body 解析 JsonObject
-                if (ctx.body() != null) {
-                    JsonObject jo = ctx.body().asJsonObject();
-                    if (jo != null) parameterValueList.put(k, jo);
-                }
-            } else if (parameterValueList.get(k) == null
-                    && JsonArray.class.getName().equals(v.getRight().getName())) {
-                // 兜底: content-type 非 application/json 时尝试从 body 解析 JsonArray
-                if (ctx.body() != null) {
-                    JsonArray ja = ctx.body().asJsonArray();
-                    if (ja != null) parameterValueList.put(k, ja);
+                    e.printStackTrace();
                 }
             }
         });
+        // 解析body-json参数
+        if ("application/json".equals(ctx.parsedHeaders().contentType().value()) && ctx.body().asJsonObject() != null) {
+            JsonObject body = ctx.body().asJsonObject();
+            if (body != null) {
+                methodParametersTemp.forEach((k, v) -> {
+                    // 只解析已配置包名前缀的实体类
+                    if (CommonUtil.matchRegList(entityPackagesReg.getList(), v.getRight().getName())) {
+                        try {
+                            Class<?> aClass = Class.forName(v.getRight().getName());
+                            JsonObject data = CommonUtil.getSubJsonForEntity(body, aClass);
+                            if (!data.isEmpty()) {
+                                Object entity = data.mapTo(aClass);
+                                parameterValueList.put(k, entity);
+                            }
+                        } catch (ClassNotFoundException e) {
+                            e.printStackTrace();
+                        }
+
+                    }
+                });
+            }
+        }
         // 调用handle 获取响应对象
         Object[] parameterValueArray = parameterValueList.values().toArray(new Object[0]);
         try {
             // 反射调用
             Object data = ReflectionUtil.invokeWithArguments(method, instance, parameterValueArray);
             if (data != null) {
-
-                if (data instanceof JsonResult jsonResult) {
-                    doFireJsonResultResponse(ctx, (JsonResult<?>) data, jsonResult.getCode());
-                } else if (data instanceof JsonObject) {
-                    doFireJsonObjectResponse(ctx, ((JsonObject) data));
+                if (data instanceof JsonResult) {
+                    fireJsonResponse(ctx, data);
                 } else if (data instanceof Future) { // 处理异步响应
-                    Future<?> responseFuture = (Future<?>) data;
-                    AtomicReference<RoutingContext> ctxRef = new AtomicReference<>(ctx);
-                    ctx.addEndHandler(v -> ctxRef.set(null));
-                    responseFuture.onComplete(ar -> {
-                        RoutingContext responseCtx = ctxRef.getAndSet(null);
-                        if (responseCtx == null || isResponseDone(responseCtx)) {
-                            return;
+                    ((Future<?>) data).onSuccess(res -> {
+                        if (res instanceof JsonObject) {
+                            fireJsonResponse(ctx, res);
+                        } else if (res != null) {
+                            fireJsonResponse(ctx, JsonResult.data(res));
                         }
-                        if (ar.succeeded()) {
-                            Object res = ar.result();
-                            if (res instanceof JsonResult jsonResult) {
-                                doFireJsonResultResponse(responseCtx, jsonResult, jsonResult.getCode());
-                            } else if (res instanceof JsonObject) {
-                                doFireJsonObjectResponse(responseCtx, ((JsonObject) res));
-                            } else if (res != null) {
-                                doFireJsonResultResponse(responseCtx, JsonResult.data(res));
-                            } else {
-                                doFireJsonResultResponse(responseCtx, JsonResult.data(null));
-                            }
-                        } else {
-                            Throwable e = ar.cause();
-                            LOGGER.error("请求处理失败", e);
-                            String msg = e != null && e.getMessage() != null ? e.getMessage() : "服务器内部错误";
-                            doFireJsonResultResponse(responseCtx, JsonResult.error(msg), 500);
-                        }
-                    });
+                    }).onFailure(e -> fireJsonResponse(ctx, JsonResult.error(e.getMessage())));
                 } else {
-                    doFireJsonResultResponse(ctx, JsonResult.data(data));
+                    ctx.response().headers().set(CONTENT_TYPE, MIMEType.TEXT_HTML.getValue());
+                    ctx.end(data.toString());
                 }
             }
         } catch (Throwable e) {
-            LOGGER.error("请求处理异常", e);
-            String msg = e.getMessage() != null ? e.getMessage() : "服务器内部错误";
-            doFireJsonResultResponse(ctx, JsonResult.error(msg), 500);
+            e.printStackTrace();
+            String err = e.getMessage();
+            if (e.getCause() != null) {
+                if (e.getCause() instanceof InvocationTargetException) {
+                    err = ((InvocationTargetException) e.getCause()).getTargetException().getMessage();
+                } else {
+                    err = e.getCause().getMessage();
+                }
+            }
+            fireJsonResponse(ctx, JsonResult.error(err));
         }
     }
 
@@ -451,13 +402,4 @@ public class RouterHandlerFactory implements BaseHttpApi {
         }
         return fmt;
     }
-
-    private Set<BeforeInterceptor> getBeforeInterceptor() {
-        Set<Class<? extends BeforeInterceptor>> interceptorClassSet =
-                reflections.getSubTypesOf(BeforeInterceptor.class);
-        if (interceptorClassSet == null) {
-            return new HashSet<>();
-        }
-        return CommonUtil.sortClassSet(interceptorClassSet);
-    }
 }

core/src/main/java/cn/qaiu/vx/core/interceptor/AfterInterceptor.java

@@ -1,15 +0,0 @@
-package cn.qaiu.vx.core.interceptor;
-
-import io.vertx.core.json.JsonObject;
-import io.vertx.ext.web.RoutingContext;
-
-/**
- * 后置拦截器接口
- *
- * @author <a href="https://qaiu.top">QAIU</a>
- */
-public interface AfterInterceptor {
-
-    void handle(RoutingContext ctx, JsonObject responseData);
-
-}

core/src/main/java/cn/qaiu/vx/core/interceptor/BeforeInterceptor.java

@@ -1,40 +0,0 @@
-package cn.qaiu.vx.core.interceptor;
-
-import io.vertx.core.Handler;
-import io.vertx.ext.web.RoutingContext;
-
-/**
- * 前置拦截器接口
- * <p>
- * 注意：Vert.x是异步非阻塞框架，不能在Event Loop中使用synchronized等阻塞操作！
- * 所有操作都应该是非阻塞的，使用Vert.x的上下文数据存储机制保证线程安全。
- * </p>
- *
- * @author <a href="https://qaiu.top">QAIU</a>
- */
-public interface BeforeInterceptor extends Handler<RoutingContext> {
-    String IS_NEXT = "RoutingContextIsNext";
-
-    default Handler<RoutingContext> doHandle() {
-        return ctx -> {
-            // 【优化】移除synchronized锁，Vert.x的RoutingContext本身就是线程安全的
-            // 每个请求都有独立的RoutingContext，不需要额外加锁
-            ctx.put(IS_NEXT, false);
-            handle(ctx); // 调用具体的处理逻辑
-            // 确保如果没有调用doNext()并且响应未结束，则返回错误
-            // if (!(Boolean) ctx.get(IS_NEXT) && !ctx.response().ended()) {
-            //     sendError(ctx, 403);
-            // }
-        };
-    }
-
-    default void doNext(RoutingContext context) {
-        // 【优化】移除synchronized锁
-        // RoutingContext的put和next操作是线程安全的，不需要额外同步
-        context.put(IS_NEXT, true);
-        context.next(); // 继续执行下一个处理器
-    }
-
-    void handle(RoutingContext context); // 实现具体的拦截处理逻辑
-}
-

core/src/main/java/cn/qaiu/vx/core/interceptor/Interceptor.java

@@ -0,0 +1,19 @@
+package cn.qaiu.vx.core.interceptor;
+
+import io.vertx.core.Handler;
+import io.vertx.ext.web.RoutingContext;
+
+/**
+ * 拦截器接口
+ * <br>Create date 2021-05-06 09:20:37
+ *
+ * @author <a href="https://qaiu.top">QAIU</a>
+ */
+public interface Interceptor {
+
+    default Handler<RoutingContext> doHandle() {
+        return this::handle;
+    }
+
+    void handle(RoutingContext context);
+}

core/src/main/java/cn/qaiu/vx/core/model/JsonResult.java

@@ -1,9 +1,6 @@
 package cn.qaiu.vx.core.model;
 
 
-import cn.qaiu.vx.core.util.CastUtil;
-import com.fasterxml.jackson.databind.ObjectMapper;
-import io.vertx.core.json.JsonObject;
 import org.apache.commons.lang3.StringUtils;
 
 import java.io.Serial;
@@ -34,6 +31,8 @@ public class JsonResult<T> implements Serializable {
 
     private boolean success = true; //是否成功
 
+    private int count;
+
     private T data;
 
     private long timestamp = System.currentTimeMillis(); //时间戳
@@ -52,6 +51,20 @@ public class JsonResult<T> implements Serializable {
         this.success = success;
     }
 
+    public JsonResult(int code, String msg, boolean success, T data, int count) {
+        this(code, msg, success, data);
+        this.count = count;
+    }
+
+    public int getCount() {
+        return count;
+    }
+
+    public JsonResult<T> setCount(int count) {
+        this.count = count;
+        return this;
+    }
+
     public int getCode() {
         return code;
     }
@@ -120,9 +133,20 @@ public class JsonResult<T> implements Serializable {
         return new JsonResult<>(SUCCESS_CODE, msg, true, data);
     }
 
+    // 响应成功消息和数据实体
+    public static <T> JsonResult<T> data(String msg, T data, int count) {
+        if (StringUtils.isEmpty(msg)) msg = SUCCESS_MESSAGE;
+        return new JsonResult<>(SUCCESS_CODE, msg, true, data, count);
+    }
+
     // 响应数据实体
     public static <T> JsonResult<T> data(T data) {
-        return new JsonResult<>(SUCCESS_CODE, SUCCESS_MESSAGE, true, data);
+        return new JsonResult<>(SUCCESS_CODE, SUCCESS_MESSAGE, true, data, 0);
+    }
+
+    // 响应数据实体
+    public static <T> JsonResult<T> data(T data, int count) {
+        return new JsonResult<>(SUCCESS_CODE, SUCCESS_MESSAGE, true, data, count);
     }
 
     // 响应成功消息
@@ -135,16 +159,4 @@ public class JsonResult<T> implements Serializable {
     public static <T> JsonResult<T> success() {
         return new JsonResult<>(SUCCESS_CODE, SUCCESS_MESSAGE, true, null);
     }
-
-    // 转为json对象
-    public JsonObject toJsonObject() {
-        return JsonObject.mapFrom(this);
-    }
-
-    private static final ObjectMapper mapper = new ObjectMapper();
-
-    // 转为json对象
-    public static JsonResult<?> toJsonResult(JsonObject json) {
-        return CastUtil.cast(json.mapTo(JsonResult.class));
-    }
 }

core/src/main/java/cn/qaiu/vx/core/package-info.java

@@ -1,7 +0,0 @@
-/**
- * ModuleGen cn.qaiu.vx.core
- */
-@ModuleGen(name = "vertx-http-proxy", groupPackage = "cn.qaiu.vx.core")
-package cn.qaiu.vx.core;
-
-import io.vertx.codegen.annotations.ModuleGen;

core/src/main/java/cn/qaiu/vx/core/util/CommonUtil.java

@@ -1,8 +1,9 @@
 package cn.qaiu.vx.core.util;
 
-import cn.qaiu.vx.core.annotaions.HandleSortFilter;
 import io.vertx.core.buffer.Buffer;
 import io.vertx.core.json.JsonObject;
+import org.apache.commons.beanutils.ConvertUtils;
+import org.apache.commons.beanutils.Converter;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
@@ -13,13 +14,7 @@ import java.net.Socket;
 import java.net.URL;
 import java.net.UnknownHostException;
 import java.util.List;
-import java.util.LinkedHashSet;
 import java.util.Map;
-import java.util.Properties;
-import java.util.Set;
-import java.util.concurrent.ConcurrentHashMap;
-import java.util.regex.Pattern;
-import java.util.stream.Collectors;
 
 /**
  * CommonUtil
@@ -31,16 +26,6 @@ public class CommonUtil {
 
     private static final Logger LOGGER = LoggerFactory.getLogger(CommonUtil.class);
 
-    /** 正则表达式缓存，避免每次调用重新编译 */
-    private static final ConcurrentHashMap<String, Pattern> PATTERN_CACHE = new ConcurrentHashMap<>();
-
-    /**
-     * 获取预编译的 Pattern（带缓存）
-     */
-    private static Pattern getCachedPattern(String regex) {
-        return PATTERN_CACHE.computeIfAbsent(regex, Pattern::compile);
-    }
-
     /**
      * 匹配正则list
      *
@@ -51,7 +36,7 @@ public class CommonUtil {
     public static boolean matchRegList(List<?> regList, String destStr) {
         // 判断是否忽略
         for (Object ignores : regList) {
-            if (getCachedPattern(ignores.toString()).matcher(destStr).matches()) {
+            if (destStr.matches(ignores.toString())) {
                 return true;
             }
         }
@@ -85,11 +70,10 @@ public class CommonUtil {
         } catch (UnknownHostException e) {
             return false;
         }
-        try (Socket ignored = new Socket(Address, port)) {
-            //建立一个Socket连接
+        try(Socket ignored =  new Socket(Address, port)) {
+             //建立一个Socket连接
             flag = true;
-        } catch (IOException ignoredException) {
-        }
+        } catch (IOException ignoredException) {}
         return flag;
     }
 
@@ -111,6 +95,23 @@ public class CommonUtil {
         return data;
     }
 
+    /**
+     * 注册枚举转换器
+     *
+     * @param enums 枚举类
+     */
+    @SafeVarargs
+    @SuppressWarnings({"unchecked", "rawtypes"})
+    public static void enumConvert(Class<? extends Enum>... enums) {
+        for (Class<? extends Enum> anEnum : enums) {
+            ConvertUtils.register(new Converter() {
+                public Object convert(Class type, Object value) {
+                    return Enum.valueOf(anEnum, (String) value);
+                }
+            }, anEnum);
+        }
+    }
+
     /**
      * 处理其他配置
      *
@@ -125,51 +126,4 @@ public class CommonUtil {
         LocalConstant.put(configName, map);
         LOGGER.info("读取配置{}成功", configName);
     }
-
-    public static <T> Set<T> sortClassSet(Set<Class<? extends T>> set) {
-        return set.stream().filter(c1 -> {
-            HandleSortFilter s1 = c1.getAnnotation(HandleSortFilter.class);
-            if (s1 != null) {
-                return s1.value() >= 0;
-            } else {
-                return true;
-            }
-        }).sorted((c1, c2) -> {
-            HandleSortFilter s1 = c1.getAnnotation(HandleSortFilter.class);
-            HandleSortFilter s2 = c2.getAnnotation(HandleSortFilter.class);
-            int n1 = 0, n2 = 0;
-            if (s1 != null) {
-                n1 = s1.value();
-            }
-            if (s2 != null) {
-                n2 = s2.value();
-            }
-            return n1 - n2;
-        }).map(c -> {
-            try {
-                return ReflectionUtil.newWithNoParam(c);
-            } catch (Exception e) {
-                throw new RuntimeException(e);
-            }
-        }).collect(Collectors.toCollection(LinkedHashSet::new));
-    }
-
-    private static String appVersion;
-
-    public static String getAppVersion() {
-        if (null == appVersion) {
-            Properties properties = new Properties();
-            try (var is = CommonUtil.class.getClassLoader().getResourceAsStream("app.properties")) {
-                if (is != null) {
-                    properties.load(is);
-                    if (!properties.isEmpty()) {
-                        appVersion = properties.getProperty("app.version") + "build" + properties.getProperty("build");
-                    }
-                }
-            } catch (IOException e) {
-                LOGGER.error("读取app.properties失败", e);
-            }
-        }
-        return appVersion;
-    }
 }

core/src/main/java/cn/qaiu/vx/core/util/ConfigConstant.java

@@ -3,21 +3,11 @@ package cn.qaiu.vx.core.util;
 public interface ConfigConstant {
     String CUSTOM = "custom";
     String VERTX = "vertx";
+
     String EVENT_LOOP_POOL_SIZE = "eventLoopPoolSize";
     String LOCAL = "local";
     String SERVER = "server";
-    String CACHE = "cache";
-
-    String PROXY_SERVER = "proxy-server";
-
-    String PROXY = "proxy";
-
-    String AUTHS = "auths";
     String GLOBAL_CONFIG = "globalConfig";
     String CUSTOM_CONFIG = "customConfig";
     String ASYNC_SERVICE_INSTANCES = "asyncServiceInstances";
-    String IGNORES_REG="ignoresReg";
-    String BASE_LOCATIONS="baseLocations";
-
-    String ROUTE_TIME_OUT="routeTimeOut";
 }

core/src/main/java/cn/qaiu/vx/core/util/ConfigUtil.java

@@ -4,15 +4,9 @@ import io.vertx.config.ConfigRetriever;
 import io.vertx.config.ConfigRetrieverOptions;
 import io.vertx.config.ConfigStoreOptions;
 import io.vertx.core.Future;
-import io.vertx.core.Promise;
 import io.vertx.core.Vertx;
 import io.vertx.core.json.JsonObject;
 
-import java.io.InputStream;
-import java.nio.charset.StandardCharsets;
-import java.nio.file.Files;
-import java.nio.file.Path;
-
 /**
  * 异步读取配置工具类
  * <br>Create date 2021/9/2 1:23
@@ -30,29 +24,7 @@ public class ConfigUtil {
      * @return JsonObject的Future
      */
     public static Future<JsonObject> readConfig(String format, String path, Vertx vertx) {
-        // 支持 classpath: 前缀从类路径读取，否则从文件系统读取
-        if (path != null && path.startsWith("classpath:")) {
-            String resource = path.substring("classpath:".length());
-            // 使用 executeBlocking(Callable) 直接返回 Future<JsonObject>
-            return vertx.executeBlocking(() -> {
-                InputStream is = Thread.currentThread().getContextClassLoader().getResourceAsStream(resource);
-                if (is == null) {
-                    throw new RuntimeException("classpath resource not found: " + resource);
-                }
-                try (InputStream in = is) {
-                    byte[] bytes = in.readAllBytes();
-                    String content = new String(bytes, StandardCharsets.UTF_8);
-                    if ("json".equalsIgnoreCase(format)) {
-                        return new JsonObject(content);
-                    } else {
-                        throw new RuntimeException("unsupported classpath format: " + format);
-                    }
-                }
-            });
-        }
-
-        Promise<JsonObject> promise = Promise.promise();
-
+        // 读取yml配置
         ConfigStoreOptions store = new ConfigStoreOptions()
                 .setType("file")
                 .setFormat(format)
@@ -61,45 +33,10 @@ public class ConfigUtil {
         ConfigRetriever retriever = ConfigRetriever
                 .create(vertx, new ConfigRetrieverOptions().addStore(store));
 
-        // 异步获取配置
-        // 成功直接完成 promise
-        retriever.getConfig()
-                .onSuccess(config -> {
-                    promise.complete(config);
-                    retriever.close();
-                })
-                .onFailure(err -> {
-                    retriever.close();
-                    // 读取失败时，尝试从 resources/ 子目录读取（兼容 Docker 卷挂载场景）
-                    String resourcesPath = "resources/" + path;
-                    if (!path.startsWith("resources/") && Files.exists(Path.of(resourcesPath))) {
-                        ConfigStoreOptions fallbackStore = new ConfigStoreOptions()
-                                .setType("file")
-                                .setFormat(format)
-                                .setConfig(new JsonObject().put("path", resourcesPath));
-                        ConfigRetriever fallbackRetriever = ConfigRetriever
-                                .create(vertx, new ConfigRetrieverOptions().addStore(fallbackStore));
-                        fallbackRetriever.getConfig()
-                                .onSuccess(config -> {
-                                    promise.complete(config);
-                                    fallbackRetriever.close();
-                                })
-                                .onFailure(e2 -> {
-                                    promise.fail(new RuntimeException(
-                                            "读取配置文件失败: " + path + " (也尝试了 " + resourcesPath + ")", e2));
-                                    fallbackRetriever.close();
-                                });
-                    } else {
-                        promise.fail(new RuntimeException(
-                                "读取配置文件失败: " + path, err));
-                    }
-                });
-
-        return promise.future();
+        return retriever.getConfig();
     }
 
 
-
     /**
      * 异步读取Yaml配置文件
      *

core/src/main/java/cn/qaiu/vx/core/util/FutureUtils.java

@@ -1,44 +0,0 @@
-package cn.qaiu.vx.core.util;
-
-import io.vertx.core.Future;
-import io.vertx.core.Promise;
-
-import java.util.concurrent.ExecutionException;
-import java.util.concurrent.TimeUnit;
-import java.util.concurrent.TimeoutException;
-
-public class FutureUtils {
-
-    /** 默认同步等待超时时间（秒） */
-    private static final long DEFAULT_TIMEOUT_SECONDS = 120;
-
-    public static <T> T getResult(Future<T> future) {
-        try {
-            return future.toCompletionStage().toCompletableFuture()
-                    .get(DEFAULT_TIMEOUT_SECONDS, TimeUnit.SECONDS);
-        } catch (InterruptedException e) {
-            Thread.currentThread().interrupt();
-            throw new RuntimeException("线程被中断", e);
-        } catch (TimeoutException e) {
-            throw new RuntimeException("等待Future超时（" + DEFAULT_TIMEOUT_SECONDS + "秒）", e);
-        } catch (ExecutionException e) {
-            Throwable cause = e.getCause();
-            throw new RuntimeException(cause != null ? cause : e);
-        }
-    }
-
-    public static <T> T getResult(Promise<T> promise) {
-        try {
-            return promise.future().toCompletionStage().toCompletableFuture()
-                    .get(DEFAULT_TIMEOUT_SECONDS, TimeUnit.SECONDS);
-        } catch (InterruptedException e) {
-            Thread.currentThread().interrupt();
-            throw new RuntimeException("线程被中断", e);
-        } catch (TimeoutException e) {
-            throw new RuntimeException("等待Promise超时（" + DEFAULT_TIMEOUT_SECONDS + "秒）", e);
-        } catch (ExecutionException e) {
-            Throwable cause = e.getCause();
-            throw new RuntimeException(cause != null ? cause : e);
-        }
-    }
-}

core/src/main/java/cn/qaiu/vx/core/util/JacksonConfig.java

@@ -1,46 +0,0 @@
-package cn.qaiu.vx.core.util;
-
-import com.fasterxml.jackson.databind.DeserializationFeature;
-import com.fasterxml.jackson.databind.ObjectMapper;
-import com.fasterxml.jackson.datatype.jsr310.JavaTimeModule;
-import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateDeserializer;
-import com.fasterxml.jackson.datatype.jsr310.deser.LocalDateTimeDeserializer;
-import com.fasterxml.jackson.datatype.jsr310.deser.LocalTimeDeserializer;
-import io.vertx.core.json.jackson.DatabindCodec;
-import org.slf4j.LoggerFactory;
-
-import java.time.LocalDate;
-import java.time.LocalDateTime;
-import java.time.LocalTime;
-import java.time.format.DateTimeFormatter;
-
-/**
- * @author <a href="https://qaiu.top">QAIU</a>
- * @date 2023/10/14 9:07
- */
-public class JacksonConfig {
-
-    static {
-        // 通过该方法对mapper对象进行设置，所有序列化的对象都将按改规则进行系列化
-        // Include.Include.ALWAYS 默认
-        // Include.NON_DEFAULT 属性为默认值不序列化
-        // Include.NON_EMPTY 属性为 空（""） 或者为 NULL 都不序列化，则返回的json是没有这个字段的。这样对移动端会更省流量
-        // Include.NON_NULL 属性为NULL 不序列化,就是为null的字段不参加序列化
-        // objectMapper.setSerializationInclusion(JsonInclude.Include.NON_NULL);
-        ObjectMapper objectMapper = DatabindCodec.mapper();
-        objectMapper.configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
-
-        JavaTimeModule javaTimeModule = new JavaTimeModule();
-        javaTimeModule.addDeserializer(LocalDateTime.class,
-                new LocalDateTimeDeserializer(DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")));
-        javaTimeModule.addDeserializer(LocalDate.class,
-                new LocalDateDeserializer(DateTimeFormatter.ofPattern("yyyy-MM-dd")));
-        javaTimeModule.addDeserializer(LocalTime.class,
-                new LocalTimeDeserializer(DateTimeFormatter.ofPattern("HH:mm:ss")));
-        objectMapper.registerModule(javaTimeModule);
-        LoggerFactory.getLogger(JacksonConfig.class).info("Global JacksonConfig complete.");
-    }
-
-    public static void nothing() {}
-
-}

core/src/main/java/cn/qaiu/vx/core/util/LocalConstant.java

@@ -1,7 +1,7 @@
 package cn.qaiu.vx.core.util;
 
+import java.util.HashMap;
 import java.util.Map;
-import java.util.concurrent.ConcurrentHashMap;
 
 /**
  * vertx 上下文外的本地容器 为不在vertx线程的方法传递数据
@@ -10,10 +10,11 @@ import java.util.concurrent.ConcurrentHashMap;
  * @author <a href="https://qaiu.top">QAIU</a>
  */
 public class LocalConstant {
-    private static final Map<String, Object> LOCAL_CONST = new ConcurrentHashMap<>();
+    private static final Map<String, Object> LOCAL_CONST = new HashMap<>();
 
     public static Map<String, Object> put(String k, Object v) {
-        LOCAL_CONST.putIfAbsent(k, v);
+        if (LOCAL_CONST.containsKey(k)) return LOCAL_CONST;
+        LOCAL_CONST.put(k, v);
         return LOCAL_CONST;
     }
 

core/src/main/java/cn/qaiu/vx/core/util/ParamUtil.java

@@ -1,10 +1,11 @@
 package cn.qaiu.vx.core.util;
 
 import io.vertx.core.MultiMap;
-import io.vertx.core.json.JsonObject;
+import org.apache.commons.beanutils.BeanUtils;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
+import java.lang.reflect.InvocationTargetException;
 import java.util.HashMap;
 import java.util.Map;
 
@@ -17,41 +18,28 @@ import java.util.Map;
 public final class ParamUtil {
     private static final Logger LOGGER = LoggerFactory.getLogger(ParamUtil.class);
 
-    public static Map<String, Object> multiMapToMap(MultiMap multiMap) {
+    public static Map<String, String> multiMapToMap(MultiMap multiMap) {
         if (multiMap == null) return null;
-        Map<String, Object> map = new HashMap<>();
+        Map<String, String> map = new HashMap<>();
         for (Map.Entry<String, String> entry : multiMap.entries()) {
             map.put(entry.getKey(), entry.getValue());
         }
         return map;
     }
 
-    public static <T> T multiMapToEntity(MultiMap multiMap, Class<T> tClass) {
-        Map<String, Object> map = multiMapToMap(multiMap);
-        if (map == null) {
-            return null;
+    public static <T> T multiMapToEntity(MultiMap multiMap,Class<T> tClass) throws NoSuchMethodException {
+        Map<String,String> map = multiMapToMap(multiMap);
+        T obj = null;
+        try {
+            obj = tClass.getDeclaredConstructor().newInstance();
+            BeanUtils.populate(obj,map);
+        } catch (InstantiationException | IllegalAccessException e) {
+            e.printStackTrace();
+            LOGGER.error("实例化异常");
+        } catch (InvocationTargetException e2) {
+            e2.printStackTrace();
+            LOGGER.error("map2bean转换异常");
         }
-        return new JsonObject(map).mapTo(tClass);
+        return obj;
     }
-
-    public static MultiMap paramsToMap(String paramString) {
-        MultiMap entries = MultiMap.caseInsensitiveMultiMap();
-        if (paramString == null || paramString.isEmpty()) return entries;
-        String[] params = paramString.split("&");
-        if (params.length == 0) return entries;
-        for (String param : params) {
-            if (param == null || param.isEmpty()) {
-                continue;
-            }
-            String[] kv = param.split("=", 2);
-            if (kv.length == 2) {
-                entries.set(kv[0], kv[1]);
-            } else if (kv.length == 1) {
-                entries.set(kv[0], "");
-            }
-            // kv.length == 0 时（空字符串），跳过
-        }
-        return entries;
-    }
-
 }

core/src/main/java/cn/qaiu/vx/core/util/ReflectionUtil.java

@@ -5,13 +5,12 @@ import javassist.bytecode.AccessFlag;
 import javassist.bytecode.CodeAttribute;
 import javassist.bytecode.LocalVariableAttribute;
 import javassist.bytecode.MethodInfo;
+import org.apache.commons.beanutils.ConversionException;
 import org.apache.commons.lang3.StringUtils;
 import org.apache.commons.lang3.time.DateUtils;
 import org.apache.commons.lang3.tuple.Pair;
 import org.reflections.Reflections;
-import org.reflections.scanners.MemberUsageScanner;
-import org.reflections.scanners.MethodParameterNamesScanner;
-import org.reflections.scanners.Scanners;
+import org.reflections.scanners.*;
 import org.reflections.util.ClasspathHelper;
 import org.reflections.util.ConfigurationBuilder;
 import org.reflections.util.FilterBuilder;
@@ -24,12 +23,6 @@ import java.lang.reflect.Method;
 import java.net.URL;
 import java.text.ParseException;
 import java.util.*;
-import java.util.regex.Pattern;
-
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-import static cn.qaiu.vx.core.util.ConfigConstant.BASE_LOCATIONS;
 
 /**
  * 基于org.reflection和javassist的反射工具包
@@ -40,69 +33,51 @@ import static cn.qaiu.vx.core.util.ConfigConstant.BASE_LOCATIONS;
  */
 public final class ReflectionUtil {
 
-    private static final Logger LOGGER = LoggerFactory.getLogger(ReflectionUtil.class);
-
-    // 缓存Reflections实例，避免重复扫描（每次扫描约35K+值，耗时1-3秒，占用大量内存）
-    private static final Map<String, Reflections> REFLECTIONS_CACHE = new java.util.concurrent.ConcurrentHashMap<>();
-
-    // 预编译的类型匹配正则，避免每次请求重新编译
-    private static final Pattern BASIC_TYPE_PATTERN = Pattern.compile(
-            "^java\\.lang\\.((Boolean)|(Character)|(Byte)|(Short)|(Integer)|(Long)|(Float)|(Double)|(String))$");
-    private static final Pattern BASIC_TYPE_ARRAY_PATTERN = Pattern.compile(
-            "^(boolean|char|byte|short|int|long|float|double|String)\\[]$");
-
     /**
-     * 以默认配置的基础包路径获取反射器
-     *
-     * @return Reflections object
-     */
-    public static Reflections getReflections() {
-        return getReflections(SharedDataUtil.getStringForCustomConfig(BASE_LOCATIONS));
-    }
-
-    /**
-     * 获取反射器（带缓存）
+     * 获取反射器
      *
      * @param packageAddress Package address String
      * @return Reflections object
      */
     public static Reflections getReflections(String packageAddress) {
-        return REFLECTIONS_CACHE.computeIfAbsent(packageAddress, key -> {
-            List<String> packageAddressList;
-            if (key.contains(",")) {
-                packageAddressList = Arrays.asList(key.split(","));
-            } else if (key.contains(";")) {
-                packageAddressList = Arrays.asList(key.split(";"));
-            } else {
-                packageAddressList = Collections.singletonList(key);
-            }
-            return createReflections(packageAddressList);
-        });
+        List<String> packageAddressList;
+        if (packageAddress.contains(",")) {
+            packageAddressList = Arrays.asList(packageAddress.split(","));
+        } else if (packageAddress.contains(";")) {
+            packageAddressList = Arrays.asList(packageAddress.split(";"));
+        } else {
+            packageAddressList = Collections.singletonList(packageAddress);
+        }
+        return getReflections(packageAddressList);
     }
 
     /**
-     * 获取反射器（带缓存）
+     * 获取反射器
      *
      * @param packageAddresses Package address List
      * @return Reflections object
      */
     public static Reflections getReflections(List<String> packageAddresses) {
-        String cacheKey = String.join(",", packageAddresses);
-        return REFLECTIONS_CACHE.computeIfAbsent(cacheKey, key -> createReflections(packageAddresses));
-    }
+        ConfigurationBuilder configurationBuilder = new ConfigurationBuilder();
+        FilterBuilder filterBuilder = new FilterBuilder();
+        packageAddresses.forEach(str -> {
+            Collection<URL> urls = ClasspathHelper.forPackage(str.trim());
+            configurationBuilder.addUrls(urls);
+            filterBuilder.includePackage(str.trim());
+        });
 
-    private static Reflections createReflections(List<String> packageAddresses) {
-        ConfigurationBuilder configurationBuilder = new ConfigurationBuilder()
-                .addClassLoaders(Thread.currentThread().getContextClassLoader())
-                .forPackages(packageAddresses.toArray(new String[0]))
-                .setScanners(
-                        Scanners.SubTypes.filterResultsBy(s -> true), //允许getAllTypes获取所有Object的子类, 不设置为false则 getAllTypes
-                        // 会报错.默认为true.
-                        new MethodParameterNamesScanner(), //设置方法参数名称 扫描器,否则调用getConstructorParamNames 会报错
-                        Scanners.MethodsAnnotated, //设置方法注解 扫描器, 否则getConstructorsAnnotatedWith,getMethodsAnnotatedWith 会报错
-                        new MemberUsageScanner(),  //设置 member 扫描器,否则 getMethodUsage 会报错
-                        Scanners.TypesAnnotated //设置类注解 扫描器 ,否则 getTypesAnnotatedWith 会报错
-                );
+        // 采坑记录 2021-05-08
+        // 发现注解api层 没有继承父类时 这里反射一直有问题(Scanner SubTypesScanner was not configured)
+        // 因此这里需要手动配置各种Scanner扫描器 -- https://blog.csdn.net/qq_29499107/article/details/106889781
+        configurationBuilder.setScanners(
+                new SubTypesScanner(false), //允许getAllTypes获取所有Object的子类, 不设置为false则 getAllTypes 会报错.默认为true.
+                new MethodParameterNamesScanner(), //设置方法参数名称 扫描器,否则调用getConstructorParamNames 会报错
+                new MethodAnnotationsScanner(), //设置方法注解 扫描器, 否则getConstructorsAnnotatedWith,getMethodsAnnotatedWith 会报错
+                new MemberUsageScanner(),  //设置 member 扫描器,否则 getMethodUsage 会报错, 不推荐使用,有可能会报错 Caused by: java.lang.ClassCastException: javassist.bytecode.InterfaceMethodrefInfo cannot be cast to javassist.bytecode.MethodrefInfo
+                new TypeAnnotationsScanner() //设置类注解 扫描器 ,否则 getTypesAnnotatedWith 会报错
+        );
+
+        configurationBuilder.filterInputsBy(filterBuilder);
         return new Reflections(configurationBuilder);
     }
 
@@ -123,8 +98,7 @@ public final class ReflectionUtil {
             MethodInfo methodInfo = cm.getMethodInfo();
             CtClass[] parameterTypes = cm.getParameterTypes();
             CodeAttribute codeAttribute = methodInfo.getCodeAttribute();
-            LocalVariableAttribute attr =
-                    (LocalVariableAttribute) codeAttribute.getAttribute(LocalVariableAttribute.tag);
+            LocalVariableAttribute attr = (LocalVariableAttribute) codeAttribute.getAttribute(LocalVariableAttribute.tag);
 
             boolean flag = true;
             boolean flag2 = cm.getModifiers() - 1 != AccessFlag.STATIC;
@@ -136,11 +110,10 @@ public final class ReflectionUtil {
                     continue;
                 }
                 flag = false;
-                paramMap.put(attr.variableName(j + (flag2 ? 1 : 0)), Pair.of(parameterAnnotations[j - k],
-                        parameterTypes[j - k]));
+                paramMap.put(attr.variableName(j + (flag2 ? 1 : 0)), Pair.of(parameterAnnotations[j - k], parameterTypes[j - k]));
             }
         } catch (NotFoundException e) {
-            LOGGER.error("获取方法参数失败", e);
+            e.printStackTrace();
         }
         return paramMap;
     }
@@ -195,11 +168,11 @@ public final class ReflectionUtil {
                 try {
                     return DateUtils.parseDate(value, fmt);
                 } catch (ParseException e) {
-                    LOGGER.error("日期解析失败: {}", value, e);
-                    throw new RuntimeException("无法将格式化日期");
+                    e.printStackTrace();
+                    throw new ConversionException("无法将格式化日期");
                 }
             default:
-                throw new RuntimeException("无法将String类型" + value + "转为[" + name + "]");
+                throw new ConversionException("无法将String类型" + value + "转为[" + name + "]");
         }
     }
 
@@ -211,7 +184,7 @@ public final class ReflectionUtil {
      * @return Array
      */
     public static Object conversionArray(CtClass ctClass, String value) {
-        if (!isBasicTypeArray(ctClass)) throw new RuntimeException("无法解析数组");
+        if (!isBasicTypeArray(ctClass)) throw new ConversionException("无法解析数组");
         String[] strArr = value.split(",");
         List<Object> obj = new ArrayList<>();
         Arrays.stream(strArr).forEach(v -> obj.add(conversion(ctClass, v, null)));
@@ -227,7 +200,7 @@ public final class ReflectionUtil {
             }
             return arr;
         } catch (Exception e) {
-            LOGGER.error("数组类型转换失败: {}", value, e);
+            e.printStackTrace();
         }
         return null;
     }
@@ -241,7 +214,7 @@ public final class ReflectionUtil {
         if (ctClass.isPrimitive() || "java.util.Date".equals(ctClass.getName())) {
             return true;
         }
-        return BASIC_TYPE_PATTERN.matcher(ctClass.getName()).matches();
+        return ctClass.getName().matches("^java\\.lang\\.((Boolean)|(Character)|(Byte)|(Short)|(Integer)|(Long)|(Float)|(Double)|(String))$");
     }
 
     /**
@@ -252,7 +225,7 @@ public final class ReflectionUtil {
     public static boolean isBasicTypeArray(CtClass ctClass) {
         if (!ctClass.isArray()) {
             return false;
-        } else return BASIC_TYPE_ARRAY_PATTERN.matcher(ctClass.getName()).matches();
+        } else return (ctClass.getName().matches("^(boolen|char|byte|short|int|long|float|double|String)\\[]$"));
     }
 
     /**
@@ -265,8 +238,7 @@ public final class ReflectionUtil {
      * @throws InstantiationException    InstantiationException
      * @throws IllegalAccessException    IllegalAccessException
      */
-    public static <T> T newWithNoParam(Class<T> handler) throws NoSuchMethodException, InvocationTargetException,
-            InstantiationException, IllegalAccessException {
+    public static <T> T newWithNoParam(Class<T> handler) throws NoSuchMethodException, InvocationTargetException, InstantiationException, IllegalAccessException {
         return handler.getConstructor().newInstance();
     }
 

core/src/main/java/cn/qaiu/vx/core/util/ResponseUtil.java

@@ -1,83 +0,0 @@
-package cn.qaiu.vx.core.util;
-
-import cn.qaiu.vx.core.model.JsonResult;
-import io.vertx.core.Promise;
-import io.vertx.core.http.HttpHeaders;
-import io.vertx.core.http.HttpServerResponse;
-import io.vertx.core.json.JsonObject;
-import io.vertx.ext.web.RoutingContext;
-
-import static io.vertx.core.http.HttpHeaders.CONTENT_TYPE;
-
-public class ResponseUtil {
-
-    public static void redirect(HttpServerResponse response, String url) {
-        if (response.ended() || response.closed()) {
-            return;
-        }
-        response.putHeader(CONTENT_TYPE, "text/html; charset=utf-8")
-                .putHeader("Referrer-Policy", "no-referrer")
-                .putHeader(HttpHeaders.LOCATION, url).setStatusCode(302).end();
-    }
-
-    public static void redirect(HttpServerResponse response, String url, Promise<?> promise) {
-        try {
-            redirect(response, url);
-            promise.tryComplete();
-        } catch (Throwable t) {
-            promise.tryFail(t);
-        }
-    }
-
-    public static void fireJsonObjectResponse(RoutingContext ctx, JsonObject jsonObject) {
-        fireJsonObjectResponse(ctx, jsonObject, 200);
-    }
-
-    public static void fireJsonObjectResponse(HttpServerResponse ctx, JsonObject jsonObject) {
-        fireJsonObjectResponse(ctx, jsonObject, 200);
-    }
-
-    public static void fireJsonObjectResponse(RoutingContext ctx, JsonObject jsonObject, int statusCode) {
-        if (ctx.response().ended() || ctx.response().closed()) {
-            return;
-        }
-        ctx.response().putHeader(CONTENT_TYPE, "application/json; charset=utf-8")
-                .setStatusCode(statusCode)
-                .end(jsonObject.encode());
-    }
-
-    public static void fireJsonObjectResponse(HttpServerResponse ctx, JsonObject jsonObject, int statusCode) {
-        if (ctx.ended() || ctx.closed()) {
-            return;
-        }
-        ctx.putHeader(CONTENT_TYPE, "application/json; charset=utf-8")
-                .setStatusCode(statusCode)
-                .end(jsonObject.encode());
-    }
-
-    public static <T> void fireJsonResultResponse(RoutingContext ctx, JsonResult<T> jsonResult) {
-        fireJsonObjectResponse(ctx, jsonResult.toJsonObject());
-    }
-
-    public static <T> void fireJsonResultResponse(RoutingContext ctx, JsonResult<T> jsonResult, int statusCode) {
-        fireJsonObjectResponse(ctx, jsonResult.toJsonObject(), statusCode);
-    }
-
-    public static <T> void fireJsonResultResponse(HttpServerResponse ctx, JsonResult<T> jsonResult) {
-        fireJsonObjectResponse(ctx, jsonResult.toJsonObject());
-    }
-
-    public static void fireTextResponse(RoutingContext ctx, String text) {
-        if (ctx.response().ended() || ctx.response().closed()) {
-            return;
-        }
-        ctx.response().putHeader(CONTENT_TYPE, "text/html; charset=utf-8").end(text);
-    }
-
-    public static void sendError(RoutingContext ctx, int statusCode) {
-        if (ctx.response().ended() || ctx.response().closed()) {
-            return;
-        }
-        ctx.response().setStatusCode(statusCode).end();
-    }
-}

core/src/main/java/cn/qaiu/vx/core/util/SharedDataUtil.java

@@ -3,6 +3,7 @@ package cn.qaiu.vx.core.util;
 import io.vertx.core.json.JsonArray;
 import io.vertx.core.json.JsonObject;
 import io.vertx.core.shareddata.LocalMap;
+import io.vertx.core.shareddata.SharedData;
 
 /**
  * vertx 共享数据
@@ -12,8 +13,10 @@ import io.vertx.core.shareddata.LocalMap;
  */
 public class SharedDataUtil {
 
-    public static io.vertx.core.shareddata.SharedData shareData() {
-        return VertxHolder.getVertxInstance().sharedData();
+    private static final SharedData sharedData = VertxHolder.getVertxInstance().sharedData();
+
+    public static SharedData shareData() {
+        return sharedData;
     }
 
     public static LocalMap<String, Object> getLocalMap(String key) {
@@ -21,7 +24,7 @@ public class SharedDataUtil {
     }
 
     public static <T> LocalMap<String, T> getLocalMapWithCast(String key) {
-        return shareData().getLocalMap(key);
+        return  sharedData.getLocalMap(key);
     }
 
     public static JsonObject getJsonConfig(String key) {
@@ -29,11 +32,11 @@ public class SharedDataUtil {
         return (JsonObject) localMap.get(key);
     }
 
-    public static JsonObject getCustomConfig() {
-        return getJsonConfig("customConfig");
+    public static JsonObject getJsonObjectForCustomConfig(String key) {
+        return getJsonConfig("customConfig").getJsonObject(key);
     }
 
-    public static String getStringForCustomConfig(String key) {
+    public static String getJsonStringForCustomConfig(String key) {
         return getJsonConfig("customConfig").getString(key);
     }
 

core/src/main/java/cn/qaiu/vx/core/util/SnowflakeIdWorker.java

@@ -1,4 +1,4 @@
-package cn.qaiu.lz.common.util;
+package cn.qaiu.vx.core.util;
 
 import org.apache.commons.lang3.StringUtils;
 import org.slf4j.Logger;
@@ -30,8 +30,6 @@ public class SnowflakeIdWorker {
 
     // ==============================Fields===========================================
 
-    //开始时间截 (2021-01-01)
-    private static final long EPOCH = 1609459200000L;
     /**
      * 机器id所占的位数
      */
@@ -96,7 +94,7 @@ public class SnowflakeIdWorker {
      *
      * @return SnowflakeId
      */
-    public synchronized Long nextId() {
+    public synchronized long nextId() {
         long timestamp = timeGen();
 
         //如果当前时间小于上一次ID生成的时间戳，说明系统时钟回退过这个时候应当抛出异常
@@ -135,7 +133,9 @@ public class SnowflakeIdWorker {
         //时间截向左移22位(5+5+12)
         long timestampLeftShift = sequenceBits + workerIdBits + datacenterIdBits;
 
-        return ((timestamp - EPOCH) << timestampLeftShift) //
+        //开始时间截 (2021-01-01)
+        long twepoch = 1609459200000L;
+        return ((timestamp - twepoch) << timestampLeftShift) //
                 | (datacenterId << datacenterIdShift) //
                 | (workerId << sequenceBits) //
                 | sequence;
@@ -214,18 +214,30 @@ public class SnowflakeIdWorker {
         return snowflakeIdWorker;
     }
 
-    synchronized public static Long getLongId() {
-        return snowflakeIdWorker.nextId();
-    }
-
-    synchronized public static String getStringId() {
-        return snowflakeIdWorker.nextId().toString();
-    }
-
     synchronized public static SnowflakeIdWorker idWorkerCluster(long workerId, long datacenterId) {
         if (snowflakeIdWorkerCluster == null) {
             snowflakeIdWorkerCluster = new SnowflakeIdWorker(workerId, datacenterId);
         }
         return snowflakeIdWorkerCluster;
     }
+    //==============================Test=============================================
+
+    /**
+     * 测试
+     */
+    public static void main(String[] args) {
+        final SnowflakeIdWorker snowflakeIdWorkerCluster = idWorkerCluster(0, 1);
+        final SnowflakeIdWorker idWorker = idWorker();
+        for (int i = 0; i < 100; i++) {
+            long id = idWorker.nextId();
+            System.out.println(Long.toBinaryString(id));
+            System.out.println(id);
+            System.out.println("------------");
+            id = snowflakeIdWorkerCluster.nextId();
+            System.out.println(Long.toBinaryString(id));
+            System.out.println(id);
+            System.out.println("------------\n");
+        }
+
+    }
 }

core/src/main/java/cn/qaiu/vx/core/verticle/HttpProxyVerticle.java

@@ -1,419 +0,0 @@
-package cn.qaiu.vx.core.verticle;
-
-import io.vertx.core.AbstractVerticle;
-import io.vertx.core.Future;
-import io.vertx.core.Promise;
-import io.vertx.core.http.*;
-import io.vertx.core.json.JsonObject;
-import io.vertx.core.net.NetClient;
-import io.vertx.core.net.NetClientOptions;
-import io.vertx.core.net.NetSocket;
-import io.vertx.core.net.ProxyOptions;
-import org.apache.commons.lang3.StringUtils;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-import java.net.URI;
-import java.util.Base64;
-
-import static cn.qaiu.vx.core.util.ConfigConstant.GLOBAL_CONFIG;
-import static cn.qaiu.vx.core.util.ConfigConstant.LOCAL;
-
-/**
- *
- */
-public class HttpProxyVerticle extends AbstractVerticle {
-    private static final Logger LOGGER = LoggerFactory.getLogger(HttpProxyVerticle.class);
-
-    private HttpClient httpClient;
-    private NetClient netClient;
-    private HttpServer httpServer;
-    private volatile boolean stopping = false;
-
-    private JsonObject proxyPreConf;
-    private JsonObject proxyServerConf;
-
-
-    @Override
-    public void start(io.vertx.core.Promise<Void> startPromise) {
-        stopping = false;
-        proxyServerConf = ((JsonObject)vertx.sharedData().getLocalMap(LOCAL).get(GLOBAL_CONFIG)).getJsonObject("proxy-server");
-        proxyPreConf = ((JsonObject)vertx.sharedData().getLocalMap(LOCAL).get(GLOBAL_CONFIG)).getJsonObject("proxy-pre");
-        Integer serverPort = proxyServerConf.getInteger("port");
-
-        ProxyOptions proxyOptions = null;
-        if (proxyPreConf != null && StringUtils.isNotBlank(proxyPreConf.getString("ip"))) {
-            proxyOptions = new ProxyOptions(proxyPreConf);
-        }
-
-        // 初始化 HTTP 客户端，用于向目标服务器发送 HTTP 请求
-        HttpClientOptions httpClientOptions = new HttpClientOptions()
-                .setMaxPoolSize(64)
-                .setMaxWaitQueueSize(256)
-                .setConnectTimeout(15000)
-                .setIdleTimeout(60)
-                .setKeepAlive(true);
-        if (proxyOptions != null) {
-            httpClientOptions.setProxyOptions(proxyOptions);
-        }
-        httpClient = vertx.createHttpClient(httpClientOptions);
-
-        // 创建并启动 HTTP 代理服务器，监听指定端口
-        HttpServerOptions httpServerOptions = new HttpServerOptions();
-        if (proxyServerConf.containsKey("username") &&
-                StringUtils.isNotBlank(proxyServerConf.getString("username"))) {
-            httpServerOptions.setClientAuth(ClientAuth.REQUIRED);
-        }
-
-        httpServer = vertx.createHttpServer(httpServerOptions);
-        httpServer.requestHandler(this::handleClientRequest);
-
-        // 初始化 NetClient，用于在 CONNECT 请求中建立 TCP 连接隧道
-        NetClientOptions netClientOptions = new NetClientOptions();
-
-        if (proxyOptions != null) {
-            netClientOptions.setProxyOptions(proxyOptions);
-        }
-
-        netClient = vertx.createNetClient(netClientOptions
-                .setConnectTimeout(15000)
-                .setTrustAll(true));
-
-        // 启动 HTTP 代理服务器
-        httpServer.listen(serverPort)
-                .onSuccess(res -> {
-                    LOGGER.info("HTTP Proxy server started on port {}", serverPort);
-                    startPromise.complete();
-                })
-                .onFailure(err -> {
-                    LOGGER.error("Failed to start HTTP Proxy server: " + err.getMessage(), err);
-                    closeClients().onComplete(close -> startPromise.fail(err));
-                });
-    }
-
-    // 处理 HTTP CONNECT 请求，用于代理 HTTPS 流量
-    private void handleConnectRequest(HttpServerRequest clientRequest) {
-        String[] uriParts = clientRequest.uri().split(":");
-        if (uriParts.length != 2) {
-            failClientResponse(clientRequest.response(), 400, "Bad Request: Invalid URI format");
-            return;
-        }
-
-        // 解析目标主机和端口
-        String targetHost = uriParts[0];
-        int targetPort;
-        try {
-            targetPort = Integer.parseInt(uriParts[1]);
-        } catch (NumberFormatException e) {
-            failClientResponse(clientRequest.response(), 400, "Bad Request: Invalid port");
-            return;
-        }
-        clientRequest.pause();
-        // 通过 NetClient 连接目标服务器并创建隧道
-        try {
-            netClient.connect(targetPort, targetHost)
-                    .onSuccess(targetSocket -> {
-                        // Upgrade client connection to NetSocket and implement bidirectional data flow
-                        clientRequest.toNetSocket()
-                                .onSuccess(clientSocket -> {
-                                    clientSocket.pipeTo(targetSocket)
-                                            .onFailure(err -> {
-                                                LOGGER.debug("CONNECT client -> target pipe closed", err);
-                                                closeTunnelSockets(clientSocket, targetSocket);
-                                            });
-                                    targetSocket.pipeTo(clientSocket)
-                                            .onFailure(err -> {
-                                                LOGGER.debug("CONNECT target -> client pipe closed", err);
-                                                closeTunnelSockets(clientSocket, targetSocket);
-                                            });
-
-                                    // Close the other socket when one side closes
-                                    clientSocket.closeHandler(v -> targetSocket.close());
-                                    targetSocket.closeHandler(v -> clientSocket.close());
-                                })
-                                .onFailure(clientSocketAttempt -> {
-                                    System.err.println("Failed to upgrade client connection to socket: " + clientSocketAttempt.getMessage());
-                                    targetSocket.close();
-                                    failClientRequestAndClose(clientRequest, 500, "Internal Server Error");
-                                });
-                    })
-                    .onFailure(connectionAttempt -> {
-                        LOGGER.warn("Failed to connect to target: {}", connectionAttempt.getMessage());
-                        failClientRequestAndClose(clientRequest, 502, "Bad Gateway: Unable to connect to target");
-                    });
-        } catch (Exception e) {
-            LOGGER.warn("CONNECT 请求创建失败", e);
-            failClientRequestAndClose(clientRequest, 502, "Bad Gateway: Unable to connect to target");
-        }
-    }
-
-    // 处理客户端的 HTTP 请求
-    private void handleClientRequest(HttpServerRequest clientRequest) {
-        if (stopping) {
-            failClientResponse(clientRequest.response(), 503, "Service Unavailable");
-            return;
-        }
-        // 打印来源ip和访问目标URI
-        LOGGER.debug("source: {}, target: {}", clientRequest.remoteAddress().toString(), clientRequest.uri());
-        if (proxyServerConf.containsKey("username") &&
-                StringUtils.isNotBlank(proxyServerConf.getString("username"))) {
-            String s = clientRequest.headers().get("Proxy-Authorization");
-            if (s == null) {
-                failClientResponse(clientRequest.response(), 403, null);
-                return;
-            }
-            String[] split;
-            try {
-                split = new String(Base64.getDecoder().decode(s.replace("Basic ", ""))).split(":");
-            } catch (IllegalArgumentException e) {
-                LOGGER.warn("Proxy-Authorization header is not valid Base64");
-                failClientResponse(clientRequest.response(), 403, null);
-                return;
-            }
-            if (split.length <= 1) {
-                LOGGER.warn("Proxy-Authorization header format invalid: missing username:password separator");
-                failClientResponse(clientRequest.response(), 403, null);
-                return;
-            }
-            String username = proxyServerConf.getString("username");
-            String password = proxyServerConf.getString("password");
-            if (!split[0].equals(username) || !split[1].equals(password)) {
-                LOGGER.info("-----auth failed------\nusername: {}", split[0]);
-                failClientResponse(clientRequest.response(), 403, null);
-                return;
-            }
-        }
-
-        if (clientRequest.method() == HttpMethod.CONNECT) {
-            // 处理 CONNECT 请求
-            handleConnectRequest(clientRequest);
-        } else {
-            // 处理普通的 HTTP 请求
-            handleHttpRequest(clientRequest);
-        }
-    }
-
-    // 处理 HTTP 请求，转发至目标服务器并返回响应
-    private void handleHttpRequest(HttpServerRequest clientRequest) {
-        // 获取目标主机
-        String hostHeader = clientRequest.getHeader("Host");
-        if (hostHeader == null) {
-            failClientResponse(clientRequest.response(), 400, "Host header is missing");
-            return;
-        }
-
-        HostAndPort target;
-        try {
-            target = parseHostHeader(hostHeader);
-        } catch (IllegalArgumentException e) {
-            failClientResponse(clientRequest.response(), 400, "Bad Request: Invalid Host header");
-            return;
-        }
-        String targetHost = target.host();
-        int targetPort = extractPortFromUrl(clientRequest.uri(), target.port()); // 默认为 HTTP 的端口
-        if (targetPort <= 0) {
-            failClientResponse(clientRequest.response(), 400, "Bad Request: Invalid target port");
-            return;
-        }
-        clientRequest.pause(); // 暂停客户端请求的读取，等上游请求创建完成
-
-        try {
-            httpClient.request(clientRequest.method(), targetPort, targetHost, clientRequest.uri())
-                    .onSuccess(request -> {
-                        // 逐个设置请求头
-                        clientRequest.headers().forEach(header -> request.putHeader(header.getKey(), header.getValue()));
-
-                        request.response()
-                                .onSuccess(response -> {
-                                    HttpServerResponse clientResponse = clientRequest.response();
-                                    if (clientResponse.ended() || clientResponse.closed()) {
-                                        response.resume();
-                                        return;
-                                    }
-                                    clientResponse.setStatusCode(response.statusCode());
-                                    clientResponse.headers().setAll(response.headers());
-                                    response.pipeTo(clientResponse)
-                                            .onFailure(err -> {
-                                                LOGGER.error("HTTP代理响应转发失败", err);
-                                                try {
-                                                    response.request().reset();
-                                                } catch (Exception e) {
-                                                    LOGGER.debug("HTTP代理上游响应已关闭", e);
-                                                }
-                                                failClientRequestAndClose(clientRequest, 502, "Bad Gateway: Unable to reach target");
-                                            });
-                                })
-                                .onFailure(err -> {
-                                    LOGGER.error("HTTP代理响应失败", err);
-                                    try {
-                                        request.reset();
-                                    } catch (Exception e) {
-                                        LOGGER.debug("HTTP代理上游请求已关闭", e);
-                                    }
-                                    failClientRequestAndClose(clientRequest, 502, "Bad Gateway: Unable to reach target");
-                                });
-
-                        clientRequest.pipeTo(request)
-                                .onFailure(err -> {
-                                    LOGGER.error("HTTP代理请求转发失败", err);
-                                    try {
-                                        request.reset();
-                                    } catch (Exception e) {
-                                        LOGGER.debug("HTTP代理上游请求已关闭", e);
-                                    }
-                                    failClientRequestAndClose(clientRequest, 502, "Bad Gateway: Unable to reach target");
-                                });
-                        clientRequest.resume();
-                    })
-                    .onFailure(err -> {
-                        LOGGER.error("HTTP请求失败", err);
-                        failClientRequestAndClose(clientRequest, 502, "Bad Gateway: Request failed");
-                    });
-        } catch (Exception e) {
-            LOGGER.error("HTTP请求创建失败", e);
-            failClientRequestAndClose(clientRequest, 502, "Bad Gateway: Request failed");
-        }
-    }
-
-    private void failClientResponse(HttpServerResponse response, String message) {
-        failClientResponse(response, 502, message);
-    }
-
-    private void failClientResponse(HttpServerResponse response, int statusCode, String message) {
-        if (response.ended() || response.closed()) {
-            return;
-        }
-        try {
-            if (!response.headWritten()) {
-                response.setStatusCode(statusCode);
-                if (message == null) {
-                    response.end();
-                } else {
-                    response.end(message);
-                }
-            } else {
-                response.reset();
-            }
-        } catch (Exception e) {
-            LOGGER.debug("客户端响应已关闭，忽略代理错误响应", e);
-        }
-    }
-
-    private void failClientRequestAndClose(HttpServerRequest request, int statusCode, String message) {
-        HttpServerResponse response = request.response();
-        if (response.ended() || response.closed()) {
-            closeClientConnection(request);
-            return;
-        }
-        try {
-            if (!response.headWritten()) {
-                response.setStatusCode(statusCode);
-                Future<Void> endFuture = message == null ? response.end() : response.end(message);
-                endFuture.onComplete(v -> closeClientConnection(request));
-            } else {
-                response.reset();
-                closeClientConnection(request);
-            }
-        } catch (Exception e) {
-            LOGGER.debug("客户端响应已关闭，关闭代理连接", e);
-            closeClientConnection(request);
-        }
-    }
-
-    private void closeClientConnection(HttpServerRequest request) {
-        try {
-            request.connection().close();
-        } catch (Exception e) {
-            LOGGER.debug("关闭客户端代理连接失败", e);
-        }
-    }
-
-    private void closeTunnelSockets(NetSocket clientSocket, NetSocket targetSocket) {
-        try {
-            clientSocket.close();
-        } catch (Exception e) {
-            LOGGER.debug("关闭CONNECT客户端socket失败", e);
-        }
-        try {
-            targetSocket.close();
-        } catch (Exception e) {
-            LOGGER.debug("关闭CONNECT目标socket失败", e);
-        }
-    }
-
-
-    /**
-     * 从 URL 中提取端口号
-     *
-     * @param urlString URL 字符串
-     * @return 提取的端口号，如果没有指定端口，则返回默认端口
-     */
-    public static int extractPortFromUrl(String urlString) {
-        return extractPortFromUrl(urlString, 80);
-    }
-
-    public static int extractPortFromUrl(String urlString, int defaultPort) {
-        try {
-            URI uri = new URI(urlString);
-            int port = uri.getPort();
-            // 如果 URL 没有指定端口，使用默认端口
-            if (port == -1) {
-                if ("https".equalsIgnoreCase(uri.getScheme())) {
-                    port = 443; // HTTPS 默认端口
-                } else {
-                    port = defaultPort; // HTTP 默认端口
-                }
-            }
-            return port;
-        } catch (Exception e) {
-            LOGGER.error("提取端口失败: {}", urlString, e);
-            // 出现异常时返回 -1，表示提取失败
-            return -1;
-        }
-    }
-
-    private HostAndPort parseHostHeader(String hostHeader) {
-        if (hostHeader.startsWith("[")) {
-            int end = hostHeader.indexOf(']');
-            if (end > 0) {
-                String host = hostHeader.substring(1, end);
-                int port = 80;
-                if (hostHeader.length() > end + 2 && hostHeader.charAt(end + 1) == ':') {
-                    port = Integer.parseInt(hostHeader.substring(end + 2));
-                }
-                return new HostAndPort(host, port);
-            }
-        }
-        int lastColon = hostHeader.lastIndexOf(':');
-        if (lastColon > 0 && hostHeader.indexOf(':') == lastColon) {
-            return new HostAndPort(hostHeader.substring(0, lastColon), Integer.parseInt(hostHeader.substring(lastColon + 1)));
-        }
-        return new HostAndPort(hostHeader, 80);
-    }
-
-    private record HostAndPort(String host, int port) {
-    }
-
-
-    @Override
-    public void stop(Promise<Void> stopPromise) {
-        stopping = true;
-        Future<Void> serverClose = httpServer == null ? Future.succeededFuture() : httpServer.close();
-        serverClose.onComplete(serverResult -> closeClients().onComplete(clientResult -> {
-                    if (serverResult.failed()) {
-                        stopPromise.fail(serverResult.cause());
-                    } else if (clientResult.failed()) {
-                        stopPromise.fail(clientResult.cause());
-                    } else {
-                        stopPromise.complete();
-                    }
-                }));
-    }
-
-    private Future<Void> closeClients() {
-        Future<Void> httpClientClose = httpClient == null ? Future.succeededFuture() : httpClient.close();
-        Future<Void> netClientClose = netClient == null ? Future.succeededFuture() : netClient.close();
-        return Future.all(httpClientClose, netClientClose).mapEmpty();
-    }
-
-}

core/src/main/java/cn/qaiu/vx/core/verticle/PostExecVerticle.java

@@ -1,68 +0,0 @@
-package cn.qaiu.vx.core.verticle;
-
-import cn.qaiu.vx.core.base.AppRun;
-import cn.qaiu.vx.core.base.DefaultAppRun;
-import cn.qaiu.vx.core.util.CommonUtil;
-import cn.qaiu.vx.core.util.ReflectionUtil;
-import cn.qaiu.vx.core.util.SharedDataUtil;
-import io.vertx.core.AbstractVerticle;
-import io.vertx.core.Promise;
-import io.vertx.core.json.JsonObject;
-import org.reflections.Reflections;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-import java.util.List;
-import java.util.Set;
-import java.util.concurrent.atomic.AtomicBoolean;
-
-/**
- * 后置执行Verticle - 在core启动后立即执行AppRun实现
- * <br>Create date 2024-01-01 00:00:00
- *
- * @author <a href="https://qaiu.top">QAIU</a>
- */
-public class PostExecVerticle extends AbstractVerticle {
-
-    private static final Logger LOGGER = LoggerFactory.getLogger(PostExecVerticle.class);
-    private static final Set<AppRun> appRunImplementations;
-    private static final AtomicBoolean lock = new AtomicBoolean(false);
-
-    static {
-        Reflections reflections = ReflectionUtil.getReflections();
-        Set<Class<? extends AppRun>> subTypesOf = reflections.getSubTypesOf(AppRun.class);
-        subTypesOf.add(DefaultAppRun.class);
-        appRunImplementations = CommonUtil.sortClassSet(subTypesOf);
-        if (appRunImplementations.isEmpty()) {
-            LOGGER.warn("未找到 AppRun 接口的实现类");
-        } else {
-            LOGGER.info("找到 {} 个 AppRun 接口的实现类", appRunImplementations.size());
-        }
-    }
-
-    @Override
-    public void start(Promise<Void> startPromise) {
-        if (!lock.compareAndSet(false, true)) {
-            return;
-        }
-        LOGGER.info("PostExecVerticle 开始执行...");
-
-        if (appRunImplementations != null && !appRunImplementations.isEmpty()) {
-            appRunImplementations.forEach(appRun -> {
-                try {
-                    LOGGER.info("执行 AppRun 实现: {}", appRun.getClass().getName());
-                    JsonObject globalConfig = SharedDataUtil.getJsonConfig("globalConfig");
-                    appRun.execute(globalConfig);
-                    LOGGER.info("AppRun 实现 {} 执行完成", appRun.getClass().getName());
-                } catch (Exception e) {
-                    LOGGER.error("执行 AppRun 实现 {} 时发生错误",appRun.getClass().getName(), e);
-                }
-            });
-        } else {
-            LOGGER.info("未找到 AppRun 接口的实现类");
-        }
-
-        LOGGER.info("PostExecVerticle 执行完成");
-        startPromise.complete();
-    }
-}

core/src/main/java/cn/qaiu/vx/core/verticle/ReverseProxyVerticle.java

@@ -3,26 +3,18 @@ package cn.qaiu.vx.core.verticle;
 import cn.qaiu.vx.core.util.*;
 import io.vertx.core.AbstractVerticle;
 import io.vertx.core.Future;
-import io.vertx.core.Handler;
 import io.vertx.core.Promise;
 import io.vertx.core.http.HttpClient;
-import io.vertx.core.http.HttpClientOptions;
 import io.vertx.core.http.HttpServer;
-import io.vertx.core.http.HttpServerOptions;
-import io.vertx.core.http.HttpServerRequest;
-import io.vertx.core.http.HttpServerResponse;
+import io.vertx.core.http.WebSocket;
 import io.vertx.core.json.JsonArray;
 import io.vertx.core.json.JsonObject;
-import io.vertx.core.net.PemKeyCertOptions;
-import io.vertx.ext.web.Route;
 import io.vertx.ext.web.Router;
-import io.vertx.ext.web.RoutingContext;
 import io.vertx.ext.web.handler.StaticHandler;
+import io.vertx.ext.web.handler.sockjs.SockJSHandler;
+import io.vertx.ext.web.handler.sockjs.SockJSHandlerOptions;
 import io.vertx.ext.web.proxy.handler.ProxyHandler;
 import io.vertx.httpproxy.HttpProxy;
-import io.vertx.httpproxy.ProxyContext;
-import io.vertx.httpproxy.ProxyInterceptor;
-import io.vertx.httpproxy.ProxyResponse;
 import org.apache.commons.lang3.StringUtils;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
@@ -30,18 +22,12 @@ import org.slf4j.LoggerFactory;
 import java.io.File;
 import java.net.MalformedURLException;
 import java.net.URL;
-import java.util.ArrayList;
-import java.util.HashSet;
-import java.util.List;
 import java.util.Map;
-import java.util.Set;
-import java.util.concurrent.ConcurrentHashMap;
 
 /**
  * <p>反向代理服务</p>
  * <p>可以根据配置文件自动生成代理服务</p>
  * <p>可以配置多个服务, 配置文件见示例</p>
- * <p>【优化】支持高并发场景，连接池复用，避免线程阻塞</p>
  * <br>Create date 2021/9/2 0:41
  *
  * @author <a href="https://qaiu.top">QAIU</a>
@@ -50,201 +36,36 @@ public class ReverseProxyVerticle extends AbstractVerticle {
 
     private static final Logger LOGGER = LoggerFactory.getLogger(ReverseProxyVerticle.class);
 
-    private static final String DEFAULT_PATH_404 = "webroot/err/page404.html";
+    private static final String PATH_PROXY_CONFIG = SharedDataUtil
+            .getJsonConfig(ConfigConstant.GLOBAL_CONFIG)
+            .getString("proxyConf");
+    private static final Future<JsonObject> CONFIG = ConfigUtil.readYamlConfig(PATH_PROXY_CONFIG);
+    private static final String DEFAULT_PATH_404 = "webroot/err/404.html";
 
     private static String serverName = "Vert.x-proxy-server"; //Server name in Http response header
 
-    public static String REROUTE_PATH_PREFIX = "/__rrvpspp"; //re_route_vert_proxy_server_path_prefix 硬编码
 
-    /**
-     * 【优化】HttpClient连接池，按host:port缓存复用，避免每个请求都创建新连接
-     */
-    private final Map<String, HttpClientEntry> httpClientPool = new ConcurrentHashMap<>();
-    private final List<HttpServer> httpServers = new ArrayList<>();
-    private volatile boolean stopping = false;
-
-    /**
-     * 连接池条目。HttpProxy 会持有这里的 HttpClient 引用，不能在路由仍可用时关闭。
-     */
-    private static class HttpClientEntry {
-        final HttpClient client;
-
-        HttpClientEntry(HttpClient client) {
-            this.client = client;
-        }
-    }
-
-    /**
-     * 【优化】高并发场景下的HttpClient配置
-     */
-    private static final int MAX_POOL_SIZE = 32;           // 最大连接池大小
-    private static final int MAX_WAIT_QUEUE_SIZE = 128;    // 最大等待队列大小
-    private static final int CONNECT_TIMEOUT = 30000;      // 连接超时30秒
-    private static final int IDLE_TIMEOUT = 60;            // 空闲超时60秒
-    private static final boolean KEEP_ALIVE = true;        // 启用Keep-Alive
-    private static final boolean PIPELINING = false;       // 代理场景关闭管线化，避免慢响应堆积
     @Override
-    public void start(Promise<Void> startPromise) {
-        stopping = false;
-        String pathProxyConfig = SharedDataUtil
-                .getJsonConfig(ConfigConstant.GLOBAL_CONFIG)
-                .getString("proxyConf");
-        ConfigUtil.readYamlConfig(pathProxyConfig).onSuccess(config -> startProxyServers(config).onComplete(startPromise)).onFailure(e -> {
-            LOGGER.info("web代理配置已禁用，当前仅支持API调用");
-            startPromise.complete();
-        });
+    public void start(Promise<Void> startPromise) throws Exception {
+        CONFIG.onSuccess(this::handleProxyConfList);
+        startPromise.complete();
     }
 
-    /**
-     * 【优化】Verticle停止时清理HttpClient连接池
-     */
-    @Override
-    public void stop(Promise<Void> stopPromise) {
-        stopping = true;
-        LOGGER.info("Stopping ReverseProxyVerticle, closing {} servers and {} HttpClient connections...",
-                httpServers.size(), httpClientPool.size());
-
-        List<Future<Void>> serverCloseFutures = new ArrayList<>();
-        httpServers.forEach(server -> serverCloseFutures.add(server.close()));
-        Future<Void> serverCloseFuture = serverCloseFutures.isEmpty()
-                ? Future.succeededFuture()
-                : Future.all(serverCloseFutures).mapEmpty();
-
-        serverCloseFuture.onComplete(serverClose -> {
-            List<Future<Void>> clientCloseFutures = new ArrayList<>();
-            closeHttpClients(clientCloseFutures);
-            Future<Void> clientCloseFuture = clientCloseFutures.isEmpty()
-                    ? Future.succeededFuture()
-                    : Future.all(clientCloseFutures).mapEmpty();
-
-            clientCloseFuture.onComplete(clientClose -> {
-                if (serverClose.succeeded()) {
-                    httpServers.clear();
-                }
-                if (clientClose.succeeded()) {
-                    httpClientPool.clear();
-                }
-                if (serverClose.failed()) {
-                    stopPromise.fail(serverClose.cause());
-                } else if (clientClose.failed()) {
-                    stopPromise.fail(clientClose.cause());
-                } else {
-                    stopPromise.complete();
-                }
-            });
-        });
-    }
-
-    private void closeHttpClients(List<Future<Void>> closeFutures) {
-        httpClientPool.values().forEach(entry -> {
-            try {
-                closeFutures.add(entry.client.close());
-            } catch (Exception e) {
-                LOGGER.warn("Error closing HttpClient: {}", e.getMessage());
-            }
-        });
-    }
-
-    /**
-     * 【优化】获取或创建HttpClient，实现连接池复用
-     * @param host 目标主机
-     * @param port 目标端口
-     * @return HttpClient实例
-     */
-    private HttpClient getOrCreateHttpClient(String host, int port) {
-        String key = host + ":" + port;
-        HttpClientEntry entry = httpClientPool.computeIfAbsent(key, k -> {
-            LOGGER.info("Creating new HttpClient for {}", key);
-            HttpClientOptions options = new HttpClientOptions()
-                    .setMaxPoolSize(MAX_POOL_SIZE)                    // 连接池大小
-                    .setMaxWaitQueueSize(MAX_WAIT_QUEUE_SIZE)         // 等待队列大小
-                    .setConnectTimeout(CONNECT_TIMEOUT)               // 连接超时
-                    .setIdleTimeout(IDLE_TIMEOUT)                     // 空闲超时
-                    .setKeepAlive(KEEP_ALIVE)                         // Keep-Alive
-                    .setKeepAliveTimeout(120)                         // Keep-Alive超时120秒
-                    .setPipelining(PIPELINING)                        // HTTP管线化
-                    .setPipeliningLimit(10)                           // 管线化限制
-                    .setDecompressionSupported(false)                 // 代理不解压，避免放大内存
-                    .setTcpKeepAlive(true)                            // TCP Keep-Alive
-                    .setTcpNoDelay(true)                              // 禁用Nagle算法，降低延迟
-                    .setTcpFastOpen(true)                             // 启用TCP Fast Open
-                    .setTcpQuickAck(true)                             // 启用TCP Quick ACK
-                    .setReuseAddress(true)                            // 允许地址重用
-                    .setReusePort(true);                              // 允许端口重用
-            return new HttpClientEntry(vertx.createHttpClient(options));
-        });
-        return entry.client;
-    }
-
-    /**
-     * 全局可信上游代理 IP 集合（如 nginx），仅这些 IP 的 X-Forwarded-For 会被信任
-     */
-    private Set<String> globalTrustedProxies = new HashSet<>();
-
     /**
      * 获取主配置文件
      *
      * @param config proxy config
      */
-    private Future<Void> startProxyServers(JsonObject config) {
+    private void handleProxyConfList(JsonObject config) {
         serverName = config.getString("server-name");
-        // 解析全局 trusted-proxies
-        JsonArray trustedArr = config.getJsonArray("trusted-proxies");
-        if (trustedArr != null) {
-            trustedArr.forEach(ip -> {
-                if (ip instanceof String) {
-                    globalTrustedProxies.add(((String) ip).trim());
-                }
-            });
-        }
         JsonArray proxyConfList = config.getJsonArray("proxy");
-        List<Future<Void>> listenFutures = new ArrayList<>();
         if (proxyConfList != null) {
             proxyConfList.forEach(proxyConf -> {
                 if (proxyConf instanceof JsonObject) {
-                    listenFutures.add(handleProxyConf((JsonObject) proxyConf));
+                    handleProxyConf((JsonObject) proxyConf);
                 }
             });
         }
-        return listenFutures.isEmpty() ? Future.succeededFuture() : Future.all(listenFutures).mapEmpty();
-    }
-
-    /**
-     * 解析真实客户端 IP。
-     * 若直连来源在可信代理列表中，优先取 X-Real-IP，其次取 X-Forwarded-For 第一个值；
-     * 否则直接使用直连对端地址。
-     */
-    private String resolveClientIp(HttpServerRequest request) {
-        String peerIp = request.remoteAddress().host();
-        if (globalTrustedProxies.contains(peerIp)) {
-            String realIp = request.getHeader("X-Real-IP");
-            if (StringUtils.isNotBlank(realIp)) {
-                return realIp.trim();
-            }
-            String xff = request.getHeader("X-Forwarded-For");
-            if (StringUtils.isNotBlank(xff)) {
-                return xff.split(",")[0].trim();
-            }
-        }
-        return peerIp;
-    }
-
-    /**
-     * 解析 proxy-set-headers 中的 nginx 风格变量。
-     * 支持：$remote_addr、$proxy_add_x_forwarded_for、$scheme、$host；
-     * 其他值作为字面量直接使用。
-     */
-    private String resolveHeaderVariable(String tpl, HttpServerRequest req, String clientIp) {
-        return switch (tpl) {
-            case "$remote_addr" -> clientIp;
-            case "$proxy_add_x_forwarded_for" -> {
-                String existing = req.getHeader("X-Forwarded-For");
-                yield StringUtils.isNotBlank(existing) ? existing + ", " + clientIp : clientIp;
-            }
-            case "$scheme" -> req.isSSL() ? "https" : "http";
-            case "$host"   -> req.getHeader("Host");
-            default        -> tpl;
-        };
     }
 
     /**
@@ -252,52 +73,37 @@ public class ReverseProxyVerticle extends AbstractVerticle {
      *
      * @param proxyConf 代理配置
      */
-    private Future<Void> handleProxyConf(JsonObject proxyConf) {
-        // page404 path
-        if (proxyConf.containsKey(
-
-                "page404")) {
+    private void handleProxyConf(JsonObject proxyConf) {
+        // 404 path
+        if (proxyConf.containsKey("404")) {
             System.getProperty("user.dir");
-            String path = proxyConf.getString("page404");
+            String path = proxyConf.getString("404");
             if (StringUtils.isEmpty(path)) {
-                proxyConf.put("page404", DEFAULT_PATH_404);
+                proxyConf.put("404", DEFAULT_PATH_404);
             } else {
                 if (!path.startsWith("/")) {
                     path = "/" + path;
                 }
                 if (!new File(System.getProperty("user.dir") + path).exists()) {
-                    proxyConf.put("page404", DEFAULT_PATH_404);
+                    proxyConf.put("404", DEFAULT_PATH_404);
                 }
             }
         } else {
-            proxyConf.put("page404", DEFAULT_PATH_404);
+            proxyConf.put("404", DEFAULT_PATH_404);
         }
 
+        final HttpClient httpClient = VertxHolder.getVertxInstance().createHttpClient();
         Router proxyRouter = Router.router(vertx);
 
         // Add Server name header
         proxyRouter.route().handler(ctx -> {
-            if (stopping) {
-                sendProxyError(ctx, 503, "Service Unavailable");
-                return;
-            }
-            String realPath = ctx.request().uri();
-            if (realPath.startsWith(REROUTE_PATH_PREFIX)) {
-                // vertx web proxy暂不支持rewrite, 所以这里进行手动替换, 请求地址中的请求path前缀替换为originPath
-                String rePath = realPath.replace(REROUTE_PATH_PREFIX, "");
-                ctx.reroute(rePath);
-                return;
-            }
-
-            if (!ctx.response().ended() && !ctx.response().closed()) {
-                ctx.response().putHeader("Server", serverName);
-            }
+            ctx.response().putHeader("Server", serverName);
             ctx.next();
         });
 
         // http api proxy
         if (proxyConf.containsKey("location")) {
-            handleLocation(proxyConf.getJsonArray("location"), proxyRouter);
+            handleLocation(proxyConf.getJsonArray("location"), httpClient, proxyRouter);
         }
 
         // static server
@@ -305,124 +111,22 @@ public class ReverseProxyVerticle extends AbstractVerticle {
             handleStatic(proxyConf.getJsonObject("static"), proxyRouter);
         }
 
-        // Send page404 page
-        proxyRouter.errorHandler(404, ctx -> {
-            sendNotFoundPage(ctx, proxyConf.getString("page404"));
-        });
-        proxyRouter.errorHandler(500, this::handleProxyFailure);
+        // static server
+        if (proxyConf.containsKey("sock")) {
+            handleSock(proxyConf.getJsonArray("sock"), httpClient, proxyRouter);
+        }
 
-        HttpServer server = getHttpsServer(proxyConf);
+        // Send 404 page
+        proxyRouter.errorHandler(404, ctx -> {
+            ctx.response().sendFile(proxyConf.getString("404"));
+        });
+
+        HttpServer server = vertx.createHttpServer();
         server.requestHandler(proxyRouter);
 
         Integer port = proxyConf.getInteger("listen");
         LOGGER.info("proxy server start on {} port", port);
-        return server.listen(port)
-                .onSuccess(s -> httpServers.add(s))
-                .onFailure(e -> LOGGER.error("proxy server start failed on {} port", port, e))
-                .mapEmpty();
-    }
-
-    private HttpServer getHttpsServer(JsonObject proxyConf) {
-        HttpServerOptions httpServerOptions = new HttpServerOptions()
-                // 【优化】高并发服务器配置
-                .setTcpKeepAlive(true)                    // TCP Keep-Alive
-                .setTcpNoDelay(true)                      // 禁用Nagle算法
-                .setCompressionSupported(true)            // 启用压缩
-                .setAcceptBacklog(1024)                   // 限制积压队列，避免小容器内存膨胀
-                .setIdleTimeout(120)                      // 空闲超时120秒
-                .setTcpFastOpen(true)                     // 启用TCP Fast Open
-                .setTcpQuickAck(true)                     // 启用TCP Quick ACK
-                .setReuseAddress(true)                    // 允许地址重用
-                .setReusePort(true);                      // 允许端口重用
-        if (proxyConf.containsKey("ssl")) {
-            JsonObject sslConfig = proxyConf.getJsonObject("ssl");
-
-            URL sslUrl = this.getClass().getClassLoader().getResource("");
-            if (sslUrl == null) {
-                throw new RuntimeException("SSL url not exist...");
-            }
-            if (sslConfig.containsKey("enable") && sslConfig.getBoolean("enable")) {
-                String sslCertificatePath = sslUrl.getPath() + sslConfig.getString("ssl_certificate");
-                String sslCertificateKeyPath = sslUrl.getPath() + sslConfig.getString("ssl_certificate_key");
-                LOGGER.info("enable ssl config. ");
-                httpServerOptions
-                        .setSsl(true)
-                        .setKeyCertOptions(
-                                new PemKeyCertOptions()
-                                        .setKeyPath(sslCertificateKeyPath)
-                                        .setCertPath(sslCertificatePath)
-                        ).addEnabledSecureTransportProtocol(sslConfig.getString("ssl_protocols"));
-                String sslCiphers = sslConfig.getString("ssl_ciphers");
-                if (sslCiphers != null && !sslCiphers.isEmpty()) {
-                    for (String s : sslCiphers.split(":")) {
-                        httpServerOptions.addEnabledCipherSuite(s);
-                    }
-                }
-            }
-
-        }
-        return vertx.createHttpServer(httpServerOptions);
-    }
-
-    private void addProxyHandler(Route route, HttpProxy httpProxy) {
-        Handler<RoutingContext> proxyHandler = ProxyHandler.create(httpProxy);
-        route.handler(ctx -> {
-            try {
-                proxyHandler.handle(ctx);
-            } catch (Throwable t) {
-                LOGGER.error("反向代理处理异常", t);
-                ctx.fail(t);
-            }
-        }).failureHandler(this::handleProxyFailure);
-    }
-
-    private void handleProxyFailure(RoutingContext ctx) {
-        Throwable failure = ctx.failure();
-        if (failure != null) {
-            LOGGER.error("反向代理路由失败", failure);
-        }
-        int statusCode = ctx.statusCode() > 0 ? ctx.statusCode() : 502;
-        if (statusCode < 400) {
-            statusCode = 502;
-        }
-        sendProxyError(ctx, statusCode, "Bad Gateway");
-    }
-
-    private void sendNotFoundPage(RoutingContext ctx, String page404) {
-        HttpServerResponse response = ctx.response();
-        if (response.ended() || response.closed()) {
-            return;
-        }
-        try {
-            if (response.headWritten()) {
-                response.reset();
-                return;
-            }
-            response.sendFile(page404)
-                    .onFailure(e -> {
-                        LOGGER.warn("发送代理 404 页面失败: {}", page404, e);
-                        sendProxyError(ctx, 404, "404 not found");
-                    });
-        } catch (Exception e) {
-            LOGGER.warn("发送代理 404 页面异常: {}", page404, e);
-            sendProxyError(ctx, 404, "404 not found");
-        }
-    }
-
-    private void sendProxyError(RoutingContext ctx, int statusCode, String message) {
-        HttpServerResponse response = ctx.response();
-        if (response.ended() || response.closed()) {
-            return;
-        }
-        try {
-            if (!response.headWritten()) {
-                response.setStatusCode(statusCode).end(message);
-            } else {
-                response.reset();
-            }
-        } catch (Exception e) {
-            LOGGER.debug("代理响应已关闭，忽略错误响应", e);
-        }
+        server.listen(port);
     }
 
     /**
@@ -441,12 +145,9 @@ public class ReverseProxyVerticle extends AbstractVerticle {
             ctx.next();
         });
 
-
-        StaticHandler staticHandler;
+        final StaticHandler staticHandler = StaticHandler.create();
         if (staticConf.containsKey("root")) {
-            staticHandler = StaticHandler.create(staticConf.getString("root"));
-        } else {
-            staticHandler = StaticHandler.create();
+            staticHandler.setWebRoot(staticConf.getString("root"));
         }
         if (staticConf.containsKey("directory-listing")) {
             staticHandler.setDirectoryListing(staticConf.getBoolean("directory-listing"));
@@ -460,9 +161,10 @@ public class ReverseProxyVerticle extends AbstractVerticle {
      * 处理Location配置 代理请求Location(和nginx类似?)
      *
      * @param locationsConf location配置
+     * @param httpClient    客户端
      * @param proxyRouter   代理路由
      */
-    private void handleLocation(JsonArray locationsConf, Router proxyRouter) {
+    private void handleLocation(JsonArray locationsConf, HttpClient httpClient, Router proxyRouter) {
 
         locationsConf.stream().map(e -> (JsonObject) e).forEach(location -> {
             // 代理规则
@@ -473,104 +175,33 @@ public class ReverseProxyVerticle extends AbstractVerticle {
                 String host = url.getHost();
                 int port = url.getPort();
                 if (port == -1) {
-                    port = 443;
+                    port = 80;
                 }
                 String originPath = url.getPath();
-                LOGGER.info("path {}, originPath {}, to {}:{}", path, originPath, host, port);
+                LOGGER.debug("Conf(path, originPath, host, port) ----> {},{},{},{}", path, originPath, host, port);
 
-                // 【优化】使用连接池获取HttpClient，避免每个location都创建新连接
-                final HttpClient httpClient = getOrCreateHttpClient(host, port);
+                // 注意这里不能origin多个代理地址, 一个实例只能代理一个origin
                 final HttpProxy httpProxy = HttpProxy.reverseProxy(httpClient);
                 httpProxy.origin(port, host);
-
-                // proxy-set-headers 支持（nginx 风格变量替换）
-                if (location.containsKey("proxy-set-headers")) {
-                    final JsonObject headerConf = location.getJsonObject("proxy-set-headers");
-                    httpProxy.addInterceptor(new ProxyInterceptor() {
-                        @Override
-                        public Future<ProxyResponse> handleProxyRequest(ProxyContext ctx) {
-                            HttpServerRequest incoming = ctx.request().proxiedRequest();
-                            String clientIp = resolveClientIp(incoming);
-                            headerConf.forEach(entry -> {
-                                Object val = entry.getValue();
-                                if (val != null) {
-                                    String resolved = resolveHeaderVariable(val.toString(), incoming, clientIp);
-                                    if (resolved != null) {
-                                        ctx.request().putHeader(entry.getKey(), resolved);
-                                    }
-                                }
-                            });
-                            return ProxyInterceptor.super.handleProxyRequest(ctx);
-                        }
-                    });
-                }
-
                 if (StringUtils.isEmpty(path)) {
                     return;
                 }
 
                 // 代理目标路径为空 就像nginx一样路径穿透 (相对路径)
                 if (StringUtils.isEmpty(originPath) || path.equals(originPath)) {
-                    Route route = path.startsWith("~") ? proxyRouter.routeWithRegex(path.substring(1))
-                            : proxyRouter.route(path);
-                    addProxyHandler(route, httpProxy);
+                    proxyRouter.route(path + "*").handler(ProxyHandler.create(httpProxy));
                 } else {
-                    // 配置 /api/, / => 请求 /api/test 代理后 /test
-                    // 配置 /api/, /xxx => 请求 /api/test 代理后 /xxx/test
-                     final String path0 = path;
-                     final String originPath0 = REROUTE_PATH_PREFIX + originPath;
-
-                     addProxyHandler(proxyRouter.route(originPath0 + "*"), httpProxy);
-                     proxyRouter.route(path0 + "*").handler(ctx -> {
-                         String realPath = ctx.request().uri();
-                         if (realPath.startsWith(path0)) {
-                             // vertx web proxy暂不支持rewrite, 所以这里进行手动替换, 请求地址中的请求path前缀替换为originPath
-                             String rePath = realPath.replaceAll("^" + path0, originPath0);
-                             ctx.reroute(rePath);
-                         } else {
-                             ctx.next();
-                         }
-                     });
-                    // 计算唯一后缀，避免多个 location 冲突
-//                    String uniqueKey = (host + ":" + port + "|" + path).replaceAll("[^a-zA-Z0-9:_|/]", "");
-//                    String uniqueSuffix = Integer.toHexString(uniqueKey.hashCode());
-//
-//// 规格化 originPath
-//                    //String originPath = url.getPath(); // 原值
-//                    if (StringUtils.isBlank(originPath)) originPath = "/";
-//
-//// 处理 index.html 的情况：用于首页兜底，其它子路径仍按目录穿透
-//                    String indexFile;
-//                    if (originPath.endsWith(".html")) {
-//                        indexFile = originPath;     // 例如 /index.html
-//                        originPath = "/";           // 目录穿透基准改为根
-//                    } else {
-//                        indexFile = null;
-//                    }
-//
-//// 唯一内部挂载前缀
-//                    final String originMount = REROUTE_PATH_PREFIX + uniqueSuffix + originPath;
-//
-//// 1) 目标挂载：所有被重写的请求最终到这里走 ProxyHandler
-//                    proxyRouter.route(originMount + "*").handler(ProxyHandler.create(httpProxy));
-//
-//// 2) 从外部前缀 -> 内部挂载 的重写
-//                    final String path0 = path;
-//                    proxyRouter.route(path0 + "*").handler(ctx -> {
-//                        String uri = ctx.request().uri();
-//                        if (!uri.startsWith(path0)) { ctx.next(); return; }
-//
-//                        // 首页兜底：访问 /n2 或 /n2/ 时，重写到 index.html（如果配置了）
-//                        if (indexFile != null && (uri.equals(path0) || uri.equals(path0.substring(0, path0.length()-1)))) {
-//                            String rePath = originMount.endsWith("/") ? (originMount + indexFile.substring(1)) : (originMount + indexFile);
-//                            ctx.reroute(rePath);
-//                            return;
-//                        }
-//
-//                        // 一般穿透：/n2/xxx -> originMount + xxx
-//                        String rePath = uri.replaceFirst("^" + path0, originMount);
-//                        ctx.reroute(rePath);
-//                    });
+                    proxyRouter.route(originPath + "*").handler(ProxyHandler.create(httpProxy));
+                    proxyRouter.route(path + "*").handler(ctx -> {
+                        String realPath = ctx.request().path();
+                        if (realPath.startsWith(path)) {
+                            // vertx web proxy暂不支持rewrite, 所以这里进行手动替换, 请求地址中的请求path前缀替换为originPath
+                            String rePath = realPath.replaceAll("^" + path, originPath);
+                            ctx.reroute(rePath);
+                        } else {
+                            ctx.next();
+                        }
+                    });
                 }
 
             } catch (MalformedURLException e) {
@@ -579,4 +210,54 @@ public class ReverseProxyVerticle extends AbstractVerticle {
 
         });
     }
+
+    /**
+     * 处理websocket
+     *
+     * @param confList    sock配置
+     * @param httpClient  客户端
+     * @param proxyRouter 代理路由
+     */
+    private void handleSock(JsonArray confList, HttpClient httpClient, Router proxyRouter) {
+        // 代理规则
+        confList.stream().map(e -> (JsonObject) e).forEach(conf -> {
+
+            String origin = conf.getString("origin");
+            String path = conf.getString("path");
+            LOGGER.info("websocket proxy: {}, {}",origin,path);
+
+            SockJSHandlerOptions options = new SockJSHandlerOptions()
+                    .setHeartbeatInterval(2000)
+                    .setRegisterWriteHandler(true);
+
+            SockJSHandler sockJSHandler = SockJSHandler.create(VertxHolder.getVertxInstance(), options);
+            if (!path.startsWith("/")) {
+                path = "/" + path;
+            }
+
+
+            Router route = sockJSHandler.socketHandler(sock -> {
+                sock.handler(buffer -> {
+                    Future<WebSocket> webSocketFuture = httpClient.webSocket(8086,"127.0.0.1",sock.uri());
+                    webSocketFuture.onSuccess(s -> {
+                        System.out.println(buffer.toString());
+                        s.write(buffer).onSuccess(v -> {
+                            s.handler(w->{
+                                System.out.println("--------"+w.toString());
+                            });
+                        });
+                    });
+                });
+                sock.endHandler(v -> {
+
+                });
+                sock.closeHandler(v -> {
+
+                });
+            });
+            proxyRouter.mountSubRouter("/real/serverApi/test", route);
+        });
+
+
+    }
 }

core/src/main/java/cn/qaiu/vx/core/verticle/RouterVerticle.java

@@ -2,7 +2,6 @@ package cn.qaiu.vx.core.verticle;
 
 import cn.qaiu.vx.core.handlerfactory.RouterHandlerFactory;
 import cn.qaiu.vx.core.util.CommonUtil;
-import cn.qaiu.vx.core.util.JacksonConfig;
 import cn.qaiu.vx.core.util.SharedDataUtil;
 import io.vertx.core.AbstractVerticle;
 import io.vertx.core.Promise;
@@ -22,22 +21,21 @@ public class RouterVerticle extends AbstractVerticle {
 
     private static final Logger LOGGER = LoggerFactory.getLogger(RouterVerticle.class);
 
+    private static final int port = SharedDataUtil.getValueForServerConfig("port");
+    private static final Router router = new RouterHandlerFactory(
+            SharedDataUtil.getJsonStringForCustomConfig("routerLocations"),
+            SharedDataUtil.getJsonStringForServerConfig("contextPath")).createRouter();
+
+    private static final JsonObject globalConfig = SharedDataUtil.getJsonConfig("globalConfig");
+
     private HttpServer server;
-    private Router router;
-    private int port;
-    private JsonObject globalConfig;
 
     static {
-        LOGGER.info(JacksonConfig.class.getSimpleName() + " >> ");
-        JacksonConfig.nothing();
+        LOGGER.info("To start listening to port {} ......", port);
     }
 
     @Override
     public void start(Promise<Void> startPromise) {
-        port = SharedDataUtil.getValueForServerConfig("port");
-        globalConfig = SharedDataUtil.getJsonConfig("globalConfig");
-        LOGGER.info("To start listening to port {} ......", port);
-
         // 端口是否占用
         if (CommonUtil.isPortUsing(port)) {
             throw new RuntimeException("Start fail: the '" + port + "' port is already in use...");
@@ -49,23 +47,9 @@ public class RouterVerticle extends AbstractVerticle {
             options = new HttpServerOptions();
         }
         options.setPort(port);
-        
-        // 【优化】高并发服务器配置
-        options.setTcpKeepAlive(true)                     // TCP Keep-Alive
-               .setTcpNoDelay(true)                       // 禁用Nagle算法，降低延迟
-               .setCompressionSupported(true)             // 启用压缩
-               .setAcceptBacklog(50000)                   // 增加积压队列到50000，防止高并发时连接被拒绝
-               .setIdleTimeout(120)                       // 空闲超时120秒
-               .setTcpFastOpen(true)                      // 启用TCP Fast Open
-               .setTcpQuickAck(true)                      // 启用TCP Quick ACK
-               .setReuseAddress(true)                     // 允许地址重用
-               .setReusePort(true);                       // 允许端口重用
-        
-        router = new RouterHandlerFactory(
-                SharedDataUtil.getJsonStringForServerConfig("contextPath")).createRouter();
         server = vertx.createHttpServer(options);
 
-        server.requestHandler(router).listen()
+        server.requestHandler(router).webSocketHandler(s->{}).listen()
                 .onSuccess(s -> startPromise.complete())
                 .onFailure(e -> startPromise.fail(e.getCause()));
     }

core/src/main/java/cn/qaiu/vx/core/verticle/ServiceVerticle.java

@@ -3,17 +3,14 @@ package cn.qaiu.vx.core.verticle;
 import cn.qaiu.vx.core.annotaions.Service;
 import cn.qaiu.vx.core.base.BaseAsyncService;
 import cn.qaiu.vx.core.util.ReflectionUtil;
+import cn.qaiu.vx.core.util.SharedDataUtil;
 import io.vertx.core.AbstractVerticle;
 import io.vertx.core.Promise;
-import io.vertx.core.eventbus.MessageConsumer;
-import io.vertx.core.json.JsonObject;
 import io.vertx.serviceproxy.ServiceBinder;
 import org.reflections.Reflections;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 
-import java.util.ArrayList;
-import java.util.List;
 import java.util.Set;
 import java.util.concurrent.atomic.AtomicInteger;
 
@@ -28,48 +25,27 @@ public class ServiceVerticle extends AbstractVerticle {
     Logger LOGGER = LoggerFactory.getLogger(ServiceVerticle.class);
     private static final AtomicInteger ID = new AtomicInteger(1);
     private static final Set<Class<?>> handlers;
-    private final List<MessageConsumer<JsonObject>> consumers = new ArrayList<>();
 
     static {
-        Reflections reflections = ReflectionUtil.getReflections();
+        String handlerLocations = SharedDataUtil.getJsonStringForCustomConfig("handlerLocations");
+        Reflections reflections = ReflectionUtil.getReflections(handlerLocations);
         handlers = reflections.getTypesAnnotatedWith(Service.class);
     }
+
     @Override
     public void start(Promise<Void> startPromise) {
         ServiceBinder binder = new ServiceBinder(vertx);
         if (null != handlers && handlers.size() > 0) {
-            // handlers转为拼接类列表，xxx,yyy,zzz
-            StringBuilder serviceNames = new StringBuilder();
             handlers.forEach(asyncService -> {
                 try {
-                    serviceNames.append(asyncService.getName()).append("|");
                     BaseAsyncService asInstance = (BaseAsyncService) ReflectionUtil.newWithNoParam(asyncService);
-                    String address = asInstance.getAddress();
-                    MessageConsumer<JsonObject> consumer = binder.setAddress(address)
-                            .register(asInstance.getAsyncInterfaceClass(), asInstance);
-                    consumers.add(consumer);
+                    binder.setAddress(asInstance.getAddress()).register(asInstance.getAsyncInterfaceClass(), asInstance);
                 } catch (Exception e) {
-                    LOGGER.error("Failed to register service: {}", asyncService.getName(), e);
+                    LOGGER.error(e.getMessage());
                 }
             });
-
-            LOGGER.info("registered async services -> id: {}, name: {}", ID.getAndIncrement(), serviceNames.toString());
+            LOGGER.info("registered async services -> id: {}", ID.getAndIncrement());
         }
         startPromise.complete();
     }
-
-    @Override
-    public void stop(Promise<Void> stopPromise) {
-        int count = consumers.size();
-        consumers.forEach(consumer -> {
-            try {
-                consumer.unregister();
-            } catch (Exception e) {
-                LOGGER.warn("Failed to unregister service consumer at address: {}", consumer.address(), e);
-            }
-        });
-        consumers.clear();
-        LOGGER.info("ServiceVerticle stopped, unregistered {} services", count);
-        stopPromise.complete();
-    }
 }

core/src/main/java/cn/qaiu/vx/core/verticle/conf/HttpProxyConf.java

@@ -1,89 +0,0 @@
-package cn.qaiu.vx.core.verticle.conf;
-
-import io.vertx.codegen.annotations.DataObject;
-import io.vertx.codegen.json.annotations.JsonGen;
-import io.vertx.core.json.JsonObject;
-import io.vertx.core.net.ProxyOptions;
-
-import java.util.UUID;
-
-@DataObject
-//@JsonGen(publicConverter = false)
-public class HttpProxyConf {
-
-    public static final String DEFAULT_USERNAME = UUID.randomUUID().toString();
-
-    public static final String DEFAULT_PASSWORD = UUID.randomUUID().toString();
-
-    public static final Integer DEFAULT_PORT = 6432;
-
-    public static final Integer DEFAULT_TIMEOUT = 15000;
-
-    Integer timeout;
-
-    String username;
-
-    String password;
-
-    Integer port;
-
-    ProxyOptions preProxyOptions;
-
-    public HttpProxyConf() {
-        this.username = DEFAULT_USERNAME;
-        this.password = DEFAULT_PASSWORD;
-        this.port = DEFAULT_PORT;
-        this.timeout = DEFAULT_TIMEOUT;
-        this.preProxyOptions = new ProxyOptions();
-    }
-
-    public HttpProxyConf(JsonObject json) {
-        this();
-    }
-
-
-    public Integer getTimeout() {
-        return timeout;
-    }
-
-    public HttpProxyConf setTimeout(Integer timeout) {
-        this.timeout = timeout;
-        return this;
-    }
-
-    public String getUsername() {
-        return username;
-    }
-
-    public HttpProxyConf setUsername(String username) {
-        this.username = username;
-        return this;
-    }
-
-    public String getPassword() {
-        return password;
-    }
-
-    public HttpProxyConf setPassword(String password) {
-        this.password = password;
-        return this;
-    }
-
-    public Integer getPort() {
-        return port;
-    }
-
-    public HttpProxyConf setPort(Integer port) {
-        this.port = port;
-        return this;
-    }
-
-    public ProxyOptions getPreProxyOptions() {
-        return preProxyOptions;
-    }
-
-    public HttpProxyConf setPreProxyOptions(ProxyOptions preProxyOptions) {
-        this.preProxyOptions = preProxyOptions;
-        return this;
-    }
-}

core/src/main/resources/app.properties

@@ -1,2 +0,0 @@
-app.version=${project.version}
-build=${maven.build.timestamp}

core/src/main/resources/logback.xml

@@ -1,15 +1,13 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <configuration>
-    <statusListener class="ch.qos.logback.core.status.NopStatusListener" />
+
     <!-- 日志自定义颜色 -->
     <!-- https://logback.qos.ch/manual/layouts.html#coloring -->
 
     <!--日志文件主目录：这里${user.home}为当前服务器用户主目录-->
     <property name="LOG_HOME" value="logs"/>
-    <!--日志文件名称：这里spring.application.name表示工程名称-->
 
     <property name="LOGBACK_DEFAULT" value="%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n"/>
-    <property name="CUSTOMER_PATTERN" value="%d{yyyy-MM-dd HH:mm:ss.SSS} %magenta([%t]) %highlight(%-5p) %yellow(${PID:-}) %cyan(%-40.40logger{39}) : %green(%m%n)"/>
     <property name="CUSTOMER_PATTERN2" value="%d{yyyy-MM-dd HH:mm:ss.SSS} %highlight(%-5level) -> %magenta([%15.15thread]) %cyan(%-40.40logger{39}) : %msg%n"/>
 
     <!--配置日志文件(File)-->
@@ -37,10 +35,10 @@
 
     <!-- 将文件输出设置成异步输出 -->
     <appender name="ASYNC-FILE" class="ch.qos.logback.classic.AsyncAppender">
-        <!-- 队列剩余 20% 时开始丢弃 TRACE/DEBUG/INFO 级别日志，避免阻塞调用线程 -->
-        <discardingThreshold>20</discardingThreshold>
+        <!-- 不丢失日志.默认的,如果队列的80%已满,则会丢弃TRACT、DEBUG、INFO级别的日志 -->
+        <discardingThreshold>0</discardingThreshold>
         <!-- 更改默认的队列的深度,该值会影响性能.默认值为256 -->
-        <queueSize>512</queueSize>
+        <queueSize>256</queueSize>
         <!-- 添加附加的appender,最多只能添加一个 -->
         <appender-ref ref="FILE"/>
     </appender>
@@ -53,10 +51,8 @@
     </appender>
     <logger name="io.netty" level="warn"/>
     <logger name="io.vertx" level="info"/>
-    <logger name="com.zaxxer.hikari" level="info"/>
-    <logger name="cn.qaiu" level="debug"/>
-    <root level="info">
+    <root level="debug">
         <appender-ref ref="STDOUT"/>
-<!--        <appender-ref ref="FILE"/>-->
+        <appender-ref ref="FILE"/>
     </root>
 </configuration>

core/src/test/java/cn/qaiu/vx/core/test/JsonBodyBindingLogicTest.java

@@ -1,134 +0,0 @@
-package cn.qaiu.vx.core.test;
-
-import io.vertx.core.json.JsonArray;
-import io.vertx.core.json.JsonObject;
-import org.junit.Assert;
-import org.junit.Test;
-
-/**
- * 单元测试：验证 RouterHandlerFactory 关于 JsonObject/JsonArray 参数绑定的核心分支逻辑是否正确
- * （不启动整个 Vert.x 服务器，直接用 Vert.x JsonObject/JsonArray API 模拟验证关键逻辑）
- */
-public class JsonBodyBindingLogicTest {
-
-    // === 模拟 handlerMethod 中的 JSON body 绑定逻辑 ===
-
-    /**
-     * 模拟：content-type = application/json，body 是 JsonObject
-     * 期望：JsonObject 类型参数被正确绑定
-     */
-    @Test
-    public void testJsonObjectBinding() {
-        String bodyStr = "{\"name\":\"test\",\"value\":123}";
-
-        // 模拟 ctx.body().asJsonObject()
-        JsonObject body = parseAsJsonObject(bodyStr);
-        Assert.assertNotNull("body 应能解析为 JsonObject", body);
-
-        // 模拟绑定逻辑中的类型判断
-        String targetType = JsonObject.class.getName();
-        boolean matched = JsonObject.class.getName().equals(targetType);
-        Assert.assertTrue("JsonObject 类型应命中绑定分支", matched);
-
-        // 模拟结果
-        Object bound = body; // parameterValueList.put(k, body)
-        Assert.assertNotNull("JsonObject 参数应被绑定（非null）", bound);
-        Assert.assertEquals("name字段应为test", "test", ((JsonObject) bound).getString("name"));
-        Assert.assertEquals("value字段应为123", 123, (int) ((JsonObject) bound).getInteger("value"));
-
-        System.out.println("[PASS] testJsonObjectBinding: JsonObject 绑定成功 -> " + bound);
-    }
-
-    /**
-     * 模拟：content-type = application/json，body 是 JsonArray
-     * 期望：JsonArray 类型参数被正确绑定
-     */
-    @Test
-    public void testJsonArrayBinding() {
-        String bodyStr = "[1,2,3]";
-
-        // body 解析为 JsonObject 应返回 null
-        JsonObject bodyAsObj = parseAsJsonObject(bodyStr);
-        Assert.assertNull("JsonArray body 解析为 JsonObject 应为 null", bodyAsObj);
-
-        // 进入 else 分支，解析为 JsonArray
-        JsonArray bodyArr = parseAsJsonArray(bodyStr);
-        Assert.assertNotNull("body 应能解析为 JsonArray", bodyArr);
-
-        String targetType = JsonArray.class.getName();
-        boolean matched = JsonArray.class.getName().equals(targetType);
-        Assert.assertTrue("JsonArray 类型应命中绑定分支", matched);
-
-        Object bound = bodyArr;
-        Assert.assertNotNull("JsonArray 参数应被绑定（非null）", bound);
-        Assert.assertEquals("数组大小应为3", 3, ((JsonArray) bound).size());
-
-        System.out.println("[PASS] testJsonArrayBinding: JsonArray 绑定成功, size=" + ((JsonArray) bound).size());
-    }
-
-    /**
-     * 验证旧代码的 bug：条件 ctx.body().asJsonObject() != null 会把 JsonArray body 排除在外
-     * 新代码只判断 content-type，在 body==null 时才进 else 分支处理 JsonArray
-     */
-    @Test
-    public void testOldConditionBug() {
-        String jsonArrayBody = "[1,2,3]";
-
-        // 旧代码条件：content-type==json && asJsonObject()!=null
-        // 对于 JsonArray body，asJsonObject() 返回 null，整个 if 跳过
-        JsonObject wrongParsed = parseAsJsonObject(jsonArrayBody);
-        boolean oldConditionPassed = wrongParsed != null; // 旧代码的第二个条件
-        Assert.assertFalse("旧代码 bug: JsonArray body 会导致 asJsonObject()==null，整个分支跳过", oldConditionPassed);
-
-        // 新代码：先进 if，body==null 再走 else 解析 JsonArray
-        boolean newConditionFirst = true; // content-type 匹配
-        JsonObject newBody = parseAsJsonObject(jsonArrayBody);
-        boolean newBodyIsNull = newBody == null; // null -> 进 else
-        Assert.assertTrue("新代码: body 解析为 null 时应走 else 分支解析 JsonArray", newBodyIsNull);
-
-        JsonArray newArr = parseAsJsonArray(jsonArrayBody);
-        Assert.assertNotNull("新代码: else 分支正确解析出 JsonArray", newArr);
-
-        System.out.println("[PASS] testOldConditionBug: 修复验证通过，新代码正确处理 JsonArray body");
-    }
-
-    /**
-     * 验证：JsonObject 参数旧代码没有绑定分支（只处理实体类）
-     */
-    @Test
-    public void testOldMissingJsonObjectBranch() {
-        String bodyStr = "{\"key\":\"value\"}";
-        JsonObject body = parseAsJsonObject(bodyStr);
-
-        // 旧代码只调用 matchRegList(entityPackagesReg, typeName)
-        // 对于 io.vertx.core.json.JsonObject，该方法返回 false，不会被绑定
-        String typeName = JsonObject.class.getName(); // "io.vertx.core.json.JsonObject"
-        // entityPackagesReg 一般是 "cn.qaiu.*" 这类，不会匹配 io.vertx
-        boolean oldWouldBind = typeName.startsWith("cn.qaiu"); // 模拟旧代码逻辑
-        Assert.assertFalse("旧代码 bug: JsonObject 参数不会被绑定", oldWouldBind);
-
-        // 新代码：增加了 JsonObject 类型判断
-        boolean newWouldBind = JsonObject.class.getName().equals(typeName);
-        Assert.assertTrue("新代码: JsonObject 参数应能被绑定", newWouldBind);
-
-        System.out.println("[PASS] testOldMissingJsonObjectBranch: 修复验证通过");
-    }
-
-    // ===== 辅助方法：模拟 Vert.x RequestBody 的 asJsonObject/asJsonArray 行为 =====
-
-    private JsonObject parseAsJsonObject(String str) {
-        try {
-            return new JsonObject(str);
-        } catch (Exception e) {
-            return null;
-        }
-    }
-
-    private JsonArray parseAsJsonArray(String str) {
-        try {
-            return new JsonArray(str);
-        } catch (Exception e) {
-            return null;
-        }
-    }
-}

core/src/test/java/cn/qaiu/vx/core/test/RouterHandlerBindingTest.java

@@ -1,125 +0,0 @@
-package cn.qaiu.vx.core.test;
-
-import cn.qaiu.vx.core.util.VertxHolder;
-import io.vertx.core.Vertx;
-import io.vertx.core.json.JsonArray;
-import io.vertx.core.json.JsonObject;
-
-import java.net.URI;
-import java.net.http.HttpClient;
-import java.net.http.HttpRequest;
-import java.net.http.HttpResponse;
-import java.util.concurrent.CountDownLatch;
-import java.util.concurrent.TimeUnit;
-
-/**
- * 集成测试: 验证 RouterHandlerFactory 对 JsonObject/JsonArray 参数绑定逻辑是否正确
- *
- * 运行方式: mvn test-compile -pl core && java -cp "core/target/test-classes:core/target/classes:..." \
- *            cn.qaiu.vx.core.test.RouterHandlerBindingTest
- *
- * 或直接在 IDE 中运行 main 方法。
- */
-public class RouterHandlerBindingTest {
-
-    static final int TEST_PORT = 18989;
-
-    public static void main(String[] args) throws Exception {
-        System.out.println("=== RouterHandler JsonObject/JsonArray 绑定测试 ===\n");
-
-        // 1. 先初始化 Vert.x 与 VertxHolder ——必须在加载 RouterHandlerFactory 之前
-        Vertx vertx = Vertx.vertx();
-        VertxHolder.init(vertx);
-
-        // 2. 向 SharedData 注入最小化配置
-        //    baseLocations 指向测试包，使 Reflections 只扫描 TestJsonHandler
-        vertx.sharedData().getLocalMap("local").put("customConfig", new JsonObject()
-                .put("baseLocations", "cn.qaiu.vx.core.test")
-                .put("routeTimeOut", 30000)
-                .put("entityPackagesReg", new JsonArray()));
-        // ReverseProxyVerticle.<clinit> 需要 globalConfig.proxyConf（非空字符串即可）
-        vertx.sharedData().getLocalMap("local").put("globalConfig", new JsonObject()
-                .put("proxyConf", "proxy.yml"));
-
-        // 3. 创建 Router（此时才触发 BaseHttpApi.reflections 静态字段初始化）
-        //    用反射延迟加载，确保上面的 SharedData 已就绪
-        cn.qaiu.vx.core.handlerfactory.RouterHandlerFactory factory =
-                new cn.qaiu.vx.core.handlerfactory.RouterHandlerFactory("api");
-        io.vertx.ext.web.Router router = factory.createRouter();
-
-        // 4. 启动 HTTP 服务器
-        CountDownLatch latch = new CountDownLatch(1);
-        vertx.createHttpServer()
-                .requestHandler(router)
-                .listen(TEST_PORT, res -> {
-                    if (res.succeeded()) {
-                        System.out.println("✔ 测试服务器启动成功  port=" + TEST_PORT);
-                    } else {
-                        System.err.println("✘ 服务器启动失败: " + res.cause().getMessage());
-                    }
-                    latch.countDown();
-                });
-
-        if (!latch.await(5, TimeUnit.SECONDS)) {
-            System.err.println("服务器启动超时");
-            vertx.close();
-            System.exit(1);
-        }
-        Thread.sleep(100); // 等 Vert.x 就绪
-
-        // 5. 执行测试
-        boolean allPassed = true;
-        allPassed &= testJsonObject();
-        allPassed &= testJsonArray();
-
-        // 6. 关闭
-        CountDownLatch closeLatch = new CountDownLatch(1);
-        vertx.close(v -> closeLatch.countDown());
-        closeLatch.await(3, TimeUnit.SECONDS);
-
-        System.out.println("\n" + (allPassed ? "✅ 全部测试通过!" : "❌ 存在测试失败!"));
-        System.exit(allPassed ? 0 : 1);
-    }
-
-    // ---------- 子测试 ----------
-
-    private static boolean testJsonObject() throws Exception {
-        String bodyStr = "{\"name\":\"test\",\"value\":123}";
-        String respBody = post("/api/test/json-object", bodyStr);
-        System.out.println("[JsonObject] 响应: " + respBody);
-
-        JsonObject result = new JsonObject(respBody);
-        JsonObject data = result.getJsonObject("data");
-        boolean bound = data != null && Boolean.TRUE.equals(data.getBoolean("bound"));
-        System.out.println("[JsonObject] " + (bound
-                ? "PASS ✅  body 正确绑定为 JsonObject"
-                : "FAIL ❌  body 未绑定 (null)"));
-        return bound;
-    }
-
-    private static boolean testJsonArray() throws Exception {
-        String bodyStr = "[1,2,3]";
-        String respBody = post("/api/test/json-array", bodyStr);
-        System.out.println("[JsonArray]  响应: " + respBody);
-
-        JsonObject result = new JsonObject(respBody);
-        JsonObject data = result.getJsonObject("data");
-        boolean bound = data != null
-                && Boolean.TRUE.equals(data.getBoolean("bound"))
-                && Integer.valueOf(3).equals(data.getInteger("size"));
-        System.out.println("[JsonArray]  " + (bound
-                ? "PASS ✅  body 正确绑定为 JsonArray, size=3"
-                : "FAIL ❌  body 未绑定 或 size 不对"));
-        return bound;
-    }
-
-    private static String post(String path, String body) throws Exception {
-        HttpClient client = HttpClient.newHttpClient();
-        HttpRequest req = HttpRequest.newBuilder()
-                .uri(URI.create("http://localhost:" + TEST_PORT + path))
-                .header("Content-Type", "application/json")
-                .POST(HttpRequest.BodyPublishers.ofString(body))
-                .build();
-        return client.send(req, HttpResponse.BodyHandlers.ofString()).body();
-    }
-}

core/src/test/java/cn/qaiu/vx/core/test/TestJsonHandler.java

@@ -1,36 +0,0 @@
-package cn.qaiu.vx.core.test;
-
-import cn.qaiu.vx.core.annotaions.RouteHandler;
-import cn.qaiu.vx.core.annotaions.RouteMapping;
-import cn.qaiu.vx.core.enums.MIMEType;
-import cn.qaiu.vx.core.enums.RouteMethod;
-import cn.qaiu.vx.core.model.JsonResult;
-import io.vertx.core.Future;
-import io.vertx.core.json.JsonArray;
-import io.vertx.core.json.JsonObject;
-
-/**
- * 用于测试 RouterHandlerFactory 对 JsonObject/JsonArray 参数绑定的测试 Handler
- */
-@RouteHandler("test")
-public class TestJsonHandler {
-
-    /** POST /api/test/json-object  Body: {"name":"test","value":123} */
-    @RouteMapping(value = "/json-object", method = RouteMethod.POST, requestMIMEType = MIMEType.APPLICATION_JSON)
-    public Future<JsonResult> testJsonObject(JsonObject body) {
-        // 只返回是否绑定成功及已知字段值，不嵌套原始 body 避免 toJsonObject() 循环
-        boolean bound = body != null;
-        String nameVal = bound ? body.getString("name", "") : "";
-        return Future.succeededFuture(JsonResult.data(new io.vertx.core.json.JsonObject()
-                .put("bound", bound)
-                .put("name", nameVal)));
-    }
-
-    /** POST /api/test/json-array  Body: [1,2,3] */
-    @RouteMapping(value = "/json-array", method = RouteMethod.POST, requestMIMEType = MIMEType.APPLICATION_JSON)
-    public Future<JsonResult> testJsonArray(JsonArray body) {
-        return Future.succeededFuture(JsonResult.data(new io.vertx.core.json.JsonObject()
-                .put("bound", body != null)
-                .put("size", body != null ? body.size() : -1)));
-    }
-}

docker-entrypoint.sh

@@ -1,13 +0,0 @@
-#!/bin/sh
-set -e
-
-# Fix permissions on volume-mounted directories (runs as root)
-chown -R appuser:appgroup /app/db /app/logs /app/resources 2>/dev/null || true
-
-# Run Java directly - entrypoint is PID 1, exec makes Java PID 1
-# Docker SIGTERM goes directly to Java, triggering ShutdownHook
-DEFAULT_JVM_OPTS="-Xmx${JVM_XMX:-512M} -Xss${JVM_XSS:-512k} -XX:MaxDirectMemorySize=${JVM_MAX_DIRECT_MEMORY:-256M} -DNFD_LOG_LEVEL=${NFD_LOG_LEVEL:-info} -DNFD_PLAYGROUND_ENABLED=${NFD_PLAYGROUND_ENABLED:-false}"
-if [ -n "${JVM_MAX_METASPACE:-}" ]; then
-  DEFAULT_JVM_OPTS="$DEFAULT_JVM_OPTS -XX:MaxMetaspaceSize=$JVM_MAX_METASPACE"
-fi
-exec java ${DEFAULT_JVM_OPTS} ${JVM_OPTS} -Duser.timezone=${TZ:-Asia/Shanghai} -jar /app/netdisk-fast-download.jar

mvnw

@@ -1,310 +0,0 @@
-#!/bin/sh
-# ----------------------------------------------------------------------------
-# Licensed to the Apache Software Foundation (ASF) under one
-# or more contributor license agreements.  See the NOTICE file
-# distributed with this work for additional information
-# regarding copyright ownership.  The ASF licenses this file
-# to you under the Apache License, Version 2.0 (the
-# "License"); you may not use this file except in compliance
-# with the License.  You may obtain a copy of the License at
-#
-#    http://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing,
-# software distributed under the License is distributed on an
-# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-# KIND, either express or implied.  See the License for the
-# specific language governing permissions and limitations
-# under the License.
-# ----------------------------------------------------------------------------
-
-# ----------------------------------------------------------------------------
-# Maven Start Up Batch script
-#
-# Required ENV vars:
-# ------------------
-#   JAVA_HOME - location of a JDK home dir
-#
-# Optional ENV vars
-# -----------------
-#   M2_HOME - location of maven2's installed home dir
-#   MAVEN_OPTS - parameters passed to the Java VM when running Maven
-#     e.g. to debug Maven itself, use
-#       set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
-#   MAVEN_SKIP_RC - flag to disable loading of mavenrc files
-# ----------------------------------------------------------------------------
-
-if [ -z "$MAVEN_SKIP_RC" ] ; then
-
-  if [ -f /etc/mavenrc ] ; then
-    . /etc/mavenrc
-  fi
-
-  if [ -f "$HOME/.mavenrc" ] ; then
-    . "$HOME/.mavenrc"
-  fi
-
-fi
-
-# OS specific support.  $var _must_ be set to either true or false.
-cygwin=false;
-darwin=false;
-mingw=false
-case "`uname`" in
-  CYGWIN*) cygwin=true ;;
-  MINGW*) mingw=true;;
-  Darwin*) darwin=true
-    # Use /usr/libexec/java_home if available, otherwise fall back to /Library/Java/Home
-    # See https://developer.apple.com/library/mac/qa/qa1170/_index.html
-    if [ -z "$JAVA_HOME" ]; then
-      if [ -x "/usr/libexec/java_home" ]; then
-        export JAVA_HOME="`/usr/libexec/java_home`"
-      else
-        export JAVA_HOME="/Library/Java/Home"
-      fi
-    fi
-    ;;
-esac
-
-if [ -z "$JAVA_HOME" ] ; then
-  if [ -r /etc/gentoo-release ] ; then
-    JAVA_HOME=`java-config --jre-home`
-  fi
-fi
-
-if [ -z "$M2_HOME" ] ; then
-  ## resolve links - $0 may be a link to maven's home
-  PRG="$0"
-
-  # need this for relative symlinks
-  while [ -h "$PRG" ] ; do
-    ls=`ls -ld "$PRG"`
-    link=`expr "$ls" : '.*-> \(.*\)$'`
-    if expr "$link" : '/.*' > /dev/null; then
-      PRG="$link"
-    else
-      PRG="`dirname "$PRG"`/$link"
-    fi
-  done
-
-  saveddir=`pwd`
-
-  M2_HOME=`dirname "$PRG"`/..
-
-  # make it fully qualified
-  M2_HOME=`cd "$M2_HOME" && pwd`
-
-  cd "$saveddir"
-  # echo Using m2 at $M2_HOME
-fi
-
-# For Cygwin, ensure paths are in UNIX format before anything is touched
-if $cygwin ; then
-  [ -n "$M2_HOME" ] &&
-    M2_HOME=`cygpath --unix "$M2_HOME"`
-  [ -n "$JAVA_HOME" ] &&
-    JAVA_HOME=`cygpath --unix "$JAVA_HOME"`
-  [ -n "$CLASSPATH" ] &&
-    CLASSPATH=`cygpath --path --unix "$CLASSPATH"`
-fi
-
-# For Mingw, ensure paths are in UNIX format before anything is touched
-if $mingw ; then
-  [ -n "$M2_HOME" ] &&
-    M2_HOME="`(cd "$M2_HOME"; pwd)`"
-  [ -n "$JAVA_HOME" ] &&
-    JAVA_HOME="`(cd "$JAVA_HOME"; pwd)`"
-fi
-
-if [ -z "$JAVA_HOME" ]; then
-  javaExecutable="`which javac`"
-  if [ -n "$javaExecutable" ] && ! [ "`expr \"$javaExecutable\" : '\([^ ]*\)'`" = "no" ]; then
-    # readlink(1) is not available as standard on Solaris 10.
-    readLink=`which readlink`
-    if [ ! `expr "$readLink" : '\([^ ]*\)'` = "no" ]; then
-      if $darwin ; then
-        javaHome="`dirname \"$javaExecutable\"`"
-        javaExecutable="`cd \"$javaHome\" && pwd -P`/javac"
-      else
-        javaExecutable="`readlink -f \"$javaExecutable\"`"
-      fi
-      javaHome="`dirname \"$javaExecutable\"`"
-      javaHome=`expr "$javaHome" : '\(.*\)/bin'`
-      JAVA_HOME="$javaHome"
-      export JAVA_HOME
-    fi
-  fi
-fi
-
-if [ -z "$JAVACMD" ] ; then
-  if [ -n "$JAVA_HOME"  ] ; then
-    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
-      # IBM's JDK on AIX uses strange locations for the executables
-      JAVACMD="$JAVA_HOME/jre/sh/java"
-    else
-      JAVACMD="$JAVA_HOME/bin/java"
-    fi
-  else
-    JAVACMD="`which java`"
-  fi
-fi
-
-if [ ! -x "$JAVACMD" ] ; then
-  echo "Error: JAVA_HOME is not defined correctly." >&2
-  echo "  We cannot execute $JAVACMD" >&2
-  exit 1
-fi
-
-if [ -z "$JAVA_HOME" ] ; then
-  echo "Warning: JAVA_HOME environment variable is not set."
-fi
-
-CLASSWORLDS_LAUNCHER=org.codehaus.plexus.classworlds.launcher.Launcher
-
-# traverses directory structure from process work directory to filesystem root
-# first directory with .mvn subdirectory is considered project base directory
-find_maven_basedir() {
-
-  if [ -z "$1" ]
-  then
-    echo "Path not specified to find_maven_basedir"
-    return 1
-  fi
-
-  basedir="$1"
-  wdir="$1"
-  while [ "$wdir" != '/' ] ; do
-    if [ -d "$wdir"/.mvn ] ; then
-      basedir=$wdir
-      break
-    fi
-    # workaround for JBEAP-8937 (on Solaris 10/Sparc)
-    if [ -d "${wdir}" ]; then
-      wdir=`cd "$wdir/.."; pwd`
-    fi
-    # end of workaround
-  done
-  echo "${basedir}"
-}
-
-# concatenates all lines of a file
-concat_lines() {
-  if [ -f "$1" ]; then
-    echo "$(tr -s '\n' ' ' < "$1")"
-  fi
-}
-
-BASE_DIR=`find_maven_basedir "$(pwd)"`
-if [ -z "$BASE_DIR" ]; then
-  exit 1;
-fi
-
-##########################################################################################
-# Extension to allow automatically downloading the maven-wrapper.jar from Maven-central
-# This allows using the maven wrapper in projects that prohibit checking in binary data.
-##########################################################################################
-if [ -r "$BASE_DIR/.mvn/wrapper/maven-wrapper.jar" ]; then
-    if [ "$MVNW_VERBOSE" = true ]; then
-      echo "Found .mvn/wrapper/maven-wrapper.jar"
-    fi
-else
-    if [ "$MVNW_VERBOSE" = true ]; then
-      echo "Couldn't find .mvn/wrapper/maven-wrapper.jar, downloading it ..."
-    fi
-    if [ -n "$MVNW_REPOURL" ]; then
-      jarUrl="$MVNW_REPOURL/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar"
-    else
-      jarUrl="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar"
-    fi
-    while IFS="=" read key value; do
-      case "$key" in (wrapperUrl) jarUrl="$value"; break ;;
-      esac
-    done < "$BASE_DIR/.mvn/wrapper/maven-wrapper.properties"
-    if [ "$MVNW_VERBOSE" = true ]; then
-      echo "Downloading from: $jarUrl"
-    fi
-    wrapperJarPath="$BASE_DIR/.mvn/wrapper/maven-wrapper.jar"
-    if $cygwin; then
-      wrapperJarPath=`cygpath --path --windows "$wrapperJarPath"`
-    fi
-
-    if command -v wget > /dev/null; then
-        if [ "$MVNW_VERBOSE" = true ]; then
-          echo "Found wget ... using wget"
-        fi
-        if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then
-            wget "$jarUrl" -O "$wrapperJarPath"
-        else
-            wget --http-user=$MVNW_USERNAME --http-password=$MVNW_PASSWORD "$jarUrl" -O "$wrapperJarPath"
-        fi
-    elif command -v curl > /dev/null; then
-        if [ "$MVNW_VERBOSE" = true ]; then
-          echo "Found curl ... using curl"
-        fi
-        if [ -z "$MVNW_USERNAME" ] || [ -z "$MVNW_PASSWORD" ]; then
-            curl -o "$wrapperJarPath" "$jarUrl" -f
-        else
-            curl --user $MVNW_USERNAME:$MVNW_PASSWORD -o "$wrapperJarPath" "$jarUrl" -f
-        fi
-
-    else
-        if [ "$MVNW_VERBOSE" = true ]; then
-          echo "Falling back to using Java to download"
-        fi
-        javaClass="$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.java"
-        # For Cygwin, switch paths to Windows format before running javac
-        if $cygwin; then
-          javaClass=`cygpath --path --windows "$javaClass"`
-        fi
-        if [ -e "$javaClass" ]; then
-            if [ ! -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then
-                if [ "$MVNW_VERBOSE" = true ]; then
-                  echo " - Compiling MavenWrapperDownloader.java ..."
-                fi
-                # Compiling the Java class
-                ("$JAVA_HOME/bin/javac" "$javaClass")
-            fi
-            if [ -e "$BASE_DIR/.mvn/wrapper/MavenWrapperDownloader.class" ]; then
-                # Running the downloader
-                if [ "$MVNW_VERBOSE" = true ]; then
-                  echo " - Running MavenWrapperDownloader.java ..."
-                fi
-                ("$JAVA_HOME/bin/java" -cp .mvn/wrapper MavenWrapperDownloader "$MAVEN_PROJECTBASEDIR")
-            fi
-        fi
-    fi
-fi
-##########################################################################################
-# End of extension
-##########################################################################################
-
-export MAVEN_PROJECTBASEDIR=${MAVEN_BASEDIR:-"$BASE_DIR"}
-if [ "$MVNW_VERBOSE" = true ]; then
-  echo $MAVEN_PROJECTBASEDIR
-fi
-MAVEN_OPTS="$(concat_lines "$MAVEN_PROJECTBASEDIR/.mvn/jvm.config") $MAVEN_OPTS"
-
-# For Cygwin, switch paths to Windows format before running java
-if $cygwin; then
-  [ -n "$M2_HOME" ] &&
-    M2_HOME=`cygpath --path --windows "$M2_HOME"`
-  [ -n "$JAVA_HOME" ] &&
-    JAVA_HOME=`cygpath --path --windows "$JAVA_HOME"`
-  [ -n "$CLASSPATH" ] &&
-    CLASSPATH=`cygpath --path --windows "$CLASSPATH"`
-  [ -n "$MAVEN_PROJECTBASEDIR" ] &&
-    MAVEN_PROJECTBASEDIR=`cygpath --path --windows "$MAVEN_PROJECTBASEDIR"`
-fi
-
-# Provide a "standardized" way to retrieve the CLI args that will
-# work with both Windows and non-Windows executions.
-MAVEN_CMD_LINE_ARGS="$MAVEN_CONFIG $@"
-export MAVEN_CMD_LINE_ARGS
-
-WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
-
-exec "$JAVACMD" \
-  $MAVEN_OPTS \
-  -classpath "$MAVEN_PROJECTBASEDIR/.mvn/wrapper/maven-wrapper.jar" \
-  "-Dmaven.home=${M2_HOME}" "-Dmaven.multiModuleProjectDirectory=${MAVEN_PROJECTBASEDIR}" \
-  ${WRAPPER_LAUNCHER} $MAVEN_CONFIG "$@"

mvnw.cmd

@@ -1,182 +0,0 @@
-@REM ----------------------------------------------------------------------------
-@REM Licensed to the Apache Software Foundation (ASF) under one
-@REM or more contributor license agreements.  See the NOTICE file
-@REM distributed with this work for additional information
-@REM regarding copyright ownership.  The ASF licenses this file
-@REM to you under the Apache License, Version 2.0 (the
-@REM "License"); you may not use this file except in compliance
-@REM with the License.  You may obtain a copy of the License at
-@REM
-@REM    http://www.apache.org/licenses/LICENSE-2.0
-@REM
-@REM Unless required by applicable law or agreed to in writing,
-@REM software distributed under the License is distributed on an
-@REM "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-@REM KIND, either express or implied.  See the License for the
-@REM specific language governing permissions and limitations
-@REM under the License.
-@REM ----------------------------------------------------------------------------
-
-@REM ----------------------------------------------------------------------------
-@REM Maven Start Up Batch script
-@REM
-@REM Required ENV vars:
-@REM JAVA_HOME - location of a JDK home dir
-@REM
-@REM Optional ENV vars
-@REM M2_HOME - location of maven2's installed home dir
-@REM MAVEN_BATCH_ECHO - set to 'on' to enable the echoing of the batch commands
-@REM MAVEN_BATCH_PAUSE - set to 'on' to wait for a keystroke before ending
-@REM MAVEN_OPTS - parameters passed to the Java VM when running Maven
-@REM     e.g. to debug Maven itself, use
-@REM set MAVEN_OPTS=-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
-@REM MAVEN_SKIP_RC - flag to disable loading of mavenrc files
-@REM ----------------------------------------------------------------------------
-
-@REM Begin all REM lines with '@' in case MAVEN_BATCH_ECHO is 'on'
-@echo off
-@REM set title of command window
-title %0
-@REM enable echoing by setting MAVEN_BATCH_ECHO to 'on'
-@if "%MAVEN_BATCH_ECHO%" == "on"  echo %MAVEN_BATCH_ECHO%
-
-@REM set %HOME% to equivalent of $HOME
-if "%HOME%" == "" (set "HOME=%HOMEDRIVE%%HOMEPATH%")
-
-@REM Execute a user defined script before this one
-if not "%MAVEN_SKIP_RC%" == "" goto skipRcPre
-@REM check for pre script, once with legacy .bat ending and once with .cmd ending
-if exist "%HOME%\mavenrc_pre.bat" call "%HOME%\mavenrc_pre.bat"
-if exist "%HOME%\mavenrc_pre.cmd" call "%HOME%\mavenrc_pre.cmd"
-:skipRcPre
-
-@setlocal
-
-set ERROR_CODE=0
-
-@REM To isolate internal variables from possible post scripts, we use another setlocal
-@setlocal
-
-@REM ==== START VALIDATION ====
-if not "%JAVA_HOME%" == "" goto OkJHome
-
-echo.
-echo Error: JAVA_HOME not found in your environment. >&2
-echo Please set the JAVA_HOME variable in your environment to match the >&2
-echo location of your Java installation. >&2
-echo.
-goto error
-
-:OkJHome
-if exist "%JAVA_HOME%\bin\java.exe" goto init
-
-echo.
-echo Error: JAVA_HOME is set to an invalid directory. >&2
-echo JAVA_HOME = "%JAVA_HOME%" >&2
-echo Please set the JAVA_HOME variable in your environment to match the >&2
-echo location of your Java installation. >&2
-echo.
-goto error
-
-@REM ==== END VALIDATION ====
-
-:init
-
-@REM Find the project base dir, i.e. the directory that contains the folder ".mvn".
-@REM Fallback to current working directory if not found.
-
-set MAVEN_PROJECTBASEDIR=%MAVEN_BASEDIR%
-IF NOT "%MAVEN_PROJECTBASEDIR%"=="" goto endDetectBaseDir
-
-set EXEC_DIR=%CD%
-set WDIR=%EXEC_DIR%
-:findBaseDir
-IF EXIST "%WDIR%"\.mvn goto baseDirFound
-cd ..
-IF "%WDIR%"=="%CD%" goto baseDirNotFound
-set WDIR=%CD%
-goto findBaseDir
-
-:baseDirFound
-set MAVEN_PROJECTBASEDIR=%WDIR%
-cd "%EXEC_DIR%"
-goto endDetectBaseDir
-
-:baseDirNotFound
-set MAVEN_PROJECTBASEDIR=%EXEC_DIR%
-cd "%EXEC_DIR%"
-
-:endDetectBaseDir
-
-IF NOT EXIST "%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config" goto endReadAdditionalConfig
-
-@setlocal EnableExtensions EnableDelayedExpansion
-for /F "usebackq delims=" %%a in ("%MAVEN_PROJECTBASEDIR%\.mvn\jvm.config") do set JVM_CONFIG_MAVEN_PROPS=!JVM_CONFIG_MAVEN_PROPS! %%a
-@endlocal & set JVM_CONFIG_MAVEN_PROPS=%JVM_CONFIG_MAVEN_PROPS%
-
-:endReadAdditionalConfig
-
-SET MAVEN_JAVA_EXE="%JAVA_HOME%\bin\java.exe"
-set WRAPPER_JAR="%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.jar"
-set WRAPPER_LAUNCHER=org.apache.maven.wrapper.MavenWrapperMain
-
-set DOWNLOAD_URL="https://repo.maven.apache.org/maven2/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar"
-
-FOR /F "tokens=1,2 delims==" %%A IN ("%MAVEN_PROJECTBASEDIR%\.mvn\wrapper\maven-wrapper.properties") DO (
-    IF "%%A"=="wrapperUrl" SET DOWNLOAD_URL=%%B
-)
-
-@REM Extension to allow automatically downloading the maven-wrapper.jar from Maven-central
-@REM This allows using the maven wrapper in projects that prohibit checking in binary data.
-if exist %WRAPPER_JAR% (
-    if "%MVNW_VERBOSE%" == "true" (
-        echo Found %WRAPPER_JAR%
-    )
-) else (
-    if not "%MVNW_REPOURL%" == "" (
-        SET DOWNLOAD_URL="%MVNW_REPOURL%/io/takari/maven-wrapper/0.5.6/maven-wrapper-0.5.6.jar"
-    )
-    if "%MVNW_VERBOSE%" == "true" (
-        echo Couldn't find %WRAPPER_JAR%, downloading it ...
-        echo Downloading from: %DOWNLOAD_URL%
-    )
-
-    powershell -Command "&{"^
-		"$webclient = new-object System.Net.WebClient;"^
-		"if (-not ([string]::IsNullOrEmpty('%MVNW_USERNAME%') -and [string]::IsNullOrEmpty('%MVNW_PASSWORD%'))) {"^
-		"$webclient.Credentials = new-object System.Net.NetworkCredential('%MVNW_USERNAME%', '%MVNW_PASSWORD%');"^
-		"}"^
-		"[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; $webclient.DownloadFile('%DOWNLOAD_URL%', '%WRAPPER_JAR%')"^
-		"}"
-    if "%MVNW_VERBOSE%" == "true" (
-        echo Finished downloading %WRAPPER_JAR%
-    )
-)
-@REM End of extension
-
-@REM Provide a "standardized" way to retrieve the CLI args that will
-@REM work with both Windows and non-Windows executions.
-set MAVEN_CMD_LINE_ARGS=%*
-
-%MAVEN_JAVA_EXE% %JVM_CONFIG_MAVEN_PROPS% %MAVEN_OPTS% %MAVEN_DEBUG_OPTS% -classpath %WRAPPER_JAR% "-Dmaven.multiModuleProjectDirectory=%MAVEN_PROJECTBASEDIR%" %WRAPPER_LAUNCHER% %MAVEN_CONFIG% %*
-if ERRORLEVEL 1 goto error
-goto end
-
-:error
-set ERROR_CODE=1
-
-:end
-@endlocal & set ERROR_CODE=%ERROR_CODE%
-
-if not "%MAVEN_SKIP_RC%" == "" goto skipRcPost
-@REM check for post script, once with legacy .bat ending and once with .cmd ending
-if exist "%HOME%\mavenrc_post.bat" call "%HOME%\mavenrc_post.bat"
-if exist "%HOME%\mavenrc_post.cmd" call "%HOME%\mavenrc_post.cmd"
-:skipRcPost
-
-@REM pause the script if MAVEN_BATCH_PAUSE is set to 'on'
-if "%MAVEN_BATCH_PAUSE%" == "on" pause
-
-if "%MAVEN_TERMINATE_CMD%" == "on" exit %ERROR_CODE%
-
-exit /B %ERROR_CODE%

note.txt

@@ -1,74 +0,0 @@
-直链缓存设计
-     每个网盘对应的标准分享URL如下
-
-蓝奏云 (lz)          https://lanzoux.com/{shareKey}
-蓝奏云优享 (iz)       https://www.ilanzou.com/s/{shareKey}
-奶牛快传 (cow)        https://cowtransfer.com/s/{shareKey}
-移动云云空间 (ec)     https://www.ecpan.cn/web/#/yunpanProxy?path=%2F%23%2Fdrive%2Foutside&data={shareKey}&isShare=1
-小飞机网盘 (fj)       https://share.feijipan.com/s/{shareKey}
-亿方云 (fc)           https://v2.fangcloud.com/sharing/{shareKey}
-123云盘 (ye)         https://www.123pan.com/s/{shareKey}.html
-文叔叔 (ws)          https://f.ws59.cn/f/{shareKey}
-联想乐云 (le)         https://lecloud.lenovo.com/share/{shareKey}
-
-私有化网盘需要自己的域名也就是origin地址.
-Cloudreve自建网盘 (ce) {origin}/s/{shareKey}
-
-分享URL -> 类型+key
-类型+key -> 标准分享URL
-
-缓存key -> 下载URL
-分享链接 -> add 网盘类型 pwd origin(私有化) -> 直链
-
-开源版 TODO
-1. 缓存优化, 配置自动重载
-2. 缓存删除接口(后台功能)
-3. JS脚本引擎 自定义解析
-
-
-
-专属版 功能设计
-1. 支持绑定域名, 后台管理-账号管理, token管理, 账号解析次数限制
-2. 流量统计, 文件分享信息, 目录解析, 文件云下载
-3. IP代理池
-
-网页跳转 防盗链
-可禁用parser接口
-
-标志短链 鉴权后 生成混淆链接
-
-
-短链算法:
-1. 基于Hash映射  hash(type:key:pwd) = h/xxxxx
-
-鉴权实现:
-auth-jdbc
-
-// 基于标准SQL语法
-
-支持H2, MySQL
-
-用户:
-jwt鉴权用户
-
-角色:
-超级管理员
-注册用户
-
-定义操作(权限):
-用户的创建/删除/查询/修改, 生成短链/删除短链/修改解析次数和有效期/查询短链信息(
-文件信息: 文件/文件夹, 文件数量, 文件大小, 文件类型; 链接信息: 解析次数, 缓存次数等)
-
-微服务设计:
-TODO
-
-后台管理:
-  菜单:
-    网盘管理: token配置, 启用/禁用
-    短链管理: 短链列表, 新增, 删除
-    解析统计: 下载次数统计, 下载流量统计, 详细解析列表
-    状态监视: 服务请求并发数; 来源IP列表: 拉黑, 限制次数; Nginx
-    系统配置: 管理员账户, 系统参数: 域名配置, 预览URL,
-
-
-

package.json

@@ -1,5 +0,0 @@
-{
-  "dependencies": {
-    "mvn": "^3.5.0"
-  }
-}

parser/README.md

@@ -1,108 +0,0 @@
-# parser
-
-NFD 解析器模块：聚合各类网盘/分享页解析，统一输出文件列表与下载信息，供上层下载器使用。
-
-- 语言：Java 17
-- 构建：Maven
-- 模块版本：10.2.5
-
-## 依赖（Maven Central）
-```xml
-<dependency>
-  <groupId>cn.qaiu</groupId>
-  <artifactId>parser</artifactId>
-  <version>10.2.5</version>
-</dependency>
-```
-- Gradle Groovy DSL：
-```groovy
-dependencies {
-  implementation 'cn.qaiu:parser:10.2.5'
-}
-```
-- Gradle Kotlin DSL：
-```kotlin
-dependencies {
-  implementation("cn.qaiu:parser:10.2.5")
-}
-```
-
-## 核心 API 速览
-- WebClientVertxInit：注入/获取 Vert.x 实例（内部 HTTP 客户端依赖）。
-- ParserCreate：从分享链接或类型构建解析器；生成短链 path。
-- IPanTool：统一解析接口（parse、parseFileList、parseById）。
-- **CustomParserRegistry**：自定义解析器注册中心（支持扩展）。
-- **CustomParserConfig**：自定义解析器配置类（支持扩展）。
-
-## 使用示例（极简）
-```java
-List<FileInfo> list = ParserCreate
-  .fromShareUrl("https://share.feijipan.com/s/3pMsofZd")
-  .createTool()
-  .parseFileList()
-  .toCompletionStage().toCompletableFuture().join();
-```
-完整示例与调试脚本见 parser/doc/README.md。
-
-## 快速开始
-- 环境：JDK >= 17，Maven >= 3.9
-- 构建/安装：
-```
-mvn -pl parser -am clean package -DskipTests
-mvn -pl parser -am install
-```
-- 测试：
-```
-mvn -pl parser test
-```
-
-## 自定义解析器扩展
-本模块支持用户自定义解析器扩展。通过简单的配置和注册，你可以添加自己的网盘解析实现：
-
-```java
-// 1. 继承 PanBase 抽象类（推荐）
-public class MyPanTool extends PanBase {
-    public MyPanTool(ShareLinkInfo info) { 
-        super(info);
-    }
-    @Override
-    public Future<String> parse() { 
-        // 使用 PanBase 提供的 HTTP 客户端
-        client.getAbs("https://api.example.com")
-            .send()
-            .onSuccess(res -> complete(asJson(res).getString("url")))
-            .onFailure(handleFail("请求失败"));
-        return future();
-    }
-}
-
-// 2. 注册到系统
-CustomParserConfig config = CustomParserConfig.builder()
-    .type("mypan")
-    .displayName("我的网盘")
-    .toolClass(MyPanTool.class)
-    .build();
-CustomParserRegistry.register(config);
-
-// 3. 使用自定义解析器（仅支持 fromType 方式）
-IPanTool tool = ParserCreate.fromType("mypan")
-    .shareKey("abc123")
-    .createTool();
-String url = tool.parseSync();
-```
-
-**详细文档：** [自定义解析器扩展指南](doc/CUSTOM_PARSER_GUIDE.md)
-
-## 文档
-- parser/doc/README.md：解析约定、示例、IDEA `.http` 调试
-- **parser/doc/JAVASCRIPT_PARSER_GUIDE.md：JavaScript解析器开发完整指南** - 使用JavaScript编写自定义解析器
-- **parser/doc/CUSTOM_PARSER_GUIDE.md：自定义解析器扩展完整指南** - Java自定义解析器扩展
-- **parser/doc/CUSTOM_PARSER_QUICKSTART.md：自定义解析器快速开始** - 快速上手指南
-
-## 目录
-- src/main/java/cn/qaiu/entity：通用实体（如 FileInfo）
-- src/main/java/cn/qaiu/parser：解析框架 & 各站点实现（impl）
-- src/test/java：单测与示例
-
-## 许可证
-MIT License

parser/doc/API_USAGE.md

@@ -1,396 +0,0 @@
-# 自定义解析器API使用指南
-
-## 📡 API端点
-
-当你在演练场发布自定义解析器后，可以通过以下API端点使用：
-
----
-
-## 1️⃣ 302重定向（直接下载）
-
-**端点**: `/parser`
-
-**方法**: `GET`
-
-**描述**: 返回302重定向到实际下载地址，适合浏览器直接访问下载
-
-### 请求参数
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| url | string | ✅ 是 | 分享链接（需URL编码） |
-| pwd | string | ❌ 否 | 分享密码 |
-| auth | string | ❌ 否 | 认证参数（AES加密后的JSON，用于需要登录的网盘） |
-
-### 认证参数说明（v0.2.1+）
-
-部分网盘（如夸克QK、UC网盘）需要登录后的 Cookie 才能解析。`auth` 参数用于传递认证信息：
-
-**加密方式**：
-- 算法：AES/ECB/PKCS5Padding
-- 密钥：`nfd_auth_key2026`（16字节）
-- 流程：JSON → AES加密 → Base64 → URL编码
-
-**JSON 结构**：
-```json
-{
-  "authType": "cookie",        // 认证类型: cookie/accesstoken/authorization
-  "token": "your_cookie_here"  // Cookie 或 Token 内容
-}
-```
-
-**网盘认证要求**：
-| 网盘 | 认证要求 |
-|------|---------|
-| 夸克网盘(QK) | **必须** |
-| UC网盘(UC) | **必须** |
-| 小飞机网盘(FJ) | 大文件需要 |
-| 蓝奏优享(IZ) | 大文件需要 |
-
-### 请求示例
-
-```bash
-# 基本请求
-GET http://localhost:6400/parser?url=https://lanzoui.com/i7Aq12ab3cd
-
-# 带密码
-GET http://localhost:6400/parser?url=https://lanzoui.com/i7Aq12ab3cd&pwd=1234
-
-# curl命令
-curl -L "http://localhost:6400/parser?url=https://lanzoui.com/i7Aq12ab3cd"
-```
-
-### 响应
-
-```http
-HTTP/1.1 302 Found
-Location: https://download-server.com/file/xxx
-```
-
-浏览器会自动跳转到下载地址。
-
----
-
-## 2️⃣ JSON响应（获取解析结果）
-
-**端点**: `/json/parser`
-
-**方法**: `GET`
-
-**描述**: 返回JSON格式的解析结果，包含下载链接等详细信息
-
-### 请求参数
-
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| url | string | ✅ 是 | 分享链接（需URL编码） |
-| pwd | string | ❌ 否 | 分享密码 |
-
-### 请求示例
-
-```bash
-# 基本请求
-GET http://localhost:6400/json/parser?url=https://lanzoui.com/i7Aq12ab3cd
-
-# 带密码
-GET http://localhost:6400/json/parser?url=https://lanzoui.com/i7Aq12ab3cd&pwd=1234
-
-# curl命令
-curl "http://localhost:6400/json/parser?url=https://lanzoui.com/i7Aq12ab3cd"
-```
-
-### 响应格式
-
-```json
-{
-  "code": 200,
-  "msg": "success",
-  "data": {
-    "url": "https://download-server.com/file/xxx",
-    "fileName": "example.zip",
-    "fileSize": "10MB",
-    "parseTime": 1234
-  }
-}
-```
-
----
-
-## 🔧 使用场景
-
-### 场景1: 浏览器直接下载
-
-用户点击链接直接下载：
-
-```html
-<a href="http://localhost:6400/parser?url=https://lanzoui.com/i7Aq12ab3cd">
-  点击下载
-</a>
-```
-
-### 场景2: 获取下载信息
-
-JavaScript获取下载链接：
-
-```javascript
-fetch('http://localhost:6400/json/parser?url=https://lanzoui.com/i7Aq12ab3cd')
-  .then(res => res.json())
-  .then(data => {
-    console.log('下载链接:', data.data.url);
-    console.log('文件名:', data.data.fileName);
-  });
-```
-
-### 场景3: 命令行下载
-
-```bash
-# 方式1: 直接下载
-curl -L -O "http://localhost:6400/parser?url=https://lanzoui.com/i7Aq12ab3cd"
-
-# 方式2: 先获取链接再下载
-DOWNLOAD_URL=$(curl -s "http://localhost:6400/json/parser?url=https://lanzoui.com/i7Aq12ab3cd" | jq -r '.data.url')
-curl -L -O "$DOWNLOAD_URL"
-```
-
-### 场景4: Python脚本
-
-```python
-import requests
-
-# 获取解析结果
-response = requests.get(
-    'http://localhost:6400/json/parser',
-    params={
-        'url': 'https://lanzoui.com/i7Aq12ab3cd',
-        'pwd': '1234'
-    }
-)
-
-result = response.json()
-if result['code'] == 200:
-    download_url = result['data']['url']
-    print(f'下载链接: {download_url}')
-    
-    # 下载文件
-    file_response = requests.get(download_url)
-    with open('download.file', 'wb') as f:
-        f.write(file_response.content)
-```
-
----
-
-## 🎯 解析器匹配规则
-
-系统会根据分享链接的URL自动选择合适的解析器：
-
-1. **优先匹配自定义解析器**
-   - 检查演练场发布的解析器
-   - 使用 `@match` 正则表达式匹配
-
-2. **内置解析器**
-   - 如果没有匹配的自定义解析器
-   - 使用系统内置的解析器
-
-### 示例
-
-假设你发布了蓝奏云解析器：
-
-```javascript
-// @match https?://lanzou[a-z]{1,2}\.com/(?<KEY>[a-zA-Z0-9]+)
-```
-
-当请求以下链接时会使用你的解析器：
-- ✅ `https://lanzoui.com/i7Aq12ab3cd`
-- ✅ `https://lanzoux.com/i7Aq12ab3cd`
-- ✅ `http://lanzouy.com/i7Aq12ab3cd`
-
----
-
-## ⚙️ 高级用法
-
-### 1. 指定解析器类型
-
-```bash
-# 通过type参数指定解析器
-GET http://localhost:6400/parser?url=https://example.com/s/abc&type=custom_parser
-```
-
-### 2. 获取文件列表
-
-对于支持文件夹的网盘：
-
-```bash
-# 获取文件列表
-GET http://localhost:6400/json/parser/list?url=https://example.com/s/abc
-
-# 按文件ID获取下载链接
-GET http://localhost:6400/json/parser/file?url=https://example.com/s/abc&fileId=123
-```
-
-### 3. 批量解析
-
-```javascript
-const urls = [
-  'https://lanzoui.com/i7Aq12ab3cd',
-  'https://lanzoui.com/i8Bq34ef5gh'
-];
-
-const results = await Promise.all(
-  urls.map(url => 
-    fetch(`http://localhost:6400/json/parser?url=${encodeURIComponent(url)}`)
-      .then(res => res.json())
-  )
-);
-```
-
----
-
-## 🔒 安全注意事项
-
-### 1. SSRF防护
-
-系统已实施SSRF防护，以下请求会被拦截：
-
-❌ 内网地址：
-```bash
-# 这些会被拦截
-http://127.0.0.1:8080/admin
-http://192.168.1.1/config
-http://169.254.169.254/latest/meta-data/
-```
-
-✅ 公网地址：
-```bash
-# 这些是允许的
-https://lanzoui.com/xxx
-https://pan.baidu.com/s/xxx
-```
-
-### 2. 速率限制
-
-建议添加速率限制，避免滥用：
-
-```javascript
-// 使用节流
-import { throttle } from 'lodash';
-
-const parseUrl = throttle((url) => {
-  return fetch(`/json/parser?url=${encodeURIComponent(url)}`);
-}, 1000); // 每秒最多1次请求
-```
-
----
-
-## 📊 错误处理
-
-### 常见错误码
-
-| 错误码 | 说明 | 解决方法 |
-|--------|------|----------|
-| 400 | 参数错误 | 检查url参数是否正确编码 |
-| 404 | 未找到解析器 | 确认链接格式是否匹配解析器规则 |
-| 500 | 解析失败 | 查看日志，可能是解析器代码错误 |
-| 503 | 服务不可用 | 稍后重试 |
-
-### 错误响应示例
-
-```json
-{
-  "code": 500,
-  "msg": "解析失败: 无法提取下载参数",
-  "data": null
-}
-```
-
-### 错误处理示例
-
-```javascript
-fetch('/json/parser?url=' + encodeURIComponent(shareUrl))
-  .then(res => res.json())
-  .then(data => {
-    if (data.code === 200) {
-      console.log('成功:', data.data.url);
-    } else {
-      console.error('失败:', data.msg);
-    }
-  })
-  .catch(error => {
-    console.error('请求失败:', error.message);
-  });
-```
-
----
-
-## 💡 最佳实践
-
-### 1. URL编码
-
-始终对分享链接进行URL编码：
-
-```javascript
-// ✅ 正确
-const encodedUrl = encodeURIComponent('https://lanzoui.com/i7Aq12ab3cd');
-fetch(`/json/parser?url=${encodedUrl}`);
-
-// ❌ 错误
-fetch('/json/parser?url=https://lanzoui.com/i7Aq12ab3cd');
-```
-
-### 2. 错误重试
-
-实现指数退避重试：
-
-```javascript
-async function parseWithRetry(url, maxRetries = 3) {
-  for (let i = 0; i < maxRetries; i++) {
-    try {
-      const response = await fetch(`/json/parser?url=${encodeURIComponent(url)}`);
-      const data = await response.json();
-      
-      if (data.code === 200) {
-        return data;
-      }
-      
-      // 如果是服务器错误，重试
-      if (data.code >= 500 && i < maxRetries - 1) {
-        await new Promise(resolve => setTimeout(resolve, Math.pow(2, i) * 1000));
-        continue;
-      }
-      
-      throw new Error(data.msg);
-    } catch (error) {
-      if (i === maxRetries - 1) throw error;
-      await new Promise(resolve => setTimeout(resolve, Math.pow(2, i) * 1000));
-    }
-  }
-}
-```
-
-### 3. 超时处理
-
-设置请求超时：
-
-```javascript
-const controller = new AbortController();
-const timeout = setTimeout(() => controller.abort(), 30000); // 30秒超时
-
-fetch('/json/parser?url=' + encodeURIComponent(url), {
-  signal: controller.signal
-})
-  .then(res => res.json())
-  .finally(() => clearTimeout(timeout));
-```
-
----
-
-## 📚 更多资源
-
-- **演练场文档**: `/parser/doc/JAVASCRIPT_PARSER_GUIDE.md`
-- **自定义解析器**: `/parser/doc/CUSTOM_PARSER_GUIDE.md`
-- **安全指南**: `/parser/doc/security/`
-
----
-
-**最后更新**: 2025-11-29  
-**版本**: v1.0
-

parser/doc/CHANGELOG_CUSTOM_PARSER.md

@@ -1,257 +0,0 @@
-# 自定义解析器扩展功能更新日志
-
-## 版本：10.1.17+
-**更新日期：** 2024-10-17
-
----
-
-## 🎉 新增功能：自定义解析器扩展
-
-### 概述
-用户在依赖本项目 Maven 坐标后，可以自己实现解析器接口，并通过注册机制将自定义解析器集成到系统中。
-
-### 核心变更
-
-#### 1. 新增类
-
-##### CustomParserConfig.java
-- **位置：** `cn.qaiu.parser.custom.CustomParserConfig`
-- **功能：** 自定义解析器配置类
-- **主要字段：**
-  - `type`: 解析器类型标识（唯一，必填）
-  - `displayName`: 显示名称（必填）
-  - `toolClass`: 解析工具类（必填，必须实现IPanTool接口）
-  - `standardUrlTemplate`: 标准URL模板（可选）
-  - `panDomain`: 网盘域名（可选）
-- **使用方式：** 通过 Builder 模式构建
-- **验证机制：**
-  - 自动验证 toolClass 是否实现 IPanTool 接口
-  - 自动验证 toolClass 是否有 ShareLinkInfo 单参构造器
-  - 验证必填字段是否为空
-
-##### CustomParserRegistry.java
-- **位置：** `cn.qaiu.parser.custom.CustomParserRegistry`
-- **功能：** 自定义解析器注册中心
-- **主要方法：**
-  - `register(CustomParserConfig)`: 注册解析器
-  - `unregister(String type)`: 注销解析器
-  - `get(String type)`: 获取解析器配置
-  - `contains(String type)`: 检查是否已注册
-  - `clear()`: 清空所有注册
-  - `size()`: 获取注册数量
-  - `getAll()`: 获取所有配置
-- **特性：**
-  - 线程安全（使用 ConcurrentHashMap）
-  - 自动检查类型冲突（与内置解析器）
-  - 防止重复注册
-
-#### 2. 修改的类
-
-##### ParserCreate.java
-- **新增字段：**
-  - `customParserConfig`: 自定义解析器配置
-  - `isCustomParser`: 是否为自定义解析器标识
-  
-- **新增构造器：**
-  - `ParserCreate(CustomParserConfig, ShareLinkInfo)`: 自定义解析器专用构造器
-
-- **修改的方法：**
-  - `fromType(String type)`: 优先查找自定义解析器，再查找内置解析器
-  - `createTool()`: 支持创建自定义解析器工具实例
-  - `normalizeShareLink()`: 自定义解析器抛出不支持异常
-  - `shareKey(String)`: 支持自定义解析器的 shareKey 设置
-  - `getStandardUrlTemplate()`: 支持返回自定义解析器的模板
-  - `genPathSuffix()`: 支持生成自定义解析器的路径
-
-- **新增方法：**
-  - `isCustomParser()`: 判断是否为自定义解析器
-  - `getCustomParserConfig()`: 获取自定义解析器配置
-  - `getPanDomainTemplate()`: 获取内置解析器模板
-
-#### 3. 测试类
-
-##### CustomParserTest.java
-- **位置：** `cn.qaiu.parser.custom.CustomParserTest`
-- **测试覆盖：**
-  - ✅ 注册自定义解析器
-  - ✅ 重复注册检测
-  - ✅ 与内置类型冲突检测
-  - ✅ 注销解析器
-  - ✅ 创建工具实例
-  - ✅ fromShareUrl 不支持自定义解析器
-  - ✅ normalizeShareLink 不支持
-  - ✅ 生成路径后缀
-  - ✅ 配置验证
-  - ✅ 工具类验证
-
-#### 4. 文档
-
-##### CUSTOM_PARSER_GUIDE.md
-- **位置：** `parser/doc/CUSTOM_PARSER_GUIDE.md`
-- **内容：** 完整的自定义解析器扩展指南
-  - 使用步骤
-  - API 参考
-  - 完整示例
-  - 常见问题
-
-##### CUSTOM_PARSER_QUICKSTART.md
-- **位置：** `parser/doc/CUSTOM_PARSER_QUICKSTART.md`
-- **内容：** 5分钟快速开始指南
-  - 快速集成步骤
-  - 可运行示例
-  - Spring Boot 集成
-  - 常见问题速查
-
-##### README.md（更新）
-- **位置：** `parser/README.md`
-- **更新内容：**
-  - 新增自定义解析器扩展章节
-  - 添加快速示例
-  - 更新核心 API 列表
-  - 添加文档链接
-
----
-
-## 🔒 设计约束
-
-### 1. 创建限制
-**自定义解析器只能通过 `fromType` 方法创建**
-
-```java
-// ✅ 支持
-ParserCreate.fromType("mypan")
-    .shareKey("abc123")
-    .createTool();
-
-// ❌ 不支持
-ParserCreate.fromShareUrl("https://mypan.com/s/abc123");
-```
-
-**原因：** 自定义解析器没有正则表达式来匹配分享链接
-
-### 2. 方法限制
-自定义解析器不支持 `normalizeShareLink()` 方法
-
-```java
-ParserCreate parser = ParserCreate.fromType("mypan");
-parser.normalizeShareLink();  // ❌ 抛出 UnsupportedOperationException
-```
-
-### 3. 类型唯一性
-- 自定义解析器类型不能与内置类型冲突
-- 不能重复注册相同类型
-
-### 4. 构造器要求
-解析器工具类必须提供 `ShareLinkInfo` 单参构造器：
-
-```java
-public class MyTool implements IPanTool {
-    public MyTool(ShareLinkInfo info) {  // 必须
-        // ...
-    }
-}
-```
-
----
-
-## 💡 使用场景
-
-### 1. 企业内部网盘
-为企业内部网盘系统添加解析支持
-
-### 2. 私有部署网盘
-支持私有部署的网盘服务（如 Cloudreve、可道云的自定义实例）
-
-### 3. 新兴网盘服务
-快速支持新出现的网盘服务，无需等待官方更新
-
-### 4. 临时解析方案
-在等待官方支持期间的临时解决方案
-
----
-
-## 📦 影响范围
-
-### 兼容性
-- ✅ **向后兼容**：不影响现有功能
-- ✅ **可选功能**：不使用则无影响
-- ✅ **独立模块**：与内置解析器解耦
-
-### 依赖关系
-- 无新增外部依赖
-- 使用已有的 `ShareLinkInfo`、`IPanTool` 等接口
-
-### 性能影响
-- 注册查找：O(1) 时间复杂度（HashMap）
-- 内存占用：每个注册器约 1KB
-- 线程安全：使用 ConcurrentHashMap，无锁竞争
-
----
-
-## 🚀 升级指南
-
-### 现有用户
-无需任何改动，所有现有功能保持不变。
-
-### 新用户
-参考文档快速集成：
-1. [快速开始](doc/CUSTOM_PARSER_QUICKSTART.md)
-2. [完整指南](doc/CUSTOM_PARSER_GUIDE.md)
-
----
-
-## 📝 示例代码
-
-### 最小示例（3步）
-
-```java
-// 1. 实现接口
-class MyTool implements IPanTool {
-    public MyTool(ShareLinkInfo info) {}
-    public Future<String> parse() { /* ... */ }
-}
-
-// 2. 注册
-CustomParserRegistry.register(
-    CustomParserConfig.builder()
-        .type("mypan")
-        .displayName("我的网盘")
-        .toolClass(MyTool.class)
-        .build()
-);
-
-// 3. 使用
-IPanTool tool = ParserCreate.fromType("mypan")
-    .shareKey("abc")
-    .createTool();
-String url = tool.parseSync();
-```
-
----
-
-## 🎯 下一步计划
-
-### 潜在增强
-- [ ] 支持解析器优先级
-- [ ] 支持解析器热更新
-- [ ] 添加解析器性能监控
-- [ ] 提供解析器开发脚手架
-
-### 社区贡献
-欢迎提交优秀的自定义解析器实现，我们将评估后合并到内置解析器中。
-
----
-
-## 🤝 贡献者
-- [@qaiu](https://github.com/qaiu) - 设计与实现
-
-## 📄 许可
-MIT License
-
----
-
-**完整文档：**
-- [自定义解析器扩展指南](doc/CUSTOM_PARSER_GUIDE.md)
-- [快速开始指南](doc/CUSTOM_PARSER_QUICKSTART.md)
-- [测试用例](src/test/java/cn/qaiu/parser/CustomParserTest.java)
-

parser/doc/CLIENT_LINK_GENERATOR_GUIDE.md

@@ -1,316 +0,0 @@
-# 客户端下载链接生成器使用指南
-
-## 概述
-
-客户端下载链接生成器是 parser 模块的新功能，用于将解析得到的直链转换为各种下载客户端可识别的格式，包括 curl、wget、aria2、IDM、迅雷、比特彗星、Motrix、FDM 等主流下载工具。
-
-## 核心特性
-
-- **多客户端支持**：支持 8 种主流下载客户端格式
-- **防盗链处理**：自动处理请求头、Referer 等防盗链参数
-- **可扩展设计**：支持注册自定义生成器
-- **元数据存储**：通过 `ShareLinkInfo.otherParam` 存储下载元数据
-- **线程安全**：工厂类使用 ConcurrentHashMap 保证线程安全
-
-## 支持的客户端类型
-
-| 客户端类型 | 代码 | 说明 | 输出格式 |
-|-----------|------|------|----------|
-| Aria2 | `ARIA2` | 命令行/RPC | aria2c 命令 |
-| Motrix | `MOTRIX` | 跨平台下载工具 | JSON 格式 |
-| 比特彗星 | `BITCOMET` | BT 下载工具 | bitcomet:// 协议链接 |
-| 迅雷 | `THUNDER` | 国内主流下载工具 | thunder:// 协议链接 |
-| wget | `WGET` | 命令行工具 | wget 命令 |
-| cURL | `CURL` | 命令行工具 | curl 命令 |
-| IDM | `IDM` | Windows 下载管理器 | idm:// 协议链接 |
-| FDM | `FDM` | Free Download Manager | 文本格式 |
-| PowerShell | `POWERSHELL` | Windows PowerShell | PowerShell 命令 |
-
-## 快速开始
-
-### 1. 基本使用
-
-```java
-// 解析分享链接
-IPanTool tool = ParserCreate.fromShareUrl("https://example.com/share/abc123")
-    .createTool();
-String directLink = tool.parseSync();
-
-// 获取 ShareLinkInfo
-ShareLinkInfo info = tool.getShareLinkInfo();
-
-// 生成所有类型的客户端链接
-Map<ClientLinkType, String> clientLinks = ClientLinkGeneratorFactory.generateAll(info);
-
-// 使用生成的链接
-String curlCommand = clientLinks.get(ClientLinkType.CURL);
-String thunderLink = clientLinks.get(ClientLinkType.THUNDER);
-```
-
-### 2. 使用新的便捷方法（推荐）
-
-```java
-// 解析分享链接并自动生成客户端链接
-IPanTool tool = ParserCreate.fromShareUrl("https://example.com/share/abc123")
-    .createTool();
-
-// 一步完成解析和客户端链接生成
-Map<ClientLinkType, String> clientLinks = tool.parseWithClientLinksSync();
-
-// 使用生成的链接
-String curlCommand = clientLinks.get(ClientLinkType.CURL);
-String thunderLink = clientLinks.get(ClientLinkType.THUNDER);
-```
-
-### 3. 异步方式
-
-```java
-// 异步解析并生成客户端链接
-tool.parseWithClientLinks()
-    .onSuccess(clientLinks -> {
-        log.info("生成的客户端链接: {}", clientLinks);
-    })
-    .onFailure(error -> {
-        log.error("解析失败", error);
-    });
-```
-
-### 4. 生成特定类型的链接
-
-```java
-// 生成 curl 命令
-String curlCommand = ClientLinkGeneratorFactory.generate(info, ClientLinkType.CURL);
-
-// 生成迅雷链接
-String thunderLink = ClientLinkGeneratorFactory.generate(info, ClientLinkType.THUNDER);
-
-// 生成 aria2 命令
-String aria2Command = ClientLinkGeneratorFactory.generate(info, ClientLinkType.ARIA2);
-```
-
-### 5. 使用便捷工具类
-
-```java
-// 使用 ClientLinkUtils 工具类
-String curlCommand = ClientLinkUtils.generateCurlCommand(info);
-String wgetCommand = ClientLinkUtils.generateWgetCommand(info);
-String thunderLink = ClientLinkUtils.generateThunderLink(info);
-String powershellCommand = ClientLinkUtils.generatePowerShellCommand(info);
-
-// 检查是否有有效的下载元数据
-boolean hasValidMeta = ClientLinkUtils.hasValidDownloadMeta(info);
-```
-
-## 输出示例
-
-### PowerShell 命令示例
-
-```powershell
-$session = New-Object Microsoft.PowerShell.Commands.WebRequestSession
-$session.UserAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
-Invoke-WebRequest `
--UseBasicParsing `
--Uri "https://example.com/file.zip" `
--WebSession $session `
--Headers @{`
-  "Cookie"="session=abc123"`
-`
-  "Accept"="text/html,application/xhtml+xml"`
-`
-  "User-Agent"="Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"`
-`
-  "Referer"="https://example.com/share/test"`
-} `
--OutFile "test-file.zip"
-```
-
-### cURL 命令示例
-
-```bash
-curl \
-  -L \
-  -H \
-  "Cookie: session=abc123" \
-  -H \
-  "User-Agent: Mozilla/5.0 (Test Browser)" \
-  -H \
-  "Referer: https://example.com/share/test" \
-  -o \
-  "test-file.zip" \
-  "https://example.com/file.zip"
-```
-
-### 迅雷链接示例
-
-```
-thunder://QUFodHRwczovL2V4YW1wbGUuY29tL2ZpbGUuemlwWlo=
-```
-
-### Aria2 命令示例
-
-```bash
-aria2c \
---header="Cookie: session=abc123" \
---header="User-Agent: Mozilla/5.0 (Test Browser)" \
---header="Referer: https://example.com/share/test" \
---out="test-file.zip" \
---continue \
---max-tries=3 \
---retry-wait=5 \
-"https://example.com/file.zip"
-```
-
-## 解析器集成
-
-### 1. 使用 completeWithMeta 方法
-
-在解析器实现中，使用 `PanBase` 提供的 `completeWithMeta` 方法来存储下载元数据：
-
-```java
-public class MyPanTool extends PanBase {
-    
-    @Override
-    public Future<String> parse() {
-        // ... 解析逻辑 ...
-        
-        // 获取下载链接
-        String downloadUrl = "https://example.com/file.zip";
-        
-        // 准备请求头
-        Map<String, String> headers = new HashMap<>();
-        headers.put("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36");
-        headers.put("Referer", shareLinkInfo.getShareUrl());
-        headers.put("Cookie", "session=abc123");
-        
-        // 使用 completeWithMeta 存储元数据
-        completeWithMeta(downloadUrl, headers);
-        
-        return future();
-    }
-}
-```
-
-### 2. 使用 MultiMap 版本
-
-如果使用 Vert.x 的 MultiMap：
-
-```java
-MultiMap headers = MultiMap.caseInsensitiveMultiMap();
-headers.set("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36");
-headers.set("Referer", shareLinkInfo.getShareUrl());
-
-// 使用 MultiMap 版本
-completeWithMeta(downloadUrl, headers);
-```
-
-## 输出示例
-
-### curl 命令
-```bash
-curl -L "https://example.com/file.zip" \
-  -H "User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" \
-  -H "Referer: https://example.com/share/abc123" \
-  -H "Cookie: session=abc123" \
-  -o "file.zip"
-```
-
-### wget 命令
-```bash
-wget --header="User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" \
-     --header="Referer: https://example.com/share/abc123" \
-     --header="Cookie: session=abc123" \
-     -O "file.zip" \
-     "https://example.com/file.zip"
-```
-
-### aria2 命令
-```bash
-aria2c --header="User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36" \
-       --header="Referer: https://example.com/share/abc123" \
-       --header="Cookie: session=abc123" \
-       --out="file.zip" \
-       --continue \
-       --max-tries=3 \
-       --retry-wait=5 \
-       "https://example.com/file.zip"
-```
-
-### 迅雷链接
-```
-thunder://QUFodHRwczovL2V4YW1wbGUuY29tL2ZpbGUuemlwWlo=
-```
-
-### IDM 链接
-```
-idm:///?url=aHR0cHM6Ly9leGFtcGxlLmNvbS9maWxlLnppcA==&header=UmVmZXJlcjogaHR0cHM6Ly9leGFtcGxlLmNvbS9zaGFyZS9hYmMxMjMK
-```
-
-## 扩展开发
-
-### 1. 自定义生成器
-
-实现 `ClientLinkGenerator` 接口：
-
-```java
-public class MyCustomGenerator implements ClientLinkGenerator {
-    
-    @Override
-    public String generate(DownloadLinkMeta meta) {
-        // 自定义生成逻辑
-        return "myapp://download?url=" + meta.getUrl();
-    }
-    
-    @Override
-    public ClientLinkType getType() {
-        return ClientLinkType.CURL; // 或者定义新的类型
-    }
-}
-```
-
-### 2. 注册自定义生成器
-
-```java
-// 注册自定义生成器
-ClientLinkGeneratorFactory.register(new MyCustomGenerator());
-
-// 使用自定义生成器
-String customLink = ClientLinkGeneratorFactory.generate(info, ClientLinkType.CURL);
-```
-
-## 注意事项
-
-1. **防盗链处理**：不同网盘的防盗链策略不同，需要在元数据中完整保存所需的 headers
-2. **URL 编码**：生成客户端链接时注意 URL 和参数的正确编码（Base64、URLEncode 等）
-3. **兼容性**：确保生成的命令/协议在主流客户端中可用
-4. **可选特性**：元数据存储和客户端链接生成均为可选，不影响现有解析器功能
-5. **线程安全**：工厂类使用 ConcurrentHashMap 存储生成器，支持多线程环境
-
-## API 参考
-
-### IPanTool 接口新增方法
-
-- `parseWithClientLinks()` - 解析文件并生成客户端下载链接（异步）
-- `parseWithClientLinksSync()` - 解析文件并生成客户端下载链接（同步）
-- `getShareLinkInfo()` - 获取 ShareLinkInfo 对象
-
-### ClientLinkGeneratorFactory
-
-- `generateAll(ShareLinkInfo info)` - 生成所有类型的客户端链接
-- `generate(ShareLinkInfo info, ClientLinkType type)` - 生成指定类型的链接
-- `register(ClientLinkGenerator generator)` - 注册自定义生成器
-- `unregister(ClientLinkType type)` - 注销生成器
-- `isRegistered(ClientLinkType type)` - 检查是否已注册
-
-### ClientLinkUtils
-
-- `generateAllClientLinks(ShareLinkInfo info)` - 生成所有客户端链接
-- `generateCurlCommand(ShareLinkInfo info)` - 生成 curl 命令
-- `generateWgetCommand(ShareLinkInfo info)` - 生成 wget 命令
-- `generateThunderLink(ShareLinkInfo info)` - 生成迅雷链接
-- `generatePowerShellCommand(ShareLinkInfo info)` - 生成 PowerShell 命令
-- `hasValidDownloadMeta(ShareLinkInfo info)` - 检查元数据有效性
-
-### PanBase
-
-- `completeWithMeta(String url, Map<String, String> headers)` - 完成解析并存储元数据
-- `completeWithMeta(String url, MultiMap headers)` - 完成解析并存储元数据（MultiMap版本）

parser/doc/CUSTOM_PARSER_GUIDE.md

@@ -1,510 +0,0 @@
-# 自定义解析器扩展指南
-
-> 最后更新：2025-10-17
-
-## 概述
-
-本模块支持用户自定义解析器扩展。用户在依赖本项目的 Maven 坐标后，可以实现自己的网盘解析器并注册到系统中使用。
-
-> **提示**：除了Java自定义解析器，本项目还支持使用JavaScript编写解析器，无需编译即可使用。  
-> 查看 [JavaScript解析器开发指南](JAVASCRIPT_PARSER_GUIDE.md) 了解更多。
-
-## 核心组件
-
-### 1. CustomParserConfig
-自定义解析器配置类，用于描述自定义解析器的元信息。
-
-### 2. CustomParserRegistry
-自定义解析器注册中心，用于管理所有已注册的自定义解析器。
-
-### 3. ParserCreate
-解析器工厂类，已增强支持自定义解析器的创建。
-
-## 使用步骤
-
-### 步骤1: 添加 Maven 依赖
-
-```xml
-<dependency>
-    <groupId>cn.qaiu</groupId>
-    <artifactId>parser</artifactId>
-    <version>10.2.5</version>
-</dependency>
-```
-
-### 步骤2: 继承 PanBase 抽象类
-
-创建自己的解析工具类，**必须继承 `PanBase` 抽象类**（而不是直接实现 IPanTool 接口）。PanBase 提供了丰富的工具方法和 HTTP 客户端，简化解析器的开发。
-
-```java
-package com.example.parser;
-
-import cn.qaiu.entity.ShareLinkInfo;
-import cn.qaiu.parser.PanBase;
-import io.vertx.core.Future;
-
-/**
- * 自定义网盘解析器示例
- */
-public class MyCustomPanTool extends PanBase {
-    
-    /**
-     * 必须提供 ShareLinkInfo 单参构造器
-     */
-    public MyCustomPanTool(ShareLinkInfo shareLinkInfo) {
-        super(shareLinkInfo);
-    }
-    
-    @Override
-    public Future<String> parse() {
-        // 使用 PanBase 提供的 HTTP 客户端发起请求
-        String shareKey = shareLinkInfo.getShareKey();
-        String sharePassword = shareLinkInfo.getSharePassword();
-        
-        // 示例：使用 client 发起 GET 请求
-        client.getAbs("https://your-pan-domain.com/api/share/" + shareKey)
-            .send()
-            .onSuccess(res -> {
-                // 使用 asJson 方法将响应转换为 JSON
-                var json = asJson(res);
-                String downloadUrl = json.getString("download_url");
-                
-                // 使用 complete 方法完成 Promise
-                complete(downloadUrl);
-            })
-            .onFailure(handleFail("请求下载链接失败"));
-        
-        // 返回 Future
-        return future();
-    }
-    
-    /**
-     * 如果需要解析文件列表，可以重写此方法
-     */
-    @Override
-    public Future<List<FileInfo>> parseFileList() {
-        // 实现文件列表解析逻辑
-        return super.parseFileList();
-    }
-    
-    /**
-     * 如果需要根据文件ID获取下载链接，可以重写此方法
-     */
-    @Override
-    public Future<String> parseById() {
-        // 实现根据ID解析的逻辑
-        return super.parseById();
-    }
-}
-```
-
-### PanBase 提供的核心方法
-
-PanBase 为解析器开发提供了以下工具和方法：
-
-#### HTTP 客户端
-- **`client`**: 标准 WebClient 实例，支持自动重定向
-- **`clientSession`**: 带会话管理的 WebClient，自动处理 Cookie
-- **`clientNoRedirects`**: 不自动重定向的 WebClient，用于需要手动处理重定向的场景
-
-#### 响应处理
-- **`asJson(HttpResponse)`**: 将 HTTP 响应转换为 JsonObject，自动处理 gzip 压缩和异常
-- **`asText(HttpResponse)`**: 将 HTTP 响应转换为文本，自动处理 gzip 压缩
-
-#### Promise 管理
-- **`complete(String)`**: 完成 Promise 并返回结果
-- **`future()`**: 获取 Promise 的 Future 对象
-- **`fail(String, Object...)`**: Promise 失败时记录错误信息
-- **`fail(Throwable, String, Object...)`**: Promise 失败时记录错误信息和异常
-- **`handleFail(String)`**: 生成失败处理器，用于请求的 onFailure 回调
-
-#### 其他工具
-- **`nextParser()`**: 调用下一个解析器，用于通用域名解析转发
-- **`getDomainName()`**: 获取域名名称
-- **`shareLinkInfo`**: 分享链接信息对象，包含 shareKey、sharePassword 等
-- **`log`**: 日志记录器
-
-### WebClient 请求流程
-
-WebClient 是基于 Vert.x 的异步 HTTP 客户端，其请求流程如下：
-
-1. **初始化 Vert.x 实例**
-   ```java
-   Vertx vertx = Vertx.vertx();
-   WebClientVertxInit.init(vertx);
-   ```
-
-2. **创建解析器实例**
-   - 继承 PanBase 的解析器会自动获得配置好的 WebClient 实例
-
-3. **发起异步请求**
-   ```java
-   client.getAbs("https://api.example.com/endpoint")
-       .putHeader("User-Agent", "MyParser/1.0")
-       .send()
-       .onSuccess(res -> {
-           // 处理成功响应
-           JsonObject json = asJson(res);
-           complete(json.getString("url"));
-       })
-       .onFailure(handleFail("请求失败"));
-   ```
-
-4. **请求流程说明**
-   - **GET 请求**: 使用 `client.getAbs(url).send()`
-   - **POST 请求**: 使用 `client.postAbs(url).sendJson(body)` 或 `.sendForm(form)`
-   - **会话请求**: 使用 `clientSession` 自动管理 Cookie
-   - **禁用重定向**: 使用 `clientNoRedirects` 手动处理 302/301
-   - **代理支持**: PanBase 构造器会自动处理 shareLinkInfo 中的代理配置
-
-5. **响应处理**
-   ```java
-   .onSuccess(res -> {
-       // 检查状态码
-       if (res.statusCode() != 200) {
-           fail("请求失败，状态码：" + res.statusCode());
-           return;
-       }
-       
-       // 解析 JSON 响应
-       JsonObject json = asJson(res);
-       
-       // 或解析文本响应
-       String text = asText(res);
-       
-       // 完成 Promise
-       complete(result);
-   })
-   .onFailure(handleFail("网络请求异常"));
-   ```
-
-6. **错误处理**
-   - 使用 `fail()` 方法标记解析失败
-   - 使用 `handleFail()` 生成统一的失败处理器
-   - 所有异常会自动记录到日志
-
-### 步骤3: 注册自定义解析器
-
-在应用启动时注册你的解析器：
-
-```java
-import cn.qaiu.parser.custom.CustomParserConfig;
-import cn.qaiu.parser.custom.CustomParserRegistry;
-import com.example.parser.MyCustomPanTool;
-
-public class Application {
-    
-    public static void main(String[] args) {
-        // 注册自定义解析器
-        registerCustomParsers();
-        
-        // 启动你的应用...
-    }
-    
-    private static void registerCustomParsers() {
-        // 创建自定义解析器配置
-        CustomParserConfig config = CustomParserConfig.builder()
-                .type("mypan")  // 类型标识（必填，唯一，建议小写）
-                .displayName("我的网盘")  // 显示名称（必填）
-                .toolClass(MyCustomPanTool.class)  // 解析工具类（必填）
-                .standardUrlTemplate("https://mypan.com/s/{shareKey}")  // URL模板（可选）
-                .panDomain("https://mypan.com")  // 网盘域名（可选）
-                .build();
-        
-        // 注册到系统
-        CustomParserRegistry.register(config);
-        
-        System.out.println("自定义解析器注册成功！");
-    }
-}
-```
-
-### 步骤4: 使用自定义解析器
-
-**重要：自定义解析器只能通过 `fromType` 方法创建，不支持从分享链接自动识别。**
-
-```java
-import cn.qaiu.parser.ParserCreate;
-import cn.qaiu.parser.IPanTool;
-
-public class Example {
-    
-    public static void main(String[] args) {
-        // 方式1: 使用 fromType 创建（推荐）
-        IPanTool tool = ParserCreate.fromType("mypan")  // 使用注册时的type
-                .shareKey("abc123")  // 设置分享键
-                .setShareLinkInfoPwd("1234")  // 设置密码（可选）
-                .createTool();  // 创建工具实例
-        
-        // 方式1: 使用同步方法解析（推荐）
-        String downloadUrl = tool.parseSync();
-        System.out.println("下载链接: " + downloadUrl);
-        
-        // 方式2: 使用同步方法解析文件列表
-        List<FileInfo> files = tool.parseFileListSync();
-        System.out.println("文件列表: " + files.size() + " 个文件");
-        
-        // 方式3: 使用同步方法根据文件ID获取下载链接
-        if (!files.isEmpty()) {
-            String fileId = files.get(0).getFileId();
-            String fileDownloadUrl = tool.parseByIdSync();
-            System.out.println("文件下载链接: " + fileDownloadUrl);
-        }
-        
-        // 方式4: 异步解析（仍支持）
-        tool.parse().onSuccess(url -> {
-            System.out.println("异步获取下载链接: " + url);
-        }).onFailure(err -> {
-            System.err.println("解析失败: " + err.getMessage());
-        });
-    }
-}
-```
-
-## 同步方法支持
-
-解析器现在支持三种同步方法，简化了使用方式：
-
-### 1. parseSync()
-解析单个文件的下载链接：
-```java
-String downloadUrl = tool.parseSync();
-```
-
-### 2. parseFileListSync()
-解析文件列表（目录）：
-```java
-List<FileInfo> files = tool.parseFileListSync();
-for (FileInfo file : files) {
-    System.out.println("文件: " + file.getFileName());
-}
-```
-
-### 3. parseByIdSync()
-根据文件ID获取下载链接：
-```java
-String fileDownloadUrl = tool.parseByIdSync();
-```
-
-### 同步方法优势
-- **简化使用**: 无需处理 Future 和回调
-- **异常处理**: 同步方法会抛出异常，便于错误处理
-- **代码简洁**: 减少异步代码的复杂性
-
-### 异步方法仍可用
-原有的异步方法仍然支持：
-- `parse()`: 返回 `Future<String>`
-- `parseFileList()`: 返回 `Future<List<FileInfo>>`
-- `parseById()`: 返回 `Future<String>`
-
-## 注意事项
-
-### 1. 类型标识规范
-- 类型标识（type）必须唯一
-- 建议使用小写英文字母
-- 不能与内置解析器类型冲突
-- 注册时会自动检查冲突
-
-### 2. 构造器要求
-自定义解析器类必须提供 `ShareLinkInfo` 单参构造器，并调用父类构造器：
-```java
-public MyCustomPanTool(ShareLinkInfo shareLinkInfo) {
-    super(shareLinkInfo);
-}
-```
-
-### 3. 创建方式限制
-- ✅ **支持：** 通过 `ParserCreate.fromType("type")` 创建
-- ❌ **不支持：** 通过 `ParserCreate.fromShareUrl(url)` 自动识别
-
-这是因为自定义解析器没有正则表达式模式来匹配分享链接。
-
-### 4. 线程安全
-`CustomParserRegistry` 使用 `ConcurrentHashMap` 实现，支持多线程安全的注册和查询。
-
-## API 参考
-
-### CustomParserConfig.Builder
-
-| 方法 | 说明 | 必填 |
-|------|------|------|
-| `type(String)` | 设置类型标识，必须唯一 | 是 |
-| `displayName(String)` | 设置显示名称 | 是 |
-| `toolClass(Class)` | 设置解析工具类 | 是 |
-| `standardUrlTemplate(String)` | 设置标准URL模板 | 否 |
-| `panDomain(String)` | 设置网盘域名 | 否 |
-| `build()` | 构建配置对象 | - |
-
-### CustomParserRegistry
-
-| 方法 | 说明 |
-|------|------|
-| `register(CustomParserConfig)` | 注册自定义解析器 |
-| `unregister(String type)` | 注销指定类型的解析器 |
-| `get(String type)` | 获取指定类型的解析器配置 |
-| `contains(String type)` | 检查是否已注册 |
-| `clear()` | 清空所有自定义解析器 |
-| `size()` | 获取已注册数量 |
-| `getAll()` | 获取所有已注册配置 |
-
-### ParserCreate 扩展方法
-
-| 方法 | 说明 |
-|------|------|
-| `isCustomParser()` | 判断是否为自定义解析器 |
-| `getCustomParserConfig()` | 获取自定义解析器配置 |
-| `getPanDomainTemplate()` | 获取内置解析器模板 |
-
-## 完整示例
-
-```java
-import cn.qaiu.entity.ShareLinkInfo;
-import cn.qaiu.parser.custom.CustomParserConfig;
-import cn.qaiu.parser.custom.CustomParserRegistry;
-import cn.qaiu.parser.IPanTool;
-import cn.qaiu.parser.ParserCreate;
-import cn.qaiu.parser.PanBase;
-import io.vertx.core.Future;
-
-public class CompleteExample {
-    
-    public static void main(String[] args) {
-        // 1. 注册自定义解析器
-        registerParser();
-        
-        // 2. 使用自定义解析器
-        useParser();
-        
-        // 3. 查询注册状态
-        checkRegistry();
-        
-        // 4. 注销解析器（可选）
-        // CustomParserRegistry.unregister("mypan");
-    }
-    
-    private static void registerParser() {
-        CustomParserConfig config = CustomParserConfig.builder()
-                .type("mypan")
-                .displayName("我的网盘")
-                .toolClass(MyCustomPanTool.class)
-                .standardUrlTemplate("https://mypan.com/s/{shareKey}")
-                .panDomain("https://mypan.com")
-                .build();
-        
-        try {
-            CustomParserRegistry.register(config);
-            System.out.println("✓ 解析器注册成功");
-        } catch (IllegalArgumentException e) {
-            System.err.println("✗ 注册失败: " + e.getMessage());
-        }
-    }
-    
-    private static void useParser() {
-        try {
-            ParserCreate parser = ParserCreate.fromType("mypan")
-                    .shareKey("abc123")
-                    .setShareLinkInfoPwd("1234");
-            
-            // 检查是否为自定义解析器
-            if (parser.isCustomParser()) {
-                System.out.println("✓ 这是一个自定义解析器");
-                System.out.println("  配置: " + parser.getCustomParserConfig());
-            }
-            
-            // 创建工具并解析
-            IPanTool tool = parser.createTool();
-            
-            // 使用同步方法解析
-            String url = tool.parseSync();
-            System.out.println("✓ 下载链接: " + url);
-            
-            // 解析文件列表
-            List<FileInfo> files = tool.parseFileListSync();
-            System.out.println("✓ 文件列表: " + files.size() + " 个文件");
-            
-            // 根据文件ID获取下载链接
-            if (!files.isEmpty()) {
-                String fileDownloadUrl = tool.parseByIdSync();
-                System.out.println("✓ 文件下载链接: " + fileDownloadUrl);
-            }
-            
-        } catch (Exception e) {
-            System.err.println("✗ 解析失败: " + e.getMessage());
-        }
-    }
-    
-    private static void checkRegistry() {
-        System.out.println("\n已注册的自定义解析器:");
-        System.out.println("  数量: " + CustomParserRegistry.size());
-        
-        if (CustomParserRegistry.contains("mypan")) {
-            CustomParserConfig config = CustomParserRegistry.get("mypan");
-            System.out.println("  - " + config.getType() + ": " + config.getDisplayName());
-        }
-    }
-    
-    // 自定义解析器实现（继承 PanBase）
-    static class MyCustomPanTool extends PanBase {
-        
-        public MyCustomPanTool(ShareLinkInfo shareLinkInfo) {
-            super(shareLinkInfo);
-        }
-        
-        @Override
-        public Future<String> parse() {
-            // 使用 PanBase 提供的 HTTP 客户端
-            String shareKey = shareLinkInfo.getShareKey();
-            
-            client.getAbs("https://mypan.com/api/share/" + shareKey)
-                .send()
-                .onSuccess(res -> {
-                    // 使用 asJson 解析响应
-                    var json = asJson(res);
-                    String downloadUrl = json.getString("download_url");
-                    
-                    // 使用 complete 完成 Promise
-                    complete(downloadUrl);
-                })
-                .onFailure(handleFail("获取下载链接失败"));
-            
-            return future();
-        }
-    }
-}
-```
-
-## 常见问题
-
-### Q1: 如何更新已注册的解析器？
-A: 需要先注销再重新注册：
-```java
-CustomParserRegistry.unregister("mypan");
-CustomParserRegistry.register(newConfig);
-```
-
-### Q2: 注册时抛出"类型标识已被注册"异常？
-A: 该类型已被使用，请更换其他类型标识或先注销已有的。
-
-### Q3: 注册时抛出"与内置解析器冲突"异常？
-A: 你使用的类型标识与系统内置的解析器类型冲突，请查看 `PanDomainTemplate` 枚举了解所有内置类型。
-
-### Q4: 可以从分享链接自动识别我的自定义解析器吗？
-A: 不可以。自定义解析器只能通过 `fromType` 方法创建。如果需要从链接识别，建议提交 PR 将解析器添加到 `PanDomainTemplate` 枚举中。
-
-### Q5: 解析器需要依赖外部服务怎么办？
-A: 可以在解析器类中注入依赖，或使用单例模式管理外部服务连接。
-
-## 相关文档
-
-- [JavaScript解析器开发指南](JAVASCRIPT_PARSER_GUIDE.md) - 使用JavaScript编写解析器，无需编译
-- [自定义解析器快速开始](CUSTOM_PARSER_QUICKSTART.md) - 快速上手指南
-- [解析器开发文档](README.md) - 解析器开发约定和规范
-
-## 贡献
-
-如果你实现了通用的网盘解析器，欢迎提交 PR 将其加入到内置解析器中！
-
-## 许可
-
-本模块遵循项目主LICENSE。
-

parser/doc/CUSTOM_PARSER_QUICKSTART.md

@@ -1,284 +0,0 @@
-# 自定义解析器快速开始
-
-> **提示**：除了Java自定义解析器，本项目还支持使用JavaScript编写解析器，无需编译即可使用。  
-> 查看 [JavaScript解析器开发指南](JAVASCRIPT_PARSER_GUIDE.md) 了解更多。
-
-## 5分钟快速集成指南
-
-### 步骤1: 添加依赖（pom.xml）
-
-```xml
-<dependency>
-    <groupId>cn.qaiu</groupId>
-    <artifactId>parser</artifactId>
-    <version>10.2.5</version>
-</dependency>
-```
-
-### 步骤2: 实现解析器（3个文件）
-
-#### 2.1 创建解析工具类 `MyPanTool.java`
-
-```java
-package com.example.myapp.parser;
-
-import cn.qaiu.entity.ShareLinkInfo;
-import cn.qaiu.parser.IPanTool;
-import io.vertx.core.Future;
-import io.vertx.core.Promise;
-
-public class MyPanTool implements IPanTool {
-    private final ShareLinkInfo shareLinkInfo;
-    
-    // 必须有这个构造器！
-    public MyPanTool(ShareLinkInfo shareLinkInfo) {
-        this.shareLinkInfo = shareLinkInfo;
-    }
-    
-    @Override
-    public Future<String> parse() {
-        Promise<String> promise = Promise.promise();
-        
-        String shareKey = shareLinkInfo.getShareKey();
-        String password = shareLinkInfo.getSharePassword();
-        
-        // TODO: 调用你的网盘API
-        String downloadUrl = "https://mypan.com/download/" + shareKey;
-        
-        promise.complete(downloadUrl);
-        return promise.future();
-    }
-}
-```
-
-#### 2.2 创建注册器 `ParserRegistry.java`
-
-```java
-package com.example.myapp.config;
-
-import cn.qaiu.parser.custom.CustomParserConfig;
-import cn.qaiu.parser.custom.CustomParserRegistry;
-import com.example.myapp.parser.MyPanTool;
-
-public class ParserRegistry {
-    
-    public static void init() {
-        CustomParserConfig config = CustomParserConfig.builder()
-                .type("mypan")              // 唯一标识
-                .displayName("我的网盘")     // 显示名称
-                .toolClass(MyPanTool.class) // 解析器类
-                .build();
-        
-        CustomParserRegistry.register(config);
-    }
-}
-```
-
-#### 2.3 在应用启动时注册
-
-```java
-package com.example.myapp;
-
-import com.example.myapp.config.ParserRegistry;
-import io.vertx.core.Vertx;
-import cn.qaiu.WebClientVertxInit;
-
-public class Application {
-    
-    public static void main(String[] args) {
-        // 1. 初始化 Vertx（必需）
-        Vertx vertx = Vertx.vertx();
-        WebClientVertxInit.init(vertx);
-        
-        // 2. 注册自定义解析器
-        ParserRegistry.init();
-        
-        // 3. 启动应用...
-        System.out.println("应用启动成功！");
-    }
-}
-```
-
-### 步骤3: 使用解析器
-
-```java
-package com.example.myapp.service;
-
-import cn.qaiu.parser.ParserCreate;
-import cn.qaiu.parser.IPanTool;
-
-public class DownloadService {
-    
-    public String getDownloadUrl(String shareKey, String password) {
-        // 创建解析器
-        IPanTool tool = ParserCreate.fromType("mypan")
-                .shareKey(shareKey)
-                .setShareLinkInfoPwd(password)
-                .createTool();
-        
-        // 同步解析
-        return tool.parseSync();
-        
-        // 或异步解析：
-        // tool.parse().onSuccess(url -> {
-        //     System.out.println("下载链接: " + url);
-        // });
-    }
-}
-```
-
-## 完整示例（可直接运行）
-
-```java
-package com.example;
-
-import cn.qaiu.entity.ShareLinkInfo;
-import cn.qaiu.parser.custom.CustomParserConfig;
-import cn.qaiu.parser.custom.CustomParserRegistry;
-import cn.qaiu.parser.IPanTool;
-import cn.qaiu.parser.ParserCreate;
-import cn.qaiu.WebClientVertxInit;
-import io.vertx.core.Future;
-import io.vertx.core.Promise;
-import io.vertx.core.Vertx;
-
-public class QuickStartExample {
-    
-    public static void main(String[] args) {
-        // 1. 初始化环境
-        Vertx vertx = Vertx.vertx();
-        WebClientVertxInit.init(vertx);
-        
-        // 2. 注册自定义解析器
-        CustomParserConfig config = CustomParserConfig.builder()
-                .type("demo")
-                .displayName("演示网盘")
-                .toolClass(DemoPanTool.class)
-                .build();
-        CustomParserRegistry.register(config);
-        System.out.println("✓ 解析器注册成功");
-        
-        // 3. 使用解析器
-        IPanTool tool = ParserCreate.fromType("demo")
-                .shareKey("test123")
-                .setShareLinkInfoPwd("pass123")
-                .createTool();
-        
-        String url = tool.parseSync();
-        System.out.println("✓ 下载链接: " + url);
-        
-        // 清理
-        vertx.close();
-    }
-    
-    // 演示解析器实现
-    static class DemoPanTool implements IPanTool {
-        private final ShareLinkInfo info;
-        
-        public DemoPanTool(ShareLinkInfo info) {
-            this.info = info;
-        }
-        
-        @Override
-        public Future<String> parse() {
-            Promise<String> promise = Promise.promise();
-            String url = "https://demo.com/download/" 
-                       + info.getShareKey() 
-                       + "?pwd=" + info.getSharePassword();
-            promise.complete(url);
-            return promise.future();
-        }
-    }
-}
-```
-
-运行输出：
-```
-✓ 解析器注册成功
-✓ 下载链接: https://demo.com/download/test123?pwd=pass123
-```
-
-## 常见问题速查
-
-### Q: 忘记注册解析器会怎样？
-A: 抛出异常：`未找到类型为 'xxx' 的解析器`
-
-**解决方法：** 确保在使用前调用 `CustomParserRegistry.register(config)`
-
-### Q: 构造器写错了会怎样？
-A: 抛出异常：`toolClass必须有ShareLinkInfo单参构造器`
-
-**解决方法：** 确保有这个构造器：
-```java
-public MyTool(ShareLinkInfo info) { ... }
-```
-
-### Q: 可以从分享链接自动识别吗？
-A: 不可以。自定义解析器只能通过 `fromType` 创建。
-
-**正确用法：**
-```java
-ParserCreate.fromType("mypan")  // ✓ 正确
-    .shareKey("abc")
-    .createTool();
-
-ParserCreate.fromShareUrl("https://...")  // ✗ 不支持
-```
-
-### Q: 如何调试解析器？
-A: 在 `parse()` 方法中添加日志：
-
-```java
-@Override
-public Future<String> parse() {
-    System.out.println("开始解析: " + shareLinkInfo);
-    // ... 解析逻辑
-}
-```
-
-## Spring Boot 集成示例
-
-```java
-@Configuration
-public class ParserConfig {
-    
-    @Bean
-    public Vertx vertx() {
-        Vertx vertx = Vertx.vertx();
-        WebClientVertxInit.init(vertx);
-        return vertx;
-    }
-    
-    @PostConstruct
-    public void registerCustomParsers() {
-        CustomParserConfig config = CustomParserConfig.builder()
-                .type("mypan")
-                .displayName("我的网盘")
-                .toolClass(MyPanTool.class)
-                .build();
-        
-        CustomParserRegistry.register(config);
-        log.info("自定义解析器注册完成");
-    }
-}
-```
-
-## 下一步
-
-- 📖 阅读[完整文档](CUSTOM_PARSER_GUIDE.md)了解高级用法
-- 🔍 查看[测试代码](../src/test/java/cn/qaiu/parser/CustomParserTest.java)了解更多示例
-- 💡 参考[内置解析器](../src/main/java/cn/qaiu/parser/impl/)了解最佳实践
-
-## 相关文档
-
-- [自定义解析器扩展完整指南](CUSTOM_PARSER_GUIDE.md) - Java自定义解析器详细文档
-- [JavaScript解析器开发指南](JAVASCRIPT_PARSER_GUIDE.md) - 使用JavaScript编写解析器
-- [解析器开发文档](README.md) - 解析器开发约定和规范
-
-## 技术支持
-
-遇到问题？
-1. 查看[完整文档](CUSTOM_PARSER_GUIDE.md)
-2. 查看[测试用例](../src/test/java/cn/qaiu/parser/CustomParserTest.java)
-3. 提交 [Issue](https://github.com/qaiu/netdisk-fast-download/issues)
-

parser/doc/IMPLEMENTATION_SUMMARY.md

@@ -1,311 +0,0 @@
-# 自定义解析器扩展功能实现总结
-
-## ✅ 实现完成
-
-### 1. 核心功能实现
-
-#### 1.1 配置类 (CustomParserConfig)
-- ✅ 使用 Builder 模式构建配置
-- ✅ 支持必填字段验证（type、displayName、toolClass）
-- ✅ 自动验证 toolClass 是否实现 IPanTool 接口
-- ✅ 自动验证 toolClass 是否有 ShareLinkInfo 单参构造器
-- ✅ 支持可选字段（standardUrlTemplate、panDomain）
-
-#### 1.2 注册中心 (CustomParserRegistry)
-- ✅ 使用 ConcurrentHashMap 保证线程安全
-- ✅ 支持注册/注销/查询操作
-- ✅ 自动检测与内置解析器的类型冲突
-- ✅ 防止重复注册同一类型
-- ✅ 提供批量查询接口（getAll）
-- ✅ 提供清空接口（clear）
-
-#### 1.3 工厂类增强 (ParserCreate)
-- ✅ 新增自定义解析器专用构造器
-- ✅ `fromType` 方法优先查找自定义解析器
-- ✅ `createTool` 方法支持创建自定义解析器实例
-- ✅ `normalizeShareLink` 方法对自定义解析器抛出异常
-- ✅ `shareKey` 方法支持自定义解析器
-- ✅ `getStandardUrlTemplate` 方法支持自定义解析器
-- ✅ `genPathSuffix` 方法支持自定义解析器
-- ✅ 新增 `isCustomParser` 判断方法
-- ✅ 新增 `getCustomParserConfig` 获取配置方法
-- ✅ 新增 `getPanDomainTemplate` 获取内置模板方法
-
-### 2. 测试覆盖
-
-#### 2.1 单元测试 (CustomParserTest)
-- ✅ 测试注册功能（正常、重复、冲突）
-- ✅ 测试注销功能
-- ✅ 测试工具创建
-- ✅ 测试不支持的操作（fromShareUrl、normalizeShareLink）
-- ✅ 测试路径生成
-- ✅ 测试批量查询
-- ✅ 测试配置验证
-- ✅ 测试工具类验证
-- ✅ 使用 JUnit 4 框架
-- ✅ 11个测试方法全覆盖
-
-#### 2.2 编译验证
-```bash
-✅ 编译成功：60个源文件
-✅ 测试编译成功：9个测试文件
-✅ 无编译错误
-✅ 无Lint错误
-```
-
-### 3. 文档完善
-
-#### 3.1 完整指南
-- ✅ **CUSTOM_PARSER_GUIDE.md** - 完整扩展指南（15个章节）
-  - 概述
-  - 核心组件
-  - 使用步骤（4步详解）
-  - 注意事项（4大类）
-  - API参考（3个主要类）
-  - 完整示例
-  - 常见问题（5个FAQ）
-  - 贡献指南
-
-#### 3.2 快速开始
-- ✅ **CUSTOM_PARSER_QUICKSTART.md** - 5分钟快速上手
-  - 3步集成
-  - 可运行的完整示例
-  - Spring Boot集成示例
-  - 常见问题速查
-  - 调试技巧
-
-#### 3.3 更新日志
-- ✅ **CHANGELOG_CUSTOM_PARSER.md** - 详细变更记录
-  - 新增类列表
-  - 修改的方法
-  - 设计约束
-  - 使用场景
-  - 影响范围
-  - 升级指南
-
-#### 3.4 项目文档更新
-- ✅ **README.md** - 更新主文档
-  - 新增核心API说明
-  - 添加快速示例
-  - 链接到详细文档
-
----
-
-## 📊 代码统计
-
-### 新增文件
-```
-CustomParserConfig.java           - 160行
-CustomParserRegistry.java         - 110行
-CustomParserTest.java             - 310行
-CUSTOM_PARSER_GUIDE.md           - 500+行
-CUSTOM_PARSER_QUICKSTART.md      - 300+行
-CHANGELOG_CUSTOM_PARSER.md       - 300+行
-IMPLEMENTATION_SUMMARY.md        - 本文件
-```
-
-### 修改文件
-```
-ParserCreate.java                - +80行改动
-README.md                        - +30行新增
-```
-
-### 代码行数统计
-- **新增Java代码:** ~580行
-- **新增测试代码:** ~310行
-- **新增文档:** ~1,500行
-- **总计:** ~2,390行
-
----
-
-## 🎯 设计原则遵循
-
-### 1. SOLID原则
-- ✅ **单一职责:** CustomParserConfig只负责配置，Registry只负责注册管理
-- ✅ **开闭原则:** 对扩展开放（支持自定义），对修改关闭（不改变现有行为）
-- ✅ **依赖倒置:** 依赖IPanTool接口而非具体实现
-
-### 2. 安全性
-- ✅ 类型安全检查（编译时+运行时）
-- ✅ 构造器验证
-- ✅ 接口实现验证
-- ✅ 类型冲突检测
-- ✅ 重复注册防护
-
-### 3. 线程安全
-- ✅ 使用ConcurrentHashMap
-- ✅ synchronized方法（fromType）
-- ✅ 不可变配置对象
-
-### 4. 向后兼容
-- ✅ 不影响现有代码
-- ✅ 可选功能（不用则不影响）
-- ✅ 无新增外部依赖
-
----
-
-## 🔍 技术亮点
-
-### 1. Builder模式
-```java
-CustomParserConfig config = CustomParserConfig.builder()
-    .type("mypan")
-    .displayName("我的网盘")
-    .toolClass(MyTool.class)
-    .build();  // 自动验证
-```
-
-### 2. 注册中心模式
-```java
-CustomParserRegistry.register(config);  // 集中管理
-CustomParserRegistry.get("mypan");      // 快速查询
-```
-
-### 3. 策略模式
-```java
-// 自动选择策略
-ParserCreate.fromType("mypan")  // 自定义解析器
-ParserCreate.fromType("lz")     // 内置解析器
-```
-
-### 4. 责任链模式
-```java
-// fromType优先查找自定义，再查找内置
-CustomParserConfig → PanDomainTemplate → Exception
-```
-
----
-
-## 📈 性能指标
-
-### 时间复杂度
-- 注册: O(1)
-- 查询: O(1)
-- 注销: O(1)
-
-### 空间复杂度
-- 每个配置对象: ~1KB
-- 100个自定义解析器: ~100KB
-
-### 并发性能
-- 无锁设计（ConcurrentHashMap）
-- 支持高并发读写
-
----
-
-## 🧪 测试结果
-
-### 编译测试
-```bash
-✅ mvn clean compile - SUCCESS
-✅ 60 source files compiled
-✅ No errors
-```
-
-### 单元测试
-```bash
-✅ 11个测试用例
-✅ 覆盖所有核心功能
-✅ 覆盖异常情况
-✅ 覆盖边界条件
-```
-
-### 代码质量
-```bash
-✅ No linter errors
-✅ No compiler warnings (except deprecation)
-✅ No security issues
-```
-
----
-
-## 📚 使用示例验证
-
-### 最小示例
-```java
-// ✅ 编译通过
-// ✅ 运行正常
-CustomParserRegistry.register(
-    CustomParserConfig.builder()
-        .type("test")
-        .displayName("测试")
-        .toolClass(TestTool.class)
-        .build()
-);
-```
-
-### 完整示例
-```java
-// ✅ 功能完整
-// ✅ 文档齐全
-// ✅ 可直接运行
-见 CUSTOM_PARSER_QUICKSTART.md
-```
-
----
-
-## 🎓 文档质量
-
-### 完整性
-- ✅ 概念说明
-- ✅ 使用步骤
-- ✅ 代码示例
-- ✅ API参考
-- ✅ 常见问题
-- ✅ 故障排查
-
-### 可读性
-- ✅ 中文文档
-- ✅ 代码高亮
-- ✅ 清晰的章节结构
-- ✅ 丰富的示例
-- ✅ 表格和列表
-
-### 实用性
-- ✅ 5分钟快速开始
-- ✅ 可复制粘贴的代码
-- ✅ Spring Boot集成示例
-- ✅ 常见问题速查
-
----
-
-## 🎉 总结
-
-### 功能完成度：100%
-- ✅ 核心功能
-- ✅ 测试覆盖
-- ✅ 文档完善
-- ✅ 代码质量
-
-### 用户友好度：⭐⭐⭐⭐⭐
-- ✅ 简单易用
-- ✅ 文档齐全
-- ✅ 示例丰富
-- ✅ 错误提示清晰
-
-### 代码质量：⭐⭐⭐⭐⭐
-- ✅ 设计合理
-- ✅ 类型安全
-- ✅ 线程安全
-- ✅ 性能优秀
-
-### 可维护性：⭐⭐⭐⭐⭐
-- ✅ 结构清晰
-- ✅ 职责明确
-- ✅ 易于扩展
-- ✅ 易于调试
-
----
-
-## 📞 联系方式
-
-- **作者:** [@qaiu](https://qaiu.top)
-- **项目:** netdisk-fast-download
-- **文档:** parser/doc/
-
----
-
-**实现日期:** 2024-10-17  
-**版本:** 10.1.17+  
-**状态:** ✅ 已完成，可投入使用
-

parser/doc/JAVASCRIPT_PARSER_GUIDE.md

@@ -1,729 +0,0 @@
-# JavaScript解析器扩展开发指南
-
-## 概述
-
-本指南介绍如何使用JavaScript编写自定义网盘解析器，支持通过JavaScript代码实现网盘解析逻辑，无需编写Java代码。
-
-## 目录
-
-- [快速开始](#快速开始)
-- [API参考](#api参考)
-  - [ShareLinkInfo对象](#sharelinkinfo对象)
-  - [JsHttpClient对象](#jshttpclient对象)
-  - [JsHttpResponse对象](#jshttpresponse对象)
-  - [JsLogger对象](#jslogger对象)
-- [重定向处理](#重定向处理)
-- [代理支持](#代理支持)
-- [实现方法](#实现方法)
-  - [parse方法（必填）](#parse方法必填)
-  - [parseFileList方法（可选）](#parsefilelist方法可选)
-  - [parseById方法（可选）](#parsebyid方法可选)
-- [错误处理](#错误处理)
-- [调试技巧](#调试技巧)
-- [最佳实践](#最佳实践)
-- [示例解析器](#示例解析器)
-
-## 快速开始
-
-### 1. 创建JavaScript脚本
-
-在 `./custom-parsers/` 目录下创建 `.js` 文件，使用以下模板：
-
-```javascript
-// ==UserScript==
-// @name         我的解析器
-// @type         my_parser
-// @displayName  我的网盘
-// @description  使用JavaScript实现的网盘解析器
-// @match        https?://example\.com/s/(?<KEY>\w+)
-// @author       yourname
-// @version      1.0.0
-// ==/UserScript==
-
-// 使用require导入类型定义（仅用于IDE类型提示）
-var types = require('./types');
-/** @typedef {types.ShareLinkInfo} ShareLinkInfo */
-/** @typedef {types.JsHttpClient} JsHttpClient */
-/** @typedef {types.JsLogger} JsLogger */
-/** @typedef {types.FileInfo} FileInfo */
-
-/**
- * 解析单个文件下载链接
- * @param {ShareLinkInfo} shareLinkInfo - 分享链接信息
- * @param {JsHttpClient} http - HTTP客户端
- * @param {JsLogger} logger - 日志对象
- * @returns {string} 下载链接
- */
-function parse(shareLinkInfo, http, logger) {
-    var url = shareLinkInfo.getShareUrl();
-    var response = http.get(url);
-    return response.body();
-}
-```
-
-### 2. 解析器加载路径
-
-JavaScript解析器支持两种加载方式：
-
-#### 内置解析器（jar包内）
-- **位置**：jar包内的 `custom-parsers/` 资源目录
-- **特点**：随jar包一起发布，无需额外配置
-- **路径**：`parser/src/main/resources/custom-parsers/`
-
-#### 外部解析器（用户自定义）
-- **默认位置**：应用运行目录下的 `./custom-parsers/` 文件夹
-- **配置方式**（优先级从高到低）：
-  1. **系统属性**：`-Dparser.custom-parsers.path=/path/to/your/parsers`
-  2. **环境变量**：`PARSER_CUSTOM_PARSERS_PATH=/path/to/your/parsers`
-  3. **默认路径**：`./custom-parsers/`（相对于应用运行目录）
-
-#### 配置示例
-
-**Maven项目中使用：**
-```bash
-# 方式1：系统属性
-mvn exec:java -Dexec.mainClass="your.MainClass" -Dparser.custom-parsers.path=./src/main/resources/custom-parsers
-
-# 方式2：环境变量
-export PARSER_CUSTOM_PARSERS_PATH=./src/main/resources/custom-parsers
-mvn exec:java -Dexec.mainClass="your.MainClass"
-```
-
-**jar包运行时：**
-```bash
-# 方式1：系统属性
-java -Dparser.custom-parsers.path=/path/to/your/parsers -jar your-app.jar
-
-# 方式2：环境变量
-export PARSER_CUSTOM_PARSERS_PATH=/path/to/your/parsers
-java -jar your-app.jar
-```
-
-**Docker部署：**
-```bash
-# 挂载外部解析器目录
-docker run -d -v /path/to/your/parsers:/app/custom-parsers your-image
-
-# 或使用环境变量
-docker run -d -e PARSER_CUSTOM_PARSERS_PATH=/app/custom-parsers your-image
-```
-
-### 3. 重启应用
-
-重启应用后，JavaScript解析器会自动加载并注册。查看应用日志确认解析器是否成功加载。
-
-## 元数据格式
-
-### 必填字段
-
-- `@name`: 脚本名称
-- `@type`: 解析器类型标识（唯一）
-- `@displayName`: 显示名称
-- `@match`: URL匹配正则（必须包含 `(?<KEY>...)` 命名捕获组）
-
-### 可选字段
-
-- `@description`: 描述信息
-- `@author`: 作者
-- `@version`: 版本号
-
-### 示例
-
-```javascript
-// ==UserScript==
-// @name         蓝奏云解析器
-// @type         lanzou_js
-// @displayName  蓝奏云(JS)
-// @description  使用JavaScript实现的蓝奏云解析器
-// @match        https?://.*\.lanzou[a-z]\.com/(?<KEY>\w+)
-// @match        https?://.*\.lanzoui\.com/(?<KEY>\w+)
-// @author       qaiu
-// @version      1.0.0
-// ==/UserScript==
-```
-
-## API参考
-
-### ShareLinkInfo对象
-
-提供分享链接信息的访问接口：
-
-```javascript
-// 获取分享URL
-var shareUrl = shareLinkInfo.getShareUrl();
-
-// 获取分享Key
-var shareKey = shareLinkInfo.getShareKey();
-
-// 获取分享密码
-var password = shareLinkInfo.getSharePassword();
-
-// 获取网盘类型
-var type = shareLinkInfo.getType();
-
-// 获取网盘名称
-var panName = shareLinkInfo.getPanName();
-
-// 获取其他参数
-var dirId = shareLinkInfo.getOtherParam("dirId");
-var paramJson = shareLinkInfo.getOtherParam("paramJson");
-
-// 检查参数是否存在
-if (shareLinkInfo.hasOtherParam("customParam")) {
-    var value = shareLinkInfo.getOtherParamAsString("customParam");
-}
-```
-
-### JsHttpClient对象
-
-提供HTTP请求功能：
-
-```javascript
-// GET请求
-var response = http.get("https://api.example.com/data");
-
-// GET请求并跟随重定向
-var redirectResponse = http.getWithRedirect("https://api.example.com/redirect");
-
-// GET请求但不跟随重定向（用于获取Location头）
-var noRedirectResponse = http.getNoRedirect("https://api.example.com/redirect");
-if (noRedirectResponse.statusCode() >= 300 && noRedirectResponse.statusCode() < 400) {
-    var location = noRedirectResponse.header("Location");
-    console.log("重定向到: " + location);
-}
-
-// POST请求
-var response = http.post("https://api.example.com/submit", {
-    key: "value",
-    data: "test"
-});
-
-// 设置请求头（单个）
-http.putHeader("User-Agent", "MyBot/1.0")
-    .putHeader("Authorization", "Bearer token");
-
-// 批量设置请求头
-http.putHeaders({
-    "User-Agent": "MyBot/1.0",
-    "Authorization": "Bearer token",
-    "Accept": "application/json"
-});
-
-// 删除指定请求头
-http.removeHeader("Authorization");
-
-// 清空所有请求头（保留默认头）
-http.clearHeaders();
-
-// 获取所有请求头
-var allHeaders = http.getHeaders();
-logger.debug("当前请求头: " + JSON.stringify(allHeaders));
-
-// 设置请求超时时间（秒）
-http.setTimeout(60); // 设置为60秒
-
-// PUT请求
-var putResponse = http.put("https://api.example.com/resource", {
-    key: "value"
-});
-
-// DELETE请求
-var deleteResponse = http.delete("https://api.example.com/resource/123");
-
-// PATCH请求
-var patchResponse = http.patch("https://api.example.com/resource/123", {
-    key: "newValue"
-});
-
-// URL编码/解码（静态方法）
-var encoded = JsHttpClient.urlEncode("hello world"); // "hello%20world"
-var decoded = JsHttpClient.urlDecode("hello%20world"); // "hello world"
-
-// 发送简单表单数据
-var formResponse = http.sendForm("https://api.example.com/login", {
-    username: "user",
-    password: "pass"
-});
-
-// 发送JSON数据
-var jsonResponse = http.sendJson("https://api.example.com/submit", {
-    name: "test",
-    value: 123
-});
-```
-
-### JsHttpResponse对象
-
-处理HTTP响应：
-
-```javascript
-var response = http.get("https://api.example.com/data");
-
-// 获取响应体（字符串）
-var body = response.body();
-
-// 解析JSON响应
-var data = response.json();
-
-// 获取状态码
-var status = response.statusCode();
-
-// 获取响应头
-var contentType = response.header("Content-Type");
-var allHeaders = response.headers();
-
-// 检查请求是否成功
-if (response.isSuccess()) {
-    logger.info("请求成功");
-} else {
-    logger.error("请求失败: " + status);
-}
-
-// 获取响应体字节数组
-var bytes = response.bodyBytes();
-
-// 获取响应体大小
-var size = response.bodySize();
-logger.info("响应体大小: " + size + " 字节");
-```
-
-### JsLogger对象
-
-提供日志功能：
-
-```javascript
-// 不同级别的日志
-logger.debug("调试信息");
-logger.info("一般信息");
-logger.warn("警告信息");
-logger.error("错误信息");
-
-// 带参数的日志
-logger.info("用户 {} 访问了 {}", username, url);
-
-// 检查日志级别
-if (logger.isDebugEnabled()) {
-    logger.debug("详细的调试信息");
-}
-```
-
-## 重定向处理
-
-当网盘服务返回302重定向时，可以使用`getNoRedirect`方法获取真实的下载链接：
-
-```javascript
-/**
- * 获取真实的下载链接（处理302重定向）
- * @param {string} downloadUrl - 原始下载链接
- * @param {JsHttpClient} http - HTTP客户端
- * @param {JsLogger} logger - 日志记录器
- * @returns {string} 真实的下载链接
- */
-function getRealDownloadUrl(downloadUrl, http, logger) {
-    try {
-        logger.info("获取真实下载链接: " + downloadUrl);
-        
-        // 使用不跟随重定向的方法获取Location头
-        var headResponse = http.getNoRedirect(downloadUrl);
-        
-        if (headResponse.statusCode() >= 300 && headResponse.statusCode() < 400) {
-            // 处理重定向
-            var location = headResponse.header("Location");
-            if (location) {
-                logger.info("获取到重定向链接: " + location);
-                return location;
-            }
-        }
-        
-        // 如果没有重定向或无法获取Location，返回原链接
-        logger.debug("下载链接无需重定向或无法获取重定向信息");
-        return downloadUrl;
-        
-    } catch (e) {
-        logger.error("获取真实下载链接失败: " + e.message);
-        // 如果获取失败，返回原链接
-        return downloadUrl;
-    }
-}
-
-// 在parse方法中使用
-function parse(shareLinkInfo, http, logger) {
-    // ... 获取原始下载链接的代码 ...
-    var originalUrl = "https://example.com/download?id=123";
-    
-    // 获取真实的下载链接
-    var realUrl = getRealDownloadUrl(originalUrl, http, logger);
-    return realUrl;
-}
-```
-
-## 代理支持
-
-JavaScript解析器支持HTTP代理配置，代理信息通过`ShareLinkInfo`的`otherParam`传递：
-
-```javascript
-function parse(shareLinkInfo, http, logger) {
-    // 检查是否有代理配置
-    var proxyConfig = shareLinkInfo.getOtherParam("proxy");
-    if (proxyConfig) {
-        logger.info("使用代理: " + proxyConfig.host + ":" + proxyConfig.port);
-    }
-    
-    // HTTP客户端会自动使用代理配置
-    var response = http.get("https://api.example.com/data");
-    return response.body();
-}
-```
-
-代理配置格式：
-```json
-{
-    "type": "HTTP",  // 代理类型: HTTP, SOCKS4, SOCKS5
-    "host": "proxy.example.com",
-    "port": 8080,
-    "username": "user",  // 可选，代理认证用户名
-    "password": "pass"    // 可选，代理认证密码
-}
-```
-
-## 实现方法
-
-JavaScript解析器支持三种方法，对应Java接口的三种同步方法：
-
-### parse方法（必填）
-
-解析单个文件的下载链接，对应Java的 `parseSync()` 方法：
-
-```javascript
-function parse(shareLinkInfo, http, logger) {
-    var shareUrl = shareLinkInfo.getShareUrl();
-    var password = shareLinkInfo.getSharePassword();
-    
-    // 发起请求获取页面
-    var response = http.get(shareUrl);
-    var html = response.body();
-    
-    // 解析HTML获取下载链接
-    var regex = /downloadUrl["']:\s*["']([^"']+)["']/;
-    var match = html.match(regex);
-    
-    if (match) {
-        return match[1]; // 返回下载链接
-    } else {
-        throw new Error("无法解析下载链接");
-    }
-}
-```
-
-### parseFileList方法（可选）
-
-解析文件列表（目录），对应Java的 `parseFileListSync()` 方法：
-
-```javascript
-function parseFileList(shareLinkInfo, http, logger) {
-    var dirId = shareLinkInfo.getOtherParam("dirId") || "0";
-    
-    // 请求文件列表API
-    var response = http.get("/api/list?dirId=" + dirId);
-    var data = response.json();
-    
-    var fileList = [];
-    for (var i = 0; i < data.files.length; i++) {
-        var file = data.files[i];
-        
-        var fileInfo = {
-            fileName: file.name,
-            fileId: file.id,
-            fileType: file.isDir ? "folder" : "file",
-            size: file.size,
-            sizeStr: formatSize(file.size),
-            createTime: file.createTime,
-            parserUrl: "/v2/redirectUrl/my_parser/" + file.id
-        };
-        
-        fileList.push(fileInfo);
-    }
-    
-    return fileList;
-}
-```
-
-### parseById方法（可选）
-
-根据文件ID获取下载链接，对应Java的 `parseByIdSync()` 方法：
-
-```javascript
-function parseById(shareLinkInfo, http, logger) {
-    var paramJson = shareLinkInfo.getOtherParam("paramJson");
-    var fileId = paramJson.fileId;
-    
-    // 请求下载API
-    var response = http.get("/api/download?fileId=" + fileId);
-    var data = response.json();
-    
-    return data.downloadUrl;
-}
-```
-
-## 同步方法支持
-
-JavaScript解析器的方法都是同步执行的，对应Java接口的三种同步方法：
-
-### 方法对应关系
-
-| JavaScript方法 | Java同步方法 | 说明 |
-|----------------|-------------|------|
-| `parse()` | `parseSync()` | 解析单个文件下载链接 |
-| `parseFileList()` | `parseFileListSync()` | 解析文件列表 |
-| `parseById()` | `parseByIdSync()` | 根据文件ID获取下载链接 |
-
-### 使用示例
-
-```javascript
-// 在Java中调用JavaScript解析器
-IPanTool tool = ParserCreate.fromType("my_js_parser")
-    .shareKey("abc123")
-    .createTool();
-
-// 使用同步方法调用JavaScript函数
-String downloadUrl = tool.parseSync();           // 调用 parse() 函数
-List<FileInfo> files = tool.parseFileListSync(); // 调用 parseFileList() 函数  
-String fileUrl = tool.parseByIdSync();           // 调用 parseById() 函数
-```
-
-### 注意事项
-
-- JavaScript方法都是同步执行的，无需处理异步回调
-- 如果JavaScript方法抛出异常，Java同步方法会抛出相应的异常
-- 建议在JavaScript方法中添加适当的错误处理和日志记录
-
-## 函数定义方式
-
-JavaScript解析器使用全局函数定义，不需要`exports`对象：
-
-```javascript
-/**
- * 解析单个文件下载链接（必填）
- * @param {ShareLinkInfo} shareLinkInfo - 分享链接信息
- * @param {JsHttpClient} http - HTTP客户端
- * @param {JsLogger} logger - 日志对象
- * @returns {string} 下载链接
- */
-function parse(shareLinkInfo, http, logger) {
-    // 实现解析逻辑
-    return "https://example.com/download";
-}
-
-/**
- * 解析文件列表（可选）
- * @param {ShareLinkInfo} shareLinkInfo - 分享链接信息
- * @param {JsHttpClient} http - HTTP客户端
- * @param {JsLogger} logger - 日志对象
- * @returns {Array} 文件信息数组
- */
-function parseFileList(shareLinkInfo, http, logger) {
-    // 实现文件列表解析逻辑
-    return [];
-}
-
-/**
- * 根据文件ID获取下载链接（可选）
- * @param {ShareLinkInfo} shareLinkInfo - 分享链接信息
- * @param {JsHttpClient} http - HTTP客户端
- * @param {JsLogger} logger - 日志对象
- * @returns {string} 下载链接
- */
-function parseById(shareLinkInfo, http, logger) {
-    // 实现按ID解析逻辑
-    return "https://example.com/download";
-}
-```
-
-**注意**：JavaScript解析器通过`engine.eval()`执行，函数必须定义为全局函数，不需要使用`exports`或`module.exports`。
-
-## VSCode配置
-
-### 1. 安装JavaScript扩展
-
-安装 "JavaScript (ES6) code snippets" 扩展。
-
-### 2. 配置jsconfig.json
-
-在 `custom-parsers` 目录下创建 `jsconfig.json`：
-
-```json
-{
-  "compilerOptions": {
-    "checkJs": true,
-    "target": "ES5",
-    "lib": ["ES5"],
-    "allowJs": true,
-    "noEmit": true
-  },
-  "include": ["*.js", "types.d.ts"],
-  "exclude": ["node_modules"]
-}
-```
-
-### 3. 使用类型提示
-
-```javascript
-// 引用类型定义
-var types = require('./types');
-/** @typedef {types.ShareLinkInfo} ShareLinkInfo */
-/** @typedef {types.JsHttpClient} JsHttpClient */
-
-// 使用类型注解
-/**
- * @param {ShareLinkInfo} shareLinkInfo
- * @param {JsHttpClient} http
- * @returns {string}
- */
-function parse(shareLinkInfo, http, logger) {
-    // VSCode会提供代码补全和类型检查
-}
-```
-
-## 调试技巧
-
-### 1. 使用日志
-
-```javascript
-function parse(shareLinkInfo, http, logger) {
-    logger.info("开始解析: " + shareLinkInfo.getShareUrl());
-    
-    var response = http.get(shareLinkInfo.getShareUrl());
-    logger.debug("响应状态: " + response.statusCode());
-    logger.debug("响应内容: " + response.body().substring(0, 100));
-    
-    // 解析逻辑...
-}
-```
-
-### 2. 错误处理
-
-```javascript
-function parse(shareLinkInfo, http, logger) {
-    try {
-        var response = http.get(shareLinkInfo.getShareUrl());
-        
-        if (!response.isSuccess()) {
-            throw new Error("HTTP请求失败: " + response.statusCode());
-        }
-        
-        var data = response.json();
-        return data.downloadUrl;
-        
-    } catch (e) {
-        logger.error("解析失败: " + e.message);
-        throw e; // 重新抛出异常
-    }
-}
-```
-
-### 3. 启用调试模式
-
-设置系统属性启用详细日志：
-
-```bash
--Dnfd.js.debug=true
-```
-
-## 常见问题
-
-### Q: 如何获取分享密码？
-
-A: 使用 `shareLinkInfo.getSharePassword()` 方法。
-
-### Q: 如何处理需要登录的网盘？
-
-A: 使用 `http.putHeader()` 设置认证头，或使用 `http.sendForm(url, data)` 发送登录表单。
-
-### Q: 如何解析复杂的HTML？
-
-A: 使用正则表达式或字符串方法解析HTML内容。
-
-### Q: 如何处理异步请求？
-
-A: 当前版本使用同步API，所有HTTP请求都是同步的。
-
-### Q: 如何调试JavaScript代码？
-
-A: 使用 `logger.debug()` 输出调试信息，查看应用日志。
-
-### Q: 如何批量设置请求头？
-
-A: 使用 `http.putHeaders()` 方法批量设置多个请求头：
-
-```javascript
-// 批量设置请求头
-http.putHeaders({
-    "User-Agent": "Mozilla/5.0...",
-    "Accept": "application/json",
-    "Authorization": "Bearer token",
-    "Referer": "https://example.com"
-});
-```
-
-### Q: 如何清空所有请求头？
-
-A: 使用 `http.clearHeaders()` 方法清空所有请求头（会保留默认头）：
-
-```javascript
-// 清空所有请求头，保留默认头（Accept-Encoding、User-Agent、Accept-Language）
-http.clearHeaders();
-```
-
-### Q: 如何设置请求超时时间？
-
-A: 使用 `http.setTimeout()` 方法设置超时时间（秒）：
-
-```javascript
-// 设置超时时间为60秒
-http.setTimeout(60);
-var response = http.get("https://api.example.com/data");
-```
-
-## 示例脚本
-
-参考以下示例文件，包含完整的解析器实现：
-
-- **`parser/src/main/resources/custom-parsers/example-demo.js`** - 完整的演示解析器，展示所有功能
-- **`parser/src/main/resources/custom-parsers/baidu-photo.js`** - 百度相册解析器示例
-- **`parser/src/main/resources/custom-parsers/migu-music.js`** - 咪咕音乐解析器示例
-- **`parser/src/main/resources/custom-parsers/qishui-music.js`** - 汽水音乐解析器示例
-
-这些示例展示了：
-- 元数据配置
-- 三个核心方法的实现（parse、parseFileList、parseById）
-- 错误处理和日志记录
-- 文件信息构建
-- 重定向处理
-- 代理支持
-- Header管理（批量设置、清空等）
-
-## 限制说明
-
-1. **JavaScript版本**: 仅支持ES5.1语法（Nashorn引擎限制）
-2. **同步执行**: 所有HTTP请求都是同步的
-3. **内存限制**: 长时间运行可能存在内存泄漏风险
-4. **安全限制**: 无法访问文件系统或执行系统命令
-
-## 相关文档
-
-- [自定义解析器扩展指南](CUSTOM_PARSER_GUIDE.md) - Java自定义解析器扩展
-- [自定义解析器快速开始](CUSTOM_PARSER_QUICKSTART.md) - 快速上手指南
-- [解析器开发文档](README.md) - 解析器开发约定和规范
-
-## 更新日志
-
-- v1.0.0: 初始版本，支持基本的JavaScript解析器功能
-- 支持外部解析器路径配置（系统属性、环境变量）
-- 支持重定向处理（getNoRedirect、getWithRedirect）
-- 支持代理配置（HTTP/SOCKS4/SOCKS5）
-- v1.1.0: 增强HTTP客户端功能
-  - 新增header管理方法：clearHeaders、removeHeader、putHeaders、getHeaders
-  - 新增HTTP请求方法：PUT、DELETE、PATCH
-  - 新增工具方法：URL编码/解码（urlEncode、urlDecode）
-  - 新增超时时间设置：setTimeout
-  - 响应对象增强：bodyBytes、bodySize

parser/doc/README.md

@@ -1,268 +0,0 @@
-# parser 开发文档
-
-面向开发者的解析器实现说明：约定、数据映射、HTTP 调试与示例代码。
-
-- 语言/构建：Java 17 / Maven
-- 关键接口：cn.qaiu.parser.IPanTool（返回 Future<List<FileInfo>>），各站点位于 parser/src/main/java/cn/qaiu/parser/impl
-- 数据模型：cn.qaiu.entity.FileInfo（统一对外文件项）
-- JavaScript解析器：支持使用JavaScript编写自定义解析器，位于 parser/src/main/resources/custom-parsers/
-
----
-
-## 0. 快速调用示例（最小可运行）
-```java
-import cn.qaiu.WebClientVertxInit;
-import cn.qaiu.entity.FileInfo;
-import cn.qaiu.parser.IPanTool;
-import cn.qaiu.parser.ParserCreate;
-import io.vertx.core.Vertx;
-import java.util.List;
-
-public class ParserQuickStart {
-    public static void main(String[] args) {
-        // 1) 初始化 Vert.x（parser 内部 WebClient 依赖它）
-        Vertx vertx = Vertx.vertx();
-        WebClientVertxInit.init(vertx);
-
-        // 2) 从分享链接自动识别网盘类型并创建解析器
-        String shareUrl = "https://www.ilanzou.com/s/xxxx"; // 替换为实际分享链接
-        IPanTool tool = ParserCreate.fromShareUrl(shareUrl)
-                // .setShareLinkInfoPwd("1234") // 如有提取码可设置
-                .createTool();
-
-        // 3) 使用同步方法获取文件列表（推荐）
-        List<FileInfo> files = tool.parseFileListSync();
-        for (FileInfo f : files) {
-            System.out.printf("%s\t%s\t%s\n",
-                f.getFileName(), f.getSizeStr(), f.getParserUrl());
-        }
-
-        // 4) 使用同步方法获取原始解析输出（不同盘实现差异较大，仅供调试）
-        String raw = tool.parseSync();
-        System.out.println("raw: " + (raw == null ? "null" : raw.substring(0, Math.min(raw.length(), 200)) + "..."));
-        
-        // 5) 使用同步方法根据文件ID获取下载链接（可选）
-        if (!files.isEmpty()) {
-            String fileId = files.get(0).getFileId();
-            String downloadUrl = tool.parseByIdSync();
-            System.out.println("文件下载链接: " + downloadUrl);
-        }
-
-        // 6) 生成 parser 短链 path（可用于上层路由聚合显示）
-        String path = ParserCreate.fromShareUrl(shareUrl).genPathSuffix();
-        System.out.println("path suffix: /" + path);
-
-        vertx.close();
-    }
-}
-```
-
-等价用法：已知网盘类型 + shareKey 构造
-```java
-IPanTool tool = ParserCreate.fromType("lz") // 对应 PanDomainTemplate.LZ
-        .shareKey("abcd12")                   // 必填：分享 key
-        .setShareLinkInfoPwd("1234")         // 可选：提取码
-        .createTool();
-// 获取文件列表（使用同步方法）
-List<FileInfo> files = tool.parseFileListSync();
-```
-
-要点：
-- 必须先 WebClientVertxInit.init(Vertx)；未初始化时会直接报错，避免解析器偷偷创建第二个 Vert.x 实例。
-- 支持三种同步方法：
-  - `parseSync()`: 解析单个文件下载链接
-  - `parseFileListSync()`: 解析文件列表
-  - `parseByIdSync()`: 根据文件ID获取下载链接
-- 异步方法仍可用：parse()、parseFileList()、parseById() 返回 Future 对象
-- 生成短链 path：ParserCreate.genPathSuffix()（用于页面/服务端聚合）。
-
-## JavaScript解析器快速开始
-
-除了Java解析器，还支持使用JavaScript编写自定义解析器：
-
-### 1. 创建JavaScript解析器
-
-在 `parser/src/main/resources/custom-parsers/` 目录下创建 `.js` 文件：
-
-```javascript
-// ==UserScript==
-// @name         我的解析器
-// @type         my_parser
-// @displayName  我的网盘
-// @description  使用JavaScript实现的网盘解析器
-// @match        https?://example\.com/s/(?<KEY>\w+)
-// @author       yourname
-// @version      1.0.0
-// ==/UserScript==
-
-/**
- * 解析单个文件下载链接
- * @param {ShareLinkInfo} shareLinkInfo - 分享链接信息
- * @param {JsHttpClient} http - HTTP客户端
- * @param {JsLogger} logger - 日志对象
- * @returns {string} 下载链接
- */
-function parse(shareLinkInfo, http, logger) {
-    var url = shareLinkInfo.getShareUrl();
-    var response = http.get(url);
-    return response.body();
-}
-```
-
-### 2. JavaScript解析器特性
-
-- **重定向处理**：支持`getNoRedirect()`方法获取302重定向的真实链接
-- **代理支持**：自动支持HTTP/SOCKS代理配置
-- **类型提示**：提供完整的JSDoc类型定义
-- **热加载**：修改后重启应用即可生效
-
-### 3. 详细文档
-
-- **[JavaScript解析器开发指南](JAVASCRIPT_PARSER_GUIDE.md)** - 完整的JavaScript解析器开发文档，包含API参考、示例代码和最佳实践
-- **[自定义解析器扩展指南](CUSTOM_PARSER_GUIDE.md)** - Java自定义解析器扩展完整指南
-- **[自定义解析器快速开始](CUSTOM_PARSER_QUICKSTART.md)** - 快速上手自定义解析器开发
-
----
-
-## 1. 解析器约定
-- 输入：目标分享/目录页或接口的上下文（通常在实现类构造或初始化时已注入必要参数，如 shareKey、cookie、headers）。
-- 输出：Future<List<FileInfo>>（文件/目录混合列表，必要时区分 file/folder）。
-- 错误：失败场景通过 Future 失败或返回空列表；日志由上层统一处理。
-- 并发：尽量使用 Vert.x Web Client 异步请求；注意限流与重试策略由实现类自定。
-
-FileInfo 关键字段（节选）：
-- fileId：唯一标识
-- fileName：展示名（建议带扩展名，如 basename）
-- fileType：如 "file"/"folder" 或 mime（实现自定，保持一致即可）
-- size（Long, 字节）/ sizeStr（原文字符串）
-- createTime / updateTime：格式 yyyy-MM-dd HH:mm:ss（如源为时间戳或 yyyy-MM-dd 需转）
-- parserUrl：非直连下载的中间链接或协议占位（如 BilPan://）
-- filePath / previewUrl / extParameters：按需补充
-
-工具类：
-- FileSizeConverter：字符串容量转字节、字节转可读容量
-
----
-
-## 2. 文件列表解析规范
-
-### 通用解析原则
-
-1. **数据结构识别**：根据网盘API响应结构确定文件列表的路径
-2. **字段映射**：将网盘特定字段映射到统一的`FileInfo`对象
-3. **类型区分**：正确识别文件和文件夹类型
-4. **数据转换**：处理时间格式、文件大小等数据格式转换
-
-### FileInfo字段映射指南
-
-| FileInfo字段 | 说明 | 映射建议 |
-|-------------|------|----------|
-| `fileName` | 文件名 | 优先使用文件名字段，无则使用标题字段 |
-| `fileId` | 文件ID | 使用网盘提供的唯一标识符 |
-| `fileType` | 文件类型 | "file"或"folder" |
-| `size` | 文件大小(字节) | 转换为字节数，文件夹可为0 |
-| `sizeStr` | 文件大小(可读) | 保持网盘原始格式或转换 |
-| `createTime` | 创建时间 | 统一时间格式 |
-| `updateTime` | 更新时间 | 统一时间格式 |
-| `parserUrl` | 下载链接 | 网盘提供的下载URL |
-| `previewUrl` | 预览链接 | 可选，网盘提供的预览URL |
-
-### 常见数据转换
-
-- **文件大小**：使用`FileSizeConverter`进行字符串与字节数转换
-- **时间格式**：统一转换为标准时间格式
-- **文件类型**：根据网盘API判断文件/文件夹类型
-
-### 解析注意事项
-
-- **数据验证**：检查必要字段是否存在，避免空指针异常
-- **格式兼容**：处理不同网盘的数据格式差异
-- **错误处理**：转换失败时提供合理的默认值
-- **扩展字段**：额外信息可存储在`extParameters`中
-
-### 解析示例
-
-```java
-// 通用解析模式示例
-JsonObject root = response.json(); // 获取API响应
-JsonArray fileList = root.getJsonArray("files"); // 根据实际API调整路径
-List<FileInfo> result = new ArrayList<>();
-
-for (JsonObject item : fileList) {
-    FileInfo fileInfo = new FileInfo();
-    
-    // 基本字段映射
-    fileInfo.setFileName(item.getString("name"));
-    fileInfo.setFileId(item.getString("id"));
-    fileInfo.setFileType(item.getString("type").equals("file") ? "file" : "folder");
-    
-    // 文件大小处理
-    String sizeStr = item.getString("size");
-    if (sizeStr != null) {
-        fileInfo.setSizeStr(sizeStr);
-        try {
-            fileInfo.setSize(FileSizeConverter.convertToBytes(sizeStr));
-        } catch (Exception e) {
-            // 转换失败时保持sizeStr，size为0
-        }
-    }
-    
-    // 时间处理
-    fileInfo.setCreateTime(formatTime(item.getString("createTime")));
-    fileInfo.setUpdateTime(formatTime(item.getString("updateTime")));
-    
-    // 下载链接
-    fileInfo.setParserUrl(item.getString("downloadUrl"));
-    
-    result.add(fileInfo);
-}
-```
-
-### JavaScript解析器示例
-
-```javascript
-function parseFileList(shareLinkInfo, http, logger) {
-    var response = http.get(shareLinkInfo.getShareUrl());
-    var data = response.json();
-    
-    var fileList = [];
-    var files = data.files || data.data || data.items; // 根据实际API调整
-    
-    for (var i = 0; i < files.length; i++) {
-        var file = files[i];
-        var fileInfo = {
-            fileName: file.name || file.title,
-            fileId: file.id,
-            fileType: file.type === "file" ? "file" : "folder",
-            size: file.size || 0,
-            sizeStr: file.sizeStr || formatSize(file.size),
-            createTime: file.createTime,
-            updateTime: file.updateTime,
-            parserUrl: file.downloadUrl || file.url
-        };
-        
-        fileList.push(fileInfo);
-    }
-    
-    return fileList;
-}
-```
-
----
-
-## 3. 开发流程建议
-- 新增站点：在 impl 下新增 Tool，实现 IPanTool，复用 PanBase/模板类；补充单测。
-- 字段不全：尽量回填 sizeStr/createTime 等便于前端展示；不可用字段置空。
-- 单测：放置于 parser/src/test/java，尽量添加 1-2 个 happy path + 1 个边界用例。
-
-## 4. 常见问题
-- 容量解析失败：保留 sizeStr，并忽略 size；避免抛出异常影响整体列表。
-- 协议占位下载链接：统一放至 parserUrl，直链转换由下载阶段处理。
-- 鉴权：Cookie/Token 过期问题由上层刷新或外部注入处理；解析器保持无状态最佳。
-
----
-
-## 5. 参考
-- FileInfo：parser/src/main/java/cn/qaiu/entity/FileInfo.java
-- IPanTool：parser/src/main/java/cn/qaiu/parser/IPanTool.java
-- FileSizeConverter：parser/src/main/java/cn/qaiu/util/FileSizeConverter.java

parser/doc/SECURITY_TESTING_GUIDE.md

@@ -1,464 +0,0 @@
-# JavaScript执行器安全测试指南
-
-## 概述
-
-本文档提供了一套完整的安全测试用例，用于验证JavaScript演练场执行器的安全性。这些测试旨在检测潜在的安全漏洞，包括但不限于：
-
-- 系统命令执行
-- 文件系统访问
-- 反射攻击
-- 网络攻击 (SSRF)
-- JVM退出
-- DOS攻击
-- 内存溢出
-
-## ⚠️ 重要警告
-
-**这些测试用例包含危险代码，仅用于安全测试目的！**
-
-- ❌ 不要在生产环境执行这些测试
-- ❌ 不要将这些代码暴露给未授权用户
-- ✅ 仅在隔离的测试环境中执行
-- ✅ 执行前确保有完整的系统备份
-
-## 测试方式
-
-### 方式1: JUnit单元测试
-
-使用提供的JUnit测试类 `SecurityTest.java`：
-
-```bash
-cd parser
-mvn test -Dtest=SecurityTest
-```
-
-### 方式2: HTTP接口测试
-
-使用提供的HTTP测试文件 `playground-security-tests.http`：
-
-1. 启动应用服务器
-2. 在IDE中打开 `web-service/src/test/resources/playground-security-tests.http`
-3. 逐个执行测试用例
-
-或使用curl命令：
-
-```bash
-curl -X POST http://localhost:9000/v2/playground/test \
-  -H "Content-Type: application/json" \
-  -d @test-case.json
-```
-
-## 测试用例说明
-
-### 1. 系统命令执行测试 🔴 高危
-
-**测试目标**: 验证是否能通过Java的Runtime或ProcessBuilder执行系统命令
-
-**危险级别**: ⚠️⚠️⚠️ 极高
-
-**测试内容**:
-- 尝试使用 `Runtime.getRuntime().exec()` 执行shell命令
-- 尝试使用 `ProcessBuilder` 执行系统命令
-- 尝试读取命令执行结果
-
-**预期结果**: 
-- ✅ **安全**: 无法访问 `Java.type()` 或相关类
-- ❌ **危险**: 成功执行系统命令
-
-**示例攻击**:
-```javascript
-var Runtime = Java.type('java.lang.Runtime');
-var process = Runtime.getRuntime().exec('whoami');
-```
-
----
-
-### 2. 文件系统访问测试 🔴 高危
-
-**测试目标**: 验证是否能读写本地文件系统
-
-**危险级别**: ⚠️⚠️⚠️ 极高
-
-**测试内容**:
-- 尝试读取敏感文件 (`/etc/passwd`, 数据库文件等)
-- 尝试写入文件到系统目录
-- 尝试删除文件
-
-**预期结果**:
-- ✅ **安全**: 无法访问文件系统API
-- ❌ **危险**: 成功读写文件
-
-**示例攻击**:
-```javascript
-var Files = Java.type('java.nio.file.Files');
-var content = Files.readAllLines(Paths.get('/etc/passwd'));
-```
-
----
-
-### 3. 系统属性访问测试 🟡 中危
-
-**测试目标**: 验证是否能访问系统属性和环境变量
-
-**危险级别**: ⚠️⚠️ 高
-
-**测试内容**:
-- 读取系统属性 (`user.home`, `user.name`, `java.version`)
-- 读取环境变量 (`PATH`, `JAVA_HOME`, API密钥等)
-- 修改系统属性
-
-**预期结果**:
-- ✅ **安全**: 无法访问System类
-- ❌ **危险**: 成功获取敏感信息
-
-**潜在风险**: 可能泄露系统配置、用户信息、API密钥等敏感数据
-
----
-
-### 4. 反射攻击测试 🔴 高危
-
-**测试目标**: 验证是否能通过反射绕过访问控制
-
-**危险级别**: ⚠️⚠️⚠️ 极高
-
-**测试内容**:
-- 使用 `Class.forName()` 加载任意类
-- 通过反射调用私有方法
-- 修改final字段
-- 获取ClassLoader
-
-**预期结果**:
-- ✅ **安全**: 无法使用反射API
-- ❌ **危险**: 成功绕过访问控制
-
-**示例攻击**:
-```javascript
-var Class = Java.type('java.lang.Class');
-var systemClass = Class.forName('java.lang.System');
-var methods = systemClass.getDeclaredMethods();
-```
-
----
-
-### 5. 网络Socket攻击测试 🔴 高危
-
-**测试目标**: 验证是否能创建任意网络连接
-
-**危险级别**: ⚠️⚠️⚠️ 极高
-
-**测试内容**:
-- 创建Socket连接到任意主机
-- 使用URL/URLConnection访问任意地址
-- 端口扫描
-
-**预期结果**:
-- ✅ **安全**: 无法创建网络连接
-- ❌ **危险**: 可以连接任意主机端口
-
-**潜在风险**: 可用于端口扫描、内网渗透、绕过防火墙
-
----
-
-### 6. JVM退出攻击测试 🔴 高危
-
-**测试目标**: 验证是否能终止JVM进程
-
-**危险级别**: ⚠️⚠️⚠️ 极高
-
-**测试内容**:
-- 调用 `System.exit()`
-- 调用 `Runtime.halt()`
-- 触发致命错误
-
-**预期结果**:
-- ✅ **安全**: 无法退出JVM
-- ❌ **危险**: 成功终止应用
-
-**影响**: 导致整个应用崩溃，拒绝服务
-
----
-
-### 7. HTTP客户端SSRF测试 🟡 中危
-
-**测试目标**: 验证注入的httpClient是否可被滥用
-
-**危险级别**: ⚠️⚠️ 高
-
-**测试内容**:
-- 访问内网地址 (127.0.0.1, 192.168.x.x, 10.x.x.x)
-- 访问云服务元数据API (169.254.169.254)
-- 访问本地服务端口
-- 访问管理后台
-
-**预期结果**:
-- ✅ **最佳**: HTTP客户端有白名单限制
-- ⚠️ **可接受**: 可以访问外网但不能访问内网
-- ❌ **危险**: 可以访问任意地址包括内网
-
-**潜在风险**: SSRF攻击、内网信息泄露、云服务凭证窃取
-
----
-
-### 8. 对象滥用测试 🟡 中危
-
-**测试目标**: 验证注入的Java对象是否可被反射访问
-
-**危险级别**: ⚠️⚠️ 高
-
-**测试内容**:
-- 通过反射访问注入对象的私有字段
-- 调用对象的非公开方法
-- 修改对象内部状态
-
-**预期结果**:
-- ✅ **安全**: 无法通过反射访问对象
-- ⚠️ **可接受**: 只能访问公开API
-- ❌ **危险**: 可以访问和修改内部状态
-
----
-
-### 9. DOS攻击测试 🟡 中危
-
-**测试目标**: 验证是否存在执行时间限制
-
-**危险级别**: ⚠️⚠️ 高
-
-**测试内容**:
-- 无限循环
-- 长时间计算
-- 递归调用
-
-**预期结果**:
-- ✅ **安全**: 有超时机制，自动中断执行
-- ❌ **危险**: 可以无限执行
-
-**影响**: 消耗CPU资源，导致服务响应缓慢或拒绝服务
-
----
-
-### 10. 内存溢出测试 🟡 中危
-
-**测试目标**: 验证是否存在内存使用限制
-
-**危险级别**: ⚠️⚠️ 高
-
-**测试内容**:
-- 创建大量对象
-- 分配大数组
-- 递归创建深层对象
-
-**预期结果**:
-- ✅ **安全**: 有内存限制，防止OOM
-- ❌ **危险**: 可以无限分配内存
-
-**影响**: 导致内存溢出，应用崩溃
-
----
-
-## 安全建议
-
-### 当前Nashorn引擎的安全问题
-
-Nashorn引擎默认允许JavaScript访问所有Java类，这是一个严重的安全隐患。以下是建议的安全措施：
-
-### 1. 使用ClassFilter限制类访问 🔒 必须
-
-```java
-import jdk.nashorn.api.scripting.ClassFilter;
-import jdk.nashorn.api.scripting.NashornScriptEngineFactory;
-
-public class SecurityClassFilter implements ClassFilter {
-    @Override
-    public boolean exposeToScripts(String className) {
-        // 黑名单：禁止访问危险类
-        if (className.startsWith("java.lang.Runtime") ||
-            className.startsWith("java.lang.ProcessBuilder") ||
-            className.startsWith("java.io.File") ||
-            className.startsWith("java.nio.file") ||
-            className.startsWith("java.lang.System") ||
-            className.startsWith("java.lang.Class") ||
-            className.startsWith("java.lang.reflect") ||
-            className.startsWith("java.net.Socket") ||
-            className.startsWith("java.net.URL")) {
-            return false;
-        }
-        
-        // 白名单：只允许特定的类
-        // return className.startsWith("允许的包名");
-        
-        return false; // 默认拒绝所有
-    }
-}
-
-// 使用ClassFilter创建引擎
-NashornScriptEngineFactory factory = new NashornScriptEngineFactory();
-ScriptEngine engine = factory.getScriptEngine(new SecurityClassFilter());
-```
-
-### 2. 设置执行超时 ⏱️ 强烈推荐
-
-```java
-// 使用Future + timeout
-Future<?> future = executor.submit(() -> {
-    engine.eval(jsCode);
-});
-
-try {
-    future.get(30, TimeUnit.SECONDS); // 30秒超时
-} catch (TimeoutException e) {
-    future.cancel(true);
-    throw new RuntimeException("脚本执行超时");
-}
-```
-
-### 3. 限制内存使用 💾 推荐
-
-```java
-// 在Worker线程中执行，限制堆大小
-// 启动参数: -Xmx512m
-```
-
-### 4. 沙箱隔离 🏝️ 强烈推荐
-
-考虑使用以下方案：
-
-- **GraalVM JavaScript**: 更安全的JavaScript引擎，支持沙箱
-- **Docker容器隔离**: 在容器中执行不信任的代码
-- **Java SecurityManager**: 配置安全策略文件
-
-### 5. HTTP客户端访问控制 🌐 必须
-
-```java
-// 在JsHttpClient中添加URL验证
-private boolean isAllowedUrl(String url) {
-    // 禁止访问内网地址
-    if (url.matches(".*\\b(127\\.0\\.0\\.1|localhost|192\\.168\\.|10\\.|172\\.(1[6-9]|2[0-9]|3[01])\\.).*")) {
-        return false;
-    }
-    
-    // 禁止访问云服务元数据
-    if (url.contains("169.254.169.254")) {
-        return false;
-    }
-    
-    // 白名单检查
-    // return allowedDomains.contains(getDomain(url));
-    
-    return true;
-}
-```
-
-### 6. 输入验证 ✅ 必须
-
-```java
-// 验证JavaScript代码
-private void validateJsCode(String jsCode) {
-    // 检查代码长度
-    if (jsCode.length() > 100000) {
-        throw new IllegalArgumentException("代码过长");
-    }
-    
-    // 检查危险关键词
-    List<String> dangerousKeywords = Arrays.asList(
-        "Java.type",
-        "getClass",
-        "getRuntime",
-        "exec(",
-        "ProcessBuilder",
-        "System.exit",
-        "Runtime.halt"
-    );
-    
-    for (String keyword : dangerousKeywords) {
-        if (jsCode.contains(keyword)) {
-            throw new SecurityException("代码包含危险操作: " + keyword);
-        }
-    }
-}
-```
-
-### 7. 监控和日志 📊 必须
-
-```java
-// 记录所有执行的脚本
-log.info("执行脚本 - 用户: {}, IP: {}, 代码哈希: {}", 
-    userId, clientIp, DigestUtils.md5Hex(jsCode));
-
-// 监控异常行为
-if (executionTime > 10000) {
-    log.warn("脚本执行时间过长: {}ms", executionTime);
-}
-```
-
-### 8. 迁移到GraalVM 🚀 长期建议
-
-Nashorn已在JDK 15中废弃，建议迁移到GraalVM JavaScript：
-
-```xml
-<dependency>
-    <groupId>org.graalvm.js</groupId>
-    <artifactId>js</artifactId>
-    <version>23.0.0</version>
-</dependency>
-```
-
-GraalVM提供更好的安全性和性能：
-- 默认沙箱隔离
-- 无法访问Java类（除非显式允许）
-- 更好的性能
-- 活跃维护
-
-## 测试检查清单
-
-执行安全测试时，请确认以下检查项：
-
-- [ ] 测试1: 系统命令执行 - 应该**失败**
-- [ ] 测试2: 文件系统访问 - 应该**失败**
-- [ ] 测试3: 系统属性访问 - 应该**失败**
-- [ ] 测试4: 反射攻击 - 应该**失败**
-- [ ] 测试5: 网络Socket - 应该**失败**
-- [ ] 测试6: JVM退出 - 应该**失败**
-- [ ] 测试7: SSRF攻击 - 应该**部分失败**（禁止内网访问）
-- [ ] 测试8: 对象滥用 - 应该**部分失败**（只能访问公开API）
-- [ ] 测试9: DOS攻击 - 应该**超时中断**
-- [ ] 测试10: 内存溢出 - 应该**抛出OOM或限制**
-
-## 安全评估标准
-
-### 🟢 安全 (A级)
-- 所有高危测试都失败
-- 有完善的ClassFilter
-- 有超时和内存限制
-- HTTP客户端有访问控制
-
-### 🟡 基本安全 (B级)
-- 大部分高危测试失败
-- 无法执行系统命令和文件操作
-- 有部分访问控制
-
-### 🟠 存在风险 (C级)
-- 某些中危测试通过
-- 缺少超时或内存限制
-- HTTP客户端无限制
-
-### 🔴 严重不安全 (D级)
-- 高危测试通过
-- 可以执行系统命令
-- 可以读写文件系统
-- **不应在生产环境使用**
-
-## 参考资料
-
-- [OWASP - Server Side Request Forgery](https://owasp.org/www-community/attacks/Server_Side_Request_Forgery)
-- [Nashorn Security Guide](https://docs.oracle.com/javase/8/docs/technotes/guides/scripting/nashorn/security.html)
-- [GraalVM JavaScript Security](https://www.graalvm.org/latest/security-guide/polyglot-sandbox/)
-- [Java SecurityManager Documentation](https://docs.oracle.com/javase/tutorial/essential/environment/security.html)
-
-## 联系方式
-
-如果发现新的安全漏洞，请通过安全渠道报告，不要公开披露。
-
----
-
-**免责声明**: 本文档仅用于安全测试和教育目的。任何人使用这些测试用例造成的损害，作者概不负责。
-

parser/doc/auth-param/AUTH_PARAM_GUIDE.md

@@ -1,341 +0,0 @@
-# 认证参数传递指南 (Auth Parameter Guide)
-
-## 概述
-
-本文档描述了网盘解析接口中携带认证参数的方法。通过 `auth` 参数，可以在解析请求时传递临时认证信息（如 Cookie、Token、用户名密码等），使解析器能够访问需要登录或授权的网盘资源。
-
-## 网盘认证要求
-
-| 网盘 | 类型代码 | 认证要求 | 说明 |
-|------|---------|---------|------|
-| 夸克网盘 | QK | **必须** | 必须配置 Cookie 才能解析和下载 |
-| UC网盘 | UC | **必须** | 必须配置 Cookie 才能解析和下载 |
-| 小飞机网盘 | FJ | 可选 | 大文件（>100MB）需要配置认证信息 |
-| 蓝奏优享 | IZ | 可选 | 大文件需要配置认证信息 |
-| 其他网盘 | - | 不需要 | 无需认证即可解析 |
-
-> 💡 **如何获取 Cookie**: 在浏览器中登录对应网盘，打开开发者工具（F12），切换到 Network 标签，刷新页面，在请求头中找到 Cookie 字段并复制完整内容。
-
-## 认证参数格式
-
-### 编码流程
-
-```
-JSON对象 → AES加密 → Base64编码 → URL编码
-```
-
-### 解码流程
-
-```
-URL解码 → Base64解码 → AES解密 → JSON对象
-```
-
-### 加密配置
-
-- **加密算法**: AES/ECB/PKCS5Padding
-- **密钥长度**: 16位（128位）
-- **默认密钥**: `nfd_auth_key2026`（可在 `app-dev.yml` 中通过 `server.authEncryptKey` 配置）
-
-### 密钥作用说明（重要）
-
-当前系统中涉及两类不同用途的密钥：
-
-1. `server.authEncryptKey`
-   - 用途：加解密 `auth` 参数（前端/调用方传入的认证信息）
-   - 影响范围：`/parser`、`/json/parser`、`/v2/linkInfo` 等接口中的 `auth` 参数
-   - 注意：这是 **AES 对称加密密钥**，要求 16 位
-
-2. `server.donatedAccountFailureTokenSignKey`
-   - 用途：签名和验签“捐赠账号失败计数 token”（用于防伪造、失败计数）
-   - 影响范围：捐赠账号失败计数与自动失效逻辑
-   - 注意：这是 **HMAC 签名密钥**，与 `authEncryptKey` 已解耦，建议使用高强度随机字符串
-
-> 建议：生产环境务必同时自定义这两个密钥，且不要设置为相同值。
-
-## JSON 模型定义
-
-### AuthParam 对象
-
-```json
-{
-  "authType": "string",     // 认证类型（必填）
-  "username": "string",     // 用户名
-  "password": "string",     // 密码
-  "token": "string",        // Token/AccessToken/Cookie值
-  "cookie": "string",       // Cookie 字符串
-  "auth": "string",         // Authorization 头内容
-  "ext1": "string",         // 扩展字段1（格式: key:value）
-  "ext2": "string",         // 扩展字段2（格式: key:value）
-  "ext3": "string",         // 扩展字段3（格式: key:value）
-  "ext4": "string",         // 扩展字段4（格式: key:value）
-  "ext5": "string"          // 扩展字段5（格式: key:value）
-}
-```
-
-### 认证类型 (authType)
-
-| authType | 说明 | 主要字段 |
-|----------|------|---------|
-| `accesstoken` | 使用 AccessToken 认证 | `token` |
-| `cookie` | 使用 Cookie 认证 | `token` (存放 cookie 值) |
-| `authorization` | 使用 Authorization 头认证 | `token` |
-| `password` / `username_password` | 用户名密码认证 | `username`, `password` |
-| `custom` | 自定义认证（使用扩展字段） | `token`, `ext1`-`ext5` |
-
-### 示例 JSON
-
-#### 1. Token 认证
-```json
-{
-  "authType": "accesstoken",
-  "token": "your_access_token_here"
-}
-```
-
-#### 2. Cookie 认证
-```json
-{
-  "authType": "cookie",
-  "token": "session_id=abc123; user_token=xyz789"
-}
-```
-
-#### 3. 用户名密码认证
-```json
-{
-  "authType": "password",
-  "username": "your_username",
-  "password": "your_password"
-}
-```
-
-#### 4. 自定义认证
-```json
-{
-  "authType": "custom",
-  "token": "main_token",
-  "ext1": "refresh_token:your_refresh_token",
-  "ext2": "device_id:device123"
-}
-```
-
-## 接口调用示例
-
-### 基础接口
-
-#### 1. 解析并重定向 (GET /parser)
-
-```
-GET /parser?url={分享链接}&pwd={提取码}&auth={加密认证参数}
-```
-
-**参数说明:**
-- `url`: 网盘分享链接（必填）
-- `pwd`: 提取码（可选）
-- `auth`: 加密后的认证参数（可选）
-
-**响应:** 302 重定向到直链
-
-#### 2. 解析返回 JSON (GET /json/parser)
-
-```
-GET /json/parser?url={分享链接}&pwd={提取码}&auth={加密认证参数}
-```
-
-**响应示例:**
-```json
-{
-  "shareKey": "lz:xxxx",
-  "directLink": "https://...",
-  "cacheHit": false,
-  "expires": "2026-02-05 12:00:00",
-  "expiration": 1738728000000
-}
-```
-
-#### 3. 获取链接信息 (GET /v2/linkInfo)
-
-```
-GET /v2/linkInfo?url={分享链接}&pwd={提取码}&auth={加密认证参数}
-```
-
-**响应:** 返回下载链接、API 链接、预览链接等信息
-
-## 各语言加密示例
-
-### Java
-
-```java
-import cn.qaiu.lz.common.util.AuthParamCodec;
-import cn.qaiu.lz.web.model.AuthParam;
-
-// 方式1: 使用 AuthParam 对象
-AuthParam authParam = AuthParam.builder()
-    .authType("accesstoken")
-    .token("your_token_here")
-    .build();
-String encrypted = AuthParamCodec.encode(authParam);
-
-// 方式2: 快速编码
-String encrypted = AuthParamCodec.quickEncode("accesstoken", "your_token_here");
-
-// 方式3: 用户名密码
-String encrypted = AuthParamCodec.quickEncodePassword("username", "password");
-
-// 解码
-AuthParam decoded = AuthParamCodec.decode(encrypted);
-```
-
-### JavaScript (浏览器/Node.js)
-
-```javascript
-// 使用 CryptoJS 库
-const CryptoJS = require('crypto-js');
-
-const AUTH_KEY = 'nfd_auth_key2026';
-
-// 加密
-function encodeAuthParam(authObj) {
-    const jsonStr = JSON.stringify(authObj);
-    const encrypted = CryptoJS.AES.encrypt(jsonStr, CryptoJS.enc.Utf8.parse(AUTH_KEY), {
-        mode: CryptoJS.mode.ECB,
-        padding: CryptoJS.pad.Pkcs7
-    });
-    const base64 = encrypted.toString();
-    return encodeURIComponent(base64);
-}
-
-// 解密
-function decodeAuthParam(encryptedAuth) {
-    const base64 = decodeURIComponent(encryptedAuth);
-    const decrypted = CryptoJS.AES.decrypt(base64, CryptoJS.enc.Utf8.parse(AUTH_KEY), {
-        mode: CryptoJS.mode.ECB,
-        padding: CryptoJS.pad.Pkcs7
-    });
-    return JSON.parse(decrypted.toString(CryptoJS.enc.Utf8));
-}
-
-// 使用示例
-const auth = encodeAuthParam({
-    authType: 'accesstoken',
-    token: 'your_token_here'
-});
-const url = `http://127.0.0.1:6400/parser?url=${shareUrl}&auth=${auth}`;
-```
-
-### Python
-
-```python
-import json
-import base64
-from urllib.parse import quote, unquote
-from Crypto.Cipher import AES
-from Crypto.Util.Padding import pad, unpad
-
-AUTH_KEY = b'nfd_auth_key2026'
-
-def encode_auth_param(auth_obj):
-    """加密认证参数"""
-    json_str = json.dumps(auth_obj, ensure_ascii=False)
-    cipher = AES.new(AUTH_KEY, AES.MODE_ECB)
-    padded = pad(json_str.encode('utf-8'), AES.block_size)
-    encrypted = cipher.encrypt(padded)
-    base64_str = base64.b64encode(encrypted).decode('utf-8')
-    return quote(base64_str)
-
-def decode_auth_param(encrypted_auth):
-    """解密认证参数"""
-    base64_str = unquote(encrypted_auth)
-    encrypted = base64.b64decode(base64_str)
-    cipher = AES.new(AUTH_KEY, AES.MODE_ECB)
-    decrypted = unpad(cipher.decrypt(encrypted), AES.block_size)
-    return json.loads(decrypted.decode('utf-8'))
-
-# 使用示例
-auth = encode_auth_param({
-    'authType': 'accesstoken',
-    'token': 'your_token_here'
-})
-url = f'http://127.0.0.1:6400/parser?url={share_url}&auth={auth}'
-```
-
-### cURL 命令行
-
-```bash
-# 假设已加密的 auth 参数为 ENCRYPTED_AUTH
-curl -L "http://127.0.0.1:6400/parser?url=https://www.lanzoux.com/xxxx&auth=ENCRYPTED_AUTH"
-
-# 获取 JSON 响应
-curl "http://127.0.0.1:6400/json/parser?url=https://www.lanzoux.com/xxxx&auth=ENCRYPTED_AUTH"
-```
-
-## 解析器使用认证信息
-
-解析器可以从 `shareLinkInfo.otherParam.get("auths")` 获取 MultiMap 格式的认证信息：
-
-```java
-// 在解析器中获取认证信息
-MultiMap auths = (MultiMap) shareLinkInfo.getOtherParam().get("auths");
-
-if (auths != null) {
-    String authType = auths.get("authType");
-    String token = auths.get("token");
-    String username = auths.get("username");
-    String password = auths.get("password");
-    
-    // 根据 authType 使用相应的认证方式
-    switch (authType) {
-        case "accesstoken":
-            // 使用 token 认证
-            break;
-        case "password":
-            // 使用用户名密码登录
-            break;
-        // ...
-    }
-}
-```
-
-## 注意事项
-
-1. **安全性**: 
-   - 不要在日志中打印完整的认证参数
-   - 认证参数通过 HTTPS 传输更安全
-   - 密钥应妥善保管，建议在生产环境中更换默认密钥
-
-2. **缓存策略**:
-   - 带有临时认证参数的请求目前不会被缓存
-   - 每次请求都会重新解析
-
-3. **兼容性**:
-   - `auth` 参数与原有的 `pwd` 参数可以同时使用
-   - 不提供 `auth` 参数时，使用后台配置的认证信息
-
-4. **扩展字段**:
-   - `ext1`-`ext5` 使用 `key:value` 格式
-   - 适用于需要传递多个自定义参数的场景
-
-## 配置说明
-
-在 `app-dev.yml` 中配置密钥：
-
-```yaml
-server:
-  # auth参数加密密钥（16位AES密钥）
-  authEncryptKey: 'your_custom_key16'
-
-  # 捐赠账号失败计数token签名密钥（HMAC）
-  # 建议使用较长随机字符串，并与 authEncryptKey 不同
-  donatedAccountFailureTokenSignKey: 'your_random_hmac_sign_key'
-```
-
-### 密钥管理建议
-
-- 不要在公开仓库提交生产密钥
-- 建议通过环境变量或私有配置注入
-- 调整 `authEncryptKey` 会影响 `auth` 参数兼容性
-- 调整 `donatedAccountFailureTokenSignKey` 会使已签发的失败计数 token 失效（短期可接受）
-
-## 更新日志
-
-- **2026-02-05**: 初始版本，支持 accesstoken、cookie、password、custom 认证类型

parser/doc/auth-param/AUTH_PARAM_GUIDE_SIMPLE.md

@@ -1,118 +0,0 @@
-# 认证参数传递指南 (简化版)
-
-## JSON 对象模型
-
-### AuthParam 对象
-
-```json
-{
-  "authType": "string",     // 认证类型（必填）
-  "username": "string",     // 用户名
-  "password": "string",     // 密码
-  "token": "string",        // Token/AccessToken/Cookie值
-  "cookie": "string",       // Cookie 字符串
-  "auth": "string",         // Authorization 头内容
-  "ext1": "string",         // 扩展字段1（格式: key:value）
-  "ext2": "string",         // 扩展字段2（格式: key:value）
-  "ext3": "string",         // 扩展字段3（格式: key:value）
-  "ext4": "string",         // 扩展字段4（格式: key:value）
-  "ext5": "string"          // 扩展字段5（格式: key:value）
-}
-```
-
-## 认证类型
-
-| authType | 说明 | 主要字段 |
-|----------|------|---------|
-| `accesstoken` | AccessToken 认证 | `token` |
-| `cookie` | Cookie 认证 | `token` |
-| `authorization` | Authorization 头认证 | `token` |
-| `password` | 用户名密码认证 | `username`, `password` |
-| `custom` | 自定义认证 | `token`, `ext1`-`ext5` |
-
-## 示例
-
-### Token 认证
-```json
-{
-  "authType": "accesstoken",
-  "token": "your_access_token_here"
-}
-```
-
-### Cookie 认证
-```json
-{
-  "authType": "cookie",
-  "token": "session_id=abc123; user_token=xyz789"
-}
-```
-
-### 用户名密码
-```json
-{
-  "authType": "password",
-  "username": "your_username",
-  "password": "your_password"
-}
-```
-
-### 自定义认证
-```json
-{
-  "authType": "custom",
-  "token": "main_token",
-  "ext1": "refresh_token:your_refresh_token",
-  "ext2": "device_id:device123"
-}
-```
-
-## 使用说明
-
-1. **编码流程**: JSON对象 → AES加密 → Base64编码 → URL编码
-2. **加密配置**: AES/ECB/PKCS5Padding, 密钥: `nfd_auth_key2026` (16位)
-3. **接口调用**: `GET /parser?url={分享链接}&pwd={提取码}&auth={加密认证参数}`
-
-
-
-## 接口调用示例
-
-### 基础接口
-
-#### 1. 解析并重定向 (GET /parser)
-
-```
-GET /parser?url={分享链接}&pwd={提取码}&auth={加密认证参数}
-```
-
-**参数说明:**
-- `url`: 网盘分享链接（必填）
-- `pwd`: 提取码（可选）
-- `auth`: 加密后的认证参数（可选）
-
-**响应:** 302 重定向到直链
-
-#### 2. 解析返回 JSON (GET /json/parser)
-
-```
-GET /json/parser?url={分享链接}&pwd={提取码}&auth={加密认证参数}
-```
-
-**响应示例:**
-```json
-{
-  "shareKey": "lz:xxxx",
-  "directLink": "https://...",
-  "cacheHit": false,
-  "expires": "2026-02-05 12:00:00",
-  "expiration": 1738728000000
-}
-```
-
-#### 3. 获取链接信息 (GET /v2/linkInfo)
-
-```
-GET /v2/linkInfo?url={分享链接}&pwd={提取码}&auth={加密认证参数}
-```
-
-**响应:** 返回下载链接、API 链接、预览链接等信息

parser/doc/security/CHANGELOG_SECURITY.md

@@ -1,174 +0,0 @@
-# 安全修复更新日志
-
-## [2025-11-29] - 优化SSRF防护策略
-
-### 🔄 变更内容
-
-#### 调整SSRF防护为宽松模式
-- **问题**: 原有SSRF防护过于严格，导致正常外网请求也被拦截
-- **症状**: `Error: 请求失败: 404` 或其他网络错误
-- **修复**: 调整验证逻辑，只拦截明确的危险请求
-
-#### 具体改进
-
-1. ✅ **允许DNS解析失败的请求**
-   - 之前：DNS解析失败 → 抛出异常
-   - 现在：DNS解析失败 → 允许继续（可能是外网域名）
-
-2. ✅ **允许格式异常的URL**
-   - 之前：URL解析异常 → 抛出异常
-   - 现在：URL解析异常 → 只记录日志，允许继续
-
-3. ✅ **优化IP检测逻辑**
-   - 先检查是否为IP地址格式
-   - 对域名才进行DNS解析
-   - 减少不必要的网络请求
-
-### 🛡️ 保留的安全防护
-
-以下危险请求仍然会被拦截：
-
-- ❌ 本地回环：`127.0.0.1`, `localhost`, `::1`
-- ❌ 内网IP：`192.168.x.x`, `10.x.x.x`, `172.16-31.x.x`
-- ❌ 云服务元数据：`169.254.169.254`, `metadata.google.internal`
-- ❌ 解析到内网的域名
-
-### 📊 影响范围
-
-**修改文件**:
-- `parser/src/main/java/cn/qaiu/parser/customjs/JsHttpClient.java`
-
-**新增文档**:
-- `parser/SSRF_PROTECTION.md` - SSRF防护策略说明
-
----
-
-## [2025-11-28] - 修复JavaScript远程代码执行漏洞
-
-### 🚨 严重安全漏洞修复
-
-#### 漏洞描述
-- **类型**: 远程代码执行 (RCE)
-- **危险级别**: 🔴 极高
-- **影响**: JavaScript可以访问所有Java类，执行任意系统命令
-
-#### 修复措施
-
-1. ✅ **实现ClassFilter类过滤器**
-   - 文件：`SecurityClassFilter.java`
-   - 功能：拦截JavaScript对危险Java类的访问
-   - 黑名单包括：Runtime, File, System, Class, Socket等
-
-2. ✅ **禁用Java内置对象**
-   - 禁用：`Java`, `JavaImporter`, `Packages`
-   - 位置：`JsPlaygroundExecutor`, `JsParserExecutor`
-
-3. ✅ **添加SSRF防护**
-   - 文件：`JsHttpClient.java`
-   - 功能：防止访问内网地址和云服务元数据
-
-4. ✅ **修复ArrayIndexOutOfBoundsException**
-   - 问题：`getScriptEngine()` 方法参数错误
-   - 修复：使用正确的方法签名 `getScriptEngine(new String[0], null, classFilter)`
-
-### 📦 新增文件
-
-**安全组件**:
-- `parser/src/main/java/cn/qaiu/parser/customjs/SecurityClassFilter.java`
-
-**测试套件**:
-- `parser/src/test/java/cn/qaiu/parser/SecurityTest.java` (7个测试用例)
-- `web-service/src/test/resources/playground-security-tests.http` (10个测试用例)
-
-**文档**:
-- `parser/doc/SECURITY_TESTING_GUIDE.md` - 详细安全测试指南
-- `parser/SECURITY_TEST_README.md` - 快速开始指南
-- `parser/SECURITY_FIX_SUMMARY.md` - 修复总结
-- `parser/test-security.sh` - 自动化测试脚本
-- `SECURITY_URGENT_FIX.md` - 紧急修复通知
-- `QUICK_TEST.md` - 快速验证指南
-
-### 🔧 修改文件
-
-1. `JsPlaygroundExecutor.java`
-   - 使用安全的ScriptEngine
-   - 禁用Java对象访问
-
-2. `JsParserExecutor.java`
-   - 使用安全的ScriptEngine
-   - 禁用Java对象访问
-
-3. `JsHttpClient.java`
-   - 添加URL安全验证
-   - 实现SSRF防护
-
-### 📊 修复效果
-
-| 测试项目 | 修复前 | 修复后 |
-|---------|--------|--------|
-| 系统命令执行 | ❌ 成功 | ✅ 被拦截 |
-| 文件系统访问 | ❌ 成功 | ✅ 被拦截 |
-| 系统属性访问 | ❌ 成功 | ✅ 被拦截 |
-| 反射攻击 | ❌ 成功 | ✅ 被拦截 |
-| 网络Socket | ❌ 成功 | ✅ 被拦截 |
-| JVM退出 | ❌ 成功 | ✅ 被拦截 |
-| SSRF攻击 | ❌ 成功 | ✅ 被拦截 |
-
-### 📈 安全评级提升
-
-- **修复前**: 🔴 D级（严重不安全）
-- **修复后**: 🟢 A级（安全）
-
----
-
-## 部署建议
-
-### 立即部署步骤
-
-```bash
-# 1. 拉取最新代码
-git pull
-
-# 2. 重新编译
-mvn clean install
-
-# 3. 重启服务
-./bin/stop.sh
-./bin/run.sh
-
-# 4. 验证修复
-cd parser
-mvn test -Dtest=SecurityTest
-```
-
-### 验证清单
-
-- [ ] 服务启动成功
-- [ ] 日志显示"🔒 安全的JavaScript引擎初始化成功"
-- [ ] Java.type() 被禁用（返回undefined）
-- [ ] 内网访问被拦截
-- [ ] 外网访问正常工作
-- [ ] 安全测试全部通过
-
----
-
-## 相关资源
-
-- **快速验证**: `QUICK_TEST.md`
-- **SSRF策略**: `parser/SSRF_PROTECTION.md`
-- **详细修复**: `parser/SECURITY_FIX_SUMMARY.md`
-- **测试指南**: `parser/doc/SECURITY_TESTING_GUIDE.md`
-
----
-
-## 联系方式
-
-如发现新的安全问题或有改进建议，请通过以下方式反馈：
-- 提交Issue
-- 安全邮件：qaiu00@gmail.com
-
----
-
-**维护者**: QAIU  
-**许可**: MIT License
-

parser/doc/security/DOS_FIX_FINAL.md

@@ -1,214 +0,0 @@
-# ✅ DoS漏洞修复 - 最终版（v3）
-
-## 🎯 核心解决方案
-
-### 问题
-使用Vert.x的WorkerExecutor时，即使创建临时executor，BlockedThreadChecker仍然会监控线程并输出警告日志。
-
-### 解决方案
-**使用独立的Java ExecutorService**，完全脱离Vert.x的监控机制。
-
----
-
-## 🔧 技术实现
-
-### 关键代码
-
-```java
-// 使用独立的Java线程池，不受Vert.x的BlockedThreadChecker监控
-private static final ExecutorService INDEPENDENT_EXECUTOR = Executors.newCachedThreadPool(r -> {
-    Thread thread = new Thread(r);
-    thread.setName("playground-independent-" + System.currentTimeMillis());
-    thread.setDaemon(true); // 设置为守护线程，服务关闭时自动清理
-    return thread;
-});
-
-// 执行时使用CompletableFuture + 独立线程池
-CompletableFuture<String> executionFuture = CompletableFuture.supplyAsync(() -> {
-    // JavaScript执行逻辑
-}, INDEPENDENT_EXECUTOR);
-
-// 添加超时
-executionFuture.orTimeout(30, TimeUnit.SECONDS)
-    .whenComplete((result, error) -> {
-        // 处理结果
-    });
-```
-
----
-
-## ✅ 修复效果
-
-### v1（原始版本）
-- ❌ 使用共享WorkerExecutor
-- ❌ BlockedThreadChecker持续输出警告
-- ❌ 日志每秒滚动
-
-### v2（临时Executor）
-- ⚠️ 使用临时WorkerExecutor
-- ⚠️ 关闭后仍会输出警告（10秒检查周期）
-- ⚠️ 日志仍会滚动一段时间
-
-### v3（独立ExecutorService）✅
-- ✅ 使用独立Java线程池
-- ✅ **完全不受BlockedThreadChecker监控**
-- ✅ **日志不再滚动**
-- ✅ 守护线程，服务关闭时自动清理
-
----
-
-## 📊 对比表
-
-| 特性 | v1 | v2 | v3 ✅ |
-|------|----|----|------|
-| 线程池类型 | Vert.x WorkerExecutor | Vert.x WorkerExecutor | Java ExecutorService |
-| BlockedThreadChecker监控 | ✅ 是 | ✅ 是 | ❌ **否** |
-| 日志滚动 | ❌ 持续 | ⚠️ 一段时间 | ✅ **无** |
-| 超时机制 | ❌ 无 | ✅ 30秒 | ✅ 30秒 |
-| 资源清理 | ❌ 无 | ✅ 手动关闭 | ✅ 守护线程自动清理 |
-
----
-
-## 🧪 测试验证
-
-### 测试无限循环
-```javascript
-while(true) {
-    var x = 1 + 1;
-}
-```
-
-### v3预期行为
-1. ✅ 前端检测到 `while(true)` 弹出警告
-2. ✅ 用户确认后开始执行
-3. ✅ 30秒后返回超时错误
-4. ✅ **日志只输出一次超时错误**
-5. ✅ **不再输出BlockedThreadChecker警告**
-6. ✅ 可以立即执行下一个测试
-
-### 日志输出（v3）
-```
-2025-11-29 16:50:00.000 INFO  -> 开始执行parse方法
-2025-11-29 16:50:30.000 ERROR -> JavaScript执行超时（超过30秒），可能存在无限循环
-... (不再输出任何BlockedThreadChecker警告)
-```
-
----
-
-## 🔍 技术细节
-
-### 为什么独立ExecutorService有效？
-
-1. **BlockedThreadChecker只监控Vert.x管理的线程**
-   - WorkerExecutor是Vert.x管理的
-   - ExecutorService是标准Java线程池
-   - BlockedThreadChecker不监控标准Java线程
-
-2. **守护线程自动清理**
-   - `setDaemon(true)` 确保JVM关闭时线程自动结束
-   - 不需要手动管理线程生命周期
-
-3. **CachedThreadPool特性**
-   - 自动创建和回收线程
-   - 空闲线程60秒后自动回收
-   - 适合临时任务执行
-
----
-
-## 📝 修改的文件
-
-### `JsPlaygroundExecutor.java`
-- ✅ 移除 `WorkerExecutor` 相关代码
-- ✅ 添加 `ExecutorService INDEPENDENT_EXECUTOR`
-- ✅ 修改三个执行方法使用 `CompletableFuture.supplyAsync()`
-- ✅ 删除 `closeExecutor()` 方法（不再需要）
-
----
-
-## 🚀 部署
-
-### 1. 重新编译
-```bash
-mvn clean install -DskipTests
-```
-✅ 已完成
-
-### 2. 重启服务
-```bash
-./bin/stop.sh
-./bin/run.sh
-```
-
-### 3. 测试验证
-使用 `test2.http` 中的无限循环测试：
-```bash
-curl -X POST http://127.0.0.1:6400/v2/playground/test \
-  -H "Content-Type: application/json" \
-  -d '{
-    "jsCode": "...while(true)...",
-    "shareUrl": "https://example.com/test",
-    "method": "parse"
-  }'
-```
-
-**预期**：
-- ✅ 30秒后返回超时错误
-- ✅ 日志只输出一次错误
-- ✅ **不再输出BlockedThreadChecker警告**
-
----
-
-## ⚠️ 注意事项
-
-### 线程管理
-- 使用 `CachedThreadPool`，线程会自动回收
-- 守护线程不会阻止JVM关闭
-- 被阻塞的线程会继续执行，但不影响新请求
-
-### 资源消耗
-- 每个无限循环会占用1个线程
-- 线程空闲60秒后自动回收
-- 建议监控线程数量（如果频繁攻击）
-
-### 监控建议
-```bash
-# 监控超时事件
-tail -f logs/*/run.log | grep "JavaScript执行超时"
-
-# 确认不再有BlockedThreadChecker警告
-tail -f logs/*/run.log | grep "Thread blocked"
-# 应该：无输出（v3版本）
-```
-
----
-
-## ✅ 修复清单
-
-- [x] 代码长度限制（128KB）
-- [x] JavaScript执行超时（30秒）
-- [x] 前端危险代码检测
-- [x] **使用独立ExecutorService（v3）**
-- [x] **完全避免BlockedThreadChecker警告**
-- [x] 编译通过
-- [x] 测试验证
-
----
-
-## 🎉 最终状态
-
-**v3版本完全解决了日志滚动问题！**
-
-- ✅ 无限循环不再导致日志持续输出
-- ✅ BlockedThreadChecker不再监控这些线程
-- ✅ 用户体验良好，日志清爽
-- ✅ 服务稳定，不影响主服务
-
-**这是Nashorn引擎下的最优解决方案！** 🚀
-
----
-
-**修复版本**: v3 (最终版)  
-**修复日期**: 2025-11-29  
-**状态**: ✅ 完成并编译通过  
-**建议**: 立即部署测试
-

parser/doc/security/DOS_FIX_SUMMARY.md

@@ -1,231 +0,0 @@
-# 🔐 DoS漏洞修复报告
-
-## 修复日期
-2025-11-29
-
-## 修复漏洞
-
-### 1. ✅ 代码长度限制（防止内存炸弹）
-
-**漏洞描述**：  
-没有对JavaScript代码长度限制，攻击者可以提交超大代码或创建大量数据消耗内存。
-
-**修复内容**：
-- 添加 `MAX_CODE_LENGTH = 128 * 1024` (128KB) 常量
-- 在 `PlaygroundApi.test()` 方法中添加代码长度验证
-- 在 `PlaygroundApi.saveParser()` 方法中添加代码长度验证
-
-**修复文件**：
-```
-web-service/src/main/java/cn/qaiu/lz/web/controller/PlaygroundApi.java
-```
-
-**修复代码**：
-```java
-private static final int MAX_CODE_LENGTH = 128 * 1024; // 128KB
-
-// 代码长度验证
-if (jsCode.length() > MAX_CODE_LENGTH) {
-    promise.complete(JsonResult.error("代码长度超过限制（最大128KB），当前长度: " + jsCode.length() + " 字节").toJsonObject());
-    return promise.future();
-}
-```
-
-**测试POC**：
-参见 `web-service/src/test/resources/playground-dos-tests.http` - 测试2
-
----
-
-### 2. ✅ JavaScript执行超时（防止无限循环DoS）
-
-**漏洞描述**：  
-JavaScript执行没有超时限制，攻击者可以提交包含无限循环的代码导致线程被长期占用。
-
-**修复内容**：
-- 添加 `EXECUTION_TIMEOUT_SECONDS = 30` 秒超时常量
-- 使用 `CompletableFuture.orTimeout()` 添加超时机制
-- 超时后立即返回错误，不影响主线程
-- 修复三个执行方法：`executeParseAsync()`, `executeParseFileListAsync()`, `executeParseByIdAsync()`
-- **前端添加危险代码检测**：检测 `while(true)`, `for(;;)` 等无限循环模式并警告用户
-- **使用临时WorkerExecutor**：每个请求创建独立的executor，执行完毕后关闭，避免阻塞的线程继续输出日志
-
-**修复文件**：
-```
-parser/src/main/java/cn/qaiu/parser/customjs/JsPlaygroundExecutor.java
-web-front/src/views/Playground.vue
-```
-
-**⚠️ 重要限制与优化**：
-由于 **Nashorn 引擎的限制**，超时机制表现为：
-1. ✅ 在30秒后向客户端返回超时错误
-2. ✅ 记录超时日志
-3. ✅ 关闭临时WorkerExecutor，停止输出阻塞警告日志
-4. ❌ **无法中断正在执行的JavaScript代码**
-
-**优化措施**（2025-11-29更新）：
-- ✅ **临时Executor机制**：每个请求使用独立的临时WorkerExecutor
-- ✅ **自动清理**：执行完成或超时后自动关闭executor
-- ✅ **避免日志污染**：关闭executor后不再输出BlockedThreadChecker警告
-- ✅ **资源隔离**：被阻塞的线程被放弃，不影响新请求
-
-这意味着：
-- ✅ 客户端会及时收到超时错误
-- ✅ 日志不会持续滚动输出阻塞警告
-- ⚠️ 被阻塞的线程仍在后台执行（但已被隔离）
-- ⚠️ 频繁的无限循环攻击会创建大量线程（建议监控）
-
-**缓解措施**：
-1. ✅ 前端检测危险代码模式（已实现）
-2. ✅ 用户确认对话框（已实现）
-3. ✅ Worker线程池隔离（避免影响主服务）
-4. ✅ 超时后返回错误给用户（已实现）
-5. ⚠️ 建议监控线程阻塞告警
-6. ⚠️ 必要时重启服务释放被阻塞的线程
-
-**修复代码**：
-```java
-private static final long EXECUTION_TIMEOUT_SECONDS = 30;
-
-// 添加超时处理
-executionFuture.toCompletionStage()
-    .toCompletableFuture()
-    .orTimeout(EXECUTION_TIMEOUT_SECONDS, TimeUnit.SECONDS)
-    .whenComplete((result, error) -> {
-        if (error != null) {
-            if (error instanceof java.util.concurrent.TimeoutException) {
-                String timeoutMsg = "JavaScript执行超时（超过" + EXECUTION_TIMEOUT_SECONDS + "秒），可能存在无限循环";
-                playgroundLogger.errorJava(timeoutMsg);
-                log.error(timeoutMsg);
-                promise.fail(new RuntimeException(timeoutMsg));
-            } else {
-                promise.fail(error);
-            }
-        } else {
-            promise.complete(result);
-        }
-    });
-```
-
-**测试POC**：
-参见 `web-service/src/test/resources/playground-dos-tests.http` - 测试3, 4, 5
-
----
-
-## 修复效果
-
-### 代码长度限制
-- ✅ 超过128KB的代码会立即被拒绝
-- ✅ 返回友好的错误提示
-- ✅ 防止内存炸弹攻击
-
-### 执行超时机制
-- ✅ 无限循环会在30秒后超时
-- ✅ 超时不会阻塞主线程
-- ✅ 超时后立即返回错误给用户
-- ⚠️ **注意**：由于Nashorn引擎限制，被阻塞的worker线程无法被立即中断，会继续执行直到完成或JVM关闭
-
----
-
-## 测试验证
-
-### 测试文件
-```
-web-service/src/test/resources/playground-dos-tests.http
-```
-
-### 测试用例
-1. ✅ 正常代码执行 - 应该成功
-2. ✅ 代码长度超限 - 应该被拒绝
-3. ✅ 无限循环攻击 - 应该30秒超时
-4. ✅ 内存炸弹攻击 - 应该30秒超时
-5. ✅ 递归栈溢出 - 应该被捕获
-6. ✅ 保存解析器验证 - 应该成功
-
-### 如何运行测试
-1. 启动服务器：`./bin/run.sh`
-2. 使用HTTP客户端或IntelliJ IDEA的HTTP Client运行测试
-3. 观察响应结果
-
----
-
-## 其他建议（未实现）
-
-### 3. HTTP请求次数限制（可选）
-**建议**：限制单次执行中的HTTP请求次数（例如最多20次）
-
-```java
-// JsHttpClient.java
-private static final int MAX_REQUESTS_PER_EXECUTION = 20;
-private final AtomicInteger requestCount = new AtomicInteger(0);
-
-private void checkRequestLimit() {
-    if (requestCount.incrementAndGet() > MAX_REQUESTS_PER_EXECUTION) {
-        throw new RuntimeException("HTTP请求次数超过限制");
-    }
-}
-```
-
-### 4. 单IP创建限制（可选）
-**建议**：限制单个IP最多创建10个解析器
-
-```java
-// PlaygroundApi.java
-private static final int MAX_PARSERS_PER_IP = 10;
-```
-
-### 5. 过滤错误堆栈（可选）
-**建议**：只返回错误消息，不返回完整的Java堆栈信息
-
----
-
-## 安全状态
-
-| 漏洞 | 修复状态 | 测试状态 |
-|------|---------|----------|
-| 代码长度限制 | ✅ 已修复 | ✅ 已测试 |
-| 执行超时 | ✅ 已修复 | ✅ 已测试 |
-| HTTP请求滥用 | ⚠️ 未修复 | - |
-| 数据库污染 | ⚠️ 未修复 | - |
-| 信息泄露 | ⚠️ 未修复 | - |
-
----
-
-## 性能影响
-
-- **代码长度检查**：O(1) - 几乎无性能影响
-- **执行超时**：极小影响 - 仅添加超时监听器
-
----
-
-## 向后兼容性
-
-✅ 完全兼容
-- 不影响现有正常代码执行
-- 只拒绝恶意或超大代码
-- API接口不变
-
----
-
-## 部署建议
-
-1. ✅ 代码已编译通过
-2. ⚠️ 建议在测试环境验证后再部署生产
-3. ⚠️ 建议配置监控告警，监测超时频率
-4. ⚠️ 考虑添加IP限流或验证码防止滥用
-
----
-
-## 更新记录
-
-**2025-11-29**
-- 添加128KB代码长度限制
-- 添加30秒JavaScript执行超时
-- 创建DoS攻击测试用例
-- 编译验证通过
-
----
-
-**修复人员**: AI Assistant  
-**审核状态**: ⚠️ 待人工审核  
-**优先级**: 🔴 高 (建议尽快部署)
-

parser/doc/security/DOS_FIX_TEST_GUIDE.md

@@ -1,182 +0,0 @@
-# 🧪 DoS漏洞修复测试指南
-
-## 快速测试
-
-### 启动服务
-```bash
-cd /Users/q/IdeaProjects/mycode/netdisk-fast-download
-./bin/run.sh
-```
-
-### 使用测试文件
-```
-web-service/src/test/resources/playground-dos-tests.http
-```
-
----
-
-## 测试场景
-
-### ✅ 测试1: 正常执行
-**预期**：成功返回结果
-
-### ⚠️ 测试2: 代码长度超限  
-**预期**：立即返回错误 "代码长度超过限制"
-
-### 🔥 测试3: 无限循环（重点）
-**代码**：
-```javascript
-while(true) {
-    var x = 1 + 1;
-}
-```
-
-**v2优化后的预期行为**：
-1. ✅ 前端检测到 `while(true)` 弹出警告对话框
-2. ✅ 用户确认后开始执行
-3. ✅ 30秒后返回超时错误
-4. ✅ 日志只输出一次超时错误
-5. ✅ **不再持续输出BlockedThreadChecker警告**
-6. ✅ 可以立即执行下一个测试
-
-**v1的问题行为（已修复）**：
-- ❌ 日志每秒输出BlockedThreadChecker警告
-- ❌ 日志持续滚动，难以追踪其他问题
-- ❌ Worker线程被永久占用
-
-### 🔥 测试4: 内存炸弹
-**预期**：30秒超时或OutOfMemoryError
-
-### 🔥 测试5: 递归炸弹
-**预期**：捕获StackOverflowError
-
----
-
-## 日志对比
-
-### v1（问题版本）
-```
-2025-11-29 16:30:41.607 WARN  -> Thread blocked for 60249 ms
-2025-11-29 16:30:42.588 WARN  -> Thread blocked for 61250 ms
-2025-11-29 16:30:43.593 WARN  -> Thread blocked for 62251 ms
-2025-11-29 16:30:44.599 WARN  -> Thread blocked for 63252 ms
-... (持续输出)
-```
-
-### v2（优化版本）
-```
-2025-11-29 16:45:00.000 INFO  -> 开始执行parse方法
-2025-11-29 16:45:30.000 ERROR -> JavaScript执行超时（超过30秒），可能存在无限循环
-2025-11-29 16:45:30.010 DEBUG -> 临时WorkerExecutor已关闭
-... (不再输出BlockedThreadChecker警告)
-```
-
----
-
-## 前端体验
-
-### 危险代码警告
-
-当代码包含以下模式时：
-- `while(true)`
-- `for(;;)`
-- `for(var i=0; true;...)`
-
-会弹出对话框：
-```
-⚠️ 检测到 while(true) 无限循环
-
-这可能导致脚本无法停止并占用服务器资源。
-
-建议修改代码，添加合理的循环退出条件。
-
-确定要继续执行吗？
-
-[取消] [我知道风险，继续执行]
-```
-
----
-
-## 验证清单
-
-### 功能验证
-- [ ] 正常代码可以执行
-- [ ] 超过128KB的代码被拒绝
-- [ ] 无限循环30秒后超时
-- [ ] 前端弹出危险代码警告
-- [ ] 超时后可以立即执行新测试
-
-### 日志验证
-- [ ] 超时只输出一次错误
-- [ ] 不再持续输出BlockedThreadChecker警告
-- [ ] 临时WorkerExecutor成功关闭
-
-### 性能验证
-- [ ] 正常请求响应时间正常
-- [ ] 多次无限循环攻击不影响新请求
-- [ ] 内存使用稳定
-
----
-
-## 故障排查
-
-### 问题：日志仍在滚动
-**可能原因**：使用的是旧版本代码  
-**解决方案**：
-```bash
-mvn clean install -DskipTests
-./bin/stop.sh
-./bin/run.sh
-```
-
-### 问题：超时时间太短/太长
-**调整方法**：修改 `JsPlaygroundExecutor.java`
-```java
-private static final long EXECUTION_TIMEOUT_SECONDS = 30; // 改为需要的秒数
-```
-
-### 问题：前端检测太敏感
-**调整方法**：修改 `Playground.vue` 中的 `dangerousPatterns` 数组
-
----
-
-## 监控命令
-
-### 监控超时事件
-```bash
-tail -f logs/*/run.log | grep "JavaScript执行超时"
-```
-
-### 监控临时Executor创建
-```bash
-tail -f logs/*/run.log | grep "playground-temp-"
-```
-
-### 监控是否还有BlockedThreadChecker警告
-```bash
-tail -f logs/*/run.log | grep "Thread blocked"
-# v2版本：执行超时测试时，应该不再持续输出
-```
-
----
-
-## 成功标志
-
-### ✅ 修复成功的表现
-1. 超时错误立即返回给用户（30秒）
-2. 日志只输出一次错误
-3. BlockedThreadChecker警告不再持续输出
-4. 可以立即执行下一个测试
-5. 服务保持稳定
-
-### ❌ 修复失败的表现
-1. 日志持续每秒输出警告
-2. 无法执行新测试
-3. 服务响应缓慢
-
----
-
-**测试文件**: `web-service/src/test/resources/playground-dos-tests.http`  
-**重点测试**: 测试3 - 无限循环  
-**成功标志**: 日志不再持续滚动 ✅
-

parser/doc/security/DOS_FIX_V2.md

@@ -1,230 +0,0 @@
-# ✅ DoS漏洞修复完成报告 - v2
-
-## 修复日期
-2025-11-29 (v2更新)
-
-## 核心改进
-
-### ✅ 解决"日志持续滚动"问题
-
-**问题描述**：
-当JavaScript陷入无限循环时，Vert.x的BlockedThreadChecker会每秒输出线程阻塞警告，导致日志持续滚动，难以追踪其他问题。
-
-**解决方案 - 临时Executor机制**：
-
-```java
-// 每个请求创建独立的临时WorkerExecutor
-this.temporaryExecutor = WebClientVertxInit.get().createSharedWorkerExecutor(
-    "playground-temp-" + System.currentTimeMillis(), 
-    1, // 每个请求只需要1个线程
-    10000000000L // 设置非常长的超时，避免触发Vert.x阻塞线程告警
-);
-
-// 执行完成或超时后关闭
-private void closeExecutor() {
-    if (temporaryExecutor != null) {
-        temporaryExecutor.close();
-    }
-}
-```
-
-**效果**：
-1. ✅ 每个请求使用独立的executor（1个线程）
-2. ✅ 超时或完成后立即关闭executor
-3. ✅ 关闭后不再输出BlockedThreadChecker警告
-4. ✅ 被阻塞的线程被隔离，不影响新请求
-5. ✅ 日志清爽，只会输出一次超时错误
-
----
-
-## 完整修复列表
-
-### 1. ✅ 代码长度限制（128KB）
-
-**位置**：
-- `PlaygroundApi.test()` - 测试接口
-- `PlaygroundApi.saveParser()` - 保存接口
-
-**代码**：
-```java
-private static final int MAX_CODE_LENGTH = 128 * 1024; // 128KB
-
-if (jsCode.length() > MAX_CODE_LENGTH) {
-    return error("代码长度超过限制（最大128KB），当前: " + jsCode.length() + "字节");
-}
-```
-
-### 2. ✅ JavaScript执行超时（30秒）
-
-**位置**：
-- `JsPlaygroundExecutor.executeParseAsync()`
-- `JsPlaygroundExecutor.executeParseFileListAsync()`
-- `JsPlaygroundExecutor.executeParseByIdAsync()`
-
-**关键代码**：
-```java
-executionFuture.toCompletionStage()
-    .toCompletableFuture()
-    .orTimeout(30, TimeUnit.SECONDS)
-    .whenComplete((result, error) -> {
-        if (error instanceof TimeoutException) {
-            closeExecutor(); // 关闭executor，停止日志输出
-            promise.fail(new RuntimeException("执行超时"));
-        }
-    });
-```
-
-### 3. ✅ 前端危险代码检测
-
-**位置**：`web-front/src/views/Playground.vue`
-
-**检测模式**：
-- `while(true)`
-- `for(;;)`
-- `for(var i=0; true;...)`
-
-**行为**：
-- 检测到危险模式时弹出警告对话框
-- 用户需要确认才能继续执行
-
-### 4. ✅ 临时Executor机制（v2新增）
-
-**特性**：
-- 每个请求创建独立executor（1线程）
-- 执行完成或超时后自动关闭
-- 关闭后不再输出BlockedThreadChecker警告
-- 线程被阻塞也不影响后续请求
-
----
-
-## 修复对比
-
-| 特性 | v1 (原版) | v2 (优化版) |
-|------|-----------|-------------|
-| 代码长度限制 | ❌ 无 | ✅ 128KB |
-| 执行超时 | ❌ 无 | ✅ 30秒 |
-| 超时返回错误 | ❌ - | ✅ 是 |
-| 日志持续滚动 | ❌ 是 | ✅ 否（关闭executor） |
-| 前端危险代码检测 | ❌ 无 | ✅ 有 |
-| Worker线程隔离 | ⚠️ 共享池 | ✅ 临时独立 |
-| 资源清理 | ❌ 无 | ✅ 自动关闭 |
-
----
-
-## 测试验证
-
-### 测试文件
-```
-web-service/src/test/resources/playground-dos-tests.http
-```
-
-### 预期行为
-
-**测试无限循环**：
-```javascript
-while(true) { var x = 1 + 1; }
-```
-
-**v1表现**：
-- ❌ 30秒后返回超时错误
-- ❌ 日志持续输出BlockedThreadChecker警告
-- ❌ Worker线程被永久占用
-
-**v2表现**：
-- ✅ 30秒后返回超时错误
-- ✅ 关闭executor，日志停止输出
-- ✅ 被阻塞线程被放弃
-- ✅ 新请求正常执行
-
----
-
-## 性能影响
-
-### 资源消耗
-- **v1**：共享16个线程的Worker池
-- **v2**：每个请求创建1个线程的临时executor
-
-### 正常请求
-- 额外开销：创建/销毁executor的时间 (~10ms)
-- 影响：可忽略不计
-
-### 无限循环攻击
-- v1：16个请求耗尽所有线程
-- v2：每个请求占用1个线程，超时后放弃
-- v2更好：被阻塞线程被隔离，不影响新请求
-
----
-
-## 部署
-
-### 1. 重新编译
-```bash
-cd /path/to/netdisk-fast-download
-mvn clean install -DskipTests
-```
-✅ 已完成
-
-### 2. 重启服务
-```bash
-./bin/stop.sh
-./bin/run.sh
-```
-
-### 3. 验证
-使用 `playground-dos-tests.http` 中的测试用例验证：
-- 测试3：无限循环 - 应该30秒超时且不再持续输出日志
-- 测试4：内存炸弹 - 应该30秒超时
-- 测试5：递归炸弹 - 应该捕获StackOverflow
-
----
-
-## 监控建议
-
-### 关键指标
-```bash
-# 监控超时频率
-tail -f logs/*/run.log | grep "JavaScript执行超时"
-
-# 监控线程创建（可选）
-tail -f logs/*/run.log | grep "playground-temp-"
-```
-
-### 告警阈值
-- 单个IP 1小时内超时 >5次 → 可能的滥用
-- 总超时次数 1小时内 >20次 → 考虑添加验证码或IP限流
-
----
-
-## 文档
-
-- `DOS_FIX_SUMMARY.md` - 本文档
-- `NASHORN_LIMITATIONS.md` - Nashorn引擎限制详解
-- `playground-dos-tests.http` - 测试用例
-
----
-
-## 结论
-
-✅ **问题完全解决**
-- 代码长度限制有效防止内存炸弹
-- 执行超时及时返回错误给用户
-- 临时Executor机制避免日志持续输出
-- 前端检测提醒用户避免危险代码
-- 不影响主服务和正常请求
-
-⚠️ **残留线程说明**
-被阻塞的线程会继续在后台执行，但：
-- 已被executor关闭，不再输出日志
-- 不影响新请求的处理
-- 不消耗CPU（如果是sleep类阻塞）或消耗有限CPU
-- 服务重启时会被清理
-
-**这是Nashorn引擎下的最优解决方案！** 🎉
-
----
-
-**修复版本**: v2  
-**修复状态**: ✅ 完成  
-**测试状态**: ✅ 编译通过，待运行时验证  
-**建议**: 立即部署到生产环境
-

parser/doc/security/FAQ.md

@@ -1,309 +0,0 @@
-# 安全修复常见问题 FAQ
-
-## ❓ 常见问题解答
-
-### Q1: 为什么还是显示"请求失败: 404"？
-
-**答**: 这是**正常现象**！404是HTTP响应状态码，说明：
-
-✅ **安全检查已通过** - 你的请求没有被SSRF防护拦截  
-✅ **请求已发出** - HTTP客户端工作正常  
-❌ **目标资源不存在** - 目标服务器返回404错误
-
-#### 如何区分安全拦截 vs 正常404？
-
-| 错误类型 | 错误消息 | 原因 |
-|---------|---------|------|
-| **安全拦截** | `SecurityException: 🔒 安全拦截: 禁止访问内网IP地址` | SSRF防护拦截 |
-| **安全拦截** | `SecurityException: 🔒 安全拦截: 禁止访问云服务元数据API` | 危险域名拦截 |
-| **正常404** | `Error: 请求失败: 404` | 目标URL不存在 |
-| **正常错误** | `HTTP请求超时` | 网络超时 |
-| **正常错误** | `Connection refused` | 目标服务器拒绝连接 |
-
-#### 示例对比
-
-**❌ 被安全拦截（内网攻击）**:
-```javascript
-try {
-    var response = http.get('http://127.0.0.1:6400/admin');
-} catch (e) {
-    // 错误消息: SecurityException: 🔒 安全拦截: 禁止访问内网IP地址
-    logger.error(e.message);  
-}
-```
-
-**✅ 正常404（资源不存在）**:
-```javascript
-try {
-    var response = http.get('https://httpbin.org/not-exist');
-    if (response.statusCode() !== 200) {
-        // 404是正常的HTTP响应，不是安全拦截
-        throw new Error("请求失败: " + response.statusCode());
-    }
-} catch (e) {
-    // 错误消息: Error: 请求失败: 404
-    logger.error(e.message);
-}
-```
-
-#### 解决方法
-
-如果你的代码中有这样的检查：
-
-```javascript
-// ❌ 不好的做法：对所有非200状态码都抛出异常
-if (response.statusCode() !== 200) {
-    throw new Error("请求失败: " + response.statusCode());
-}
-```
-
-建议改为：
-
-```javascript
-// ✅ 更好的做法：区分不同的状态码
-var statusCode = response.statusCode();
-
-if (statusCode === 404) {
-    logger.warn("资源不存在: " + url);
-    return null;  // 或者其他默认值
-}
-
-if (statusCode < 200 || statusCode >= 300) {
-    throw new Error("请求失败: " + statusCode);
-}
-
-return response.body();
-```
-
----
-
-### Q2: 如何确认安全修复已生效？
-
-**答**: 执行以下测试：
-
-```javascript
-// 测试1: 尝试访问内网（应该被拦截）
-try {
-    http.get('http://127.0.0.1:6400/');
-    logger.error('❌ 失败: 内网访问成功（不应该）');
-} catch (e) {
-    if (e.message.includes('安全拦截')) {
-        logger.info('✅ 通过: 内网访问被拦截');
-    } else {
-        logger.warn('⚠️ 警告: 错误但非安全拦截 - ' + e.message);
-    }
-}
-
-// 测试2: 访问外网（应该正常工作，可能返回404但不会被拦截）
-try {
-    var response = http.get('https://httpbin.org/status/200');
-    logger.info('✅ 通过: 外网访问正常');
-} catch (e) {
-    logger.error('❌ 失败: 外网访问被拦截（不应该） - ' + e.message);
-}
-```
-
----
-
-### Q3: Java.type() 相关错误
-
-**错误消息**: `ReferenceError: "Java" is not defined`
-
-**答**: 这是**正确的行为**！说明安全修复生效了。
-
-之前（不安全）:
-```javascript
-var System = Java.type('java.lang.System');  // ❌ 可以执行
-```
-
-现在（安全）:
-```javascript
-var System = Java.type('java.lang.System');  // ✅ 抛出错误
-// ReferenceError: "Java" is not defined
-```
-
----
-
-### Q4: 如何测试SSRF防护？
-
-**答**: 使用以下测试用例：
-
-```javascript
-function testSSRF() {
-    var tests = [
-        // 应该被拦截的
-        {url: 'http://127.0.0.1:6400/', shouldBlock: true},
-        {url: 'http://localhost/', shouldBlock: true},
-        {url: 'http://192.168.1.1/', shouldBlock: true},
-        {url: 'http://169.254.169.254/latest/meta-data/', shouldBlock: true},
-        
-        // 应该允许的
-        {url: 'https://httpbin.org/get', shouldBlock: false},
-        {url: 'https://www.example.com/', shouldBlock: false}
-    ];
-    
-    tests.forEach(function(test) {
-        try {
-            var response = http.get(test.url);
-            if (test.shouldBlock) {
-                logger.error('❌ 失败: ' + test.url + ' 应该被拦截但没有');
-            } else {
-                logger.info('✅ 通过: ' + test.url + ' 正确允许');
-            }
-        } catch (e) {
-            if (test.shouldBlock && e.message.includes('安全拦截')) {
-                logger.info('✅ 通过: ' + test.url + ' 正确拦截');
-            } else if (!test.shouldBlock) {
-                logger.error('❌ 失败: ' + test.url + ' 不应该被拦截 - ' + e.message);
-            }
-        }
-    });
-}
-```
-
----
-
-### Q5: 服务启动时出现 ArrayIndexOutOfBoundsException
-
-**答**: 说明代码未更新或未重新编译。
-
-**解决方法**:
-```bash
-# 1. 确认代码已更新
-grep -n "new String\[0\]" parser/src/main/java/cn/qaiu/parser/customjs/JsPlaygroundExecutor.java
-
-# 应该看到类似：
-# 68: ScriptEngine engine = factory.getScriptEngine(new String[0], null, new SecurityClassFilter());
-
-# 2. 重新编译
-mvn clean install
-
-# 3. 重启服务
-./bin/stop.sh && ./bin/run.sh
-```
-
----
-
-### Q6: 如何关闭SSRF防护？（不推荐）
-
-**⚠️ 警告**: 关闭SSRF防护会带来严重的安全风险！
-
-如果确实需要（仅用于开发环境），可以修改 `JsHttpClient.java`:
-
-```java
-private void validateUrlSecurity(String url) {
-    // 注释掉所有验证逻辑
-    log.debug("SSRF防护已禁用（仅开发环境）");
-    return;
-}
-```
-
-**强烈建议**: 保持SSRF防护开启，使用白名单策略代替完全关闭。
-
----
-
-### Q7: 如何添加域名白名单？
-
-**答**: 当前策略是黑名单模式。如需白名单，修改 `validateUrlSecurity`:
-
-```java
-private static final String[] ALLOWED_DOMAINS = {
-    "api.example.com",
-    "cdn.example.com"
-};
-
-private void validateUrlSecurity(String url) {
-    URI uri = new URI(url);
-    String host = uri.getHost();
-    
-    // 白名单检查
-    boolean allowed = false;
-    for (String domain : ALLOWED_DOMAINS) {
-        if (host.equals(domain) || host.endsWith("." + domain)) {
-            allowed = true;
-            break;
-        }
-    }
-    
-    if (!allowed) {
-        throw new SecurityException("域名不在白名单中: " + host);
-    }
-}
-```
-
----
-
-### Q8: 性能影响
-
-**Q**: 安全检查会影响性能吗？
-
-**A**: 影响很小：
-- ClassFilter: 在引擎初始化时执行一次，几乎无性能影响
-- SSRF检查: 每次HTTP请求前执行，主要是DNS解析（已有缓存）
-- 预计性能影响: < 5ms/请求
-
----
-
-### Q9: 如何查看安全日志？
-
-**答**:
-```bash
-# 查看安全拦截日志
-tail -f logs/*/run.log | grep "安全拦截"
-
-# 查看JavaScript引擎初始化日志
-tail -f logs/*/run.log | grep "JavaScript引擎"
-
-# 应该看到：
-# 🔒 安全的JavaScript引擎初始化成功（演练场）
-```
-
----
-
-### Q10: 迁移到GraalVM
-
-**Q**: 如何迁移到更安全的GraalVM JavaScript？
-
-**A**: 
-
-1. 添加依赖（`pom.xml`）:
-```xml
-<dependency>
-    <groupId>org.graalvm.js</groupId>
-    <artifactId>js</artifactId>
-    <version>23.0.0</version>
-</dependency>
-```
-
-2. 修改代码:
-```java
-import org.graalvm.polyglot.*;
-
-Context context = Context.newBuilder("js")
-    .allowHostAccess(HostAccess.NONE)  // 禁止访问Java
-    .allowIO(IOAccess.NONE)            // 禁止IO
-    .build();
-
-Value result = context.eval("js", jsCode);
-```
-
-GraalVM优势:
-- ✅ 默认沙箱隔离
-- ✅ 更好的安全性
-- ✅ 更好的性能
-- ✅ 活跃维护
-
----
-
-## 📞 获取帮助
-
-如果以上FAQ没有解决你的问题：
-
-1. 查看详细文档: `parser/doc/security/`
-2. 运行安全测试: `./parser/doc/security/test-security.sh`
-3. 查看测试指南: `SECURITY_TESTING_GUIDE.md`
-
----
-
-**最后更新**: 2025-11-29
-

parser/doc/security/NASHORN_LIMITATIONS.md

@@ -1,189 +0,0 @@
-# ⚠️ Nashorn引擎限制说明
-
-## 问题描述
-
-Nashorn JavaScript引擎（Java 8-14自带）**无法中断正在执行的JavaScript代码**。
-
-这是Nashorn引擎的一个已知限制，无法通过编程方式解决。
-
-## 具体表现
-
-### 症状
-当JavaScript代码包含无限循环时：
-```javascript
-while(true) {
-    var x = 1 + 1;
-}
-```
-
-会出现以下情况：
-1. ✅ 30秒后客户端收到超时错误
-2. ❌ Worker线程继续执行无限循环
-3. ❌ 线程被永久阻塞，无法释放
-4. ❌ 日志持续输出线程阻塞警告
-
-### 日志示例
-```
-WARN -> [-thread-checker] i.vertx.core.impl.BlockedThreadChecker: 
-Thread Thread[playground-executor-1,5,main] has been blocked for 60249 ms, time limit is 60000 ms
-```
-
-## 为什么无法中断？
-
-### 尝试过的方案
-1. ❌ `Thread.interrupt()` - Nashorn不响应中断信号
-2. ❌ `Future.cancel(true)` - 无法强制停止Nashorn
-3. ❌ `ExecutorService.shutdownNow()` - 只能停止整个线程池
-4. ❌ `ScriptContext.setErrorWriter()` - 无法注入中断逻辑
-5. ❌ 自定义ClassFilter - 无法过滤语言关键字
-
-### 根本原因
-- Nashorn使用JVM字节码执行JavaScript
-- 无限循环被编译成JVM字节码级别的跳转
-- 没有安全点（Safepoint）可以插入中断检查
-- `while(true)` 不会调用任何Java方法，完全在JVM栈内执行
-
-## 现有防护措施
-
-### 1. ✅ 客户端超时（已实现）
-```java
-executionFuture.toCompletionStage()
-    .toCompletableFuture()
-    .orTimeout(30, TimeUnit.SECONDS)
-```
-- 30秒后返回错误给用户
-- 用户知道脚本超时
-- 但线程仍被阻塞
-
-### 2. ✅ 前端危险代码检测（已实现）
-```javascript
-// 检测无限循环模式
-/while\s*\(\s*true\s*\)/gi
-/for\s*\(\s*;\s*;\s*\)/gi
-```
-- 执行前警告用户
-- 需要用户确认
-- 依赖用户自觉
-
-### 3. ✅ Worker线程池隔离
-- 使用独立的 `playground-executor` 线程池
-- 最多16个线程
-- 不影响主服务的事件循环
-
-### 4. ✅ 代码长度限制
-- 最大128KB代码
-- 减少内存消耗
-- 但无法防止无限循环
-
-## 影响范围
-
-### 最坏情况
-- 16个恶意请求可以耗尽所有Worker线程
-- 后续所有Playground请求会等待
-- 主服务不受影响（独立线程池）
-- 需要重启服务才能恢复
-
-### 实际影响
-- 取决于使用场景
-- 如果是公开服务，有被滥用风险
-- 如果是内部工具，风险较低
-
-## 解决方案
-
-### 短期方案（已实施）
-1. ✅ 前端检测和警告
-2. ✅ 超时返回错误
-3. ✅ 文档说明限制
-4. ⚠️ 监控线程阻塞告警
-5. ⚠️ 限流（已有RateLimiter）
-
-### 中期方案（建议）
-1. 添加IP黑名单机制
-2. 添加滥用检测（同一IP多次触发超时）
-3. 考虑添加验证码
-4. 定期重启被阻塞的线程池
-
-### 长期方案（需大量工作）
-1. **迁移到GraalVM JavaScript引擎**
-   - 支持CPU时间限制
-   - 相比Nashorn更容易实现受控取消
-   - 更好的性能
-   - 但需要额外依赖
-
-2. **使用独立进程执行**
-   - 完全隔离
-   - 可以强制杀死进程
-   - 但复杂度高
-
-3. **代码静态分析**
-   - 分析AST检测循环
-   - 注入超时检查代码
-   - 但可能被绕过
-
-## 运维建议
-
-### 监控指标
-```bash
-# 监控线程阻塞告警
-tail -f logs/*/run.log | grep "Thread blocked"
-
-# 监控超时频率
-tail -f logs/*/run.log | grep "JavaScript执行超时"
-```
-
-### 告警阈值
-- 单个IP 1小时内超时 >3次 → 警告
-- Worker线程阻塞 >80% → 严重
-- 持续阻塞 >5分钟 → 考虑重启
-
-### 应急方案
-```bash
-# 重启服务释放被阻塞的线程
-./bin/stop.sh
-./bin/run.sh
-```
-
-## 用户建议
-
-### ✅ 建议的代码模式
-```javascript
-// 使用有限循环
-for(var i = 0; i < 1000; i++) {
-    // 处理逻辑
-}
-
-// 使用超时保护
-var maxIterations = 10000;
-var count = 0;
-while(condition && count++ < maxIterations) {
-    // 处理逻辑
-}
-```
-
-### ❌ 禁止的代码模式
-```javascript
-// 无限循环
-while(true) { }
-for(;;) { }
-
-// 无退出条件的循环
-while(someCondition) {
-    // someCondition永远为true
-}
-
-// 递归炸弹
-function boom() { return boom(); }
-```
-
-## 相关链接
-
-- [Nashorn Engine Issues](https://github.com/openjdk/nashorn/issues)
-- [GraalVM JavaScript](https://www.graalvm.org/javascript/)
-- [Java Script Engine Comparison](https://benchmarksgame-team.pages.debian.net/benchmarksgame/)
-
----
-
-**最后更新**: 2025-11-29  
-**状态**: ⚠️ 已知限制，已采取缓解措施  
-**建议**: 如需更严格的控制，考虑迁移到GraalVM JavaScript引擎
-

parser/doc/security/QUICK_TEST.md

@@ -1,293 +0,0 @@
-# 🧪 安全修复快速验证指南
-
-## 修复内容
-✅ JavaScript远程代码执行漏洞已修复  
-✅ SSRF攻击防护已添加  
-✅ 方法调用错误已修复（`ArrayIndexOutOfBoundsException`）
-
----
-
-## 快速测试步骤
-
-### 1. 重新编译（必须）
-
-```bash
-cd /Users/q/IdeaProjects/mycode/netdisk-fast-download
-mvn clean install -DskipTests
-```
-
-### 2. 重启服务
-
-```bash
-# 停止旧服务
-./bin/stop.sh
-
-# 启动新服务
-./bin/run.sh
-```
-
-### 3. 执行安全测试
-
-#### 方式A: 使用HTTP测试文件（推荐）
-
-1. 确保服务已启动（默认端口 6400）
-2. 使用IDE打开: `web-service/src/test/resources/playground-security-tests.http`
-3. 执行"测试3: 系统属性和环境变量访问"
-
-**期望结果**:
-```json
-{
-  "success": true,
-  "result": "✓ 安全: 无法访问系统属性",
-  "logs": [
-    {
-      "level": "INFO",
-      "message": "尝试访问系统属性..."
-    },
-    {
-      "level": "INFO", 
-      "message": "系统属性访问失败: ReferenceError: \"Java\" is not defined"
-    }
-  ]
-}
-```
-
-#### 方式B: 使用JUnit测试
-
-```bash
-cd parser
-mvn test -Dtest=SecurityTest#testSystemPropertiesAccess
-```
-
-**期望输出**:
-```
-[INFO] 尝试访问系统属性...
-[INFO] 方法1失败: ReferenceError: "Java" is not defined
-✓ 安全: 无法访问系统属性
-测试完成: 系统属性访问测试
-```
-
----
-
-## 验证清单
-
-运行测试后，确认以下几点：
-
-### ✅ 必须通过的检查
-
-- [ ] 服务启动成功，没有 `ArrayIndexOutOfBoundsException`
-- [ ] 日志中出现：`🔒 安全的JavaScript引擎初始化成功`
-- [ ] JavaScript代码执行正常（parse函数可以调用）
-- [ ] 尝试访问 `Java.type()` 时返回错误：`ReferenceError: "Java" is not defined`
-- [ ] 尝试访问 `System.getProperty()` 时失败
-- [ ] HTTP请求内网地址（如 127.0.0.1）时被拦截
-
-### ⚠️ 如果出现以下情况说明修复失败
-
-- [ ] 服务启动时抛出异常
-- [ ] JavaScript可以成功调用 `Java.type()`
-- [ ] 可以获取到系统属性（如用户名、HOME目录）
-- [ ] 可以访问内网地址（127.0.0.1, 192.168.x.x）
-
----
-
-## 快速测试用例
-
-### 测试1: 验证Java访问被禁用 ✅
-
-在演练场输入以下代码：
-
-```javascript
-// ==UserScript==
-// @name         快速安全测试
-// @type         test
-// @match        https://test.com/*
-// ==/UserScript==
-
-function parse(shareLinkInfo, http, logger) {
-    logger.info('开始安全测试...');
-    
-    // 测试1: Java对象
-    try {
-        if (typeof Java !== 'undefined') {
-            logger.error('❌ 失败: Java对象仍然可用');
-            return 'FAILED: Java可用';
-        }
-    } catch (e) {
-        logger.info('✅ 通过: Java对象未定义');
-    }
-    
-    // 测试2: JavaImporter
-    try {
-        if (typeof JavaImporter !== 'undefined') {
-            logger.error('❌ 失败: JavaImporter仍然可用');
-            return 'FAILED: JavaImporter可用';
-        }
-    } catch (e) {
-        logger.info('✅ 通过: JavaImporter未定义');
-    }
-    
-    // 测试3: Packages
-    try {
-        if (typeof Packages !== 'undefined') {
-            logger.error('❌ 失败: Packages仍然可用');
-            return 'FAILED: Packages可用';
-        }
-    } catch (e) {
-        logger.info('✅ 通过: Packages未定义');
-    }
-    
-    logger.info('✅ 所有测试通过！系统安全！');
-    return 'SUCCESS: 安全修复生效';
-}
-```
-
-**期望输出**:
-```
-[INFO] 开始安全测试...
-[INFO] ✅ 通过: Java对象未定义
-[INFO] ✅ 通过: JavaImporter未定义
-[INFO] ✅ 通过: Packages未定义
-[INFO] ✅ 所有测试通过！系统安全！
-SUCCESS: 安全修复生效
-```
-
-### 测试2: 验证SSRF防护 ✅
-
-```javascript
-function parse(shareLinkInfo, http, logger) {
-    logger.info('测试SSRF防护...');
-    
-    // 测试访问内网
-    try {
-        http.get('http://127.0.0.1:6400/');
-        logger.error('❌ 失败: 可以访问内网');
-        return 'FAILED: SSRF防护无效';
-    } catch (e) {
-        if (e.message && e.message.includes('安全拦截')) {
-            logger.info('✅ 通过: 内网访问被阻止 - ' + e.message);
-            return 'SUCCESS: SSRF防护有效';
-        } else {
-            logger.warn('⚠️ 警告: 错误但非安全拦截 - ' + e.message);
-            return 'WARNING: 未知错误';
-        }
-    }
-}
-```
-
-**期望输出**:
-```
-[INFO] 测试SSRF防护...
-[INFO] ✅ 通过: 内网访问被阻止 - SecurityException: 🔒 安全拦截: 禁止访问内网地址
-SUCCESS: SSRF防护有效
-```
-
----
-
-## 故障排查
-
-### 问题1: 服务启动失败
-
-```bash
-# 检查编译是否成功
-ls -la parser/target/parser-*.jar
-ls -la web-service/target/*.jar
-
-# 如果没有jar文件，重新编译
-mvn clean install
-```
-
-### 问题2: ArrayIndexOutOfBoundsException 仍然出现
-
-```bash
-# 确认代码已更新
-grep -n "new String\[0\]" parser/src/main/java/cn/qaiu/parser/customjs/JsPlaygroundExecutor.java
-
-# 应该看到类似：
-# 68:            ScriptEngine engine = factory.getScriptEngine(new String[0], null, new SecurityClassFilter());
-
-# 如果没有，说明代码未更新，重新拉取
-```
-
-### 问题3: 测试显示"Java仍然可用"
-
-这是**严重问题**，说明修复未生效：
-
-1. 确认代码已更新
-2. 确认重新编译
-3. 确认重启服务
-4. 检查日志是否有"安全的JavaScript引擎初始化成功"
-
-```bash
-# 检查日志
-tail -f logs/*/run.log | grep "JavaScript引擎"
-
-# 应该看到：
-# 🔒 安全的JavaScript引擎初始化成功（演练场）
-```
-
----
-
-## 一键测试脚本
-
-创建并运行快速测试：
-
-```bash
-cd /Users/q/IdeaProjects/mycode/netdisk-fast-download
-
-# 重新编译
-echo "📦 重新编译..."
-mvn clean install -DskipTests
-
-# 重启服务
-echo "🔄 重启服务..."
-./bin/stop.sh
-sleep 2
-./bin/run.sh
-
-# 等待服务启动
-echo "⏳ 等待服务启动..."
-sleep 5
-
-# 运行安全测试
-echo "🧪 运行安全测试..."
-cd parser
-mvn test -Dtest=SecurityTest#testSystemPropertiesAccess
-
-echo ""
-echo "✅ 测试完成！请检查上方输出确认安全修复是否生效。"
-```
-
----
-
-## 成功标志
-
-如果看到以下输出，说明修复成功：
-
-```
-✅ 服务启动成功
-✅ 日志: 🔒 安全的JavaScript引擎初始化成功
-✅ 测试: ReferenceError: "Java" is not defined
-✅ 测试: ✓ 安全: 无法访问系统属性
-✅ 测试: 🔒 安全拦截: 禁止访问内网地址
-```
-
----
-
-## 下一步
-
-测试通过后：
-1. ✅ 标记漏洞为"已修复"
-2. ✅ 部署到生产环境（如果适用）
-3. ✅ 更新安全文档
-4. ✅ 通知团队成员
-
----
-
-**文档**: 
-- 详细修复说明: `parser/SECURITY_FIX_SUMMARY.md`
-- 紧急修复指南: `SECURITY_URGENT_FIX.md`
-- 完整测试指南: `parser/doc/SECURITY_TESTING_GUIDE.md`
-
-**最后更新**: 2025-11-29
-

parser/doc/security/README.md

@@ -1,42 +0,0 @@
-# 安全相关文档索引
-
-本目录包含JavaScript执行器的安全修复和测试相关文档。
-
-## 📚 文档列表
-
-### 🚀 快速开始
-- **[QUICK_TEST.md](QUICK_TEST.md)** - 快速验证指南（5分钟）
-- **[FAQ.md](FAQ.md)** - 常见问题解答 ⭐ **推荐先看这个！**
-- **[test-security.sh](test-security.sh)** - 一键测试脚本
-
-### 📋 安全修复说明
-- **[SECURITY_FIX_SUMMARY.md](SECURITY_FIX_SUMMARY.md)** - 完整修复总结
-- **[SECURITY_URGENT_FIX.md](SECURITY_URGENT_FIX.md)** - 紧急修复通知
-- **[CHANGELOG_SECURITY.md](CHANGELOG_SECURITY.md)** - 安全更新日志
-
-### 🧪 测试指南
-- **[SECURITY_TEST_README.md](SECURITY_TEST_README.md)** - 安全测试快速入门
-- **[SECURITY_TESTING_GUIDE.md](../SECURITY_TESTING_GUIDE.md)** - 详细测试指南
-
-### 🛡️ 防护策略
-- **[SSRF_PROTECTION.md](SSRF_PROTECTION.md)** - SSRF防护策略说明
-
----
-
-## 🚨 重要提醒
-
-如果你看到这些文档，说明系统曾经存在严重的安全漏洞。请务必：
-
-1. ✅ 确认已应用最新的安全修复
-2. ✅ 运行安全测试验证修复效果
-3. ✅ 重新部署到生产环境
-
-## ❓ 遇到问题？
-
-- **看到"请求失败: 404"?** → 这是正常的HTTP响应，不是安全拦截！查看 [FAQ.md](FAQ.md#q1-为什么还是显示请求失败-404)
-- **Java.type() 报错?** → 这说明安全修复生效了！查看 [FAQ.md](FAQ.md#q3-javatype-相关错误)
-- **服务启动失败?** → 检查是否重新编译，查看 [FAQ.md](FAQ.md#q5-服务启动时出现-arrayindexoutofboundsexception)
-
----
-
-最后更新: 2025-11-29

parser/doc/security/SECURITY_FIX_SUMMARY.md

@@ -1,323 +0,0 @@
-# JavaScript远程代码执行漏洞修复总结
-
-## 🔴 严重安全漏洞已修复
-
-**修复日期**: 2025-11-28  
-**漏洞类型**: 远程代码执行 (RCE)  
-**危险等级**: 🔴 极高
-
----
-
-## 📋 漏洞描述
-
-### 原始问题
-
-JavaScript执行器使用 Nashorn 引擎，但**没有任何安全限制**，允许JavaScript代码：
-
-1. ❌ 访问所有Java类 (通过 `Java.type()`)
-2. ❌ 执行系统命令 (`Runtime.exec()`)
-3. ❌ 读写文件系统 (`java.io.File`)
-4. ❌ 访问系统属性 (`System.getProperty()`)
-5. ❌ 使用反射绕过限制 (`Class.forName()`)
-6. ❌ 创建任意网络连接 (`Socket`)
-7. ❌ 访问内网服务 (SSRF攻击)
-
-### 测试结果（修复前）
-
-```
-[ERROR] [JS] 【安全漏洞】获取到系统属性 - HOME: /Users/q, USER: q
-结果: 危险: 系统属性访问成功 - q
-```
-
-**这意味着任何用户提供的JavaScript代码都可以完全控制服务器！**
-
----
-
-## ✅ 已实施的安全措施
-
-### 1. ClassFilter 类过滤器 🔒
-
-**文件**: `parser/src/main/java/cn/qaiu/parser/customjs/SecurityClassFilter.java`
-
-**功能**: 拦截JavaScript对危险Java类的访问
-
-**黑名单包括**:
-- 系统命令执行: `Runtime`, `ProcessBuilder`
-- 文件系统访问: `File`, `Files`, `Paths`, `FileInputStream/OutputStream`
-- 系统访问: `System`, `SecurityManager`
-- 反射: `Class`, `Method`, `Field`, `ClassLoader`
-- 网络: `Socket`, `URL`, `URLConnection`
-- 线程: `Thread`, `ExecutorService`
-- 数据库: `Connection`, `Statement`
-- 脚本引擎: `ScriptEngine`
-
-**效果**:
-```java
-public boolean exposeToScripts(String className) {
-    // 检查黑名单
-    if (className.startsWith("java.lang.System")) {
-        log.warn("🔒 安全拦截: JavaScript尝试访问危险类 - {}", className);
-        return false;  // 拒绝访问
-    }
-    return true;
-}
-```
-
-### 2. 禁用Java内置对象 🚫
-
-**修改位置**: `JsPlaygroundExecutor.initEngine()` 和 `JsParserExecutor.initEngine()`
-
-**实施方法**:
-```java
-// 创建带ClassFilter的安全引擎
-NashornScriptEngineFactory factory = new NashornScriptEngineFactory();
-ScriptEngine engine = factory.getScriptEngine(new SecurityClassFilter());
-
-// 禁用Java对象访问
-engine.eval("var Java = undefined;");
-engine.eval("var JavaImporter = undefined;");
-engine.eval("var Packages = undefined;");
-engine.eval("var javax = undefined;");
-engine.eval("var org = undefined;");
-engine.eval("var com = undefined;");
-```
-
-**效果**: JavaScript无法使用 `Java.type()` 等方法访问Java类
-
-### 3. SSRF防护 🌐
-
-**文件**: `parser/src/main/java/cn/qaiu/parser/customjs/JsHttpClient.java`
-
-**功能**: 防止JavaScript通过HTTP客户端访问内网资源
-
-**防护措施**:
-```java
-private void validateUrlSecurity(String url) {
-    // 1. 检查危险域名黑名单
-    //    - localhost
-    //    - 169.254.169.254 (云服务元数据API)
-    //    - metadata.google.internal
-    
-    // 2. 检查内网IP
-    //    - 127.x.x.x (本地回环)
-    //    - 10.x.x.x (内网A类)
-    //    - 172.16-31.x.x (内网B类)
-    //    - 192.168.x.x (内网C类)
-    //    - 169.254.x.x (链路本地)
-    
-    // 3. 检查协议
-    //    - 仅允许 HTTP/HTTPS
-    
-    if (PRIVATE_IP_PATTERN.matcher(ip).find()) {
-        throw new SecurityException("🔒 安全拦截: 禁止访问内网地址");
-    }
-}
-```
-
-**应用位置**: 所有HTTP请求方法
-- `get()`
-- `getWithRedirect()`
-- `getNoRedirect()`
-- `post()`
-- `put()`
-
-### 4. 超时保护 ⏱️
-
-**已有机制**: Worker线程池限制
-
-**位置**: 
-- `JsPlaygroundExecutor`: 16个worker线程
-- `JsParserExecutor`: 32个worker线程
-
-**超时**: HTTP请求默认30秒超时
-
----
-
-## 🧪 安全验证
-
-### 测试方法
-
-使用提供的安全测试套件：
-
-#### 方式1: JUnit测试
-```bash
-cd parser
-mvn test -Dtest=SecurityTest
-```
-
-#### 方式2: HTTP接口测试
-```bash
-# 启动服务器后执行
-# 使用 web-service/src/test/resources/playground-security-tests.http
-```
-
-### 预期结果（修复后）
-
-所有危险操作应该被拦截：
-
-```
-[INFO] [JS] 尝试访问系统属性...
-[INFO] [JS] 系统属性访问失败: ReferenceError: "Java" is not defined
-✓ 安全: 无法访问系统属性
-```
-
----
-
-## 📊 修复效果对比
-
-| 测试项目 | 修复前 | 修复后 |
-|---------|--------|--------|
-| 系统命令执行 | ❌ 成功执行 | ✅ 被拦截 |
-| 文件系统访问 | ❌ 可读写文件 | ✅ 被拦截 |
-| 系统属性访问 | ❌ 获取成功 | ✅ 被拦截 |
-| 反射攻击 | ❌ 可使用反射 | ✅ 被拦截 |
-| 网络Socket | ❌ 可创建连接 | ✅ 被拦截 |
-| JVM退出 | ❌ 可终止进程 | ✅ 被拦截 |
-| SSRF内网访问 | ❌ 可访问内网 | ✅ 被拦截 |
-| SSRF元数据API | ❌ 可访问 | ✅ 被拦截 |
-
----
-
-## 🔧 修改的文件列表
-
-### 新增文件
-
-1. ✅ `parser/src/main/java/cn/qaiu/parser/customjs/SecurityClassFilter.java`
-   - ClassFilter实现，拦截危险类访问
-
-2. ✅ `parser/src/test/java/cn/qaiu/parser/SecurityTest.java`
-   - 7个安全测试用例
-
-3. ✅ `web-service/src/test/resources/playground-security-tests.http`
-   - 10个HTTP安全测试用例
-
-4. ✅ `parser/doc/SECURITY_TESTING_GUIDE.md`
-   - 完整的安全测试和修复指南
-
-5. ✅ `parser/SECURITY_TEST_README.md`
-   - 快速开始指南
-
-6. ✅ `parser/test-security.sh`
-   - 自动化测试脚本
-
-7. ✅ `parser/SECURITY_FIX_SUMMARY.md`
-   - 本文件（修复总结）
-
-### 修改的文件
-
-1. ✅ `parser/src/main/java/cn/qaiu/parser/customjs/JsPlaygroundExecutor.java`
-   - 修改 `initEngine()` 方法使用 SecurityClassFilter
-   - 禁用 Java 内置对象
-
-2. ✅ `parser/src/main/java/cn/qaiu/parser/customjs/JsParserExecutor.java`
-   - 修改 `initEngine()` 方法使用 SecurityClassFilter
-   - 禁用 Java 内置对象
-
-3. ✅ `parser/src/main/java/cn/qaiu/parser/customjs/JsHttpClient.java`
-   - 添加 `validateUrlSecurity()` 方法
-   - 在所有HTTP请求方法中添加SSRF检查
-   - 添加内网IP检测和危险域名黑名单
-
----
-
-## ⚠️ 重要提示
-
-### 1. 立即部署
-
-这是一个**严重的安全漏洞**，请尽快部署修复：
-
-```bash
-# 重新编译
-mvn clean install
-
-# 重启服务
-./bin/stop.sh
-./bin/run.sh
-```
-
-### 2. 验证修复
-
-部署后**必须**执行安全测试：
-
-```bash
-cd parser
-./test-security.sh
-```
-
-确认所有高危测试都被拦截！
-
-### 3. 监控日志
-
-留意日志中的安全拦截记录：
-
-```
-[WARN] 🔒 安全拦截: JavaScript尝试访问危险类 - java.lang.System
-[WARN] 🔒 安全拦截: 尝试访问内网地址 - 127.0.0.1
-```
-
-如果看到大量拦截日志，可能有人在尝试攻击。
-
-### 4. 后续改进
-
-**长期建议**: 迁移到 GraalVM JavaScript
-
-Nashorn已废弃，建议迁移到更安全、更现代的引擎：
-
-```xml
-<dependency>
-    <groupId>org.graalvm.js</groupId>
-    <artifactId>js</artifactId>
-    <version>23.0.0</version>
-</dependency>
-```
-
-GraalVM优势：
-- 默认沙箱隔离
-- 无法访问Java类（除非显式允许）
-- 更好的性能
-- 活跃维护
-
----
-
-## 📚 相关文档
-
-- **详细测试指南**: `parser/doc/SECURITY_TESTING_GUIDE.md`
-- **快速开始**: `parser/SECURITY_TEST_README.md`
-- **测试用例**: 
-  - JUnit: `parser/src/test/java/cn/qaiu/parser/SecurityTest.java`
-  - HTTP: `web-service/src/test/resources/playground-security-tests.http`
-
----
-
-## 🎯 结论
-
-### 修复前（极度危险 🔴）
-
-```javascript
-// 攻击者可以执行任意代码
-var Runtime = Java.type('java.lang.Runtime');
-Runtime.getRuntime().exec('rm -rf /');  // 删除所有文件！
-```
-
-### 修复后（安全 ✅）
-
-```javascript
-// 所有危险操作被拦截
-var Runtime = Java.type('java.lang.Runtime');
-// ReferenceError: "Java" is not defined
-```
-
-**安全级别**: 🔴 D级（严重不安全） → 🟢 A级（安全）
-
----
-
-**免责声明**: 虽然已实施多层安全防护，但没有系统是100%安全的。建议定期审计代码，关注安全更新，并考虑迁移到更现代的JavaScript引擎（如GraalVM）。
-
-**联系方式**: 如发现新的安全问题，请通过安全渠道私密报告。
-
----
-
-**修复完成** ✅  
-**审核状态**: 待用户验证  
-**下一步**: 执行安全测试套件，确认所有漏洞已修复
-

parser/doc/security/SECURITY_TEST_README.md

@@ -1,180 +0,0 @@
-# JavaScript执行器安全测试
-
-## 📋 概述
-
-本目录提供了完整的JavaScript执行器安全测试工具和文档，用于验证演练场执行器是否存在安全漏洞。
-
-## 🎯 测试目标
-
-验证以下安全风险：
-
-| 测试项目 | 危险级别 | 说明 |
-|---------|---------|------|
-| 系统命令执行 | 🔴 极高 | 验证是否能执行shell命令 |
-| 文件系统访问 | 🔴 极高 | 验证是否能读写本地文件 |
-| 系统属性访问 | 🟡 高 | 验证是否能获取系统信息 |
-| 反射攻击 | 🔴 极高 | 验证是否能通过反射绕过限制 |
-| 网络Socket | 🔴 极高 | 验证是否能创建任意网络连接 |
-| JVM退出 | 🔴 极高 | 验证是否能终止应用 |
-| SSRF攻击 | 🟡 高 | 验证HTTP客户端访问控制 |
-
-## 📂 测试资源
-
-```
-parser/
-├── src/test/java/cn/qaiu/parser/
-│   └── SecurityTest.java              # JUnit测试用例（7个测试方法）
-├── doc/
-│   └── SECURITY_TESTING_GUIDE.md      # 详细测试指南和安全建议
-├── test-security.sh                   # 快速执行脚本
-└── SECURITY_TEST_README.md           # 本文件
-
-web-service/src/test/resources/
-└── playground-security-tests.http     # HTTP接口测试用例（10个测试）
-```
-
-## 🚀 快速开始
-
-### 方式1: 使用Shell脚本（推荐）
-
-```bash
-cd parser
-chmod +x test-security.sh
-./test-security.sh
-```
-
-### 方式2: Maven命令
-
-```bash
-cd parser
-mvn test -Dtest=SecurityTest
-```
-
-### 方式3: HTTP接口测试
-
-1. 启动应用服务器
-2. 打开 `web-service/src/test/resources/playground-security-tests.http`
-3. 在IDE中逐个执行测试用例
-
-## 📊 预期结果
-
-### ✅ 安全系统（预期）
-
-所有高危测试应该**失败**，日志中应该显示：
-
-```
-[INFO] 尝试执行系统命令...
-[INFO] Runtime.exec失败: ReferenceError: "Java" is not defined
-[INFO] ProcessBuilder失败: ReferenceError: "Java" is not defined
-✓ 安全: 无法执行系统命令
-```
-
-### ❌ 不安全系统（需要修复）
-
-如果看到以下日志，说明存在严重安全漏洞：
-
-```
-[ERROR] 【安全漏洞】成功执行系统命令: root
-危险: 系统命令执行成功
-```
-
-## ⚠️ 重要警告
-
-1. **仅在测试环境执行** - 这些测试包含危险代码
-2. **不要在生产环境运行** - 可能导致系统被攻击
-3. **发现漏洞立即修复** - 不要在公开环境部署有漏洞的版本
-
-## 🔧 安全修复建议
-
-如果测试发现安全问题，请参考 `doc/SECURITY_TESTING_GUIDE.md` 中的修复方案：
-
-### 最关键的修复措施
-
-1. **实现ClassFilter** - 禁止JavaScript访问危险Java类
-2. **添加超时机制** - 防止DOS攻击
-3. **HTTP白名单** - 防止SSRF攻击
-4. **迁移到GraalVM** - 使用更安全的JavaScript引擎
-
-### 示例：ClassFilter实现
-
-```java
-import jdk.nashorn.api.scripting.ClassFilter;
-import jdk.nashorn.api.scripting.NashornScriptEngineFactory;
-
-public class SecurityClassFilter implements ClassFilter {
-    @Override
-    public boolean exposeToScripts(String className) {
-        // 禁止所有Java类访问
-        return false;
-    }
-}
-
-// 创建安全的引擎
-NashornScriptEngineFactory factory = new NashornScriptEngineFactory();
-ScriptEngine engine = factory.getScriptEngine(new SecurityClassFilter());
-```
-
-## 📖 详细文档
-
-完整的安全测试指南、修复方案和最佳实践，请查看：
-
-👉 **[doc/SECURITY_TESTING_GUIDE.md](doc/SECURITY_TESTING_GUIDE.md)**
-
-该文档包含：
-- 每个测试用例的详细说明
-- 潜在风险分析
-- 完整的修复方案
-- 安全配置最佳实践
-- GraalVM迁移指南
-
-## 🔍 测试检查清单
-
-执行测试后，请确认：
-
-- [ ] ✅ 测试1: 系统命令执行 - **失败**（安全）
-- [ ] ✅ 测试2: 文件系统访问 - **失败**（安全）
-- [ ] ✅ 测试3: 系统属性访问 - **失败**（安全）
-- [ ] ✅ 测试4: 反射攻击 - **失败**（安全）
-- [ ] ✅ 测试5: 网络Socket - **失败**（安全）
-- [ ] ✅ 测试6: JVM退出 - **失败**（安全）
-- [ ] ⚠️  测试7: SSRF攻击 - **部分失败**（禁止内网访问）
-
-## 💡 常见问题
-
-### Q: 为什么要进行这些测试？
-
-A: JavaScript执行器允许运行用户提供的代码，如果不加限制，恶意用户可能：
-- 执行系统命令窃取数据
-- 读取敏感文件
-- 攻击内网服务器
-- 导致服务器崩溃
-
-### Q: 测试失败是好事还是坏事？
-
-A: **测试失败是好事！** 这意味着危险操作被成功阻止了。如果测试通过（返回"危险"），说明存在安全漏洞。
-
-### Q: 可以跳过这些测试吗？
-
-A: **强烈不建议！** 如果系统对外提供JavaScript执行功能，必须进行安全测试。否则可能导致严重的安全事故。
-
-### Q: Nashorn已经废弃了，应该怎么办？
-
-A: 建议迁移到 **GraalVM JavaScript**，它提供：
-- 更好的安全性（默认沙箱）
-- 更好的性能
-- 活跃的维护和更新
-
-## 🆘 需要帮助？
-
-如果测试发现安全问题或需要修复建议：
-
-1. 查看详细文档：`doc/SECURITY_TESTING_GUIDE.md`
-2. 参考HTTP测试用例：`web-service/src/test/resources/playground-security-tests.http`
-3. 检查JUnit测试代码：`src/test/java/cn/qaiu/parser/SecurityTest.java`
-
----
-
-**最后更新**: 2025-11-28  
-**作者**: QAIU  
-**许可**: MIT License
-

parser/doc/security/SECURITY_URGENT_FIX.md

@@ -1,303 +0,0 @@
-# 🚨 紧急安全修复通知
-
-## ⚠️ 严重漏洞已修复 - 请立即部署
-
-**漏洞编号**: RCE-2025-001  
-**发现日期**: 2025-11-28  
-**修复状态**: ✅ 已完成  
-**危险等级**: 🔴🔴🔴 极高（远程代码执行）
-
----
-
-## 🔥 漏洞影响
-
-如果您的服务器正在运行**未修复**的版本，攻击者可以：
-
-- ✅ 执行任意系统命令
-- ✅ 读取服务器上的所有文件（包括数据库、配置文件、密钥）
-- ✅ 删除或修改文件
-- ✅ 窃取环境变量和系统信息
-- ✅ 攻击内网其他服务器
-- ✅ 完全控制服务器
-
-**这是一个可被远程利用的代码执行漏洞！**
-
----
-
-## 🎯 快速修复步骤
-
-### 1. 立即停止服务（如果正在生产环境）
-
-```bash
-./bin/stop.sh
-```
-
-### 2. 拉取最新代码
-
-```bash
-git pull
-# 或者手动应用补丁
-```
-
-### 3. 重新编译
-
-```bash
-mvn clean install
-```
-
-### 4. 验证修复（重要！）
-
-```bash
-cd parser
-mvn test -Dtest=SecurityTest
-```
-
-**确认所有测试显示"安全"而不是"危险"！**
-
-### 5. 重启服务
-
-```bash
-./bin/run.sh
-```
-
-### 6. 监控日志
-
-检查是否有安全拦截日志：
-
-```bash
-tail -f logs/*/run.log | grep "安全拦截"
-```
-
----
-
-## 📋 修复内容摘要
-
-### 新增的安全防护
-
-1. **ClassFilter** - 阻止JavaScript访问危险Java类
-2. **Java对象禁用** - 移除 `Java.type()` 等全局对象
-3. **SSRF防护** - 阻止访问内网地址和云服务元数据
-4. **URL白名单** - HTTP请求仅允许公网地址
-
-### 修复的文件
-
-- `JsPlaygroundExecutor.java` - 使用安全引擎
-- `JsParserExecutor.java` - 使用安全引擎
-- `JsHttpClient.java` - 添加SSRF防护
-- `SecurityClassFilter.java` - **新文件**：类过滤器
-
----
-
-## 🧪 验证修复是否生效
-
-### 测试1: 验证系统命令执行已被阻止
-
-访问演练场，执行以下测试代码：
-
-```javascript
-// ==UserScript==
-// @name         安全验证测试
-// @type         test
-// @match        https://test.com/*
-// ==/UserScript==
-
-function parse(shareLinkInfo, http, logger) {
-    try {
-        var Runtime = Java.type('java.lang.Runtime');
-        logger.error('【严重问题】Java.type仍然可用！');
-        return '失败：未修复';
-    } catch (e) {
-        logger.info('✅ 安全：' + e.message);
-        return '成功：已修复';
-    }
-}
-```
-
-**期望结果**: 
-```
-✅ 安全：ReferenceError: "Java" is not defined
-成功：已修复
-```
-
-**如果看到"失败：未修复"，说明修复未生效，请检查编译是否成功！**
-
-### 测试2: 验证SSRF防护
-
-```javascript
-function parse(shareLinkInfo, http, logger) {
-    try {
-        var response = http.get('http://127.0.0.1:8080/admin');
-        logger.error('【严重问题】可以访问内网！');
-        return '失败：SSRF未修复';
-    } catch (e) {
-        logger.info('✅ 安全：' + e);
-        return '成功：SSRF已修复';
-    }
-}
-```
-
-**期望结果**:
-```
-✅ 安全：SecurityException: 🔒 安全拦截: 禁止访问内网地址
-成功：SSRF已修复
-```
-
----
-
-## 📊 安全评级
-
-### 修复前
-- **评级**: 🔴 F级（完全不安全）
-- **风险**: 服务器可被完全控制
-- **建议**: 🚨 **立即下线服务**
-
-### 修复后
-- **评级**: 🟢 A级（安全）
-- **风险**: 低（已实施多层防护）
-- **建议**: ✅ 可安全使用
-
----
-
-## 🔍 如何检查您是否受影响
-
-### 检查版本
-
-查看修改时间：
-
-```bash
-# 检查关键文件是否包含安全修复
-grep -n "SecurityClassFilter" parser/src/main/java/cn/qaiu/parser/customjs/JsPlaygroundExecutor.java
-
-# 如果输出为空，说明未修复
-# 如果有输出，说明已修复
-```
-
-### 检查日志
-
-查看是否有攻击尝试：
-
-```bash
-# 搜索可疑的系统调用
-grep -r "Runtime\|ProcessBuilder\|System\.exec" logs/
-
-# 如果发现大量此类日志，可能已被攻击
-```
-
----
-
-## 🆘 紧急联系
-
-如果发现以下情况，请立即采取行动：
-
-### 已被攻击的迹象
-
-1. ❌ 服务器上出现陌生文件
-2. ❌ 系统负载异常高
-3. ❌ 发现陌生进程
-4. ❌ 配置文件被修改
-5. ❌ 日志中有大量异常请求
-
-### 应对措施
-
-1. **立即下线服务**
-   ```bash
-   ./bin/stop.sh
-   ```
-
-2. **隔离服务器**
-   - 断开网络连接（如果可能）
-   - 保存日志证据
-
-3. **检查受损范围**
-   ```bash
-   # 检查最近修改的文件
-   find / -type f -mtime -1 -ls 2>/dev/null
-   
-   # 检查可疑进程
-   ps aux | grep -E "nc|bash|sh|python|perl"
-   
-   # 检查网络连接
-   netstat -antp | grep ESTABLISHED
-   ```
-
-4. **备份日志**
-   ```bash
-   tar -czf logs-backup-$(date +%Y%m%d).tar.gz logs/
-   ```
-
-5. **应用安全补丁并重新部署**
-
-6. **修改所有密码和密钥**
-
----
-
-## 📚 详细文档
-
-- **完整修复说明**: `parser/SECURITY_FIX_SUMMARY.md`
-- **安全测试指南**: `parser/doc/SECURITY_TESTING_GUIDE.md`
-- **快速测试**: `parser/SECURITY_TEST_README.md`
-
----
-
-## ✅ 修复确认清单
-
-部署后请确认：
-
-- [ ] 代码已更新到最新版本
-- [ ] Maven重新编译成功
-- [ ] SecurityTest所有测试通过
-- [ ] 演练场测试显示"安全"
-- [ ] 日志中有"🔒 安全的JavaScript引擎初始化成功"
-- [ ] 尝试访问危险类时出现"安全拦截"日志
-- [ ] HTTP请求内网地址被阻止
-- [ ] 服务运行正常
-
----
-
-## 🎓 经验教训
-
-### 问题根源
-
-1. **过度信任用户输入** - 允许执行任意JavaScript
-2. **缺少沙箱隔离** - Nashorn默认允许访问所有Java类
-3. **没有安全审计** - 上线前未进行安全测试
-
-### 预防措施
-
-1. ✅ **永远不要信任用户输入**
-2. ✅ **使用沙箱隔离执行不可信代码**
-3. ✅ **实施最小权限原则**
-4. ✅ **定期安全审计**
-5. ✅ **关注依赖库的安全更新**
-
-### 长期计划
-
-考虑迁移到 **GraalVM JavaScript**：
-- 默认沙箱隔离
-- 更好的安全性
-- 更好的性能
-- 活跃维护
-
----
-
-## 📞 支持
-
-如有问题，请查看：
-- 详细文档: `parser/SECURITY_FIX_SUMMARY.md`
-- 测试指南: `parser/doc/SECURITY_TESTING_GUIDE.md`
-
----
-
-**重要提醒**: 
-- ⚠️ 这是一个严重的安全漏洞
-- ⚠️ 必须立即修复
-- ⚠️ 修复后必须验证
-- ⚠️ 如已被攻击，请遵循应急响应流程
-
-**修复优先级**: 🔴🔴🔴 **最高** - 立即处理
-
----
-
-最后更新: 2025-11-28  
-状态: ✅ 修复完成，等待部署验证
-

parser/doc/security/SSRF_PROTECTION.md

@@ -1,296 +0,0 @@
-# SSRF防护策略说明
-
-## 🛡️ 当前防护策略（已优化）
-
-为了保证功能可用性和安全性的平衡，SSRF防护策略已调整为**宽松模式**，只拦截明确的危险请求。
-
----
-
-## ✅ 允许的请求
-
-以下请求**不会被拦截**，可以正常使用：
-
-### 1. 外网域名 ✅
-```javascript
-http.get('https://www.example.com/api/data')  // ✅ 允许
-http.get('http://api.github.com/repos')       // ✅ 允许
-http.get('https://cdn.jsdelivr.net/file.js')  // ✅ 允许
-```
-
-### 2. 公网IP ✅
-```javascript
-http.get('http://8.8.8.8/api')               // ✅ 允许（公网IP）
-http.get('https://1.1.1.1/dns-query')        // ✅ 允许（Cloudflare DNS）
-```
-
-### 3. DNS解析失败的域名 ✅
-```javascript
-// 即使DNS暂时无法解析，也允许继续
-http.get('http://some-new-domain.com')       // ✅ 允许（DNS失败不拦截）
-```
-
----
-
-## ❌ 拦截的请求
-
-以下请求**会被拦截**，保护服务器安全：
-
-### 1. 本地回环地址 ❌
-```javascript
-http.get('http://127.0.0.1:8080/admin')      // ❌ 拦截
-http.get('http://localhost/secret')          // ❌ 拦截（解析到127.0.0.1）
-http.get('http://[::1]/api')                 // ❌ 拦截（IPv6本地）
-```
-
-### 2. 内网IP地址 ❌
-```javascript
-http.get('http://192.168.1.1/config')        // ❌ 拦截（内网C类）
-http.get('http://10.0.0.5/admin')            // ❌ 拦截（内网A类）
-http.get('http://172.16.0.1/api')            // ❌ 拦截（内网B类）
-```
-
-### 3. 云服务元数据API ❌
-```javascript
-http.get('http://169.254.169.254/latest/meta-data/')           // ❌ 拦截（AWS/阿里云）
-http.get('http://metadata.google.internal/computeMetadata/')   // ❌ 拦截（GCP）
-http.get('http://100.100.100.200/latest/meta-data/')          // ❌ 拦截（阿里云）
-```
-
-### 4. 解析到内网的域名 ❌
-```javascript
-// 如果域名DNS解析指向内网IP，会被拦截
-http.get('http://internal.company.com')      // ❌ 拦截（如果解析到192.168.x.x）
-```
-
----
-
-## 🔍 检测逻辑
-
-### 防护流程
-
-```
-用户请求 URL
-    ↓
-1. 检查是否为云服务元数据API域名
-    ├─ 是 → ❌ 拦截
-    └─ 否 → 继续
-    ↓
-2. 检查Host是否为IP地址格式
-    ├─ 是 → 检查是否为内网IP
-    │       ├─ 是 → ❌ 拦截
-    │       └─ 否 → ✅ 允许
-    └─ 否（域名）→ 继续
-    ↓
-3. 尝试DNS解析域名
-    ├─ 解析成功
-    │   ├─ IP为内网 → ❌ 拦截
-    │   └─ IP为公网 → ✅ 允许
-    └─ 解析失败 → ✅ 允许（不阻止）
-```
-
-### 内网IP判断规则
-
-使用正则表达式匹配：
-
-```java
-^(127\..*|                    // 127.0.0.0/8    - 本地回环
-  10\..*|                     // 10.0.0.0/8     - 内网A类
-  172\.(1[6-9]|2[0-9]|3[01])\..*|  // 172.16.0.0/12  - 内网B类
-  192\.168\..*|               // 192.168.0.0/16 - 内网C类
-  169\.254\..*|               // 169.254.0.0/16 - 链路本地
-  ::1|                        // IPv6本地回环
-  [fF][cCdD].*)               // IPv6唯一本地地址
-```
-
----
-
-## 📊 策略对比
-
-| 场景 | 严格模式（原版） | 宽松模式（当前）✅ |
-|------|-----------------|-------------------|
-| 外网域名 | 可能被拦截 | ✅ 允许 |
-| DNS解析失败 | 被拦截 | ✅ 允许 |
-| 公网IP | ✅ 允许 | ✅ 允许 |
-| 内网IP | ❌ 拦截 | ❌ 拦截 |
-| 本地回环 | ❌ 拦截 | ❌ 拦截 |
-| 云服务元数据 | ❌ 拦截 | ❌ 拦截 |
-| 解析到内网的域名 | ❌ 拦截 | ❌ 拦截 |
-
----
-
-## 🧪 测试用例
-
-### 测试1: 正常外网请求 ✅
-
-```javascript
-function parse(shareLinkInfo, http, logger) {
-    try {
-        var response = http.get('https://httpbin.org/get');
-        logger.info('✅ 成功访问外网: ' + response.substring(0, 50));
-        return 'SUCCESS';
-    } catch (e) {
-        logger.error('❌ 外网请求被拦截（不应该）: ' + e.message);
-        return 'FAILED';
-    }
-}
-```
-
-**期望结果**: ✅ 成功访问
-
-### 测试2: 内网攻击拦截 ❌
-
-```javascript
-function parse(shareLinkInfo, http, logger) {
-    try {
-        var response = http.get('http://127.0.0.1:6400/');
-        logger.error('❌ 内网访问成功（不应该）');
-        return 'SECURITY_BREACH';
-    } catch (e) {
-        logger.info('✅ 内网访问被拦截: ' + e.message);
-        return 'PROTECTED';
-    }
-}
-```
-
-**期望结果**: ✅ 被拦截，显示"安全拦截: 禁止访问内网IP地址"
-
-### 测试3: 云服务元数据拦截 ❌
-
-```javascript
-function parse(shareLinkInfo, http, logger) {
-    try {
-        var response = http.get('http://169.254.169.254/latest/meta-data/');
-        logger.error('❌ 元数据API访问成功（不应该）');
-        return 'SECURITY_BREACH';
-    } catch (e) {
-        logger.info('✅ 元数据API被拦截: ' + e.message);
-        return 'PROTECTED';
-    }
-}
-```
-
-**期望结果**: ✅ 被拦截，显示"安全拦截: 禁止访问云服务元数据API"
-
----
-
-## 🎯 安全建议
-
-### ✅ 当前策略适用于
-
-- 需要访问多种外网API的场景
-- 网盘、文件分享等服务
-- 需要爬取外网资源
-- 对可用性要求较高的环境
-
-### ⚠️ 如需更严格的防护
-
-如果你的应用场景需要更严格的安全控制，可以考虑：
-
-#### 1. 白名单模式
-
-只允许访问特定域名：
-
-```java
-private static final String[] ALLOWED_DOMAINS = {
-    "api.example.com",
-    "cdn.example.com"
-};
-
-private void validateUrlSecurity(String url) {
-    String host = new URI(url).getHost();
-    boolean allowed = false;
-    for (String domain : ALLOWED_DOMAINS) {
-        if (host.equals(domain) || host.endsWith("." + domain)) {
-            allowed = true;
-            break;
-        }
-    }
-    if (!allowed) {
-        throw new SecurityException("域名不在白名单中");
-    }
-}
-```
-
-#### 2. 协议限制
-
-只允许HTTPS：
-
-```java
-String scheme = uri.getScheme();
-if (!"https".equalsIgnoreCase(scheme)) {
-    throw new SecurityException("仅允许HTTPS协议");
-}
-```
-
-#### 3. 端口限制
-
-只允许标准端口（80, 443）：
-
-```java
-int port = uri.getPort();
-if (port != -1 && port != 80 && port != 443) {
-    throw new SecurityException("仅允许标准HTTP/HTTPS端口");
-}
-```
-
----
-
-## 📝 配置说明
-
-### 修改黑名单
-
-在 `JsHttpClient.java` 中修改：
-
-```java
-// 危险域名黑名单
-private static final String[] DANGEROUS_HOSTS = {
-    "localhost",
-    "169.254.169.254",           // AWS/阿里云元数据
-    "metadata.google.internal",  // GCP元数据
-    "100.100.100.200",          // 阿里云元数据
-    // 添加更多...
-};
-```
-
-### 修改内网IP规则
-
-```java
-// 内网IP正则表达式
-private static final Pattern PRIVATE_IP_PATTERN = Pattern.compile(
-    "^(127\\..*|10\\..*|172\\.(1[6-9]|2[0-9]|3[01])\\..*|192\\.168\\..*|169\\.254\\..*|::1|[fF][cCdD].*)"
-);
-```
-
----
-
-## 🔄 策略变更历史
-
-### v2 - 宽松模式（当前）✅
-- **日期**: 2025-11-29
-- **变更**: 
-  - DNS解析失败不拦截
-  - URL格式错误不拦截
-  - 只拦截明确的内网攻击
-- **原因**: 避免误杀正常外网请求
-
-### v1 - 严格模式
-- **日期**: 2025-11-28
-- **变更**: 初始实现
-- **问题**: 过于严格，导致很多正常请求被拦截
-
----
-
-## 📞 反馈
-
-如果遇到以下情况，请考虑调整策略：
-
-1. **正常外网请求被拦截** → 检查DNS解析、域名是否在黑名单
-2. **内网攻击未被拦截** → 添加更多内网IP段或域名黑名单
-3. **性能问题** → 考虑缓存DNS解析结果
-
----
-
-**最后更新**: 2025-11-29  
-**当前版本**: v2 - 宽松模式  
-**安全级别**: ⚠️ 中等（建议生产环境根据实际需求调整）
-

parser/doc/security/test-security.sh

@@ -1,59 +0,0 @@
-#!/bin/bash
-
-# JavaScript执行器安全测试脚本
-# 用于快速执行所有安全测试用例
-
-echo "========================================"
-echo "  JavaScript执行器安全测试"
-echo "========================================"
-echo ""
-
-# 进入parser目录
-cd "$(dirname "$0")"
-
-echo "📋 测试用例列表:"
-echo "  1. 系统命令执行测试 🔴"
-echo "  2. 文件系统访问测试 🔴"
-echo "  3. 系统属性访问测试 🟡"
-echo "  4. 反射攻击测试 🔴"
-echo "  5. 网络Socket测试 🔴"
-echo "  6. JVM退出测试 🔴"
-echo "  7. HTTP客户端SSRF测试 🟡"
-echo ""
-
-echo "⚠️  警告: 这些测试包含危险代码，仅用于安全验证！"
-echo ""
-
-read -p "是否继续执行测试? (y/n): " -n 1 -r
-echo ""
-
-if [[ ! $REPLY =~ ^[Yy]$ ]]; then
-    echo "测试已取消"
-    exit 1
-fi
-
-echo ""
-echo "🚀 开始执行测试..."
-echo ""
-
-# 执行JUnit测试
-mvn test -Dtest=SecurityTest
-
-# 检查测试结果
-if [ $? -eq 0 ]; then
-    echo ""
-    echo "✅ 测试执行完成"
-    echo ""
-    echo "📊 请检查测试日志，确认:"
-    echo "  ✓ 所有高危测试（系统命令、文件访问等）应该失败"
-    echo "  ✓ 所有日志中不应该出现【安全漏洞】标记"
-    echo "  ⚠ 如果出现安全漏洞警告，请立即修复！"
-else
-    echo ""
-    echo "❌ 测试执行失败"
-fi
-
-echo ""
-echo "📖 详细文档请参考: doc/SECURITY_TESTING_GUIDE.md"
-echo ""
-

parser/pom.xml

@@ -1,287 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-    <modelVersion>4.0.0</modelVersion>
-
-    <parent>
-        <groupId>cn.qaiu</groupId>
-        <artifactId>netdisk-fast-download</artifactId>
-        <version>${revision}</version>
-    </parent>
-
-    <groupId>cn.qaiu</groupId>
-    <artifactId>parser</artifactId>
-    <version>${parserVersion}</version>
-    <packaging>jar</packaging>
-
-    <name>cn.qaiu:parser</name>
-    <description>NFD parser module</description>
-    <url>https://qaiu.top</url>
-
-    <licenses>
-        <license>
-            <name>MIT License</name>
-            <url>https://opensource.org/license/mit</url>
-        </license>
-    </licenses>
-
-    <developers>
-        <developer>
-            <name>qaiu</name>
-            <email>[email protected]</email>
-            <organization>https://qaiu.top</organization>
-        </developer>
-    </developers>
-
-    <scm>
-        <connection>scm:git:https://github.com/${github.owner}/${github.repo}.git</connection>
-        <developerConnection>scm:git:ssh://[email protected]:${github.owner}/${github.repo}.git</developerConnection>
-        <url>https://github.com/${github.owner}/${github.repo}</url>
-    </scm>
-
-    <distributionManagement>
-        <snapshotRepository>
-            <id>sonatype</id>
-            <url>https://s01.oss.sonatype.org/content/repositories/snapshots/</url>
-        </snapshotRepository>
-        <repository>
-            <id>sonatype</id>
-            <url>https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/</url>
-        </repository>
-    </distributionManagement>
-
-    <properties>
-        <java.version>17</java.version>
-        <maven.compiler.source>17</maven.compiler.source>
-        <maven.compiler.target>17</maven.compiler.target>
-        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-
-        <!-- Versions -->
-        <vertx.version>4.5.27</vertx.version>
-        <org.reflections.version>0.10.2</org.reflections.version>
-        <lombok.version>1.18.38</lombok.version>
-        <slf4j.version>2.0.16</slf4j.version>
-        <commons-lang3.version>3.18.0</commons-lang3.version>
-        <jackson.version>2.18.6</jackson.version>
-        <logback.version>1.5.32</logback.version>
-        <junit.version>4.13.2</junit.version>
-    </properties>
-
-    <dependencies>
-        <!-- Logging -->
-        <dependency>
-            <groupId>ch.qos.logback</groupId>
-            <artifactId>logback-classic</artifactId>
-            <version>${logback.version}</version>
-            <scope>runtime</scope>
-        </dependency>
-        <dependency>
-            <groupId>org.slf4j</groupId>
-            <artifactId>slf4j-api</artifactId>
-            <version>${slf4j.version}</version>
-        </dependency>
-
-        <!-- Vert.x Web Client -->
-        <dependency>
-            <groupId>io.vertx</groupId>
-            <artifactId>vertx-web-client</artifactId>
-            <version>${vertx.version}</version>
-        </dependency>
-
-        <!-- Common Utils -->
-        <dependency>
-            <groupId>org.apache.commons</groupId>
-            <artifactId>commons-lang3</artifactId>
-            <version>${commons-lang3.version}</version>
-        </dependency>
-
-        <!-- Script Engine -->
-        <dependency>
-            <groupId>org.openjdk.nashorn</groupId>
-            <artifactId>nashorn-core</artifactId>
-            <version>15.4</version>
-            <scope>compile</scope>
-        </dependency>
-
-        <!-- Compression (Brotli) -->
-        <dependency>
-            <groupId>org.brotli</groupId>
-            <artifactId>dec</artifactId>
-            <version>0.1.2</version>
-        </dependency>
-
-        <!-- Unit Test -->
-        <dependency>
-            <groupId>junit</groupId>
-            <artifactId>junit</artifactId>
-            <version>${junit.version}</version>
-            <scope>test</scope>
-        </dependency>
-    </dependencies>
-
-    <build>
-        <plugins>
-
-            <!-- 从 git remote origin 自动识别 GitHub 仓库地址 -->
-            <plugin>
-                <groupId>org.codehaus.gmavenplus</groupId>
-                <artifactId>gmavenplus-plugin</artifactId>
-                <version>4.1.1</version>
-                <dependencies>
-                    <dependency>
-                        <groupId>org.apache.groovy</groupId>
-                        <artifactId>groovy</artifactId>
-                        <version>4.0.24</version>
-                    </dependency>
-                </dependencies>
-                <executions>
-                    <execution>
-                        <phase>initialize</phase>
-                        <goals><goal>execute</goal></goals>
-                        <configuration>
-                            <scripts>
-                                <script>
-                                    def url = 'git remote get-url origin'.execute().text.trim()
-                                    def m = (url =~ 'github\\.com[:/]([^/]+)/([^/.]+?)(?:\\.git)?$')
-                                    if (m.find()) {
-                                        project.properties.setProperty('github.owner', m.group(1))
-                                        project.properties.setProperty('github.repo', m.group(2))
-                                    } else {
-                                        project.properties.setProperty('github.owner', 'qaiu')
-                                        project.properties.setProperty('github.repo', 'netdisk-fast-download')
-                                    }
-                                </script>
-                            </scripts>
-                        </configuration>
-                    </execution>
-                </executions>
-            </plugin>
-
-            <!-- 编译 -->
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-compiler-plugin</artifactId>
-                <version>3.13.0</version>
-                <configuration>
-                    <release>${maven.compiler.source}</release>
-                    <encoding>${project.build.sourceEncoding}</encoding>
-                </configuration>
-            </plugin>
-
-            <!-- 打包源码 -->
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-source-plugin</artifactId>
-                <version>3.3.0</version>
-                <executions>
-                    <execution>
-                        <id>attach-sources</id>
-                        <goals>
-                            <goal>jar</goal>
-                        </goals>
-                    </execution>
-                </executions>
-            </plugin>
-
-            <!-- Javadoc (空包防验证失败) -->
-            <!-- Javadoc（兼容新版配置，无需源码中存在注释） -->
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-javadoc-plugin</artifactId>
-                <version>3.7.0</version>
-                <executions>
-                    <execution>
-                        <id>attach-javadocs</id>
-                        <goals>
-                            <goal>jar</goal>
-                        </goals>
-                        <configuration>
-                            <!-- 忽略 Javadoc 错误 -->
-                            <failOnError>false</failOnError>
-                            <!-- 禁用 doclint（新版参数名改为 additionalOptions） -->
-                            <additionalOptions>-Xdoclint:none</additionalOptions>
-                            <!-- 如果项目源码中几乎没有 Javadoc，可设 true -->
-                            <quiet>true</quiet>
-                        </configuration>
-                    </execution>
-                </executions>
-            </plugin>
-
-            <!-- GPG 签名（新版插件推荐写法） -->
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-gpg-plugin</artifactId>
-                <version>3.2.7</version>
-                <executions>
-                    <execution>
-                        <id>sign-artifacts</id>
-                        <phase>verify</phase>
-                        <goals>
-                            <goal>sign</goal>
-                        </goals>
-                        <configuration>
-                            <!-- 避免在 CI 环境出现 TTY 错误 -->
-                            <gpgArguments>
-                                <arg>--batch</arg>
-                                <arg>--yes</arg>
-                                <arg>--pinentry-mode</arg>
-                                <arg>loopback</arg>
-                            </gpgArguments>
-                        </configuration>
-                    </execution>
-                </executions>
-            </plugin>
-
-            <!-- Sonatype Central 自动发布 -->
-            <plugin>
-                <groupId>org.sonatype.central</groupId>
-                <artifactId>central-publishing-maven-plugin</artifactId>
-                <version>0.6.0</version>
-                <extensions>true</extensions>
-                <configuration>
-                    <publishingServerId>sonatype</publishingServerId>
-                    <autoPublish>true</autoPublish>
-                </configuration>
-            </plugin>
-
-            <plugin>
-                <groupId>org.codehaus.mojo</groupId>
-                <artifactId>flatten-maven-plugin</artifactId>
-                <version>1.6.0</version>
-                <executions>
-                    <execution>
-                        <id>flatten</id>
-                        <phase>process-resources</phase>
-                        <goals>
-                            <goal>flatten</goal>
-                        </goals>
-                        <configuration>
-                            <updatePomFile>true</updatePomFile>
-                            <outputDirectory>${project.basedir}</outputDirectory>
-                            <flattenMode>ossrh</flattenMode>
-                        </configuration>
-                    </execution>
-                    <execution>
-                        <id>flatten.clean</id>
-                        <phase>clean</phase>
-                        <goals>
-                            <goal>clean</goal>
-                        </goals>
-                    </execution>
-                </executions>
-            </plugin>
-
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-deploy-plugin</artifactId>
-                <version>3.1.2</version>
-                <configuration>
-                    <pomFile>${project.basedir}/.flattened-pom.xml</pomFile>
-                </configuration>
-            </plugin>
-
-        </plugins>
-
-    </build>
-</project>

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

@@ -1,35 +0,0 @@
-package cn.qaiu;
-
-import io.vertx.core.Vertx;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-import cn.qaiu.parser.custom.CustomParserRegistry;
-
-public class WebClientVertxInit {
-    private volatile Vertx vertx = null;
-    private static final WebClientVertxInit INSTANCE = new WebClientVertxInit();
-
-    private static final Logger log = LoggerFactory.getLogger(WebClientVertxInit.class);
-
-    public static synchronized void init(Vertx vx) {
-        if (vx == null) {
-            throw new IllegalArgumentException("Vertx instance must not be null");
-        }
-        INSTANCE.vertx = vx;
-        
-        // 自动加载JavaScript解析器脚本
-        try {
-            CustomParserRegistry.autoLoadJsScripts();
-        } catch (Exception e) {
-            log.warn("自动加载JavaScript解析器脚本失败", e);
-        }
-    }
-
-    public static synchronized Vertx get() {
-        if (INSTANCE.vertx == null) {
-            throw new IllegalStateException("Vertx实例未初始化，请先调用 WebClientVertxInit.init(vertx)");
-        }
-        return INSTANCE.vertx;
-    }
-}

parser/src/main/java/cn/qaiu/entity/FileInfo.java

@@ -1,250 +0,0 @@
-package cn.qaiu.entity;
-
-import java.util.Map;
-
-public class FileInfo {
-
-    /**
-     * 文件名
-     */
-    private String fileName;
-
-    /**
-     * 文件ID
-     */
-    private String fileId;
-
-    private String fileIcon;
-
-    /**
-     * 文件大小(byte)
-     */
-    private Long size;
-
-    private String sizeStr;
-
-    /**
-     * 类型
-     */
-    private String fileType;
-
-    /**
-     * 文件路径
-     */
-    private String filePath;
-
-    /**
-     * 创建(上传)时间 yyyy-MM-dd HH:mm:ss格式
-     */
-    private String createTime;
-
-    /**
-     * 上次修改时间
-     */
-    private String updateTime;
-
-    /**
-     * 创建者
-     */
-    private String createBy;
-
-    /**
-     * 文件描述
-     */
-    private String description;
-
-    /**
-     * 下载次数
-     */
-    private Integer downloadCount;
-
-    /**
-     * 网盘标识
-     */
-    private String panType;
-
-    /**
-     * nfd下载链接(可能获取不到)
-     * note: 不是下载直链
-     */
-    private String parserUrl;
-
-    //预览地址
-    private String previewUrl;
-
-    // 文件hash默认类型为md5
-    private String hash;
-
-    /**
-     * 扩展参数
-     */
-    private Map<String, Object> extParameters;
-
-    public String getFileName() {
-        return fileName;
-    }
-
-    public FileInfo setFileName(String fileName) {
-        this.fileName = fileName;
-        return this;
-    }
-
-    public String getFileId() {
-        return fileId;
-    }
-
-    public FileInfo setFileId(String fileId) {
-        this.fileId = fileId;
-        return this;
-    }
-
-    public String getFileIcon() {
-        return fileIcon;
-    }
-
-    public FileInfo setFileIcon(String fileIcon) {
-        this.fileIcon = fileIcon;
-        return this;
-    }
-
-    public Long getSize() {
-        return size;
-    }
-
-    public FileInfo setSize(Long size) {
-        this.size = size;
-        return this;
-    }
-
-    public String getSizeStr() {
-        return sizeStr;
-    }
-
-    public FileInfo setSizeStr(String sizeStr) {
-        this.sizeStr = sizeStr;
-        return this;
-    }
-
-    public String getFileType() {
-        return fileType;
-    }
-
-    public FileInfo setFileType(String fileType) {
-        this.fileType = fileType;
-        return this;
-    }
-
-    public String getFilePath() {
-        return filePath;
-    }
-
-    public FileInfo setFilePath(String filePath) {
-        this.filePath = filePath;
-        return this;
-    }
-
-    public String getCreateTime() {
-        return createTime;
-    }
-
-    public FileInfo setCreateTime(String createTime) {
-        this.createTime = createTime;
-        return this;
-    }
-
-    public String getUpdateTime() {
-        return updateTime;
-    }
-
-    public FileInfo setUpdateTime(String updateTime) {
-        this.updateTime = updateTime;
-        return this;
-    }
-
-    public String getCreateBy() {
-        return createBy;
-    }
-
-    public FileInfo setCreateBy(String createBy) {
-        this.createBy = createBy;
-        return this;
-    }
-
-    public String getDescription() {
-        return description;
-    }
-
-    public FileInfo setDescription(String description) {
-        this.description = description;
-        return this;
-    }
-
-    public Integer getDownloadCount() {
-        return downloadCount;
-    }
-
-    public FileInfo setDownloadCount(Integer downloadCount) {
-        this.downloadCount = downloadCount;
-        return this;
-    }
-
-    public String getPanType() {
-        return panType;
-    }
-
-    public FileInfo setPanType(String panType) {
-        this.panType = panType;
-        return this;
-    }
-
-    public String getParserUrl() {
-        return parserUrl;
-    }
-
-    public FileInfo setParserUrl(String parserUrl) {
-        this.parserUrl = parserUrl;
-        return this;
-    }
-    public String getPreviewUrl() {
-        return previewUrl;
-    }
-    public FileInfo setPreviewUrl(String previewUrl) {
-        this.previewUrl = previewUrl;
-        return this;
-    }
-
-    public String getHash() {
-        return hash;
-    }
-
-    public FileInfo setHash(String hash) {
-        this.hash = hash;
-        return this;
-    }
-
-    public Map<String, Object> getExtParameters() {
-        return extParameters;
-    }
-
-    public FileInfo setExtParameters(Map<String, Object> extParameters) {
-        this.extParameters = extParameters;
-        return this;
-    }
-
-    @Override
-    public String toString() {
-        return "FileInfo{" +
-                "fileName='" + fileName + '\'' +
-                ", fileId='" + fileId + '\'' +
-                ", size=" + size +
-                ", fileType='" + fileType + '\'' +
-                ", filePath='" + filePath + '\'' +
-                ", createTime='" + createTime + '\'' +
-                ", updateTime='" + updateTime + '\'' +
-                ", createBy='" + createBy + '\'' +
-                ", description='" + description + '\'' +
-                ", downloadCount=" + downloadCount +
-                ", extParameters=" + extParameters +
-                '}';
-    }
-}

parser/src/main/java/cn/qaiu/entity/ShareLinkInfo.java

@@ -1,173 +0,0 @@
-package cn.qaiu.entity;
-
-import java.util.HashMap;
-import java.util.Map;
-
-public class ShareLinkInfo {
-
-    private String shareKey;      // 分享键
-
-    private String panName;       // 网盘名称
-    private String type;          // 分享类型
-    private String sharePassword; // 分享密码（如果存在）
-    private String shareUrl;      // 原始分享链接
-    private String standardUrl;   // 规范化的标准链接
-
-    /**
-     * 其他参数预定义
-     * dirId: 目录ID 传入
-     * auths: 认证相关 传入
-     * UA: 浏览器请求头 传入
-     * fileInfo: 解析成功的文件信息对象 传出
-     */
-    private Map<String, Object> otherParam;
-
-    private ShareLinkInfo(Builder builder) {
-        this.shareKey = builder.shareKey;
-        this.panName = builder.panName;
-        this.type = builder.type;
-        this.sharePassword = builder.sharePassword;
-        this.shareUrl = builder.shareUrl;
-        this.standardUrl = builder.standardUrl;
-        this.otherParam = builder.otherParam;
-    }
-
-    // Getter和Setter方法
-
-    public String getShareKey() {
-        return shareKey;
-    }
-
-    public String getPanName() {
-        return panName;
-    }
-
-    public void setShareKey(String shareKey) {
-        this.shareKey = shareKey;
-    }
-
-    public void setPanName(String panName) {
-        this.panName = panName;
-    }
-
-    public String getType() {
-        return type;
-    }
-
-    public void setType(String type) {
-        this.type = type;
-    }
-
-    public String getSharePassword() {
-        return sharePassword;
-    }
-
-    public void setSharePassword(String sharePassword) {
-        this.sharePassword = sharePassword;
-    }
-
-    public String getShareUrl() {
-        return shareUrl;
-    }
-
-    public void setShareUrl(String shareUrl) {
-        this.shareUrl = shareUrl;
-    }
-
-    public String getStandardUrl() {
-        return standardUrl;
-    }
-
-    public void setStandardUrl(String standardUrl) {
-        this.standardUrl = standardUrl;
-    }
-
-    public String getCacheKey() {
-        // 将type和shareKey组合成一个字符串作为缓存key
-        String key = type + ":" + shareKey;
-        if (type.equals("p115")) {
-            Object ua = otherParam != null ? otherParam.get("UA") : null;
-            if (ua != null) {
-                key += ("_" + ua.toString().hashCode());
-            }
-        }
-        return key;
-    }
-
-    public ShareLinkInfo setOtherParam(Map<String, Object> otherParam) {
-        this.otherParam = otherParam;
-        return this;
-    }
-
-    public Map<String, Object> getOtherParam() {
-        return otherParam;
-    }
-
-    // 静态方法创建建造者对象
-    public static ShareLinkInfo.Builder newBuilder() {
-        return new ShareLinkInfo.Builder();
-    }
-
-    // 建造者类
-    public static class Builder {
-        public String panName;        // 分享网盘名称
-        private String shareKey;      // 分享键
-        private String type;          // 分享类型 (网盘模板枚举的小写)
-        private String sharePassword = ""; // 分享密码（如果存在）
-        private String shareUrl;      // 原始分享链接
-        private String standardUrl;   // 规范化的标准链接
-        private Map<String, Object> otherParam = new HashMap<>();   // 其他参数
-
-        public Builder shareKey(String shareKey) {
-            this.shareKey = shareKey;
-            return this;
-        }
-
-        public Builder panName(String panName) {
-            this.panName = panName;
-            return this;
-        }
-
-        public Builder type(String type) {
-            this.type = type;
-            return this;
-        }
-
-        public Builder sharePassword(String sharePassword) {
-            this.sharePassword = sharePassword;
-            return this;
-        }
-
-        public Builder shareUrl(String shareUrl) {
-            this.shareUrl = shareUrl;
-            return this;
-        }
-
-        public Builder standardUrl(String standardUrl) {
-            this.standardUrl = standardUrl;
-            return this;
-        }
-
-        public Builder otherParam(Map<String, Object> otherParam) {
-            this.otherParam = otherParam;
-            return this;
-        }
-
-        public ShareLinkInfo build() {
-            return new ShareLinkInfo(this);
-        }
-    }
-
-    @Override
-    public String toString() {
-        return "ShareLinkInfo{" +
-                "shareKey='" + shareKey + '\'' +
-                ", panName='" + panName + '\'' +
-                ", type='" + type + '\'' +
-                ", sharePassword='" + sharePassword + '\'' +
-                ", shareUrl='" + shareUrl + '\'' +
-                ", standardUrl='" + standardUrl + '\'' +
-                ", otherParam='" + otherParam + '\'' +
-                '}';
-    }
-}

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

@@ -1,243 +0,0 @@
-package cn.qaiu.parser;//package cn.qaiu.lz.common.parser;
-
-import cn.qaiu.WebClientVertxInit;
-import cn.qaiu.entity.FileInfo;
-import cn.qaiu.entity.ShareLinkInfo;
-import cn.qaiu.parser.clientlink.ClientLinkGeneratorFactory;
-import cn.qaiu.parser.clientlink.ClientLinkType;
-import io.vertx.core.Future;
-import io.vertx.core.Promise;
-
-import java.util.function.Supplier;
-import java.util.List;
-import java.util.Map;
-import java.util.concurrent.Executors;
-import java.util.concurrent.ScheduledExecutorService;
-import java.util.concurrent.ScheduledFuture;
-import java.util.concurrent.TimeUnit;
-import java.util.concurrent.TimeoutException;
-import java.util.concurrent.atomic.AtomicBoolean;
-
-public interface IPanTool extends AutoCloseable {
-
-    /** 同步等待超时时间（秒） */
-    long SYNC_TIMEOUT_SECONDS = 120;
-
-    ScheduledExecutorService CLOSE_AFTER_SCHEDULER = Executors.newSingleThreadScheduledExecutor(r -> {
-        Thread t = new Thread(r, "pan-tool-close-after");
-        t.setDaemon(true);
-        return t;
-    });
-
-    /**
-     * 解析文件
-     * @return 文件内容
-     */
-    Future<String> parse();
-
-    static <T> Future<T> closeAfter(IPanTool tool, Supplier<Future<T>> action) {
-        Promise<T> promise = Promise.promise();
-        AtomicBoolean cleanupDone = new AtomicBoolean(false);
-        ScheduledFuture<?> cleanupTask = null;
-        try {
-            Future<T> future = action.get();
-            if (future == null) {
-                closeQuietly(tool);
-                return Future.failedFuture("解析器返回空 Future");
-            }
-
-            cleanupTask = CLOSE_AFTER_SCHEDULER.schedule(() -> {
-                if (cleanupDone.compareAndSet(false, true)) {
-                    closeQuietly(tool);
-                    failOnVertxContext(promise, "解析超时（" + SYNC_TIMEOUT_SECONDS + "秒）");
-                }
-            }, SYNC_TIMEOUT_SECONDS, TimeUnit.SECONDS);
-
-            ScheduledFuture<?> scheduledCleanupTask = cleanupTask;
-            future.onComplete(ar -> {
-                scheduledCleanupTask.cancel(false);
-                if (!cleanupDone.compareAndSet(false, true)) {
-                    return;
-                }
-                closeQuietly(tool);
-                if (ar.succeeded()) {
-                    promise.tryComplete(ar.result());
-                } else {
-                    promise.tryFail(ar.cause());
-                }
-            });
-            return promise.future();
-        } catch (Throwable t) {
-            if (cleanupTask != null) {
-                cleanupTask.cancel(false);
-            }
-            closeQuietly(tool);
-            return Future.failedFuture(t);
-        }
-    }
-
-    private static <T> void failOnVertxContext(Promise<T> promise, String message) {
-        try {
-            WebClientVertxInit.get().runOnContext(ignored -> promise.tryFail(message));
-        } catch (Exception ignored) {
-            promise.tryFail(message);
-        }
-    }
-
-    static void closeQuietly(IPanTool tool) {
-        if (tool == null) {
-            return;
-        }
-        try {
-            tool.close();
-        } catch (Exception ignored) {
-            // ignore cleanup failures
-        }
-    }
-
-    static void shutdownCloseAfterScheduler() {
-        CLOSE_AFTER_SCHEDULER.shutdownNow();
-    }
-
-    default String parseSync() {
-        return timedJoin(parse());
-    }
-
-    /**
-     * 解析文件列表
-     * @return List
-     */
-    default Future<List<FileInfo>> parseFileList() {
-        Promise<List<FileInfo>> promise = Promise.promise();
-        promise.fail("Not implemented yet");
-        return promise.future();
-    }
-
-    default List<FileInfo> parseFileListSync() {
-        return timedJoin(parseFileList());
-    }
-
-    /**
-     * 根据文件ID获取下载链接
-     * @return url
-     */
-    default Future<String> parseById() {
-        Promise<String> promise = Promise.promise();
-        promise.complete("Not implemented yet");
-        return promise.future();
-    }
-
-    default String parseByIdSync() {
-        return timedJoin(parseById());
-    }
-
-    /**
-     * 解析文件并生成客户端下载链接
-     * @return Future<Map<ClientLinkType, String>> 客户端下载链接集合
-     */
-    default Future<Map<ClientLinkType, String>> parseWithClientLinks() {
-        Promise<Map<ClientLinkType, String>> promise = Promise.promise();
-        
-        // 首先尝试获取 ShareLinkInfo
-        ShareLinkInfo shareLinkInfo = getShareLinkInfo();
-        if (shareLinkInfo == null) {
-            promise.fail("无法获取 ShareLinkInfo");
-            return promise.future();
-        }
-        
-        // 检查是否已经有下载链接元数据
-        String existingDownloadUrl = (String) shareLinkInfo.getOtherParam().get("downloadUrl");
-        if (existingDownloadUrl != null && !existingDownloadUrl.trim().isEmpty()) {
-            // 如果已经有下载链接，直接生成客户端链接
-            try {
-                Map<ClientLinkType, String> clientLinks = 
-                    ClientLinkGeneratorFactory.generateAll(shareLinkInfo);
-                promise.complete(clientLinks);
-                return promise.future();
-            } catch (Exception e) {
-                // 如果生成失败，继续尝试解析
-            }
-        }
-        
-        // 尝试解析获取下载链接
-        parse().onComplete(result -> {
-            if (result.succeeded()) {
-                try {
-                    String downloadUrl = result.result();
-                    if (downloadUrl != null && !downloadUrl.trim().isEmpty()) {
-                        // 确保下载链接已存储到 otherParam 中
-                        shareLinkInfo.getOtherParam().put("downloadUrl", downloadUrl);
-                        
-                        // 生成客户端链接
-                        Map<ClientLinkType, String> clientLinks = 
-                            ClientLinkGeneratorFactory.generateAll(shareLinkInfo);
-                        promise.complete(clientLinks);
-                    } else {
-                        promise.fail("解析结果为空，无法生成客户端链接");
-                    }
-                } catch (Exception e) {
-                    promise.fail("生成客户端链接失败: " + e.getMessage());
-                }
-            } else {
-                // 解析失败时，尝试使用分享链接作为默认下载链接
-                try {
-                    String fallbackUrl = shareLinkInfo.getShareUrl();
-                    if (fallbackUrl != null && !fallbackUrl.trim().isEmpty()) {
-                        // 使用分享链接作为默认下载链接
-                        shareLinkInfo.getOtherParam().put("downloadUrl", fallbackUrl);
-                        
-                        // 尝试生成客户端链接
-                        Map<ClientLinkType, String> clientLinks = 
-                            ClientLinkGeneratorFactory.generateAll(shareLinkInfo);
-                        promise.complete(clientLinks);
-                    } else {
-                        promise.fail("解析失败且无法使用分享链接作为默认下载链接: " + result.cause().getMessage());
-                    }
-                } catch (Exception e) {
-                    promise.fail("解析失败且生成默认客户端链接失败: " + result.cause().getMessage());
-                }
-            }
-        });
-        
-        return promise.future();
-    }
-
-    /**
-     * 解析文件并生成客户端下载链接（同步版本）
-     * @return Map<ClientLinkType, String> 客户端下载链接集合
-     */
-    default Map<ClientLinkType, String> parseWithClientLinksSync() {
-        return timedJoin(parseWithClientLinks());
-    }
-
-    /**
-     * 获取 ShareLinkInfo 对象
-     * 子类需要实现此方法来提供 ShareLinkInfo
-     * @return ShareLinkInfo 对象
-     */
-    default ShareLinkInfo getShareLinkInfo() {
-        return null;
-    }
-
-    @Override
-    default void close() {
-        // default no-op
-    }
-
-    /**
-     * 带超时的同步等待工具方法，替代无超时的 join()
-     */
-    private static <T> T timedJoin(Future<T> future) {
-        try {
-            return future.toCompletionStage().toCompletableFuture()
-                    .get(SYNC_TIMEOUT_SECONDS, TimeUnit.SECONDS);
-        } catch (InterruptedException e) {
-            Thread.currentThread().interrupt();
-            throw new RuntimeException("线程被中断", e);
-        } catch (TimeoutException e) {
-            throw new RuntimeException("同步等待超时（" + SYNC_TIMEOUT_SECONDS + "秒）", e);
-        } catch (java.util.concurrent.ExecutionException e) {
-            throw new RuntimeException(e.getCause() != null ? e.getCause() : e);
-        }
-    }
-}