From 8b4a5034b90d7b32abbd3c18a1042e7394e667bc Mon Sep 17 00:00:00 2001
From: zhengli <zhengli@linzikg.com>
Date: Thu, 28 May 2026 14:11:25 +0800
Subject: [PATCH] =?UTF-8?q?docs(api):=20=E6=9B=B4=E6=96=B0=E5=9B=BE?=
 =?UTF-8?q?=E7=89=87=E7=AF=A1=E6=94=B9=E6=A3=80=E6=B5=8B=E6=8E=A5=E5=8F=A3?=
 =?UTF-8?q?=E6=96=87=E6=A1=A3=E5=B9=B6=E4=BC=98=E5=8C=96=E6=B5=8B=E8=AF=95?=
 =?UTF-8?q?=E7=94=A8=E4=BE=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 添加了ForgeryDetectionController接口的详细注释文档
- 补充了请求参数格式说明和接口功能描述
- 在测试用例中增加请求参数和响应结果的打印输出
- 优化了测试步骤的编号和断言语句的可读性
- 添加了JSON格式化输出便于调试和验证
- 完善了测试流程中的日志输出机制
---
 .../doc/ForgeryDetectionController.java          |  5 +++++
 .../doc/ForgeryDetectionControllerTest.java      | 16 +++++++++++++---
 2 files changed, 18 insertions(+), 3 deletions(-)

diff --git a/api-web/api-interface/src/main/java/com/heyu/api/controller/doc/ForgeryDetectionController.java b/api-web/api-interface/src/main/java/com/heyu/api/controller/doc/ForgeryDetectionController.java
index 98533a7..d1cc25c 100644
--- a/api-web/api-interface/src/main/java/com/heyu/api/controller/doc/ForgeryDetectionController.java
+++ b/api-web/api-interface/src/main/java/com/heyu/api/controller/doc/ForgeryDetectionController.java
@@ -38,6 +38,11 @@ public class ForgeryDetectionController {
     @Autowired
     private BForgeryDetectionHandle bForgeryDetectionHandle;
 
+    /**
+     * 图片篡改检测
+     * @param request:  {"detectProportion":"true","detectThreshold":"0.9887","imageUrl":"https://www.opsky.com.cn/upload/20211224/KXfgvm2MFRAXKbPu5LK.png","restrictProbability":"0.8","returnHeatmap":"true"}
+     * @return
+     */
     @EbAuthentication(tencent = ApiConstants.TENCENT_AUTH)
     @PostMapping("/forgeryDetection")
     public R<ForgeryDetectionResp> forgeryDetection(@RequestBody ForgeryDetectionRequest request) {
diff --git a/api-web/api-interface/src/test/java/com/heyu/api/controller/doc/ForgeryDetectionControllerTest.java b/api-web/api-interface/src/test/java/com/heyu/api/controller/doc/ForgeryDetectionControllerTest.java
index 878af99..856639b 100644
--- a/api-web/api-interface/src/test/java/com/heyu/api/controller/doc/ForgeryDetectionControllerTest.java
+++ b/api-web/api-interface/src/test/java/com/heyu/api/controller/doc/ForgeryDetectionControllerTest.java
@@ -40,15 +40,25 @@ public class ForgeryDetectionControllerTest extends ApiInterfaceApplicationTests
         request.setReturnHeatmap("true");
         request.setRestrictProbability("0.8");
 
-        // 2. 调用本地 /doc/forgeryDetection 接口
+        // 2. 打印请求参数
+        System.out.println("\n========== 请求参数 ==========");
+        System.out.println(JSON.toJSONString(request));
+        System.out.println("==============================");
+
+        // 3. 调用本地 /doc/forgeryDetection 接口
         R<ForgeryDetectionResp> result = forgeryDetectionController.forgeryDetection(request);
 
-        // 3. 断言
+        // 4. 打印响应结果
+        System.out.println("\n========== 响应结果 ==========");
+        System.out.println(JSON.toJSONString(result));
+        System.out.println("==============================");
+
+        // 5. 断言
         assertNotNull(result, "返回结果不能为空");
         assertEquals("200", result.getCode(), "接口应返回成功");
         assertNotNull(result.getData(), "返回数据不能为空");
 
-        // 4. 打印接口返回值
+        // 6. 打印接口返回值
         ForgeryDetectionResp data = result.getData();
         String heatmapDisplay = data.getHeatmap() != null
                 ? data.getHeatmap().substring(0, Math.min(50, data.getHeatmap().length())) + "...(共" + data.getHeatmap().length() + "字符)"