核心引擎：零框架假设，仅依赖 spring-ai + jackson + slf4j。 SPI 接口 / Advisor 链 / Tool 基建 / KB-RAG / 上下文编排。 唯一被所有模块依赖的纯核心，不耦合任何缓存/持久化/安全的具体实现。

Spring Boot 自动装配入口：构建 ChatClient（含 core advisor 链 + ChatMemory）、 装配 AssistantService、暴露 REST 控制器与异常处理。使用者只需引入此依赖 + 一个 spring-ai 模型 starter（如 openai）即可。

CachePort 的默认实现：基于 Caffeine 的单节点内存缓存，支持 per-entry TTL。 用于 contextual-view 视图缓存等。分布式场景请改用 aifab-cache-redis。

CachePort 的 Redis 实现：分布式部署下的视图缓存等。与 aifab-cache-caffeine 互斥使用； 同时在 classpath 时 Redis 优先（按名 @AutoConfigureBefore caffeine）。

MyBatis-Plus 持久化实现（默认后端）：把 core 的 AiCallRecordSink / AiUsageLogSink / ToolInvocationRecorder / ChatSessionStore / ConfirmationStore 落到 6 张 AI 表 （ai_call_record / ai_usage_log / ai_tool_invocation / ai_chat_session / ...

Sa-Token 安全适配：基于 StpUtil 的 AiPrincipalResolver / PermissionChecker， 方便 RuoYi-Vue-Plus 老用户平滑迁入。与 aifab-security-springsecurity 互斥（host 二选一）。

默认安全适配：基于 Spring Security 的 AiPrincipalResolver / PermissionChecker， 从 SecurityContextHolder 解析当前用户与权限。host 引入此模块即获得真实身份/权限 （替换 core 的 anonymous/always-granted 默认）。