模块分层与依赖关系

模块分层与依赖关系

后端依赖由启动层指向业务层，再指向引擎与公共能力。模块聚合和 Maven 继承承担不同职责。

启动层

blade-service/blade-api 持有启动类、平台环境配置与基座功能。POM 的产品装配段引入 AI 业务和 SPI 适配模块。

业务层

blade-core/blade-ai-business 的 Java 包为 org.springblade.ai.business.<域>，包含控制器、服务实现、Mapper、包装器、资源授权和开放接口。

业务层组织一次任务所需的资源、授权和执行，再将结果转换为当前接口的返回形式。业务模块通过系统 SPI 使用字典、用户、区划和路由等平台能力。

引擎层

模块	主要领域
blade-ai-core	模型、推理（含视觉识别 vision）、数据源、公共调用上下文、记录、密钥与内容安全
blade-ai-app	流程编排、对话编排、专家团、节点执行与微信通道
blade-ai-rag	知识解析、分段、摄取、向量化、向量存储、召回与重排 rerank
blade-ai-extension	技能、MCP、渠道、插件、三方平台与外部智能体
blade-ai-insight	智能问数执行
blade-ai-studio	创作任务、文档读取、媒体处理与导出

实体、DTO、VO 等数据对象位于相应引擎域的 pojo 下。被引擎使用的服务接口也放在对应引擎域，持久化实现保留在业务层。引擎不反向依赖业务层和启动模块。

Maven 组织

blade-ai-engine 既聚合六个引擎，也是 AI 产品父 POM，集中管理 AI 第三方库与模块坐标。blade-ai-business 与它同级，通过父 POM 继承产品依赖管理。

根 POM 管理工程版本、BladeX 基座依赖与构建插件。新增 AI 依赖先检查产品父 POM 和最终启动模块的实际仲裁结果。

源码定位：根 POM、blade-core/pom.xml、blade-core/blade-ai-engine/pom.xml、blade-ai-business/pom.xml。