代码变更说明文档

日期: 2026-03-26
提交次数: 5 次
涉及文件: 200+ 个文件

一、提交概览

提交ID	提交说明	时间
`4de959d0`	新增表结构的增删改查接口	20:49
`d2bd9e28`	基础对话;SSE 流式响应;会话创建+历史查选接口	20:16
`4dc0df0f`	ai agent	18:25
`9b5a845e`	add docs	17:37
`93cc7508`	收敛多余项目，非 admin、openplatform 外的功能收敛进 emoon-extend; 基础设施收敛进 emoon-infra	16:21

二、主要功能变更

1. AI Agent 引擎配置管理 (`4de959d0`)

新增功能: AI Agent 引擎配置的完整 CRUD 接口

涉及模块: emoon-infra/emoon-modules-api/emoon-system-api

新增文件:

AiAgentEngineConfigBo.java - 业务对象
AiAgentEngineConfigVo.java - 视图对象
AiAgentEngineConfigMapper.java - 数据访问层
IAiAgentEngineConfigService.java - 服务接口
AiAgentEngineConfigServiceImpl.java - 服务实现
AiAgentEngineConfigController.java - 控制器层

功能说明: 提供 AI Agent 引擎配置的增删改查接口，支持配置不同 AI 引擎的参数。

2. 智能对话系统 (`d2bd9e28`)

新增功能: 基础对话能力、SSE 流式响应、会话管理

涉及模块: emoon-openplatform

核心功能:

2.1 Agent 对话控制器

文件: AgentController.java
功能: 提供对话接口，支持流式响应

2.2 DTO/VO 对象

AgentChatRequest.java - 对话请求对象
AgentChatResponse.java - 对话响应对象
ConversationCreateRequest.java - 会话创建请求
ConversationVo.java - 会话视图对象

2.3 服务层

IAgentChatService.java / AgentChatServiceImpl.java - 对话服务
IConversationService.java / ConversationServiceImpl.java - 会话管理服务

2.4 工具类

SignUtil.java - 签名工具，用于接口安全验证

技术特点:

使用 SSE (Server-Sent Events) 实现流式响应
支持会话创建和历史记录查询

3. AI Agent 核心引擎 (`4dc0df0f`)

新增功能: AI Agent 核心引擎架构

涉及模块: emoon-infra/emoon-modules-api/emoon-mcp-api 和 emoon-system-api

3.1 引擎核心 (mcp-api)

文件	说明
`AgentEngine.java`	引擎接口定义
`AgentEngineFactory.java`	引擎工厂，用于创建引擎实例
`AgentRequest.java` / `AgentResponse.java`	请求/响应对象
`MockAgentEngine.java`	模拟引擎实现（用于测试）

3.2 领域模型 (新增 8 个实体)

AI Agent 应用相关:

AiAgentApp.java - AI 应用定义
AiAgentEngineConfig.java - 引擎配置

AI 卡片相关:

AiCardInstance.java - 卡片实例
AiCardDefinition.java - 卡片定义
AiCardCategory.java - 卡片分类
AiCardPlugin.java - 卡片插件
AiCardGrayConfig.java - 灰度配置
AiCardActionLog.java - 操作日志

对话相关:

AiConversation.java - 对话记录

使用统计:

AiUsageLog.java - 使用日志

3.3 数据访问层

每个实体对应一个 Mapper 接口，共 8 个 Mapper。

3.4 服务层

每个实体对应一个 Service 接口和实现，共 8 个 Service。

4. 项目架构重构 (`93cc7508`)

重构内容: 项目结构收敛整理

4.1 收敛到 emoon-extend 的模块

emoon-file-downloader - 文件下载服务

独立的文件下载微服务
包含 Dockerfile 支持容器化部署

emoon-tongue - 舌诊服务

舌诊 AI 诊断功能
包含 H5 页面支持
主要组件:
- 舌诊控制器 (CreateRecordController, DiagnosisController 等)
- 舌诊服务实现 (TongueDiagnosisServiceImpl, TongueAiDiagnosisServiceImpl 等)
- MinIO 文件存储集成
- JWT 认证工具

4.2 收敛到 emoon-infra 的基础设施

emoon-common 公共模块:

emoon-common-core - 核心工具类、常量、异常定义
emoon-common-doc - SpringDoc 接口文档配置
emoon-common-encrypt - 数据加密解密 (AES、RSA、SM2、SM4)
emoon-common-excel - Excel 导入导出
emoon-common-httpclient - HTTP 客户端封装
emoon-common-idempotent - 幂等性控制
emoon-common-job - 定时任务配置
emoon-common-json - JSON 处理
emoon-common-log - 日志注解和切面

emoon-modules-api 模块:

emoon-system-api - 系统服务 API
emoon-mcp-api - MCP 服务 API

5. 文档更新 (`9b5a845e`)

新增文档: integrated-medical-agent-dify-card-solution.md

内容: 医疗智能体 Dify 卡片集成方案说明

三、技术栈说明

新增依赖

SSE 流式响应支持
签名验证工具

架构特点

分层架构: Controller -> Service -> Mapper 清晰分层
工厂模式: AgentEngineFactory 用于引擎实例创建
模块化设计: 功能按模块划分，便于维护扩展
基础设施复用: 通用功能收敛到 emoon-infra

四、接口清单

新增 Controller 接口

模块	Controller	说明
emoon-system	AiAgentEngineConfigController	引擎配置 CRUD
emoon-openplatform	AgentController	对话接口、会话管理

五、数据库表结构

新增表 (8 张)

表名	说明
ai_agent_app	AI 应用表
ai_agent_engine_config	引擎配置表
ai_card_instance	卡片实例表
ai_card_definition	卡片定义表
ai_card_category	卡片分类表
ai_card_plugin	卡片插件表
ai_card_gray_config	灰度配置表
ai_card_action_log	操作日志表
ai_conversation	对话记录表
ai_usage_log	使用日志表

六、后续建议

接口文档: 建议为新增接口补充 Swagger 注解
单元测试: 为 Service 层添加单元测试
权限控制: 检查 Controller 接口的权限注解配置
日志规范: 统一使用 @Log 注解记录操作日志

文档生成时间: 2026-03-27
生成工具: QoderWork

2026-03-26-code-changes-summary.md 6.0 KB Patstāvīgā saite Vēsture Neapstrādāts