diff --git a/src/main/java/com/yunhai/userbase/controller/api/SysOperationLogController.java b/src/main/java/com/yunhai/userbase/controller/api/SysOperationLogController.java
index 630e2cf..e980c23 100644
--- a/src/main/java/com/yunhai/userbase/controller/api/SysOperationLogController.java
+++ b/src/main/java/com/yunhai/userbase/controller/api/SysOperationLogController.java
@@ -6,6 +6,7 @@ import com.yunhai.userbase.model.BasePageResult;
 import com.yunhai.userbase.model.oplog.SysOperationLogListVo;
 import com.yunhai.userbase.model.oplog.SysOperationLogQuery;
 import com.yunhai.userbase.service.ISysOperationLogService;
+import io.swagger.v3.oas.annotations.Operation;
 import lombok.extern.slf4j.Slf4j;
 
 import java.io.ByteArrayInputStream;
@@ -39,16 +40,18 @@ public class SysOperationLogController {
     /**
      * 分页查询操作日志列表（不含响应结果）。
      */
+    @Operation(summary = "操作日志分页查询", operationId = "operationLogList")
     @GetMapping("/List")
     public BasePageResult<SysOperationLogListVo> list(SysOperationLogQuery query, BasePageQuery pageQuery) {
         return sysOperationLogService.pageQuery(query, pageQuery);
     }
 
     /**
-     * 下载某条日志的响应结果（GZIP 解压后原文，文本文件）。<br>
+     * 下载某条日志的响应结果（GZIP 解压后原文， 文本文件）。<br>
      * 采用与项目 DownloadFileUtil 一致的 octet-stream + attachment 写法，确保浏览器稳定触发下载。<br>
      * 若该日志未记录响应数据，返回一段说明文本文件而非 404，便于排查。
      */
+    @Operation(summary = "下载日志响应原文", operationId = "operationLogDownload")
     @GetMapping("/Download/{id}")
     public ResponseEntity<InputStreamResource> download(@PathVariable Long id) {
         String data = sysOperationLogService.getResponseData(id);