> 本文整理自平台文档 docs/wujies/1.x/design/repo-layout.mdx,用于站点内容演示。
(https://console.wujies.cn/remote-apps/cms-assets/doc-9031c75f92af-cover.svg)
这一页回答"哪个文件该放哪"。三块代码分属三个 git 仓库(没有共同根,各自提交), 所以目录结构本身就是一条约定:先看它属于哪个仓库,再决定改哪里。
> 本章节其它页面讲"为什么这么设计";这一页只讲"东西在哪"。 > 目录是照着实际文件系统读出来的(2026-10 工作区),不是凭记忆写的 —— > 结构变了请重读一遍再改这一页。
三个仓库
| 仓库 | 内容 | 默认分支 |
|---|---|---|
wujies-platform | 后端(Java / Spring Boot)+ 平台 SQL 脚本 | feature/app-market |
wujies/wujies-plugins | 插件本体 + 插件前端工程(pnpm workspace)+ 打包器 + 文档 | master |
plus-ui | 宿主前端(Vue 3 / Vite) | feature/app-market |
三者没有共同 git 根:改一个功能经常要跨仓库提交两到三次。
---
一、wujies-platform/ —— 后端
反应堆根 pom.xml 的 <modules> 只有 4 个聚合模块: wujies-admin、wujies-common、wujies-extend、wujies-modules。
wujies-platform/
├── pom.xml 反应堆根:<modules> 只列上面 4 个聚合模块
├── AGENTS.md ★ 改代码前扫一遍的"不变量与已知坑"清单(权威,优先级最高)
├── wujies-admin/ 后端启动模块(Java)。产物 wujies-admin.jar
│ ├── Dockerfile
│ └── src/ PluginClassPathLoader 在这里(Spring 之前执行)
├── wujies-common/ 基础设施,27 个子模块(见下)
├── wujies-extend/ 旁挂服务,独立进程
│ ├── wujies-monitor-admin/ 监控端
│ └── wujies-snailjob-server/ 定时任务调度服务端
├── wujies-modules/ 业务模块,只剩 4 个
│ ├── wujies-app-market/ ★ 应用市场:目录 + 安装编排 + 插件运行时 + 包安全
│ ├── wujies-system/ 系统管理(用户 / 部门 / 角色 / 菜单 / 字典 / OSS / 消息)
│ ├── wujies-workflow/ 工作流
│ └── wujies-plugin-probe/ 插件运行时探针
├── script/ 运维与数据脚本
│ ├── sql/ 平台建表脚本 + 增量脚本
│ ├── prune/ 启动前清理插件 jar(prune-plugins.ps1 / start-host.ps1)
│ ├── docker/ · bin/ · leave/
├── deploy/ 部署物料与工具
│ ├── 1panel/ 1Panel 应用包定义
│ ├── docker/ · dist/
│ └── tools/ 种子 SQL / 迁移拆分等生成器(Node 脚本)
├── plugins-dist/ ★ 插件 jar 的落位目录(loader.path 指向它,只读根下、不递归)
│ ├── active-plugins.txt 本机启用清单:不在清单里的 jar 不挂载
│ ├── wujies-<app>-plugin-<版本>.jar
│ └── migrations/<appCode>/ 随包迁移脚本(子目录,刻意不会被当插件加载)
├── dist-packages/ ⚠️ **历史**产物目录(打包器早已不再往这里写,见插件仓库那棵树)
├── docs/ 平台侧文档与 SQL 片段
└── logs/ 运行日志
### wujies-common/ 的 27 个子模块
wujies-common/
├── wujies-common-bom/ BOM:统一版本,供插件 POM 导入
├── wujies-common-core/ ★ 平台核心。PluginServiceProvider / MenuOwnershipProvider
│ (宿主反查插件与菜单归属的 SPI 契约放这里)
├── wujies-common-web/ GlobalExceptionHandler(异常 → 前端的唯一出口)
├── wujies-common-plugin-sdk/ ★ 插件扩展点契约(FollowRelationApi / Platform*Api …)
├── wujies-common-mybatis/ MyBatis-Plus 集成(BaseMapperPlus 等)
├── wujies-common-tenant/ 多租户
├── wujies-common-satoken/ Sa-Token 鉴权集成
├── wujies-common-security/ 安全配置(security.excludes 白名单等)
├── wujies-common-redis/ Redis
├── wujies-common-oss/ 对象存储
├── wujies-common-job/ 定时任务宿主侧支持(任务实现随应用走)
├── wujies-common-sms/ 短信
├── wujies-common-mail/ 邮件
├── wujies-common-social/ 社会化登录
├── wujies-common-sse/ SSE 推送
├── wujies-common-websocket/ WebSocket
├── wujies-common-rabbitmq/ RabbitMQ(队列 / 交换机 / 绑定要在宿主声明)
├── wujies-common-ratelimiter/ 限流
├── wujies-common-idempotent/ 幂等
├── wujies-common-log/ 操作日志
├── wujies-common-excel/ Excel 导入导出
├── wujies-common-json/ JSON 序列化
├── wujies-common-encrypt/ 字段加解密
├── wujies-common-sensitive/ 数据脱敏
├── wujies-common-translation/ 字段翻译
├── wujies-common-phone-verify/ 手机号校验
└── wujies-common-doc/ 接口文档
> ⚠️ 这里没有 *-api 契约模块(2026-09-30 起数量为 0):契约随插件走, > 见 [必须遵守的不变量](/docs/wujies/1.x/plugin-dev/basics/invariants)。
---
二、wujies/wujies-plugins/ —— 插件仓库
pnpm workspace 根(package.json 的 name 是 wujies-plugins-workspace)。 注意它同时在工作区的子目录 wujies/ 下,不是工作区顶层。


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