部署前置条件

必需依赖

• JDK、Maven 和 Docker/Compose（开发构建）。
• MySQL、Redis、Nacos；按启用能力准备 MinIO/OSS、Milvus、Elasticsearch、Neo4j 和 RocketMQ。
• 可访问的 LLM/Embedding 供应商，或已注册的内部模型服务。
• 为会话账本、上传临时文件、对象存储和数据库准备持久化卷。

上线前检查

确认 DNS/证书、网络白名单、Nacos 命名空间、数据库账号最小权限、时区、文件大小限制、消息 Topic 和备份策略。生产密钥通过 Secret 或环境变量注入。

按能力准备依赖

能力	必需依赖	验收方式
登录与管理	MySQL、Redis、Nacos、Auth、UPMS	登录、刷新、租户切换
AI 对话	ChatModel provider、Gateway、SSE	普通和异步 SSE
RAG	Embedding provider、Milvus/ES、Dataset	向量化后检索并返回引用
文件与沙箱	对象存储/本地或 SFTP/SMB、Sandbox	分片上传、挂载、Artifact
MCP/工具	Nacos MCP、Feign 下游、密钥	tools/list 和受控工具调用
异步业务	RocketMQ/Redis、Topic、消费者	重试、幂等、死信

JDK/Maven 版本要与根 POM 对齐；当前根工程使用 Java 21、Spring Boot 3.4.5、Spring Cloud 2024.0.0。还要准备 JSONL 会话目录、上传临时目录、对象存储 bucket、备份空间和证书续期方案。