From 6ae854791c5a945498a1ecc278c825db96a2ea1b Mon Sep 17 00:00:00 2001
From: chenchuchuan <13554600537@163.com>
Date: Thu, 8 Oct 2026 15:59:16 +0800
Subject: [PATCH] =?UTF-8?q?feat(common):=20=E6=B7=BB=E5=8A=A0=E7=9F=A5?=
 =?UTF-8?q?=E8=AF=86=E5=BA=93=E5=BC=80=E6=94=BE=E6=8E=A5=E5=8F=A3=E6=96=87?=
 =?UTF-8?q?=E4=BB=B6=E6=B8=85=E5=8D=95=E5=88=86=E9=A1=B5=E5=AF=B9=E8=B1=A1?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 创建 OpenApiKbFilePageDto 类作为 /v1/kb/files 响应的 data
---
 .../common/openapi/dto/OpenApiKbFilePageDto.java   | 36 ++++++++++++++++++++++
 1 file changed, 36 insertions(+)
 create mode 100644 common/common-openapi/src/main/java/apelet/common/openapi/dto/OpenApiKbFilePageDto.java

diff --git a/common/common-openapi/src/main/java/apelet/common/openapi/dto/OpenApiKbFilePageDto.java b/common/common-openapi/src/main/java/apelet/common/openapi/dto/OpenApiKbFilePageDto.java
new file mode 100644
index 0000000..7a644ca
--- /dev/null
+++ b/common/common-openapi/src/main/java/apelet/common/openapi/dto/OpenApiKbFilePageDto.java
@@ -0,0 +1,36 @@
+package apelet.common.openapi.dto;
+
+import lombok.Data;
+
+import java.util.List;
+
+/**
+ * 知识库开放接口：文件清单分页对象，作为 /v1/kb/files 响应的 data。
+ * <p>翻页只认 hasMore：list 里的记录条数不参与判断，末页之后 list 为空且 hasMore 为 false。</p>
+ *
+ * @author chenchuchuan
+ */
+@Data
+public class OpenApiKbFilePageDto {
+
+    /**
+     * 本页记录节点数组，元素为 OpenApiKbFileNodeDto；没有附件的记录 files 为空数组。
+     */
+    private List<OpenApiKbFileNodeDto> list;
+    /**
+     * 实际生效的页码，回显用。
+     */
+    private Integer pageNo;
+    /**
+     * 实际生效的单页记录数，回显用。
+     */
+    private Integer pageSize;
+    /**
+     * 符合条件的主表记录总数，仅供参考，不得用于翻页判断。
+     */
+    private Long total;
+    /**
+     * 是否还有下一页，翻页的唯一依据。
+     */
+    private Boolean hasMore;
+}