From f5dd4f3b2825b411ec9bf55683ae22baaae2daa8 Mon Sep 17 00:00:00 2001
From: quyixiao <2621048238@qq.com>
Date: Tue, 5 May 2026 10:44:30 +0800
Subject: [PATCH] =?UTF-8?q?=E6=8F=90=E4=BA=A4=E4=BF=AE=E6=94=B9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../common/DocAnalysisOfficeController.java           | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/api-web/api-interface/src/main/java/com/heyu/api/controller/common/DocAnalysisOfficeController.java b/api-web/api-interface/src/main/java/com/heyu/api/controller/common/DocAnalysisOfficeController.java
index 7849b92..3ef2393 100644
--- a/api-web/api-interface/src/main/java/com/heyu/api/controller/common/DocAnalysisOfficeController.java
+++ b/api-web/api-interface/src/main/java/com/heyu/api/controller/common/DocAnalysisOfficeController.java
@@ -40,7 +40,16 @@ public class DocAnalysisOfficeController {
     @Autowired
     private BDocAnalysisOfficeHandle bDocAnalysisOfficeHandle;
 
-
+    /**
+     * 办公文档识别：调用百度办公文档 OCR，对版面做分析与文字识别。
+     * <p>
+     * 成功时返回每条识别结果的字类型、行置信度（均值/最低）及识别文本；失败返回错误信息。
+     * </p>
+     * GET/POST：{@code /office/doc/recognize}，示例：{@code http://localhost:8888/office/doc/recognize}
+     *
+     * @param request 百度办公文档识别请求参数（如图片、配置等，与 {@link BDocAnalysisOfficeHandle} 约定一致）
+     * @return {@link R}，{@code data} 为 {@link DocAnalysisOfficeResp} 列表；错误时 {@code errorMsg} 说明原因
+     */
     @RequestMapping("/recognize")
     @CacheResult
     public R recognize(BDocAnalysisOfficeRequest request) {