01
操作系统
应用基于 Java 构建，天生跨平台；已完成麒麟 V11 与 V10 两个版本的部署验证，其他国产操作系统同样可以兼容运行。
麒麟 Kylin V11 与 V10 已实测验证
兼容 openEuler 系及其他国产 Linux
统一交付物，无需按系统版本分别适配
Adaptation Scope
从操作系统、处理器架构到数据库、中间件、向量检索与模型运行时，平台按统一契约适配信创技术栈，业务功能与通用环境保持一致。
02
处理器架构
平台同时支持 ARM64 与 x86_64 两大处理器架构，覆盖主流国产服务器与通用 x86 服务器平台。
ARM64（鲲鹏、飞腾等国产平台）支持
x86_64（Intel、AMD、海光等）支持
一套构建产物，双架构均可部署
03
数据库与检索
业务数据、缓存与向量检索分层选型，支持国产数据库作为数据分析数据源。
MySQL 8 业务库 + Redis 7 缓存
PostgreSQL 16 + pgvector 向量检索
智能问数直连多款国产数据库
04
中间件与模型运行时
基础中间件优先使用国产系统官方源，本地大模型通过统一协议接入。
JDK 17、Nginx 使用系统官方源
Ollama / vLLM / Xinference 接入
OpenAI 兼容协议统一管理
OpenSandbox Server 0.2.3 扩展执行环境
05
扩展执行环境
代码执行、技能运行与沙箱工作区由 OpenSandbox 承载，是平台运行环境的组成部分，部署依赖容器运行时。
OpenSandbox Server 0.2.3 容器化运行时
依赖 Docker 24+ 环境
承载代码执行、技能与沙箱工作区
06
文档解析与可选依赖
文档解析默认由内置引擎完成，可按内容复杂度与部署形态选配高级解析、存储与向量组件。
内置解析引擎，开箱可用
Docling / MinerU 高级解析可选
对象存储与向量库替代方案可选
Verified Environment
以下环境与结果来自麒麟操作系统上的真实部署验证。验证采用的 8 核 / 16 GB 规格即为运行平台全部功能的最低推荐配置；平台资源占用极低，全栈常驻内存仅约 700 MB，该规格下可流畅运行。
验证环境
操作系统麒麟 Kylin V11 / V10（ARM64，兼容 x86_64）
验证规格8 vCPU / 16 GB 内存 / 100 GB 磁盘（最低推荐配置）
JDKOpenJDK 17.0.18（毕昇 BiSheng 发行版）
MySQL8.0.46
Redis7.2.11
PostgreSQL16.15 + pgvector 0.8.0
Nginx1.24.0（前端静态服务与反向代理）
部署形态前后端分离（Nginx + Java 服务）
资源占用平台全栈常驻内存约 700 MB，轻量高效
验证结果
服务启动： 5/5 服务开机自启正常
前端访问： HTTP 200
接口连通： HTTP 401（未登录，符合预期）
数据库结构： 业务库结构导入成功，业务功能运行正常
向量检索： pgvector 0.8.0 启用，距离查询排序正确
本地模型： 0.5B 指令模型对话与兼容接口返回正常
扩展组件与运行时
以下组件承载代码执行、文档解析与存储等扩展能力，按部署形态与场景单独启用；基础能力不依赖它们即可运行。
OpenSandbox Server 0.2.3
必要代码执行、技能运行、Office 内容生成与沙箱工作区的运行时，部署需 Docker 24+。
Docling
可选高级文档解析，支持表格、公式、代码、OCR 与版面分析。
MinerU
可选复杂 PDF 与图文混排文档的高级解析。
对象存储
可选RustFS / S3 兼容 / OSS / COS，替代本地文件存储，支持多节点共享与 CDN。
Milvus / Elasticsearch
可选向量存储的可选替代，按规模与检索模式选择。
Ollama / vLLM / Xinference
可选本地模型推理与向量化运行时，用于私有化部署大模型。
验证覆盖登录、聊天、智能体等基础功能。代码执行、技能运行与沙箱工作区由 OpenSandbox 承载，需在具备 Docker 24+ 运行时的节点上部署后启用；文档解析默认使用内置引擎，Docling、MinerU、对象存储与向量库替代方案按场景选配。
Live Deployment
以下截图均来自麒麟操作系统上的实际部署：从系统信息、中间件版本，到平台登录、首页访问与模型配置，全部在麒麟桌面环境中实机完成。
麒麟系统信息
Kylin Linux Advanced Server V11 与 UKUI 桌面环境
中间件版本
JDK 17（毕昇发行版）、MySQL 8.0.46、Redis 7.2.11
平台登录
麒麟桌面浏览器访问平台登录页
应用广场
平台首页在麒麟环境中正常渲染
模型管理
模型供应商配置页面正常访问
Version Matrix
以下版本要求为平台 2026.1 的正式约定，验证列是麒麟 ARM64 参考环境中实际使用的版本；标记「按需部署」的组件不在基础参考环境内，按场景单独部署。
| 级别 | 组件 | 版本要求 | 验证版本 | 说明 |
|---|---|---|---|---|
| 必要 | JDK | 17 及以上（不低于 17） | OpenJDK 17.0.18（毕昇 BiSheng 发行版） | 应用框架要求 17 及以上，JDK 21 亦可使用；国产发行版与 OpenJDK 兼容 |
| 必要 | MySQL | 8.0+（不可 5.7） | 8.0.46 ARM64 | 初始化结构依赖 MySQL 8 专有排序规则，不可用 MariaDB 替代 |
| 必要 | Redis | 7+（建议 7.2） | 7.2.11 | 缓存、会话、分布式锁与任务队列，6.x 不支持 |
| 必要 | Nginx | 任意稳定版 | 1.24.0 | 前端静态服务与后端反向代理 |
| 必要 | Docker | 24+ | 按需部署 | OpenSandbox 的容器运行时前提，随沙箱能力一并部署 |
| 必要 | OpenSandbox | 0.2.3 | 按需部署 | 代码执行、技能运行、Office 内容生成与沙箱工作区 |
| 可选 | PostgreSQL | 16 / 17 | 16.15 | 知识库向量检索的宿主机数据库；仅使用全文检索时可不部署 |
| 可选 | pgvector | 0.8.0+ | 0.8.0 | 提供向量类型与相似度索引，随 PostgreSQL 部署 |
| 可选 | Docling | 容器化部署 | 按需部署 | 高级文档解析：表格、公式、代码、OCR 与版面分析 |
| 可选 | MinerU | 容器化部署 | 按需部署 | 复杂 PDF 与图文混排文档的高级解析 |
部分国产系统的官方源缺少 MySQL Server 或高版本 PostgreSQL，实施时使用对应软件的官方 ARM64 发行包或源码编译，不改变平台的版本要求。文档解析默认由内置引擎完成，部署 Docling 或 MinerU 后可按需切换为高级解析。
Domestic Databases
智能问数可直接连接国产数据库作为数据源，平台按方言自动生成查询语句，无需改变业务使用方式。
达梦 DM8
国产关系型数据库，支持标准查询与注释语法
人大金仓 KingbaseES
兼容 PostgreSQL 语法，适配常规分析查询
神通 Oscar
国产关系型数据库，支持智能问数直连
虚谷 XuGu
国产关系型数据库，支持智能问数直连
南大通用 GBase
含 GBase 与 GBase 8s 两种方言
openGauss
开源数据库，兼容 PostgreSQL 语法族
华为 GaussDB
国产分布式数据库，支持分析查询
瀚高 HighGo
国产 PostgreSQL 系数据库
向量检索组件
PostgreSQL + pgvectorMilvusElasticsearch
国产数据库用于连接与分析企业既有数据；平台自身的业务数据与向量数据分别由 MySQL 8 与 PostgreSQL + pgvector 承载。
Hardware & Environment
平台资源占用极低，8 核 / 16 GB 的最低推荐配置即可流畅运行全部功能；生产环境请按并发规模与模型部署方式适当提升配置。
| 项目 | 推荐配置 | 说明 |
|---|---|---|
| 处理器 | 8 vCPU 及以上 | ARM64 与 x86_64 均可；生产环境按并发规模建议 16 核以上 |
| 内存 | 16 GB（最低推荐） | 平台全栈常驻内存约 700 MB，占用极低；生产环境建议 16–32 GB 或更高 |
| 磁盘 | 100 GB SSD | 生产环境建议 200 GB 以上；本地部署大模型需额外预留模型文件空间 |
| 操作系统 | 麒麟 Kylin V11 / V10 | 兼容 openEuler 系及其他国产 Linux 发行版 |
| 网络 | 内网静态地址 | 端口按需放行，建议不直接暴露公网 |
生产环境建议配置不低于 16 GB 内存；若需在同一节点本地运行大模型推理（如 vLLM），建议提升到 32 GB 以上或采用独立 GPU 节点。平台本身对资源要求极低，低配环境亦可完成功能验证。
Environment Components
平台按「必要环境先就位、可选环境按需启用」组织部署。必要环境缺失会影响平台运行；可选环境只影响对应的专项能力，按实际场景启用即可。
必要环境
平台运行的基础依赖，部署时必须就位。
JDK 17
应用运行时，Spring Boot 3.5 强制要求 Java 17；麒麟官方源提供 OpenJDK 17。
MySQL 8.0+
业务数据库，保存会话、消息、应用与权限等业务事实。
Redis 7+
缓存、会话、分布式锁与任务队列。
Nginx
前端静态服务与后端接口反向代理。
文件存储
文件上传、附件与知识库源文档的落盘位置，使用本地磁盘或对象存储承载。
OpenSandbox Server 0.2.3
代码执行、技能运行、Office 内容生成与沙箱工作区，依赖 Docker 24+ 运行时。
可选环境
按实际场景启用，不部署不影响平台的基础能力。
PostgreSQL 16/17 + pgvector 0.8.0+
知识库语义检索；只使用全文检索时可不部署。
Docling
高级文档解析，支持表格、公式、代码、OCR 与版面分析。
MinerU
复杂 PDF 与图文混排文档的高级解析。
Milvus / Elasticsearch
向量存储的可选替代，按规模与检索模式选择。
对象存储（RustFS / S3 兼容 / OSS / COS）
替代本地文件存储，支持多节点共享与 CDN 加速。
Ollama / vLLM / Xinference
私有化模型推理与向量化运行时，用于本地部署大模型。
必要环境为平台运行的最低集合；OpenSandbox 承载代码执行、技能与工作区能力，是平台运行环境的组成部分。可选环境按场景启用，缺失时对应能力不可用，但不影响登录、对话与智能体等基础功能。
Private Model Deployment
平台支持在信创环境中私有化运行推理模型与向量模型，数据全程留在内网，模型通过统一协议接入平台。
推理模型
负责对话、推理与工具调用，是智能体的核心。
Ollama
原生支持 ARM64，量化部署内存占用低，无 GPU 环境首选
vLLM
面向高并发生产，建议配备 GPU；CPU 模式需 8 GB 以上内存
Xinference
统一管理推理与向量模型，内置模型市场
向量模型
把文本转换为向量，是知识库语义检索的基础。
Ollama 嵌入模型
支持 nomic-embed-text（768 维）、bge-m3（1024 维）
Xinference
支持 bge 系列、m3e、gte 等嵌入模型
TEI / Infinity
专用向量服务，面向大规模向量化场景
部署规范要求
01模型私有化运行，推理与向量化过程不在内网之外传输数据。
02统一以 OpenAI 兼容协议接入；Ollama 等原生协议由平台适配器转换。
03向量维度三处必须一致：嵌入模型输出维度、向量库配置维度、向量表列定义（默认 1024）。
04无 GPU 的国产硬件优先采用量化推理，并使用 0.5B 级指令模型完成验证与轻量场景。
05模型服务与平台服务建议分机部署，避免推理峰值与业务进程争抢内存。
维度一致性
知识库检索最常见的故障源于向量维度不一致。更换嵌入模型后，必须同步更新向量库配置并重建向量表。