mica-ai-starters ​

mica-ai Spring Boot Starter 聚合模块，一行配置即可将 AI 能力接入 Spring Boot 应用。

本模块为聚合 POM（packaging=pom），包含 4 个 starter：

Starter功能配置前缀
mica-ai-face-spring-boot-starterOpenCV Zoo 人脸识别（YuNet 检测 + SFace 128d 向量 + MiniFASNetV2 活体 + 头像 / 证件卡片提取）mica.ai.face
mica-ai-filetype-spring-boot-starterGoogle Magika 文件类型识别（214 类，三种置信度模式）mica.ai.filetype
mica-ai-plate-spring-boot-starterHyperLPR3 中国车牌识别（检测 + 识别 + 颜色分类 + 10 类判型）mica.ai.plate
mica-ai-layout-spring-boot-starterPP-DocLayoutV3 文档版面分析（25 类 + V3 阅读顺序；模型 125MB 不随仓库分发，需本地放模型）mica.ai.layout

统一设计 ​

所有 starter 遵循一致的设计模式：

  • AutoConfiguration — 条件装配核心引擎 Bean（@ConditionalOnClass + @ConditionalOnProperty）
  • Properties — @ConfigurationProperties 绑定配置文件
  • mica-auto — 自动生成 META-INF/spring/...AutoConfiguration.imports，无需手动维护
  • 生命周期 — Bean 设置 destroyMethod = "close"，应用关闭时自动释放 ONNX 资源
  • fail-fast — enabled=true 但必填配置缺失时启动直接抛 MicaAiException

Maven 依赖（按需引入） ​

xml
<dependency>
    <groupId>net.dreamlu</groupId>
    <artifactId>mica-ai-face-spring-boot-starter</artifactId>
    <version>${mica-ai.version}</version>
</dependency>

<dependency>
    <groupId>net.dreamlu</groupId>
    <artifactId>mica-ai-filetype-spring-boot-starter</artifactId>
    <version>${mica-ai.version}</version>
</dependency>

<dependency>
    <groupId>net.dreamlu</groupId>
    <artifactId>mica-ai-plate-spring-boot-starter</artifactId>
    <version>${mica-ai.version}</version>
</dependency>
<dependency>
    <groupId>net.dreamlu</groupId>
    <artifactId>mica-ai-layout-spring-boot-starter</artifactId>
    <version>${mica-ai.version}</version>
</dependency>

引入后无需任何 Java 代码，仅需在 application.yml 中配置模型路径即可自动注入对应 Bean。

完整可运行示例见 mica-ai-example。