中国 帮助

快速开始:把 Wujies 无界平台跑起来

这一页只解决一件事:在开发机上从空库走到「装上第一个应用」,把数据库、后端宿主、插件运行时、前端、迁移与菜单这条链路走通。 读完之后你能回答下面这些问题: 问题 本文位置 权威依据 三个仓库各是什么,wujies

快速开始:把 Wujies 无界平台跑起来
封面

> 本文整理自平台文档 docs/wujies/1.x/guide/quickstart.mdx,用于站点内容演示。

(https://console.wujies.cn/remote-apps/cms-assets/doc-db6694dbfcf3-cover.svg)

这一页只解决一件事:在开发机上从空库走到「装上第一个应用」,把数据库、后端宿主、插件运行时、前端、迁移与菜单这条链路走通。

读完之后你能回答下面这些问题:

问题本文位置权威依据
三个仓库各是什么,wujies-admin 指的到底是哪一个§1wujies-platform/AGENTS.md §0
要导哪些 SQL、按什么顺序导§2script/sql/README.md、deploy/tools/build-1panel.ps1
怎么编译、怎么启动后端(并真的加载插件)§3–§4script/prune/start-host.ps1、wujies-admin/src/main/resources/application.yml
怎么起前端,它连的是哪个后端§5plus-ui/vite.config.ts、plus-ui/.env.development
怎么装一个应用,怎么判断它真的生效了§6–§7AGENTS.md §3.2、§3.4
怎么跑测试§8根 pom.xml

本页不讲:怎么写一个应用(见 [应用清单](/docs/wujies/1.x/plugin-dev/basics/manifest)、[必须遵守的不变量](/docs/wujies/1.x/plugin-dev/basics/invariants))、怎么打包上架(见 [发布应用包](/docs/wujies/1.x/package/publish))、生产部署(见 [在部署里使用应用](/docs/wujies/1.x/basics/using-apps)、[升级](/docs/wujies/1.x/deploy/upgrade))。

---

1. 先认清楚三个仓库

三个仓库没有共同的 git 根,各自提交、各自分支。

目录(相对工作区根)是什么怎么认出来
wujies-platform/后端(Java / Spring Boot)+ SQL 脚本有 pom.xml、wujies-admin/、script/sql/
wujies/wujies-plugins/应用本体(插件)+ 应用前端工程(pnpm workspace)+ 打包器有 package.ps1、wujies-<app>/、frontend/<app>-app/、keys/
plus-ui/宿主前端(Vue 3 / Vite)有 vite.config.ts、src/
写法实际指判据
wujies-platform/wujies-admin/后端启动模块,产物 wujies-admin/target/wujies-admin.jar有 pom.xml、src/main/、Dockerfile
工作区顶层的 wujies-admin/只有 app-market-dist/,前端产物的落位目录没有 package.json、没有 src/
plus-ui/宿主前端仓库;它的 package.json 里 name 就是 wujies-admin(混淆的根源)有 vite.config.ts、src/

### 后端模块地图

路径内容
wujies-admin/启动模块。PluginClassPathLoader 在这里,在 Spring 之前执行
wujies-common/基础设施:wujies-common-core、-web、-mybatis、-job、-plugin-sdk 等
wujies-modules/wujies-app-market/应用市场:目录、插件运行时、上架端、包安全
wujies-modules/wujies-system/用户 / 角色 / 菜单 / 租户等底座
wujies-modules/wujies-workflow/工作流
wujies-modules/wujies-plugin-probe/插件运行时探针
wujies-extend/独立服务:调度中心、监控中心

有三样东西不存在,别去找:

  • 平台里没有任何给应用准备的契约模块。wujies-modules/ 下只有上表那几个,平台对 cn.wujies.<app>.* 的 Java 引用数量是 0。契约随插件走。
  • 没有 wujies-job / wujies-generator / wujies-demo 模块(已删除)。定时任务随应用走,宿主只提供 wujies-common-job。
  • 平台仓库里没有 plugins/ 目录。插件本体在另一个仓库。

### 应用长什么样

每个应用是 wujies-plugins/wujies-<app>/ 下一个自包含工程,契约与实现同处一室:

wujies-plugins/wujies-gallery/
├── app.json                       清单:code / version / assets / menus
├── pom.xml                        平台依赖一律 provided
├── migrations/01-create-gallery-tables.sql
└── src/main/
    ├── java/cn/wujies/gallery/{domain,domain/bo,domain/vo,mapper,service,service/impl,controller,open,listener}
    └── resources/mapper/gallery/*.xml     ← Mapper XML 在插件里,随 jar 走
  • 实体 / BO / VO / Mapper 接口 / Mapper XML / Service 接口与实现 / controller / open / listener / task 全在插件模块自己的 src/ 下;
  • Mapper XML 由 PluginMapperRegistrar 在插件加载时动态注册进宿主的 SqlSessionFactory,不是靠宿主扫 mapperLocations;
  • 插件之间要对方的契约时,依赖兄弟插件构件(同样 provided)。

「契约单独放一个平台模块」「Mapper XML 必须留在平台侧」「靠宿主的 mapperLocations 扫插件里的 XML」都是 2026-09-30 之前的规则,已经不成立。看到这类描述(包括本站其它页面里的)以 AGENTS.md §2.2 为准。

应用有两种形态,都不奇怪:

形态判据例子
全栈应用有 app.json、pom.xml、后端 src/,也有 frontend/<app>-app/wujies-gallery、wujies-exam、wujies-mall
纯前端应用目录下只有 app.json,包里没有 jarwujies-finance

---

2. 建库:按这个顺序导 SQL

全新部署只认平台自己的初始化脚本。应用自己的表不在这里,它们随应用包走。

顺序文件内容
①wujies-platform/script/sql/platform_init.sql平台初始化:25 张 sys_* 表 + 地区 / 字典 / 参数 / 菜单 / 角色授权 / 租户 / 默认账号
②wujies-platform/script/sql/update/ 下的 7 个脚本(见下)应用市场的表结构
③wujies-platform/script/sql/app_catalog_seed.sql应用目录种子(app_info / app_version / app_category)。不导市场里什么都没有

第 ② 步的清单与顺序(不是"按文件名排序",是这份固定清单):

章节导览
THE END

喜欢就支持以下吧

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

回到内容