开发环境准备
大约 2 分钟快速开始开发指南
开发环境准备
本节适用于 BladeX-AI-Pro 2.0、Saber 5.0 和 Saber-AI 2.0。
开发环境
| 项目 | 要求或用途 |
|---|---|
| Java | JDK 21，与后端 POM 一致 |
| Maven | 解析根 POM、构建模块并访问已授权的私有依赖 |
| Node.js | ^22.18.0 或 >=24.12.0 |
| pnpm | 9 及以上（lockfile 格式 9.0），按各工程的 lockfile 安装 |
| MySQL | 保存系统与 AI 业务数据；当前 AI 新装脚本提供 MySQL 版本 |
| Redis | 会话、缓存等基础能力 |
| 文件存储 | 知识资料、创作素材与导出产物 |
| 向量库与向量模型 | 知识摄取与检索时配置 |
| ffmpeg / ffprobe | 按音视频处理需求配置 |
java -version
mvn --version
node --version
pnpm --version工程布局
本地联调建议保持以下同级关系，便于读取宿主兼容矩阵：
product/
├── BladeX-AI-Pro/
├── Saber/
├── Saber-AI/
└── Saber-Kit/宿主和 AI 工程从私有 npm registry 安装已发布的 @saber 包。日常产品开发无需同时修改或构建 Saber-Kit。
Maven 私服与 npm registry 的访问凭证写入个人配置。工程中的 .env.development.local 保存本机后端地址和 SM2 公钥；令牌、私钥和个人配置不进入代码仓库。
安装前端依赖
分别在 Saber 与 Saber-AI 中执行：
pnpm install --frozen-lockfile两工程的 @saber/micro、@saber/utils、@saber/components 均为 1.0.1。Vue 与 @vue/runtime-core 精确同版；共享依赖通过宿主兼容矩阵核对。
确认运行地址
| 服务 | 本地入口 |
|---|---|
| Saber 宿主 | http://localhost:1888/ |
| Saber-AI 开发外壳及开发态远端 | http://localhost:1881/ |
| 后端代理 | 两工程 VITE_APP_PROXY_TARGET 指向同一服务 |
已有服务时先复用，同一工程目录只运行一个 Vite 实例。会话 cookie 按主机名区分，同机共享会话时两个入口统一使用 localhost 访问，不与 127.0.0.1 混用。
Saber-AI 开发服务的对外地址由 VITE_APP_ORIGIN 指定，留空时为 http://localhost:1881。宿主页面在另一台机器上打开或经局域网地址打开时，在 Saber-AI 的 .env.development.local 中将其设为本机局域网地址，并同步宿主注册表中 ai 条目的入口，见 局域网与跨机器联调。
下一步：后端服务启动。