> 本文整理自平台文档 docs/wujies/1.x/guide/prerequisites.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-2e3cdc3ebadb-cover.svg)
这一页回答一个问题:在动手之前,机器上该有什么、路径该是什么。
它只列可以核对的既有事实,每条都给出源码或配置文件的位置;凡是我没有实际跑过验证的, 都会写明「未验证」。把它过一遍,[15 分钟跑起来](/docs/wujies/1.x/guide/quickstart) 里的命令才有可能一次跑通。
名词定义见 [核心概念](/docs/wujies/1.x/guide/concepts);这套结构为什么长这样见 [这个项目是什么](/docs/wujies/1.x/guide/introduction)。
一、先认清三个目录
后面所有路径都建立在这三行上:
| 目录 | 是什么 | 构建方式 |
|---|---|---|
wujies-platform/ | 后端宿主、平台初始化 SQL、部署物料 | Maven(Java 17) |
plus-ui/ | 宿主前端 | npm |
wujies/wujies-plugins/ | 插件本体 + 插件前端工程 | Maven + pnpm workspace |
三者没有共同的 git 根,各自分支、各自提交。改一个功能经常要两边都动。
这个名字在三处含义不同,历史上已经误导过两次排查。判据很简单:看有没有 pom.xml。
| 写法 | 实际指 | 判据 |
|---|---|---|
wujies-platform/wujies-admin/ | 后端启动模块 | 有 pom.xml、src/main;产物是 wujies-admin.jar |
工作区顶层的 wujies-admin/ | 前端产物的落位目录 | 里面只有 app-market-dist/,没有 package.json、没有 src/ |
plus-ui/ | 宿主前端仓库 | 有 vite.config.ts、src/;它的 package.json 里 name 恰好就是 wujies-admin |
所以:凡是指向 src/views/、src/plugins/、app-market-dist/ 的,都是前端 = plus-ui/; 凡是指向 src/main/resources/、wujies-admin.jar、-pl wujies-admin 的,都是后端。
二、工具链
| 项 | 要求 | 依据 |
|---|---|---|
| JDK | 17 或更高 | 根 wujies-platform/pom.xml 的 <java.version>17</java.version> 被 maven-compiler-plugin 用作 <release>;插件仓 wujies-plugins/pom.xml 同为 17;部署镜像也是 JDK 17 |
| Maven | 本机安装(版本下限仓库未约束,未验证) | 仓库里没有 Maven Wrapper(.mvn/、mvnw、mvnw.cmd 都不存在,已核对)。wujies-platform/AGENTS.md §0 给的是"本机没加 PATH 时"的两行写法 |
| Node.js | 20 或更高 | wujies/wujies-plugins/package.json 的 engines.node = >=20;plus-ui/package.json 是 >=18.18.0 —— 取更严的那个 |
| pnpm | 与 wujies-plugins/package.json 的 packageManager 一致(当前 pnpm@10.32.1) | 插件仓是 pnpm workspace(pnpm-workspace.yaml 只收 frontend/*-app) |
| npm | 用于 plus-ui/(该仓库走 package-lock.json,不是 pnpm) | plus-ui/package.json 的 engines.npm = >=8.9.0 |
插件对平台构件(cn.wujies:*:${platform.version})的依赖全是 provided —— 运行期由宿主提供, 但编译期仍要能解析到。所以第一次上手必须先在平台仓装一遍:
mvn -B install -DskipTests # 工作目录:wujies-platform/
wujies-plugins/pom.xml 的 <platform.version> 当前是 5.6.2,与平台根 pom 的 <revision> 一致; 平台升版时改的就是这一行。
### 关键依赖版本(来自 wujies-platform/pom.xml)
| 依赖 | 版本 |
|---|---|
| Spring Boot | 3.5.15 |
| MyBatis-Plus | 3.5.16 |
| Sa-Token | 1.45.0 |
| Redisson | 3.52.0 |
| dynamic-datasource | 4.3.1 |
| SnailJob | 1.10.0 |
| warm-flow(工作流) | 1.8.5 |
| springdoc | 2.8.17 |
| FastExcel | 1.3.0 |
| Hutool | 5.8.43 |
Web 容器是 Undertow:wujies-common-web/pom.xml 排除了 spring-boot-starter-tomcat, 改引 spring-boot-starter-undertow。
### 宿主前端(plus-ui/)关键版本
| 依赖 | 版本 |
|---|---|
| Vue | 3.5.13 |
| Vite | 6.3.2 |
| Vue Router | 4.5.0 |
| Pinia | 3.0.2 |
| Element Plus | ^2.11.8 |
| TypeScript | ~5.8.3 |
| UnoCSS | 66.5.2 |
| Vitest | 3.1.2 |
目标浏览器见 plus-ui/package.json 的 browserslist:Chrome ≥ 87 / Edge ≥ 88 / Safari ≥ 14 / Firefox ≥ 78。
三、中间件
| 中间件 | 要求 | 依据 |
|---|---|---|
| MySQL | 8.0 以上;不支持 MariaDB | 平台初始化 SQL 通篇 utf8mb4_0900_ai_ci,MariaDB 没有这个排序规则(见 wujies-platform/docs/1panel/1Panel部署与上架.md)。驱动是 com.mysql.cj.jdbc.Driver;只装了 mysql-connector-j,其它数据库的驱动在 wujies-admin/pom.xml 里是注释掉的 |
| Redis | 客户端是 Redisson 3.52.0;最低版本仓库未约束(未验证) | application-dev.yml 的 spring.data.redis 段 |
| RabbitMQ | 平台消息 / 延时队列用到 | application-dev.yml 的 spring.rabbitmq 段。哪些功能强依赖它,我没有逐个验证(未验证) |
| SnailJob 调度中心 | 可选。它是一个独立服务 + 自己的库 | 表与账号在 wujies-platform/script/sql/ry_job.sql;宿主侧开关是 snail-job.enabled |
插件仓里有一个 sandbox 模块(wujies-plugins/pom.xml 的 <module>sandbox</module>, 注释写明"开发工具,不进任何应用包"):它用 H2 内存库替代 MySQL,不装配 Redis / RabbitMQ, 端口 18080(sandbox/src/main/resources/application.yml)。 用法见 [本地联调](/docs/wujies/1.x/plugin-dev/backend/local-dev);沙箱的具体行为我没有实测(未验证)。
四、端口
| 端口 | 用途 | 出处 |
|---|---|---|
| 8086 | 后端宿主(server.port,context-path 为 /) | wujies-admin/src/main/resources/application.yml |
| 80 | 宿主前端 dev server(VITE_APP_PORT) | plus-ui/.env.development,由 plus-ui/vite.config.ts 读取 |
| 9090 | 监控中心(spring.boot.admin.client.url);dev profile 里 enabled: false | application-dev.yml |
| 17888 | SnailJob 调度中心服务端端口 | application-dev.yml 的 `snail-jo |
本文导览
(https://console.wujies.cn/remote-apps/cms-assets/doc-2e3cdc3ebadb-guide.svg)


评论区需要浏览器启用 JavaScript 才能加载。