# SoybeanAdmin v3.0 计划 ## 核心差异 ### 1. UI 组件库 - **v2**: NaiveUI, Element Plus, Ant Design Vue独立仓库 - **v3**: 核心 UI 使用 [`@soybeanjs/ui`](https://ui.soybeanjs.cn/),并通过 **UI 适配层**支持接入 `naive-ui` / `element-plus` / `antdv-next` ### 2. 路由与页面缓存内核 - **v2**: `@elegant-router/vue` - **v3**: `ubean/client`(从 [ubean](https://github.com/soybeanjs/ubean) 提取的纯客户端内核,核心为 `@ubean/vue`),单实现、零双份维护;不再依赖 elegant-router ### 3. 构建工具 - **v2**: 裸 Vite + 自定义脚本 - **v3**: `vite-plus`(统一 dev / build / fmt / lint / test 入口) ### 4. 数据与接口 - **v2**: ApiFox 在线 Mock - **v3**: 纯前端版本使用[msw-openapi](https://github.com/christoph-fricke/openapi-msw)或者 [**Prism Mock**](https://github.com/stoplightio/prism)(基于 `openapi.json`),[ubean](https://github.com/soybeanjs/ubean)集成模式在 `src/routes/` 直接编写内置接口 ### 5. 后端对接 - **v2**: mock 数据 - **v3**: 对接真实后端(OpenAPI 类型生成 + [`@soybeanjs/fetch`](https://github.com/soybeanjs/fetch)),无内置 Mock ### 6. 路由模式与页面目录 - **v2**: 仅 `file` 模式,`src/views/` - **v3**: `virtual` / `file` / `both` 三种模式,`src/pages/`,布局自动扫描 `src/layouts/`,自动检测 `404/loading/error.vue`, 约定式"xx.reuse.ts"复用路由 ### 7. 页面缓存与宏 - **v2**: 组件 name 注入 + 自定义 tab store - **v3**: `definePage({ name, path, layout, cache, meta, head })` + `useCacheViews` / `resetRouteCache` / `getNamedPageWrapper` ### 8. **全栈框架集成(新增)** - **v2**: 无 - **v3**: 可选集成[ubean](https://github.com/soybeanjs/ubean) 元框架,获得 SSR / 文件式 API 路由 / 全栈能力(独立 SPA ↔ ubean 全栈可切换,共用同一路由内核) ### 9. 生态内部包 - **v2**: 6 个 `@sa/*` 包 - **v3**: 极简,复用 `@soybeanjs/*` + `@ubean/*` ### 10. 工程化 - **v2**: 自定义脚本 - **v3**: vite-plus 统一入口,`@soybeanjs/cli` 提交,引入 Vitest 单测 + Playwright E2E + GitHub Actions CI 详细方案见 [v3方案](https://github.com/soybeanjs/soybean-admin/blob/main/docs/v3.md)
Activity
LiMao00 commentedon Sep 8, 2026
apifox 改为 Prism Mock 是基于什么考虑?
honghuangdc commentedon Sep 8, 2026
新版的接口会生成标准的openapi.json,纯前端版本直接使用基于openapi.json启动模拟接口的工具
editorBetter commentedon Sep 8, 2026
3.0 预计什么时候发布呢
luzhe0359 commentedon Sep 20, 2026
期待😄
docs(projects): rebrand SoybeanUI to VeanUI and add v3.0 roadmap notes
FangDingli commentedon Oct 11, 2026
V3 的 Ant Design 侧适配器,是对接
ant-design-vue还是antdv-next?v3方案 里写的是 ant-design-vue 但是本 issue 里写的是antdv-next。honghuangdc commentedon Oct 11, 2026
两个都实现
FangDingli commentedon Oct 11, 2026
🫡 收到,目前本地确实魔改了一份 AntdvNext 版,体验还不错,期待。
drag0n-app commentedon Oct 17, 2026
请问有发布时间规划吗?
honghuangdc commentedon Oct 17, 2026
已经在开发中了,还需要段时间完善细节,文档等
honghuangdc commentedon Oct 17, 2026
时间估计还需要两周才能发布预览版本
drag0n-app commentedon Oct 17, 2026
辛苦了,两周等得及,想在新项目试试