信创环境适配
信创适配体系
信创环境适配围绕处理器、操作系统、Java 运行时、数据库和基础服务展开。平台后端是运行在 JDK 21 上的 Java 服务，管理端是由 Saber 宿主发布的静态资源，模型服务与向量库通过连接配置接入，适配时按这三部分分别确认目标环境。
一、运行基线
BladeX-AI-Pro 2.0 使用 JDK 21、Spring Boot 4.1.1 和 Jackson 3，前端由 Saber 宿主装载 Saber-AI。运行环境需同时满足 Java 服务、静态资源发布和外部服务连接要求。
后端系统能力通过 blade-system-spi 获取。Boot 与 Cloud 形态分别绑定对应实现，AI 业务与引擎保持相同的系统契约。
二、适配范围
| 适配层次 | 主要工作 | 验证内容 |
|---|---|---|
| 处理器与操作系统 | 选择匹配目标架构的 JDK、容器基础镜像及本地工具 | 应用启动、文件读写、网络与进程调用 |
| Java 运行时 | 使用支持 JDK 21 的目标发行版，保留工程启动参数 | 自动装配、业务序列化、流式输出 |
| 关系数据库 | 适配驱动、建表与升级脚本、SQL 方言 | 初始化、资源管理、JSON 字段、分页与事务 |
| 缓存服务 | 核对客户端协议、认证与运行配置 | 登录会话、目录缓存及缓存失效 |
| 文件存储 | 对接部署环境的对象存储和资源访问地址 | 上传、下载、签名访问及分享页取件 |
| 模型与向量服务 | 配置服务地址、认证、模型用途和向量维度 | 推理、向量化、写入与召回 |
| 文档与媒体工具 | 安装目标架构的 ffmpeg、ffprobe 与中文字体 | 文档导出、视频合成与音频转码 |
后端 Dockerfile 默认基础镜像为 bladex/alpine-java:openjdk21_cn_slim；目标架构或操作系统没有对应镜像时，替换为目标环境可用的 JDK 21 基础镜像。
平台服务与模型推理可以部署在不同的计算节点。模型服务采用的加速卡、驱动和推理框架，由该服务的运行环境管理；平台按配置的服务协议调用。
三、数据库适配
当前版本以 MySQL 为交付基线：doc/sql 下的系统表、AI 业务表、初始化数据及升级脚本只提供 MySQL 版本。启动模块 blade-api 的 pom.xml 预置了达梦、人大金仓、崖山、PostgreSQL、Oracle 和 SQL Server 的 JDBC 驱动依赖，application.yml 保留了对应的驱动类配置，均默认注释。
切换到其他数据库时，启用对应驱动与连接配置，并将系统表、AI 业务表、初始化数据和升级脚本转换为目标数据库语法。业务代码中少量查询直接拼接 LIMIT、FOR UPDATE 子句，目标数据库不支持这些写法时需要一并调整。
智能问数连接的业务数据源与平台数据库分开配置，可选 MySQL、PostgreSQL、Oracle、SQL Server、MariaDB 与达梦等类型；所选类型的 JDBC 驱动需包含在 blade-api 的依赖中。
重点核对主键与大整数、布尔及状态字段、JSON 存储、时间类型、索引、分页和关键字。完成脚本转换后，使用模型、知识库、应用及运行记录等真实业务验证读写与事务行为。
适配交付
适配完成以业务数据读写和执行链路验证通过为准。交付记录包含数据库版本、驱动版本、脚本版本及验证范围。
四、实施顺序
- 确认处理器、操作系统、JDK 与基础服务组合，准备对应的运行镜像或安装包。
- 完成数据库与缓存连接，导入目标数据库脚本，启动后端服务。
- 部署 Saber 宿主和 AI 远端，核对登录、菜单、权限与主题装载。
- 接入对话模型、向量模型与向量库，验证应用执行、资料摄取、知识问答和运行记录。
- 按启用的业务检查文档处理、中文字体、作品分享和导出。