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) {