refactor(logging): 补齐核心模块日志与中文注释约束

common-agent-agent/src/main/java/com/bruce/agent/controller/AgentSessionController.java

@@ -10,6 +10,7 @@ import com.bruce.agent.vo.AgentSessionDetailVO;
 import com.bruce.agent.vo.AgentWorkspaceVO;
 import com.bruce.common.domain.model.RequestResult;
 import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.PathVariable;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -20,6 +21,12 @@ import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
 
+/**
+ * Agent 会话控制器。
+ * <p>
+ * 负责会话创建、详情、消息查询与工作台聚合查询，保持前端只消费 DTO / VO 契约。
+ */
+@Slf4j
 @RestController
 @RequestMapping("/api/agent-sessions")
 @RequiredArgsConstructor
@@ -31,16 +38,19 @@ public class AgentSessionController {
 
     @PostMapping("/create")
     public RequestResult<Boolean> create(@RequestBody AgentSessionCreateDTO request) {
+        log.info("Agent会话创建请求开始，agentId={}, sessionCode={}", request.getAgentId(), request.getSessionCode());
         return RequestResult.success(agentSessionService.createSession(request));
     }
 
     @GetMapping("/detail")
     public RequestResult<AgentSessionDetailVO> detail(@RequestParam("id") Long id) {
+        log.info("Agent会话详情查询开始，sessionId={}", id);
         return RequestResult.success(agentSessionService.getDetailById(id));
     }
 
     @GetMapping("/{sessionId}/messages")
     public RequestResult<List<AgentMessageVO>> messages(@PathVariable("sessionId") Long sessionId) {
+        log.info("Agent消息列表查询开始，sessionId={}", sessionId);
         return RequestResult.success(agentMessageService.listBySessionId(sessionId));
     }
 
@@ -48,12 +58,15 @@ public class AgentSessionController {
     public RequestResult<Boolean> appendMessage(@PathVariable("sessionId") Long sessionId,
                                                 @RequestBody AgentSessionMessageCreateDTO request) {
         request.setSessionId(sessionId);
+        log.info("Agent消息写入请求开始，sessionId={}, role={}, requestId={}",
+                sessionId, request.getRole(), request.getRequestId());
         return RequestResult.success(agentMessageService.appendMessage(request));
     }
 
     @GetMapping("/workspace")
     public RequestResult<AgentWorkspaceVO> workspace(@RequestParam("agentId") Long agentId,
                                                      @RequestParam(value = "sessionId", required = false) Long sessionId) {
+        log.info("Agent工作台查询开始，agentId={}, sessionId={}", agentId, sessionId);
         return RequestResult.success(agentWorkspaceService.getWorkspace(agentId, sessionId));
     }
 }