diff --git a/minio-plus-api/src/main/java/org/liuxp/minioplus/api/model/vo/FileCheckResultVo.java b/minio-plus-api/src/main/java/org/liuxp/minioplus/api/model/vo/FileCheckResultVo.java
index d373a20..b6d83ff 100644
--- a/minio-plus-api/src/main/java/org/liuxp/minioplus/api/model/vo/FileCheckResultVo.java
+++ b/minio-plus-api/src/main/java/org/liuxp/minioplus/api/model/vo/FileCheckResultVo.java
@@ -76,6 +76,9 @@ public class FileCheckResultVo {
     @Schema(description = "分块信息")
     private List<Part> partList = new ArrayList<>();
 
+    /**
+     * 分块信息实体定义
+     */
     @Getter
     @Setter
     public static class Part {
diff --git a/minio-plus-api/src/main/java/org/liuxp/minioplus/api/model/vo/FilePreShardingVo.java b/minio-plus-api/src/main/java/org/liuxp/minioplus/api/model/vo/FilePreShardingVo.java
index 159b986..f27c31d 100644
--- a/minio-plus-api/src/main/java/org/liuxp/minioplus/api/model/vo/FilePreShardingVo.java
+++ b/minio-plus-api/src/main/java/org/liuxp/minioplus/api/model/vo/FilePreShardingVo.java
@@ -41,6 +41,9 @@ public class FilePreShardingVo {
     @Schema(description = "分块信息")
     private List<Part> partList = new ArrayList<>();
 
+    /**
+     * 分块信息实体定义
+     */
     @Getter
     @Setter
     public static class Part {
diff --git a/minio-plus-s3-api/s3-api-definition/src/main/java/org/liuxp/minioplus/s3/def/ListParts.java b/minio-plus-s3-api/s3-api-definition/src/main/java/org/liuxp/minioplus/s3/def/ListParts.java
index ff89f8f..13d6c61 100644
--- a/minio-plus-s3-api/s3-api-definition/src/main/java/org/liuxp/minioplus/s3/def/ListParts.java
+++ b/minio-plus-s3-api/s3-api-definition/src/main/java/org/liuxp/minioplus/s3/def/ListParts.java
@@ -8,6 +8,12 @@ import java.time.ZonedDateTime;
 import java.util.ArrayList;
 import java.util.List;
 
+/**
+ * 分片信息列表
+ *
+ * @author contact@liuxp.me
+ * @since  2024/11/14
+ */
 @Getter
 @Setter
 @ToString
@@ -23,25 +29,41 @@ public class ListParts {
 
     private List<Part> partList = null;
 
+    /**
+     * 构造方法
+     * @return 分块列表
+     */
     public static ListParts build(){
         ListParts listParts = new ListParts();
         listParts.setPartList(new ArrayList<>());
         return listParts;
     }
 
+    /**
+     * 文件分块信息定义
+     */
     @Getter
     @Setter
     @ToString
     public static class Part{
+
+        // 分块序号
         private int partNumber;
-
+        // 分块标签(默认是MD5)
         private String etag;
-
+        // 修改时间
         private ZonedDateTime lastModified;
-
+        // 分块大小
         private Long size;
     }
 
+    /**
+     * 增加分块
+     * @param partNumber 分块序号
+     * @param etag 分块标签
+     * @param lastModified 最后修改时间
+     * @param size 分块大小
+     */
     public void addPart(int partNumber, String etag, ZonedDateTime lastModified, Long size){
 
         Part part = new Part();
diff --git a/minio-plus-s3-api/s3-api-minio/src/main/java/org/liuxp/minioplus/s3/official/CustomMinioClient.java b/minio-plus-s3-api/s3-api-minio/src/main/java/org/liuxp/minioplus/s3/official/CustomMinioClient.java
index 55fc304..85f6b0a 100644
--- a/minio-plus-s3-api/s3-api-minio/src/main/java/org/liuxp/minioplus/s3/official/CustomMinioClient.java
+++ b/minio-plus-s3-api/s3-api-minio/src/main/java/org/liuxp/minioplus/s3/official/CustomMinioClient.java
@@ -16,7 +16,10 @@ import java.security.NoSuchAlgorithmException;
  */
 public class CustomMinioClient extends MinioAsyncClient {
 
-
+    /**
+     * 构造方法
+     * @param client Minio异步客户端
+     */
     public CustomMinioClient(MinioAsyncClient client) {
         super(client);
     }
diff --git a/minio-plus-s3-api/s3-api-minio/src/main/java/org/liuxp/minioplus/s3/official/MinioS3ClientImpl.java b/minio-plus-s3-api/s3-api-minio/src/main/java/org/liuxp/minioplus/s3/official/MinioS3ClientImpl.java
index 6ee38ca..69b7994 100644
--- a/minio-plus-s3-api/s3-api-minio/src/main/java/org/liuxp/minioplus/s3/official/MinioS3ClientImpl.java
+++ b/minio-plus-s3-api/s3-api-minio/src/main/java/org/liuxp/minioplus/s3/official/MinioS3ClientImpl.java
@@ -26,6 +26,12 @@ import java.util.Map;
 import java.util.concurrent.ExecutionException;
 import java.util.concurrent.TimeUnit;
 
+/**
+ * MinIO S3文件存储引擎接口定义实现类
+ *
+ * @author contact@liuxp.me
+ * @since  2024/11/14
+ */
 @Slf4j
 public class MinioS3ClientImpl implements MinioS3Client {
 
@@ -46,10 +52,18 @@ public class MinioS3ClientImpl implements MinioS3Client {
 
     private CustomMinioClient minioClient = null;
 
+    /**
+     * 构造方法
+     * @param properties MinioPlus 配置
+     */
     public MinioS3ClientImpl(MinioPlusProperties properties) {
         this.properties = properties;
     }
 
+    /**
+     * 获取 Minio 客户端
+     * @return Minio 客户端
+     */
     public CustomMinioClient getClient() {
 
         if (null == this.minioClient) {
diff --git a/minio-plus-spring-boot-starter/minio-plus-all-springboot-starter/src/main/java/org/liuxp/minioplus/extension/controller/StorageController.java b/minio-plus-spring-boot-starter/minio-plus-all-springboot-starter/src/main/java/org/liuxp/minioplus/extension/controller/StorageController.java
index 891c546..452468f 100644
--- a/minio-plus-spring-boot-starter/minio-plus-all-springboot-starter/src/main/java/org/liuxp/minioplus/extension/controller/StorageController.java
+++ b/minio-plus-spring-boot-starter/minio-plus-all-springboot-starter/src/main/java/org/liuxp/minioplus/extension/controller/StorageController.java
@@ -47,6 +47,10 @@ public class StorageController implements StorageWebAPI {
      */
     private final StorageService storageService;
 
+    /**
+     * 构造方法
+     * @param storageService 注入存储引擎Service接口定义实现类
+     */
     public StorageController(StorageService storageService) {
         this.storageService = storageService;
     }
diff --git a/minio-plus-spring-boot-starter/minio-plus-all-springboot2-starter/src/main/java/org/liuxp/minioplus/extension/controller/StorageController.java b/minio-plus-spring-boot-starter/minio-plus-all-springboot2-starter/src/main/java/org/liuxp/minioplus/extension/controller/StorageController.java
index 891c546..452468f 100644
--- a/minio-plus-spring-boot-starter/minio-plus-all-springboot2-starter/src/main/java/org/liuxp/minioplus/extension/controller/StorageController.java
+++ b/minio-plus-spring-boot-starter/minio-plus-all-springboot2-starter/src/main/java/org/liuxp/minioplus/extension/controller/StorageController.java
@@ -47,6 +47,10 @@ public class StorageController implements StorageWebAPI {
      */
     private final StorageService storageService;
 
+    /**
+     * 构造方法
+     * @param storageService 注入存储引擎Service接口定义实现类
+     */
     public StorageController(StorageService storageService) {
         this.storageService = storageService;
     }