From cf380c5f09a6b039f184fc20d3726cfeaf16af4e Mon Sep 17 00:00:00 2001
From: cat-shark <1716967236@qq.com>
Date: Fri, 9 Oct 2026 15:07:15 +0800
Subject: [PATCH] =?UTF-8?q?feat:=20AI=20=E8=B0=83=E7=94=A8=E6=94=B9?=
=?UTF-8?q?=E4=B8=BA=E5=BC=82=E6=AD=A5=E4=BB=BB=E5=8A=A1=E5=B9=B6=E6=94=AF?=
=?UTF-8?q?=E6=8C=81=E7=BB=93=E6=9E=9C=E9=87=8D=E5=A4=8D=E8=8E=B7=E5=8F=96?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../common/TenantContext.java | 56 ++++
.../config/AiTaskConfig.java | 30 ++
.../config/AiTaskProperties.java | 33 +++
.../config/AutoTableField.java | 26 +-
.../config/MybatisPlusConfig.java | 6 +-
.../controller/AiTaskController.java | 56 ++++
.../controller/ReviewController.java | 38 +--
.../controller/StudySessionController.java | 8 -
.../dto/AiTaskResponse.java | 54 ++++
.../dto/RecallCompareOutcome.java | 30 ++
.../dto/request/AiTaskSubmitRequest.java | 43 +++
.../entity/AiTaskEntity.java | 79 ++++++
.../enums/AiTaskStatusEnum.java | 36 +++
.../enums/AiTaskTypeEnum.java | 35 +++
.../mapper/AiTaskMapper.java | 99 +++++++
.../service/AiTaskService.java | 68 +++++
.../service/StandardMindMapService.java | 15 +-
.../service/StudySessionsService.java | 7 +
.../service/event/AiTaskSubmittedEvent.java | 12 +
.../service/impl/AiTaskFailedException.java | 15 +
.../service/impl/AiTaskHandler.java | 28 ++
.../service/impl/AiTaskHandlerRegistry.java | 65 +++++
.../service/impl/AiTaskRunner.java | 95 +++++++
.../service/impl/AiTaskServiceImpl.java | 217 ++++++++++++++
.../service/impl/MindMapAiTaskHandler.java | 72 +++++
.../impl/RecallCompareAiTaskHandler.java | 93 ++++++
.../impl/ReportDraftAiTaskHandler.java | 43 +++
.../impl/StandardMindMapServiceImpl.java | 96 +++----
.../impl/StudySessionsServiceImpl.java | 6 +-
src/main/resources/application.yml | 15 +-
.../migration/V20261009_6__add_ai_tasks.sql | 31 ++
.../controller/ReviewControllerUnitTest.java | 77 +----
.../StudySessionControllerUnitTest.java | 10 -
.../service/impl/AiTaskIntegrationTest.java | 264 ++++++++++++++++++
.../service/impl/AiTaskServiceImplTest.java | 229 +++++++++++++++
.../impl/StandardMindMapServiceImplTest.java | 8 +-
src/test/resources/application.yml | 5 +-
37 files changed, 1911 insertions(+), 189 deletions(-)
create mode 100644 src/main/java/com/guo/learningprogresstracker/common/TenantContext.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/config/AiTaskConfig.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/config/AiTaskProperties.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/controller/AiTaskController.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/dto/AiTaskResponse.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/dto/RecallCompareOutcome.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/dto/request/AiTaskSubmitRequest.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/entity/AiTaskEntity.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/enums/AiTaskStatusEnum.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/enums/AiTaskTypeEnum.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/mapper/AiTaskMapper.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/AiTaskService.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/event/AiTaskSubmittedEvent.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskFailedException.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskHandler.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskHandlerRegistry.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskRunner.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskServiceImpl.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/impl/MindMapAiTaskHandler.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/impl/RecallCompareAiTaskHandler.java
create mode 100644 src/main/java/com/guo/learningprogresstracker/service/impl/ReportDraftAiTaskHandler.java
create mode 100644 src/main/resources/db/migration/V20261009_6__add_ai_tasks.sql
create mode 100644 src/test/java/com/guo/learningprogresstracker/service/impl/AiTaskIntegrationTest.java
create mode 100644 src/test/java/com/guo/learningprogresstracker/service/impl/AiTaskServiceImplTest.java
diff --git a/src/main/java/com/guo/learningprogresstracker/common/TenantContext.java b/src/main/java/com/guo/learningprogresstracker/common/TenantContext.java
new file mode 100644
index 0000000..32ba690
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/common/TenantContext.java
@@ -0,0 +1,56 @@
+package com.guo.learningprogresstracker.common;
+
+/**
+ * 显式的租户上下文(AI-02)。
+ *
+ *
租户拦截器与公共字段自动填充都从 {@code StpUtil} 取当前用户,而它依赖 Web 请求上下文。
+ * 后台执行线程(AI 任务执行器、定时收敛)没有请求上下文,直接调用会抛
+ * {@code NotWebContextException};这里让后台线程显式声明「我以哪个用户身份在执行」。
+ *
+ * 取值优先级:本上下文优先,没有时才回落到 {@code StpUtil}。这样请求线程的行为完全不变,
+ * 后台线程也只能以任务所属用户的身份执行,不会意外变成「无租户」而看到全部数据。
+ */
+public final class TenantContext {
+
+ /**
+ * 执行身份。
+ *
+ * @param loginId 登录用户
+ * @param device 设备类型,可为 null(后台任务通常没有设备信息)
+ */
+ public record Identity(String loginId, String device) {
+ }
+
+ private static final ThreadLocal CURRENT = new ThreadLocal<>();
+
+ private TenantContext() {
+ }
+
+ /** 取当前执行身份;未设置时返回 null(表示应回落到 StpUtil) */
+ public static Identity get() {
+ return CURRENT.get();
+ }
+
+ /** 在指定身份下执行;执行结束后恢复原身份,避免线程池复用造成身份串号 */
+ public static void runAs(String loginId, String device, Runnable action) {
+ callAs(loginId, device, () -> {
+ action.run();
+ return null;
+ });
+ }
+
+ /** 在指定身份下执行并返回结果(异常原样向外抛,由调用方决定如何回写) */
+ public static T callAs(String loginId, String device, java.util.function.Supplier action) {
+ Identity previous = CURRENT.get();
+ CURRENT.set(new Identity(loginId, device));
+ try {
+ return action.get();
+ } finally {
+ if (previous == null) {
+ CURRENT.remove();
+ } else {
+ CURRENT.set(previous);
+ }
+ }
+ }
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/config/AiTaskConfig.java b/src/main/java/com/guo/learningprogresstracker/config/AiTaskConfig.java
new file mode 100644
index 0000000..650e4a7
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/config/AiTaskConfig.java
@@ -0,0 +1,30 @@
+package com.guo.learningprogresstracker.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.scheduling.annotation.EnableAsync;
+import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;
+
+/**
+ * AI 任务执行器装配(AI-02)。
+ * 执行线程与请求线程分离,AI 调用不会占用 HTTP 请求线程,也不会持有请求期间打开的数据库连接。
+ */
+@Configuration
+@EnableAsync
+public class AiTaskConfig {
+
+ public static final String AI_TASK_EXECUTOR = "aiTaskExecutor";
+
+ @Bean(name = AI_TASK_EXECUTOR)
+ public ThreadPoolTaskExecutor aiTaskExecutor(AiTaskProperties properties) {
+ ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
+ executor.setCorePoolSize(properties.getExecutorCoreSize());
+ executor.setMaxPoolSize(properties.getExecutorMaxSize());
+ executor.setQueueCapacity(properties.getExecutorQueueCapacity());
+ executor.setThreadNamePrefix("ai-task-");
+ // 队列满时由调用线程执行,避免任务被静默丢弃(定时兜底仍会接手)
+ executor.setRejectedExecutionHandler(new java.util.concurrent.ThreadPoolExecutor.CallerRunsPolicy());
+ executor.initialize();
+ return executor;
+ }
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/config/AiTaskProperties.java b/src/main/java/com/guo/learningprogresstracker/config/AiTaskProperties.java
new file mode 100644
index 0000000..3305d94
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/config/AiTaskProperties.java
@@ -0,0 +1,33 @@
+package com.guo.learningprogresstracker.config;
+
+import lombok.Data;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.context.annotation.Configuration;
+
+/**
+ * AI 异步任务配置(AI-02)。
+ */
+@Data
+@Configuration
+@ConfigurationProperties(prefix = "lpt.ai-task")
+public class AiTaskProperties {
+
+ /** 单个任务允许的最长执行时间(秒):超过则视为进程中断,回收后可重试 */
+ private long stuckTimeoutSeconds = 900;
+
+ /** 兜底扫描间隔(毫秒) */
+ private long scanIntervalMs = 3000;
+
+ /** 首次兜底扫描的延迟(毫秒):让「提交后立即投递」先执行 */
+ private long scanInitialDelayMs = 3000;
+
+ /** 单次扫描最多处理多少个任务 */
+ private int scanBatchSize = 10;
+
+ /** 立即投递用的线程池大小 */
+ private int executorCoreSize = 2;
+
+ private int executorMaxSize = 4;
+
+ private int executorQueueCapacity = 50;
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/config/AutoTableField.java b/src/main/java/com/guo/learningprogresstracker/config/AutoTableField.java
index f8c2848..9d78cef 100644
--- a/src/main/java/com/guo/learningprogresstracker/config/AutoTableField.java
+++ b/src/main/java/com/guo/learningprogresstracker/config/AutoTableField.java
@@ -2,6 +2,7 @@ package com.guo.learningprogresstracker.config;
import cn.dev33.satoken.stp.StpUtil;
import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
+import com.guo.learningprogresstracker.common.TenantContext;
import lombok.extern.slf4j.Slf4j;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.context.annotation.Configuration;
@@ -20,18 +21,35 @@ public class AutoTableField implements MetaObjectHandler {
@Override
public void insertFill(MetaObject metaObject) {
- this.strictInsertFill(metaObject, "createdBy", StpUtil::getLoginIdAsString, String.class);
+ this.strictInsertFill(metaObject, "createdBy", AutoTableField::currentLoginId, String.class);
this.strictInsertFill(metaObject, "createdTime", LocalDateTime::now, LocalDateTime.class);
- this.strictInsertFill(metaObject, "lastModifiedBy", StpUtil::getLoginIdAsString, String.class);
+ this.strictInsertFill(metaObject, "lastModifiedBy", AutoTableField::currentLoginId, String.class);
this.strictInsertFill(metaObject, "lastModifiedTime", LocalDateTime::now, LocalDateTime.class);
+ this.strictInsertFill(metaObject, "deviceInfo", AutoTableField::currentDevice, String.class);
}
@Override
public void updateFill(MetaObject metaObject) {
- this.strictInsertFill(metaObject, "lastModifiedBy", StpUtil::getLoginIdAsString, String.class);
+ this.strictInsertFill(metaObject, "lastModifiedBy", AutoTableField::currentLoginId, String.class);
this.strictInsertFill(metaObject, "lastModifiedTime", LocalDateTime::now, LocalDateTime.class);
- this.strictInsertFill(metaObject,"deviceInfo",StpUtil::getLoginDevice,String.class);
+ this.strictInsertFill(metaObject, "deviceInfo", AutoTableField::currentDevice, String.class);
+ }
+
+ /**
+ * 当前登录用户:后台执行线程通过 {@link TenantContext} 显式声明身份,请求线程仍走 StpUtil。
+ */
+ static String currentLoginId() {
+ TenantContext.Identity identity = TenantContext.get();
+ return identity != null ? identity.loginId() : StpUtil.getLoginIdAsString();
+ }
+
+ /**
+ * 当前设备:后台任务通常没有设备信息,返回 null 时跳过该项填充(保持列为空而不是写脏值)。
+ */
+ static String currentDevice() {
+ TenantContext.Identity identity = TenantContext.get();
+ return identity != null ? identity.device() : StpUtil.getLoginDevice();
}
}
diff --git a/src/main/java/com/guo/learningprogresstracker/config/MybatisPlusConfig.java b/src/main/java/com/guo/learningprogresstracker/config/MybatisPlusConfig.java
index 20f5617..e871e95 100644
--- a/src/main/java/com/guo/learningprogresstracker/config/MybatisPlusConfig.java
+++ b/src/main/java/com/guo/learningprogresstracker/config/MybatisPlusConfig.java
@@ -1,6 +1,7 @@
package com.guo.learningprogresstracker.config;
import cn.dev33.satoken.stp.StpUtil;
+import com.guo.learningprogresstracker.common.TenantContext;
import net.sf.jsqlparser.expression.StringValue;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
@@ -39,7 +40,10 @@ public class MybatisPlusConfig {
interceptor.addInnerInterceptor(new TenantLineInnerInterceptor(new TenantLineHandler() {
@Override
public Expression getTenantId() {
- return new StringValue(StpUtil.getLoginIdAsString());
+ // 后台执行线程(AI 任务、定时收敛)通过 TenantContext 显式声明身份;
+ // 请求线程没有设置,仍走 StpUtil,行为完全不变
+ TenantContext.Identity identity = TenantContext.get();
+ return new StringValue(identity != null ? identity.loginId() : StpUtil.getLoginIdAsString());
}
@Override
diff --git a/src/main/java/com/guo/learningprogresstracker/controller/AiTaskController.java b/src/main/java/com/guo/learningprogresstracker/controller/AiTaskController.java
new file mode 100644
index 0000000..a44c630
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/controller/AiTaskController.java
@@ -0,0 +1,56 @@
+package com.guo.learningprogresstracker.controller;
+
+import com.guo.learningprogresstracker.dto.AiTaskResponse;
+import com.guo.learningprogresstracker.dto.request.AiTaskSubmitRequest;
+import com.guo.learningprogresstracker.entity.CommonResult;
+import com.guo.learningprogresstracker.exception.ErrorParameterException;
+import com.guo.learningprogresstracker.exception.NotFindEntitiesException;
+import com.guo.learningprogresstracker.service.AiTaskService;
+import jakarta.validation.Valid;
+import lombok.RequiredArgsConstructor;
+import org.springframework.validation.annotation.Validated;
+import org.springframework.web.bind.annotation.*;
+
+/**
+ * AI 异步任务控制层(AI-02)。
+ *
+ * 提交与查询分离:提交接口秒级返回任务标识,前端随后轮询查询接口拿结果。
+ * 这样刷新或离开页面都不会丢结果,AI 已消耗的 token 也不会白费。
+ */
+@RequestMapping("/ai/tasks")
+@RestController
+@Validated
+@RequiredArgsConstructor
+public class AiTaskController {
+
+ private final AiTaskService aiTaskService;
+
+ /**
+ * 提交 AI 任务。
+ * 同一目标已有进行中任务时直接返回该任务(AI-04:对外是任务状态,而不是可能为空的实体)。
+ */
+ @PostMapping
+ public CommonResult submit(@Valid @RequestBody AiTaskSubmitRequest request)
+ throws ErrorParameterException, NotFindEntitiesException {
+ return CommonResult.success(aiTaskService.submit(request));
+ }
+
+ /**
+ * 查询任务状态与结果;结果可重复获取。
+ */
+ @GetMapping("/{taskNum}")
+ public CommonResult getTask(@PathVariable String taskNum) throws NotFindEntitiesException {
+ return CommonResult.success(aiTaskService.getByTaskNum(taskNum));
+ }
+
+ /**
+ * 查询某目标最近的 AI 任务,用于离开页面再回来时恢复生成状态。
+ *
+ * @return 无任务时 data 为 null
+ */
+ @GetMapping("/latest")
+ public CommonResult getLatestTask(@RequestParam String type,
+ @RequestParam String targetNum) {
+ return CommonResult.success(aiTaskService.findLatest(type, targetNum));
+ }
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/controller/ReviewController.java b/src/main/java/com/guo/learningprogresstracker/controller/ReviewController.java
index 994a0c3..fcd7b6d 100644
--- a/src/main/java/com/guo/learningprogresstracker/controller/ReviewController.java
+++ b/src/main/java/com/guo/learningprogresstracker/controller/ReviewController.java
@@ -2,8 +2,6 @@ package com.guo.learningprogresstracker.controller;
import com.guo.learningprogresstracker.dto.ReviewFeedItem;
import com.guo.learningprogresstracker.dto.ReviewTaskStats;
-import com.guo.learningprogresstracker.dto.ReviewTiming;
-import com.guo.learningprogresstracker.dto.request.RecallCompareRequest;
import com.guo.learningprogresstracker.dto.request.UpdateStandardMindMapRequest;
import com.guo.learningprogresstracker.entity.CommonResult;
import com.guo.learningprogresstracker.entity.ReviewRecallRecordEntity;
@@ -88,26 +86,15 @@ public class ReviewController {
// ============ 标准思维导图与回忆对比 ============
/**
- * 获取或自动生成任务的标准思维导图
+ * 获取任务的标准思维导图。
+ *
+ * 读取不触发生成(AI-02):不存在时 data 为 null,由前端提交
+ * {@code POST /ai/tasks}(type=MIND_MAP)后轮询结果。
*/
@GetMapping("/standard-mind-map/{taskNum}")
public CommonResult getStandardMindMap(
- @PathVariable String taskNum) throws NotFindEntitiesException, OperationFailedException {
- return CommonResult.success(standardMindMapService.getOrGenerate(taskNum));
- }
-
- /**
- * 强制重新生成任务的标准思维导图
- * @param mode 生成模式:full(全量覆盖,默认)或 incremental(增量合并)
- */
- @PostMapping("/standard-mind-map/{taskNum}/regenerate")
- public CommonResult regenerateStandardMindMap(
- @PathVariable String taskNum,
- @RequestParam(defaultValue = "full") String mode) throws NotFindEntitiesException, OperationFailedException {
- if ("incremental".equals(mode)) {
- return CommonResult.success(standardMindMapService.incrementalGenerate(taskNum));
- }
- return CommonResult.success(standardMindMapService.regenerate(taskNum));
+ @PathVariable String taskNum) throws NotFindEntitiesException {
+ return CommonResult.success(standardMindMapService.getExisting(taskNum));
}
/**
@@ -120,19 +107,6 @@ public class ReviewController {
return CommonResult.success(standardMindMapService.updateByOutline(taskNum, request.getOutline()));
}
- /**
- * 用户提交回忆大纲,与标准导图对比
- */
- @PostMapping("/standard-mind-map/{taskNum}/recall")
- public CommonResult recallCompare(
- @PathVariable String taskNum,
- @Valid @RequestBody RecallCompareRequest request) throws NotFindEntitiesException, OperationFailedException {
- return CommonResult.success(standardMindMapService.recallCompare(
- taskNum, request.getRecallOutline(), request.getFocusPath(),
- new ReviewTiming(request.getReviewStartedAt(), request.getReviewLastInteractionAt(),
- request.getReviewDurationSeconds())));
- }
-
/**
* 在标准导图中查找与给定内容最匹配的节点
*/
diff --git a/src/main/java/com/guo/learningprogresstracker/controller/StudySessionController.java b/src/main/java/com/guo/learningprogresstracker/controller/StudySessionController.java
index 08a465a..f31b256 100644
--- a/src/main/java/com/guo/learningprogresstracker/controller/StudySessionController.java
+++ b/src/main/java/com/guo/learningprogresstracker/controller/StudySessionController.java
@@ -114,14 +114,6 @@ public class StudySessionController {
}
- /**
- * 生成学习报告草稿:AI 聚合残片(不可用时降级为拼接),返回给前端作为编辑起点
- */
- @GetMapping("/{sessionNum}/report-draft")
- public CommonResult getReportDraft(@PathVariable("sessionNum") String sessionNum) throws ErrorParameterException {
- return CommonResult.success("请求成功", studySessionsServiceImpl.generateReportDraft(sessionNum));
- }
-
/** 分页查询任务的残片历史 */
@GetMapping("/tasks/{taskNum}/fragments")
public CommonResult> getTaskFragments(
diff --git a/src/main/java/com/guo/learningprogresstracker/dto/AiTaskResponse.java b/src/main/java/com/guo/learningprogresstracker/dto/AiTaskResponse.java
new file mode 100644
index 0000000..9eef487
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/dto/AiTaskResponse.java
@@ -0,0 +1,54 @@
+package com.guo.learningprogresstracker.dto;
+
+import com.guo.learningprogresstracker.entity.AiTaskEntity;
+import io.swagger.v3.oas.annotations.media.Schema;
+import lombok.Data;
+
+import java.time.LocalDateTime;
+import java.util.Map;
+
+/**
+ * AI 任务对外视图(AI-02)。
+ * 提交与查询都返回它:前端只依赖 {@code status} 与 {@code result},
+ * 不需要在请求线程里等 AI(也就不会出现「AI 成功了但客户端已超时」)。
+ */
+@Data
+public class AiTaskResponse {
+
+ @Schema(description = "AI 任务编号")
+ private String taskNum;
+
+ @Schema(description = "任务类型:RECALL_COMPARE / MIND_MAP / REPORT_DRAFT")
+ private String type;
+
+ @Schema(description = "目标编号:学习任务编号或学习会话编号")
+ private String targetNum;
+
+ @Schema(description = "状态:PENDING / RUNNING / SUCCEEDED / FAILED")
+ private String status;
+
+ @Schema(description = "失败原因(用户可见文案)")
+ private String errorMessage;
+
+ @Schema(description = "提交时间")
+ private LocalDateTime createdTime;
+
+ @Schema(description = "结束时间")
+ private LocalDateTime finishedTime;
+
+ @Schema(description = "成功结果,随任务类型不同;未完成时为 null")
+ private Map result;
+
+ public static AiTaskResponse from(AiTaskEntity entity, Map result) {
+ AiTaskResponse response = new AiTaskResponse();
+ response.setTaskNum(entity.getTaskNum());
+ response.setType(entity.getAiType());
+ response.setTargetNum(entity.getTargetNum());
+ response.setStatus(entity.getStatus());
+ response.setErrorMessage(entity.getErrorMessage());
+ response.setCreatedTime(entity.getCreatedTime());
+ response.setFinishedTime(entity.getFinishedTime());
+ response.setResult(result);
+ return response;
+ }
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/dto/RecallCompareOutcome.java b/src/main/java/com/guo/learningprogresstracker/dto/RecallCompareOutcome.java
new file mode 100644
index 0000000..3911009
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/dto/RecallCompareOutcome.java
@@ -0,0 +1,30 @@
+package com.guo.learningprogresstracker.dto;
+
+/**
+ * 一次回忆对比的结果(AI-02)。
+ *
+ * 对比在 AI 任务执行器里完成,因此不再把「标准导图实体」直接返回给提交接口;
+ * 这个结果写进 AI 任务的 {@code result_payload},由前端在轮询到成功后再取详情。
+ *
+ * @param standardMapId 对比所用的标准导图 ID
+ * @param recallRecordId 本次生成的回忆记录 ID
+ * @param recallRatio 覆盖率(0-1)
+ * @param matchedCount 命中节点数
+ * @param missedCount 遗漏节点数
+ * @param extraCount 额外节点数
+ */
+public record RecallCompareOutcome(Integer standardMapId, Integer recallRecordId, Double recallRatio,
+ Integer matchedCount, Integer missedCount, Integer extraCount) {
+
+ /** 转成 AI 任务结果载荷 */
+ public java.util.Map toPayload() {
+ java.util.Map payload = new java.util.LinkedHashMap<>();
+ payload.put("standardMapId", standardMapId);
+ payload.put("recallRecordId", recallRecordId);
+ payload.put("recallRatio", recallRatio);
+ payload.put("matchedCount", matchedCount);
+ payload.put("missedCount", missedCount);
+ payload.put("extraCount", extraCount);
+ return payload;
+ }
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/dto/request/AiTaskSubmitRequest.java b/src/main/java/com/guo/learningprogresstracker/dto/request/AiTaskSubmitRequest.java
new file mode 100644
index 0000000..50ffb5a
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/dto/request/AiTaskSubmitRequest.java
@@ -0,0 +1,43 @@
+package com.guo.learningprogresstracker.dto.request;
+
+import jakarta.validation.constraints.NotBlank;
+import lombok.Data;
+
+import java.util.Map;
+
+/**
+ * 提交 AI 任务请求(AI-02)。
+ */
+@Data
+public class AiTaskSubmitRequest {
+
+ @NotBlank(message = "请先指定要处理的类型")
+ private String type;
+
+ @NotBlank(message = "请先指定要处理的对象")
+ private String targetNum;
+
+ /** 类型相关的参数;无需参数时可为空 */
+ private Map params;
+
+ /** 阅读友好度:null 表示不关心 */
+ public String paramAsString(String key) {
+ Object value = params == null ? null : params.get(key);
+ return value == null ? null : String.valueOf(value);
+ }
+
+ public Integer paramAsInteger(String key) {
+ Object value = params == null ? null : params.get(key);
+ if (value instanceof Number number) {
+ return number.intValue();
+ }
+ if (value instanceof String text && !text.isBlank()) {
+ try {
+ return Integer.valueOf(text.trim());
+ } catch (NumberFormatException e) {
+ return null;
+ }
+ }
+ return null;
+ }
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/entity/AiTaskEntity.java b/src/main/java/com/guo/learningprogresstracker/entity/AiTaskEntity.java
new file mode 100644
index 0000000..db702c3
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/entity/AiTaskEntity.java
@@ -0,0 +1,79 @@
+package com.guo.learningprogresstracker.entity;
+
+import com.baomidou.mybatisplus.annotation.IdType;
+import com.baomidou.mybatisplus.annotation.TableField;
+import com.baomidou.mybatisplus.annotation.TableId;
+import com.baomidou.mybatisplus.annotation.TableName;
+import com.guo.learningprogresstracker.enums.AiTaskStatusEnum;
+import com.guo.learningprogresstracker.utils.GenerateNumTool;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.time.LocalDateTime;
+
+/**
+ * AI 异步任务(AI-02):提交后立即返回任务标识,结果由执行器回写、按标识重复获取。
+ */
+@TableName(value = "ai_tasks")
+@Data
+public class AiTaskEntity extends BaseEntity implements Serializable {
+
+ @TableId(value = "id", type = IdType.AUTO)
+ private Integer id;
+
+ /** 对外任务标识 */
+ @TableField(value = "task_num")
+ private String taskNum;
+
+ /** 任务类型,取值见 {@code AiTaskTypeEnum} */
+ @TableField(value = "ai_type")
+ private String aiType;
+
+ /** 目标编号:学习任务编号或学习会话编号 */
+ @TableField(value = "target_num")
+ private String targetNum;
+
+ /** 状态,取值见 {@code AiTaskStatusEnum} */
+ @TableField(value = "status")
+ private String status;
+
+ /** 提交时的请求参数 JSON */
+ @TableField(value = "request_payload")
+ private String requestPayload;
+
+ /** 成功结果 JSON */
+ @TableField(value = "result_payload")
+ private String resultPayload;
+
+ /** 失败原因(用户可见文案) */
+ @TableField(value = "error_message")
+ private String errorMessage;
+
+ @TableField(value = "started_time")
+ private LocalDateTime startedTime;
+
+ @TableField(value = "finished_time")
+ private LocalDateTime finishedTime;
+
+ @TableField(exist = false)
+ private static final long serialVersionUID = 1L;
+
+ public static AiTaskEntity initNewTask(String aiType, String targetNum, String requestPayload) {
+ AiTaskEntity task = new AiTaskEntity();
+ task.setTaskNum(GenerateNumTool.generateNum("AITASK"));
+ task.setAiType(aiType);
+ task.setTargetNum(targetNum);
+ task.setStatus(AiTaskStatusEnum.PENDING.name());
+ task.setRequestPayload(requestPayload);
+ return task;
+ }
+
+ public boolean isActive() {
+ return AiTaskStatusEnum.ACTIVE.contains(AiTaskStatusEnum.valueOf(status));
+ }
+
+ public boolean isFinished() {
+ return AiTaskStatusEnum.SUCCEEDED.name().equals(status)
+ || AiTaskStatusEnum.FAILED.name().equals(status);
+ }
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/enums/AiTaskStatusEnum.java b/src/main/java/com/guo/learningprogresstracker/enums/AiTaskStatusEnum.java
new file mode 100644
index 0000000..74b98e7
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/enums/AiTaskStatusEnum.java
@@ -0,0 +1,36 @@
+package com.guo.learningprogresstracker.enums;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+import java.util.EnumSet;
+import java.util.Set;
+
+/**
+ * AI 任务状态(AI-02)。
+ */
+@Getter
+@AllArgsConstructor
+public enum AiTaskStatusEnum {
+
+ /** 已提交,等待执行 */
+ PENDING("正在准备"),
+
+ /** 执行中 */
+ RUNNING("正在生成"),
+
+ /** 已完成,结果可重复获取 */
+ SUCCEEDED("已完成"),
+
+ /** 已失败,允许用户重新提交 */
+ FAILED("失败了");
+
+ private final String description;
+
+ /** 进行中的状态集合:用于「生成中」判定与防重复提交 */
+ public static final Set ACTIVE = EnumSet.of(PENDING, RUNNING);
+
+ public static Set activeNames() {
+ return ACTIVE.stream().map(Enum::name).collect(java.util.stream.Collectors.toSet());
+ }
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/enums/AiTaskTypeEnum.java b/src/main/java/com/guo/learningprogresstracker/enums/AiTaskTypeEnum.java
new file mode 100644
index 0000000..d79f33f
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/enums/AiTaskTypeEnum.java
@@ -0,0 +1,35 @@
+package com.guo.learningprogresstracker.enums;
+
+import lombok.AllArgsConstructor;
+import lombok.Getter;
+
+/**
+ * AI 任务类型(AI-02)。
+ */
+@Getter
+@AllArgsConstructor
+public enum AiTaskTypeEnum {
+
+ /** 回忆对比:把用户回忆大纲与标准导图对比 */
+ RECALL_COMPARE("回忆对比"),
+
+ /** 标准思维导图生成:全量、增量或按需生成 */
+ MIND_MAP("思维导图生成"),
+
+ /** 学习报告草稿聚合 */
+ REPORT_DRAFT("学习报告草稿");
+
+ private final String description;
+
+ /** 宽松解析:默认大小写不敏感,并用该类型的默认用户可见名称兜底 */
+ public static AiTaskTypeEnum parse(String value) {
+ if (value == null || value.isBlank()) {
+ return null;
+ }
+ try {
+ return valueOf(value.trim().toUpperCase());
+ } catch (IllegalArgumentException e) {
+ return null;
+ }
+ }
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/mapper/AiTaskMapper.java b/src/main/java/com/guo/learningprogresstracker/mapper/AiTaskMapper.java
new file mode 100644
index 0000000..3524416
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/mapper/AiTaskMapper.java
@@ -0,0 +1,99 @@
+package com.guo.learningprogresstracker.mapper;
+
+import com.baomidou.mybatisplus.annotation.InterceptorIgnore;
+import com.baomidou.mybatisplus.core.mapper.BaseMapper;
+import com.guo.learningprogresstracker.entity.AiTaskEntity;
+import org.apache.ibatis.annotations.Mapper;
+import org.apache.ibatis.annotations.Param;
+import org.apache.ibatis.annotations.Select;
+import org.apache.ibatis.annotations.Update;
+
+import java.time.LocalDateTime;
+import java.util.List;
+
+/**
+ * AI 异步任务 Mapper(AI-02)。
+ */
+@Mapper
+public interface AiTaskMapper extends BaseMapper {
+
+ /**
+ * 取待处理任务(执行器用)。
+ *
+ * 执行器在请求之外运行,没有登录态供租户拦截器读取,因此显式忽略租户条件;
+ * 这是系统级后台处理,与请求路径的租户隔离互不影响。自定义 SQL 不会被
+ * {@code @TableLogic} 自动追加条件,所以 {@code deleted = 0} 必须显式写出。
+ */
+ @InterceptorIgnore(tenantLine = "true")
+ @Select("""
+ SELECT *
+ FROM ai_tasks
+ WHERE deleted = 0
+ AND status = 'PENDING'
+ ORDER BY created_time ASC
+ LIMIT #{limit}
+ """)
+ List selectPendingTasks(@Param("limit") int limit);
+
+ /**
+ * 按主键取任务(执行器用)。
+ *
+ * 执行器在请求之外运行,此时还不知道任务属于哪个租户,无法让租户拦截器注入条件;
+ * 因此这里显式忽略租户。读到任务后,执行器会以任务自己的 {@code created_by} 作为租户身份执行,
+ * 后续所有业务查询仍然受租户隔离约束。
+ */
+ @InterceptorIgnore(tenantLine = "true")
+ @Select("SELECT * FROM ai_tasks WHERE id = #{id} AND deleted = 0")
+ AiTaskEntity selectTaskById(@Param("id") Integer id);
+
+ /**
+ * 抢占任务:只有仍处于 PENDING 的任务才会被置为 RUNNING,保证多副本/多线程下不重复执行。
+ *
+ * @return 受影响行数,0 表示已被其他执行者抢走
+ */
+ @InterceptorIgnore(tenantLine = "true")
+ @Update("""
+ UPDATE ai_tasks
+ SET status = 'RUNNING',
+ started_time = #{startedTime},
+ last_modified_time = #{startedTime}
+ WHERE id = #{id}
+ AND status = 'PENDING'
+ AND deleted = 0
+ """)
+ int claimTask(@Param("id") Integer id, @Param("startedTime") LocalDateTime startedTime);
+
+ /**
+ * 回收超时未回写的任务(执行器崩溃或进程被杀时,任务会永远停在 RUNNING)。
+ * 置回 PENDING 让执行器重试;同时清掉开始时间,便于重新计时。
+ */
+ @InterceptorIgnore(tenantLine = "true")
+ @Update("""
+ UPDATE ai_tasks
+ SET status = 'PENDING',
+ started_time = NULL,
+ last_modified_time = #{now}
+ WHERE status = 'RUNNING'
+ AND deleted = 0
+ AND started_time IS NOT NULL
+ AND started_time <= #{cutoff}
+ """)
+ int reclaimStuckTasks(@Param("cutoff") LocalDateTime cutoff, @Param("now") LocalDateTime now);
+
+ /**
+ * 回写结果:只有仍处于 RUNNING 的任务才会被写入,避免超时回收后与新执行者互相覆盖。
+ */
+ @InterceptorIgnore(tenantLine = "true")
+ @Update("""
+ UPDATE ai_tasks
+ SET status = #{status},
+ result_payload = #{resultPayload},
+ error_message = #{errorMessage},
+ finished_time = #{finishedTime},
+ last_modified_time = #{finishedTime}
+ WHERE id = #{id}
+ AND status = 'RUNNING'
+ AND deleted = 0
+ """)
+ int finishTask(AiTaskEntity task);
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/service/AiTaskService.java b/src/main/java/com/guo/learningprogresstracker/service/AiTaskService.java
new file mode 100644
index 0000000..8597e2d
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/service/AiTaskService.java
@@ -0,0 +1,68 @@
+package com.guo.learningprogresstracker.service;
+
+import com.guo.learningprogresstracker.dto.AiTaskResponse;
+import com.guo.learningprogresstracker.dto.request.AiTaskSubmitRequest;
+import com.guo.learningprogresstracker.entity.AiTaskEntity;
+import com.guo.learningprogresstracker.exception.ErrorParameterException;
+import com.guo.learningprogresstracker.exception.NotFindEntitiesException;
+
+import java.util.List;
+import java.util.Map;
+
+/**
+ * AI 异步任务服务(AI-02)。
+ *
+ * 提交与执行分离:提交只落一条 PENDING 记录并立刻返回任务标识;执行由请求线程之外
+ * 的执行器完成。因此接口不再随 AI 耗时增长,刷新页面也不会丢失结果。
+ */
+public interface AiTaskService {
+
+ /**
+ * 提交 AI 任务。
+ *
+ * 同一用户 + 同一类型 + 同一目标若已有进行中任务,直接复用(AI-04 的「生成中」语义:
+ * 返回任务状态而不是可能为空的实体),不会重复触发生成。
+ */
+ AiTaskResponse submit(AiTaskSubmitRequest request) throws ErrorParameterException, NotFindEntitiesException;
+
+ /**
+ * 按任务标识查询任务状态与结果;结果可重复获取。
+ */
+ AiTaskResponse getByTaskNum(String taskNum) throws NotFindEntitiesException;
+
+ /**
+ * 查询某目标最近的 AI 任务(用于离开页面再回来时恢复生成状态)。
+ *
+ * @return 无任务时返回 null
+ */
+ AiTaskResponse findLatest(String type, String targetNum);
+
+ /**
+ * 取出并抢占待处理任务(执行器入口);没有可执行任务时返回空列表。
+ */
+ List claimPendingTasks(int limit);
+
+ /**
+ * 抢占指定任务(提交后立即投递的入口)。
+ *
+ * @return 抢占成功返回任务;已被其他执行者抢走或状态不允许时返回空
+ */
+ java.util.Optional claimTask(Integer id);
+
+ /**
+ * 回写成功结果。
+ */
+ void markSucceeded(AiTaskEntity task, Map result);
+
+ /**
+ * 回写失败结果(只记用户可见文案,技术细节由调用方写日志)。
+ */
+ void markFailed(AiTaskEntity task, String message);
+
+ /**
+ * 回收因进程中断而卡在 RUNNING 的任务,使其可被重新执行。
+ *
+ * @return 被回收的任务数
+ */
+ int reclaimStuckTasks();
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/service/StandardMindMapService.java b/src/main/java/com/guo/learningprogresstracker/service/StandardMindMapService.java
index 082cbaf..2e709cd 100644
--- a/src/main/java/com/guo/learningprogresstracker/service/StandardMindMapService.java
+++ b/src/main/java/com/guo/learningprogresstracker/service/StandardMindMapService.java
@@ -1,5 +1,6 @@
package com.guo.learningprogresstracker.service;
+import com.guo.learningprogresstracker.dto.RecallCompareOutcome;
import com.guo.learningprogresstracker.dto.ReviewTiming;
import com.guo.learningprogresstracker.entity.ReviewRecallRecordEntity;
import com.guo.learningprogresstracker.entity.ReviewStandardMindMapEntity;
@@ -16,9 +17,11 @@ import java.util.Map;
public interface StandardMindMapService {
/**
- * 获取指定任务的标准思维导图,不存在时自动生成。
+ * 获取指定任务已有的标准思维导图;不存在时返回 null。
+ *
+ * 不在读取路径上触发生成:生成可能耗时数分钟(AI-02),应由 AI 任务异步完成。
*/
- ReviewStandardMindMapEntity getOrGenerate(String taskNum) throws NotFindEntitiesException, OperationFailedException;
+ ReviewStandardMindMapEntity getExisting(String taskNum) throws NotFindEntitiesException;
/**
* 强制重新生成指定任务的标准思维导图。
@@ -36,14 +39,16 @@ public interface StandardMindMapService {
ReviewStandardMindMapEntity updateByOutline(String taskNum, String outline) throws NotFindEntitiesException;
/**
- * 用户提交回忆大纲,与标准导图对比并返回结果。
+ * 用户提交回忆大纲,与标准导图对比。
+ *
+ * 由 AI 任务执行器在请求线程之外调用;方法本身不持有事务,避免等待 AI 时占用数据库连接。
*
* @param recallOutline 用户回忆的缩进大纲文本
* @param focusPath 可选:标准导图中的节点路径(/ 分隔),指定后仅对比该子树
* @param timing 可选:本次复习行为的计时信息(复习-07),为空时不计复习耗时
*/
- ReviewStandardMindMapEntity recallCompare(String taskNum, String recallOutline, String focusPath,
- ReviewTiming timing) throws NotFindEntitiesException, OperationFailedException;
+ RecallCompareOutcome recallCompare(String taskNum, String recallOutline, String focusPath,
+ ReviewTiming timing) throws NotFindEntitiesException, OperationFailedException;
/**
* 根据内容文本在标准导图中查找最匹配的节点,返回节点路径。
diff --git a/src/main/java/com/guo/learningprogresstracker/service/StudySessionsService.java b/src/main/java/com/guo/learningprogresstracker/service/StudySessionsService.java
index 796414e..37b64a3 100644
--- a/src/main/java/com/guo/learningprogresstracker/service/StudySessionsService.java
+++ b/src/main/java/com/guo/learningprogresstracker/service/StudySessionsService.java
@@ -41,6 +41,13 @@ public interface StudySessionsService extends IService {
StudySessionResponse getActiveSession(String excludeTaskNum);
+ /**
+ * 生成学习报告草稿(AI 聚合残片,不可用时降级为按序拼接)。
+ *
+ * 由 AI 任务执行器调用,不在请求线程内执行(AI-02)。
+ */
+ String buildReportDraft(String sessionNum) throws ErrorParameterException;
+
/**
* 惰性收敛(会话-04):把当前用户悬挂的进行中会话按硬兜底阈值强制暂停。
* 由读取路径调用(活跃会话、任务未结束会话),用户不访问时由定时扫描兜底。
diff --git a/src/main/java/com/guo/learningprogresstracker/service/event/AiTaskSubmittedEvent.java b/src/main/java/com/guo/learningprogresstracker/service/event/AiTaskSubmittedEvent.java
new file mode 100644
index 0000000..a90f466
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/service/event/AiTaskSubmittedEvent.java
@@ -0,0 +1,12 @@
+package com.guo.learningprogresstracker.service.event;
+
+/**
+ * AI 任务已提交事件(AI-02)。
+ *
+ * 提交与执行解耦:提交方只负责落库并发出事件,执行由异步监听器在请求线程之外完成,
+ * 这样 {@code AiTaskService} 不必反过来依赖执行器,也不会形成循环依赖。
+ *
+ * @param taskId 任务主键
+ */
+public record AiTaskSubmittedEvent(Integer taskId) {
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskFailedException.java b/src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskFailedException.java
new file mode 100644
index 0000000..a552ad9
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskFailedException.java
@@ -0,0 +1,15 @@
+package com.guo.learningprogresstracker.service.impl;
+
+/**
+ * AI 任务执行失败(AI-02):{@code message} 是给用户看的文案,技术细节由抛出方写日志。
+ */
+public class AiTaskFailedException extends RuntimeException {
+
+ public AiTaskFailedException(String message) {
+ super(message);
+ }
+
+ public AiTaskFailedException(String message, Throwable cause) {
+ super(message, cause);
+ }
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskHandler.java b/src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskHandler.java
new file mode 100644
index 0000000..84e0ab4
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskHandler.java
@@ -0,0 +1,28 @@
+package com.guo.learningprogresstracker.service.impl;
+
+import com.guo.learningprogresstracker.entity.AiTaskEntity;
+import com.guo.learningprogresstracker.enums.AiTaskTypeEnum;
+
+import java.util.Map;
+
+/**
+ * 一类 AI 任务的具体执行逻辑(AI-02)。
+ *
+ * 实现类在请求线程之外被调用,因此可以放心地同步等待 AI;但不要在实现里开启长事务,
+ * 否则会把「等待 AI 时不占用数据库连接」这条约束重新破坏掉。
+ */
+public interface AiTaskHandler {
+
+ /** 该实现负责的任务类型 */
+ AiTaskTypeEnum type();
+
+ /**
+ * 执行任务。
+ *
+ * @param task 任务实体(status 已是 RUNNING)
+ * @param params 提交时的参数(可能为空 Map)
+ * @return 写回 result_payload 的结果
+ * @throws AiTaskFailedException 业务上可预期的失败,消息会展示给用户
+ */
+ Map execute(AiTaskEntity task, Map params);
+}
diff --git a/src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskHandlerRegistry.java b/src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskHandlerRegistry.java
new file mode 100644
index 0000000..274b7b7
--- /dev/null
+++ b/src/main/java/com/guo/learningprogresstracker/service/impl/AiTaskHandlerRegistry.java
@@ -0,0 +1,65 @@
+package com.guo.learningprogresstracker.service.impl;
+
+import com.fasterxml.jackson.core.type.TypeReference;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.guo.learningprogresstracker.entity.AiTaskEntity;
+import com.guo.learningprogresstracker.enums.AiTaskTypeEnum;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.stereotype.Component;
+import org.springframework.util.StringUtils;
+
+import java.util.EnumMap;
+import java.util.List;
+import java.util.Map;
+
+/**
+ * AI 任务处理器注册表(AI-02):按类型分发到具体实现。
+ */
+@Slf4j
+@Component
+public class AiTaskHandlerRegistry {
+
+ private final Map handlers = new EnumMap<>(AiTaskTypeEnum.class);
+
+ private final ObjectMapper objectMapper;
+
+ public AiTaskHandlerRegistry(List handlerList, ObjectMapper objectMapper) {
+ this.objectMapper = objectMapper;
+ for (AiTaskHandler handler : handlerList) {
+ AiTaskHandler previous = handlers.put(handler.type(), handler);
+ if (previous != null) {
+ log.warn("AI 任务类型 {} 有多个处理器,后注册的 {} 覆盖了 {}",
+ handler.type(), handler.getClass().getSimpleName(), previous.getClass().getSimpleName());
+ }
+ }
+ log.info("AI 任务处理器已注册: {}", handlers.keySet());
+ }
+
+ /**
+ * 执行任务。
+ *
+ * @throws AiTaskFailedException 类型无处理器或参数解析失败
+ */
+ public Map execute(AiTaskEntity task) {
+ AiTaskTypeEnum type = AiTaskTypeEnum.parse(task.getAiType());
+ AiTaskHandler handler = type == null ? null : handlers.get(type);
+ if (handler == null) {
+ log.error("AI 任务类型[{}]没有对应的处理器", task.getAiType());
+ throw new AiTaskFailedException("这个功能暂时不可用,请稍后再试");
+ }
+ return handler.execute(task, parseParams(task));
+ }
+
+ private Map parseParams(AiTaskEntity task) {
+ if (!StringUtils.hasText(task.getRequestPayload())) {
+ return Map.of();
+ }
+ try {
+ return objectMapper.readValue(task.getRequestPayload(), new TypeReference