chore(workflows): update build-jar workflow and README

- Upgrade Gradle version to 5.6.4 and update the Gradle action to v2.12.0
- Change upload-artifact action to v4 for improved functionality
- Enhance README.md with clearer workflow descriptions and troubleshooting tips

Author: lltx

.github/workflows/README.md

@@ -1,9 +1,13 @@
 # GitHub Actions Workflows
 
-本项目包含以下 GitHub Actions workflows：
+本项目包含以下 GitHub Actions workflow：
+
+## build-jar.yml - JAR 构建工作流
+
+**触发条件：** 
+- 每次代码提交到任何分支
+- Pull Request 到 main/master 分支
 
-## 1. build-jar.yml - JAR 构建工作流
-**触发条件：** 每次代码提交到任何分支
 **功能：**
 - 使用 JDK 8 和 Gradle 5.6.4
 - 构建标准 JAR 文件
@@ -15,34 +19,30 @@
 - `jar-files-{run_number}`: 包含所有 JAR 文件
 - `plugin-zip-{run_number}`: 包含插件分发 ZIP 文件
 
-## 2. ci.yml - 持续集成工作流
-**触发条件：** 代码提交和 Pull Request
-**功能：**
-- 运行测试
-- 构建项目
-- 上传测试结果和构建产物
-
-## 3. build.yml - 完整构建和发布工作流
-**触发条件：** 主分支提交
-**功能：**
-- 完整构建流程
-- 自动创建 GitHub Release
-- 上传 JAR 文件到 Release
-
 ## 使用说明
 
-1. **每次提交**都会触发 `build-jar.yml`，自动构建 JAR 文件
-2. 构建完成后，可以在 Actions 页面下载对应的 artifacts
-3. 主分支的提交会额外触发完整的发布流程
+1. **每次提交**都会触发自动构建，生成 JAR 文件
+2. 构建完成后，可以在 GitHub Actions 页面下载对应的 artifacts
+3. 构建过程包括：
+   - 标准 JAR 构建 (`gradle jar`)
+   - Fat JAR 构建 (`gradle fatJar`) 
+   - IntelliJ 插件构建 (`gradle buildPlugin`)
 
 ## 下载构建产物
 
-1. 进入 GitHub 项目的 Actions 页面
+1. 进入 GitHub 项目的 **Actions** 页面
 2. 选择对应的 workflow run
-3. 在页面底部的 Artifacts 部分下载需要的文件
+3. 在页面底部的 **Artifacts** 部分下载需要的文件
 
 ## 构建产物说明
 
 - **标准 JAR**: `easy_javadoc-{version}.jar`
 - **Fat JAR**: `easy_javadoc-{version}-all.jar` (包含所有依赖)
-- **插件 ZIP**: `Easy Javadoc-{version}.zip` (IntelliJ 插件分发包) 
+- **插件 ZIP**: `Easy Javadoc-{version}.zip` (IntelliJ 插件分发包)
+
+## 故障排除
+
+如果构建失败，请检查：
+1. build.gradle 文件语法是否正确
+2. 依赖版本是否兼容
+3. 在 Actions 页面查看详细的构建日志 

.github/workflows/build-jar.yml

@@ -20,8 +20,8 @@ jobs:
         java-version: '8'
         distribution: 'temurin'
 
-    - name: Setup Gradle 5.x
-      uses: gradle/gradle-build-action@v2
+    - name: Setup Gradle
+      uses: gradle/gradle-build-action@v2.12.0
       with:
         gradle-version: '5.6.4'
 
@@ -43,14 +43,14 @@ jobs:
         find build/distributions -name "*.zip" -type f | head -5
         
     - name: Upload JAR files
-      uses: actions/upload-artifact@v3
+      uses: actions/upload-artifact@v4
       with:
         name: jar-files-${{ github.run_number }}
         path: build/libs/*.jar
         retention-days: 30
 
     - name: Upload Plugin ZIP
-      uses: actions/upload-artifact@v3
+      uses: actions/upload-artifact@v4
       with:
         name: plugin-zip-${{ github.run_number }}
         path: build/distributions/*.zip