fix:Checkstyle check

.github/scripts/checkstyle-pr.sh

@@ -0,0 +1,162 @@
+#!/bin/bash
+# ============================================================
+# checkstyle-pr.sh - 增量检查（扫描整个变更文件，不过滤行号）
+# 功能：对本次提交中变更的 Java 文件执行完整的 Checkstyle 检查
+# 不阻断构建，生成完整报告
+# ============================================================
+
+set -e
+
+echo "========================================"
+echo "  Checkstyle 增量检查"
+echo "  扫描范围：本次变更的 Java 文件（完整文件）"
+echo "========================================"
+
+# 1. 确定目标分支
+if [ -n "$GITHUB_BASE_REF" ]; then
+    BASE_BRANCH="origin/$GITHUB_BASE_REF"
+elif [ -n "$GITHUB_REF" ] && [ "$GITHUB_EVENT_NAME" == "push" ]; then
+    BASE_BRANCH="HEAD^"
+else
+    if git rev-parse --verify origin/main >/dev/null 2>&1; then
+        BASE_BRANCH="origin/main"
+    elif git rev-parse --verify origin/develop >/dev/null 2>&1; then
+        BASE_BRANCH="origin/develop"
+    else
+        echo "❌ 无法确定目标分支，请设置 BASE_BRANCH 环境变量。"
+        exit 1
+    fi
+    echo "🔍 本地运行模式，对比分支: $BASE_BRANCH"
+fi
+
+# 2. 获取变更的 Java 文件
+CHANGED_FILES=$(git diff --name-only "$BASE_BRANCH" HEAD 2>/dev/null | grep '\.java$' || true)
+
+if [ -z "$CHANGED_FILES" ]; then
+    echo "✅ 没有 Java 文件变更，跳过检查。"
+    exit 0
+fi
+
+echo "📝 变更的 Java 文件："
+echo "$CHANGED_FILES"
+echo "----------------------------------------"
+
+# 按模块分组
+declare -A module_files
+for file in $CHANGED_FILES; do
+    module="${file%%/*}"
+    if [ -z "$module" ] || [ "$module" == "$file" ]; then
+        echo "⚠️ 忽略根目录文件: $file"
+        continue
+    fi
+    rel="${file#$module/}"
+    if [ -z "${module_files[$module]}" ]; then
+        module_files[$module]="$rel"
+    else
+        module_files[$module]="${module_files[$module]},$rel"
+    fi
+done
+
+if [ ${#module_files[@]} -eq 0 ]; then
+    echo "⚠️ 没有识别到任何模块，跳过检查。"
+    exit 0
+fi
+
+echo "📝 按模块分组后的相对路径："
+for module in "${!module_files[@]}"; do
+    echo "  $module: ${module_files[$module]}"
+done
+echo "----------------------------------------"
+
+total_violations=0
+
+# 对每个模块执行 Checkstyle
+for module in "${!module_files[@]}"; do
+    file_list="${module_files[$module]}"
+    echo "🚀 扫描模块: $module"
+    echo "   文件列表: $file_list"
+
+    if [ ! -d "$module" ] || [ ! -f "$module/pom.xml" ]; then
+        echo "⚠️ 模块目录 $module 不存在或没有 pom.xml，跳过。"
+        continue
+    fi
+
+    echo "   - 生成 XML 报告..."
+    set +e
+    (cd "$module" && mvn checkstyle:check -X ... 2>&1 | grep "Loading checkstyle configuration" \
+        -Dcheckstyle.config.location=../checkstyle/huawei-checkstyle.xml \
+        -Dcheckstyle.includes="$file_list" \
+        -Dcheckstyle.violationSeverity=warning)
+    if [ $? -ne 0 ]; then
+        echo "   ⚠️ 模块 $module 的 Checkstyle 检查失败（但继续）"
+    fi
+    set -e
+
+    echo "   - 生成 HTML 报告..."
+    set +e
+    (cd "$module" && mvn checkstyle:checkstyle \
+        -Dcheckstyle.config.location=../checkstyle/huawei-checkstyle.xml \
+        -Dcheckstyle.includes="$file_list" \
+        -Dcheckstyle.outputFormat=html \
+        -Dcheckstyle.violationSeverity=warning)
+    if [ $? -ne 0 ]; then
+        echo "   ⚠️ 模块 $module 的 HTML 报告生成失败（但继续）"
+    fi
+    set -e
+
+    report_file="$module/target/checkstyle-result.xml"
+    if [ -f "$report_file" ]; then
+        count=$(grep -c '<error' "$report_file" 2>/dev/null || true)
+    else
+        count=0
+    fi
+    echo ""
+done
+
+echo "----------------------------------------"
+if [ $total_violations -eq 0 ]; then
+    echo "✅ 所有变更文件未发现违规！"
+else
+    echo "⚠️ 总计发现 $total_violations 个违规。"
+    # 显示部分违规摘要（第一个有违规的模块）
+    echo ""
+    echo "📋 违规摘要（前 30 条）："
+    for module in "${!module_files[@]}"; do
+        report_file="$module/target/checkstyle-result.xml"
+        if [ -f "$report_file" ] && [ $(grep -c '<error' "$report_file" || true) -gt 0 ]; then
+            grep '<error' "$report_file" | head -30 | sed 's/<error //; s/\/>//' | \
+                sed 's|line="|行号: |g; s|column="|列: |g; s|severity="|严重性: |g; s|message="|信息: |g; s|source="||g' | \
+                while read -r line; do
+                    echo "  $line"
+                done || true
+            break
+        fi
+    done
+fi
+
+# Step Summary
+if [ -n "$GITHUB_STEP_SUMMARY" ]; then
+    {
+        echo "## 📋 Checkstyle 汇总报告"
+        echo ""
+        echo "| 指标 | 结果 |"
+        echo "|------|------|"
+        if [ $total_violations -eq 0 ]; then
+            echo "| 总违规数 | ✅ **0** |"
+        else
+            echo "| 总违规数 | ⚠️ **$total_violations** |"
+        fi
+        echo "| 涉及模块 | ${!module_files[*]} |"
+        echo ""
+        echo "📥 完整报告已作为 Artifact 上传。"
+    } >> "$GITHUB_STEP_SUMMARY"
+fi
+
+# 根据违规数决定退出码
+if [ $total_violations -eq 0 ]; then
+    echo "✅ 检查通过，构建成功。"
+    exit 0
+else
+    echo "❌ 发现 $total_violations 个违规，构建失败。"
+    exit 1
+fi

.github/scripts/pmd-pr.sh

@@ -0,0 +1,90 @@
+#!/bin/bash
+# ============================================================
+# pmd-pr.sh - PMD 增量扫描脚本
+# 功能：只扫描本次提交中变更的 Java 文件
+# 生成报告到 target/pmd-report.xml（或自定义路径）
+# ============================================================
+
+set -e
+
+echo "========================================"
+echo "  PMD 增量扫描"
+echo "  扫描范围：本次变更的 Java 文件"
+echo "========================================"
+
+# 1. 确定目标分支
+if [ -n "$GITHUB_BASE_REF" ]; then
+    BASE_BRANCH="origin/$GITHUB_BASE_REF"
+elif [ -n "$GITHUB_REF" ] && [ "$GITHUB_EVENT_NAME" == "push" ]; then
+    BASE_BRANCH="HEAD^"
+else
+    if git rev-parse --verify origin/main >/dev/null 2>&1; then
+        BASE_BRANCH="origin/main"
+    elif git rev-parse --verify origin/develop >/dev/null 2>&1; then
+        BASE_BRANCH="origin/develop"
+    else
+        echo "❌ 无法确定目标分支，请设置 BASE_BRANCH 环境变量。"
+        exit 1
+    fi
+    echo "🔍 本地运行模式，对比分支: $BASE_BRANCH"
+fi
+
+# 2. 获取变更的 Java 文件
+CHANGED_FILES=$(git diff --name-only "$BASE_BRANCH" HEAD 2>/dev/null | grep '\.java$' || true)
+
+if [ -z "$CHANGED_FILES" ]; then
+    echo "✅ 没有 Java 文件变更，跳过 PMD 扫描。"
+    exit 0
+fi
+
+echo "📝 变更的 Java 文件："
+echo "$CHANGED_FILES"
+echo "----------------------------------------"
+
+# 3. 生成文件列表（绝对路径）
+FILE_LIST="changed-files.txt"
+> "$FILE_LIST"
+for file in $CHANGED_FILES; do
+    echo "$PWD/$file" >> "$FILE_LIST"
+done
+
+echo "📄 文件列表已生成：$FILE_LIST"
+echo "----------------------------------------"
+
+# 4. 准备 PMD（如果未安装）
+PMD_VERSION="6.55.0"
+PMD_HOME="./pmd"
+if [ ! -d "$PMD_HOME" ]; then
+    echo "⬇️ 下载 PMD $PMD_VERSION ..."
+    curl -L "https://github.com/pmd/pmd/releases/download/pmd_releases%2F${PMD_VERSION}/pmd-bin-${PMD_VERSION}.zip" -o pmd.zip
+    unzip -q pmd.zip
+    mv pmd-bin-${PMD_VERSION} "$PMD_HOME"
+    rm pmd.zip
+fi
+PMD_CMD="$PMD_HOME/bin/run.sh"
+chmod +x "$PMD_CMD"
+
+# 5. 执行 PMD 扫描（使用 -filelist）
+echo "🚀 执行 PMD 扫描..."
+REPORT_FILE="target/pmd-report.xml"
+set +e
+"$PMD_CMD" pmd --no-cache \
+    -filelist "$FILE_LIST" \
+    -f xml \
+    -R category/java/quickstart.xml \
+    -r "$REPORT_FILE"
+EXIT_CODE=$?
+set -e
+
+# 6. 检查是否生成报告
+if [ -f "$REPORT_FILE" ]; then
+    echo "✅ PMD 报告已生成：$REPORT_FILE"
+else
+    echo "⚠️ PMD 未生成报告，可能无违规或出错。"
+fi
+
+# 7. 清理临时文件
+rm -f "$FILE_LIST"
+
+# 8. 始终以成功状态退出（违规由 YAML 汇总步骤决定）
+exit 0

.github/scripts/spotbugs-incremental.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+# ============================================================
+# spotbugs-incremental.sh - 增量 SpotBugs 扫描
+# 功能：只分析本次变更的 Java 文件对应的类
+# ============================================================
+
+set -e
+
+echo "========================================"
+echo "  SpotBugs 增量扫描"
+echo "========================================"
+
+# 确定目标分支
+if [ -n "$GITHUB_BASE_REF" ]; then
+    BASE_BRANCH="origin/$GITHUB_BASE_REF"
+elif [ -n "$GITHUB_REF" ] && [ "$GITHUB_EVENT_NAME" == "push" ]; then
+    BASE_BRANCH="HEAD^"
+else
+    if git rev-parse --verify origin/main >/dev/null 2>&1; then
+        BASE_BRANCH="origin/main"
+    elif git rev-parse --verify origin/develop >/dev/null 2>&1; then
+        BASE_BRANCH="origin/develop"
+    else
+        echo "❌ 无法确定目标分支，请设置 BASE_BRANCH 环境变量。"
+        exit 1
+    fi
+    echo "🔍 本地运行模式，对比分支: $BASE_BRANCH"
+fi
+
+# 获取变更的 Java 文件
+CHANGED_JAVA=$(git diff --name-only "$BASE_BRANCH" HEAD 2>/dev/null | grep '\.java$' || true)
+
+if [ -z "$CHANGED_JAVA" ]; then
+    echo "✅ 没有 Java 文件变更，跳过 SpotBugs 扫描。"
+    exit 0
+fi
+
+echo "📝 变更的 Java 文件："
+echo "$CHANGED_JAVA"
+
+# 提取类名列表
+class_list=""
+for file in $CHANGED_JAVA; do
+    # 文件可能已被删除，跳过
+    if [ ! -f "$file" ]; then
+        continue
+    fi
+    # 提取包名（假设文件中有 package 声明）
+    pkg=$(grep '^package' "$file" | sed -E 's/package\s+([^;]+);.*/\1/' | head -1)
+    if [ -z "$pkg" ]; then
+        echo "⚠️ 跳过 $file（未找到 package 声明）"
+        continue
+    fi
+    # 提取类名（不含 .java 后缀）
+    classname=$(basename "$file" .java)
+    fqdn="$pkg.$classname"
+    if [ -z "$class_list" ]; then
+        class_list="$fqdn"
+    else
+        class_list="$class_list,$fqdn"
+    fi
+done
+
+if [ -z "$class_list" ]; then
+    echo "⚠️ 未能提取到任何有效的类名，跳过 SpotBugs。"
+    exit 0
+fi
+
+echo "📋 待分析的类：$class_list"
+echo "----------------------------------------"
+
+# 执行 SpotBugs 增量分析
+echo "🚀 执行 SpotBugs 增量扫描..."
+mvn spotbugs:check -Dspotbugs.onlyAnalyze="$class_list"