refactor(server): replace Knife4j with SpringDoc OpenAPI 2.8.16

README.md

@@ -76,7 +76,7 @@ export DASHSCOPE_API_KEY=your-key-here
 mvn spring-boot:run
 # Backend runs at http://localhost:18088
 # H2 Console: http://localhost:18088/h2-console
-# API Docs (Knife4j): http://localhost:18088/doc.html
+# API Docs (SpringDoc OpenAPI): http://localhost:18088/swagger-ui.html
 ```
 
 **2. Start the frontend**
@@ -176,7 +176,7 @@ mateclaw/
 | Database | H2 (dev) / MySQL 8.0+ (prod) |
 | ORM | MyBatis Plus 3.5 |
 | Authentication | Spring Security + JWT |
-| API Docs | Knife4j (OpenAPI 3) |
+| API Docs | SpringDoc OpenAPI 3 |
 | Frontend | Vue 3 + TypeScript + Vite |
 | State Management | Pinia |
 | UI Components | Element Plus |

README_zh.md

@@ -76,7 +76,7 @@ export DASHSCOPE_API_KEY=your-key-here
 mvn spring-boot:run
 # 后端运行在 http://localhost:18088
 # H2 控制台：http://localhost:18088/h2-console
-# API 文档（Knife4j）：http://localhost:18088/doc.html
+# API 文档（SpringDoc OpenAPI）：http://localhost:18088/swagger-ui.html
 ```
 
 **2. 启动前端**
@@ -176,7 +176,7 @@ mateclaw/
 | 数据库 | H2（开发）/ MySQL 8.0+（生产） |
 | ORM | MyBatis Plus 3.5 |
 | 认证 | Spring Security + JWT |
-| API 文档 | Knife4j (OpenAPI 3) |
+| API 文档 | SpringDoc OpenAPI 3 |
 | 前端框架 | Vue 3 + TypeScript + Vite |
 | 状态管理 | Pinia |
 | UI 组件 | Element Plus |

mateclaw-server/pom.xml

@@ -28,7 +28,7 @@
         <spring-ai-alibaba.version>1.1.2.2</spring-ai-alibaba.version>
         <mybatis-plus.version>3.5.16</mybatis-plus.version>
         <hutool.version>5.8.26</hutool.version>
-        <knife4j.version>4.5.0</knife4j.version>
+        <springdoc.version>2.8.16</springdoc.version>
         <jjwt.version>0.12.6</jjwt.version>
     </properties>
 
@@ -42,6 +42,14 @@
                 <type>pom</type>
                 <scope>import</scope>
             </dependency>
+            <!-- SpringDoc OpenAPI BOM（统一管理 springdoc-* 版本） -->
+            <dependency>
+                <groupId>org.springdoc</groupId>
+                <artifactId>springdoc-openapi-bom</artifactId>
+                <version>${springdoc.version}</version>
+                <type>pom</type>
+                <scope>import</scope>
+            </dependency>
         </dependencies>
     </dependencyManagement>
 
@@ -157,11 +165,10 @@
             <scope>runtime</scope>
         </dependency>
 
-        <!-- ===== Knife4j API 文档 ===== -->
+        <!-- ===== SpringDoc OpenAPI（Swagger UI for Spring MVC） ===== -->
         <dependency>
-            <groupId>com.github.xiaoymin</groupId>
-            <artifactId>knife4j-openapi3-jakarta-spring-boot-starter</artifactId>
-            <version>${knife4j.version}</version>
+            <groupId>org.springdoc</groupId>
+            <artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
         </dependency>
 
         <!-- ===== Hutool 工具库 ===== -->

mateclaw-server/src/main/java/vip/mate/config/SecurityConfig.java

@@ -52,7 +52,7 @@ public class SecurityConfig {
                 .requestMatchers(
                     "/api/v1/auth/login",
                     "/api/v1/settings/language",
-                    "/doc.html",
+                    "/swagger-ui.html",
                     "/swagger-ui/**",
                     "/v3/api-docs/**",
                     "/webjars/**",

mateclaw-server/src/main/resources/application.yml

@@ -61,12 +61,6 @@ mybatis-plus:
       logic-delete-value: 1
       logic-not-delete-value: 0
 
-# Knife4j API 文档
-knife4j:
-  enable: true
-  setting:
-    language: zh_cn
-
 # SpringDoc OpenAPI
 springdoc:
   api-docs: