RuoYi-FastAPI v2.0.0

项目依赖

1. 升级后端、AI SDK 及六个前端工程的依赖，保留 Python 3.10 兼容性，请升级依赖或重新创建环境 (#133)。
2. 前端工程及插件示例统一使用 pnpm 11.28.6，提交锁文件，并同步调整 Docker、CLI、插件依赖安装和 CI 流程；Node.js 环境要求为 22.22.2+ 或 24.15.0+ (#133)。
3. Vue3、React Web 升级至 Vite 8，移动端升级至 Tailwind CSS 4 和 weapp-tailwindcss 5，Vue2、Vue3 AI 聊天组件适配 Markstream 2 (#133)。

升级注意事项

1. 前端目录统一为 ruoyi-fastapi-frontend/<framework>/{web,mobile}，其中 <framework> 为 vue2、vue3 或 react。已有开发、构建和部署脚本需同步调整路径及框架配置 (#131、#132)。
2. 数据库配置改为通过 DB_SOURCES 声明命名数据源，并使用 DB_DEFAULT_SOURCE 指定默认数据源。升级时需迁移原有数据库环境变量配置 (#123)。
3. 真实时刻统一采用 UTC 存储与 RFC 3339 接口格式，定时任务参数改为 JSON 数组和对象。已有数据库需备份并审查结构及数据迁移，任务字段迁移和时区校验分别参考 ruoyi-fastapi-backend/scripts/migrate_job_fields.py、ruoyi-fastapi-backend/scripts/verify_timezone_database.py (#127)。
4. 插件前端依赖需迁移到 dependencies.frontend.<framework>，旧顶层 dependencies.npm/npmDev 不再接受；框架选择统一使用 --frontend-framework 及对应环境变量，包含旧框架字段的依赖锁文件需重新生成。详见插件开发文档 (#131)。
5. 统一认证中心、任务调度和插件制品发布新增了数据库结构及配置。已有数据库应审查并执行增量迁移，勿直接重跑完整初始化 SQL；认证中心启用与密钥初始化参考统一认证中心开发者使用手册，插件发布结构升级参考插件开发文档 (#127、#129、#130)。

新增功能

1. 新增多数据源功能，支持命名数据源、独立连接池与会话管理，代码生成支持选择数据源 (#123)。
2. 新增跨时区支持，提供应用业务时区配置和用户显示时区设置，统一适配 Web、移动端的时间展示、日期筛选、导出及请求时区传递 (#127)。
3. 定时任务新增独立时区、Cron 执行预览、延迟与积压处理、并发策略，分离业务分组与调度存储 (#127)。
4. 新增任务调度同步状态和执行记录，支持手动执行追踪、同步重试、异常原因及任务删除后的记录查询 (#127)。
5. 新增 OAuth 2.0 / OIDC 统一认证中心，支持授权码与 PKCE S256、刷新令牌、客户端凭据模式，以及 Discovery、JWKS、UserInfo、令牌撤销和内省接口 (#129)。
6. 新增 SSO 会话、授权确认、密码修改和单点退出流程，支持应用发起退出与 Back-channel Logout，并提供客户端、资源、Scope、授权记录、访问策略、会话、签名密钥及认证审计管理 (#129)。
7. 新增 v2 插件清单与显式运行时，支持 Router、ASGI 子应用、Rust 原生扩展、生命周期、健康检查和后台任务，保留 v1 源码插件运行方式 (#130)。
8. 新增 PluginFrame 和浏览器桥接 SDK，支持独立前端 bundle、JSON 请求、文件传输、SSE 与 WebSocket；宿主 SDK 新增请求上下文、显式事务、配置读取及宿主服务调用能力 (#130)。
9. 新增签名插件制品构建、验签、导入及维护能力，支持发布准备、目标选择、代码回滚、签名轮换、固定目标发布等待和多 worker 实际加载状态查询 (#130)。
10. 新增插件脚手架、受控 Python 构建、SDK 溯源和离线更新工具，提供 ASGI、独立前端、持久化任务及 Rust 示例 (#130)。
11. 整合 Vue2 Web 和移动端，新增基于 React 19、Ant Design 6 的 Web 工程，以及基于 Taro、React 的移动端工程，共用 FastAPI 后端 (#131、#132)。
12. 新增 React 插件脚手架、JSX 页面校验、AI 插件页面和依赖配置，以及支持单表、树表、主子表的 React Ant Design 代码生成模板 (#132)。

BUG修复

1. 修复生产环境插件依赖安装、启动校验及多环境配置下 APP_ENV 加载异常的问题 (#122)。
2. 修复更新个人信息接口可能导致越权的问题，使用专用模型和字段白名单限制可修改内容 (#124)。
3. 修复多环境插件路径、后端部署前缀与代理配置不一致的问题，完善 WebSocket、SSE 和同源请求支持 (#130)。
4. 修复移动端已登录访问带查询参数的登录页时未正确拦截的问题 (#131)。
5. 修复用户编辑字段兼容、解锁跳转及认证错误页返回问题 (#132)。
6. 修复 Vue2 移动端开发模板编译报错、Tailwind 样式入口与基础样式覆盖问题，完善依赖升级后的构建、开发启动和热更新兼容性 (#133)。

代码重构

1. 统一项目名称为 RuoYi-FastAPI，整合多前端工程目录、仓库链接、SDK 来源记录及开发部署文档 (#131)。
2. 新增 SQLAlchemy 时间字段 Mixin，统一创建时间和更新时间的维护机制，移除控制器与服务层重复赋值，并同步适配代码生成模板 (#125)。
3. CI 按质量、后端、前端、服务集成、E2E 和原生插件六类组织，统一变更选路、兼容矩阵与 Result 检查 (#131)。

代码优化

1. 更新项目 Logo (1f24f34b)。
2. 优化多 worker 下的数据源日志输出，避免重复打印 (#123)。
3. 统一账户认证逻辑和客户端 IP 获取方式，完善回调地址校验、刷新令牌轮换与重放检测、令牌用途隔离、客户端密钥轮换及安全事件联动撤销 (#129)。
4. 完善插件配置生效状态、运行指标、发布状态和统一诊断展示，加强长连接鉴权复核、启动失败与关闭时的资源回收 (#130)。
5. 扩展跨框架、CLI 冷启动、移动端、组件、真实网络及数据库集成测试；前端 CI 覆盖 Node.js 22/24，后端、原生插件、完整集成及 E2E 覆盖 Python 3.10–3.14，完整 E2E 扩展至 30 个组合 (#131、#132、#133)。

Full Changelog: v1.10.0...v2.0.0

RuoYi-Vue3-FastAPI v1.10.0

项目依赖

前后端依赖均有升级，请升级依赖或重新创建环境。

新增功能

1. 新增ApiCache接口缓存装饰器和ApiCacheEvict接口缓存失效装饰器 (#97)。
2. 新增接口限流装饰器 (#99)。
3. 新增传输加密功能 (#100)。
4. 新增日志脱敏功能 (#101)。
5. 新增cli系统 (#103)。
6. 新增文件管理功能 (#111)。
7. 新增插件系统 (#112)。
8. 新增自动生成jwt密钥 (#116)。
9. 新增锁定屏幕功能 (#117)。
10. 字典类型列表新增抽屉效果详细信息 (#117)。
11. 添加持久化标签页开关功能 (#117)。
12. 支持表格列显隐状态记忆 (#117)。
13. 代码生成支持表单布局选项 (#117)。
14. 新增树分割组件TreePanel (#117)。
15. 新增Excel导入组件ExcelImportDialog (#117)。
16. 用户列表新增抽屉效果详细信息 (#117)。
17. 新增标签页样式chrome风格 (#117)。
18. 新增菜单路由地址和名称的校验规则 (#117)。
19. 首页新增通知公告消息提醒 (#117)。
20. 定时任务详情补充执行时间字段 (#117)。
21. 部门管理支持批量保存排序 (#117)。
22. 菜单管理支持批量保存排序 (#117)。
23. 菜单管理列表新增类型显示 (#117)。
24. 新增代码生成详情页功能 (#117)。
25. 通知公告新增详细显示 (#117)。
26. 通知公告新增阅读用户列表 (#117)。
27. 用户密码支持自定义配置规则 (#117)。

BUG修复

1. 修复日志输出格式问题 (#104)。
2. 修复文件服务安全性问题 (#111)。
3. 修复windows下应用启动日志异常的问题 (#113)。
4. 修复tui卡顿的问题 (#114)。
5. 修复E2E测试失败的问题 (#117)。

代码优化

1. 补充演示模式限制路由 (#115)。
2. 优化字典类型属性提醒说明 (#117)。
3. 优化顶部导航更多菜单路由截取 (#117)。
4. 优化RightToolbar搜索栏切换动画 (#117)。
5. 优化操作日志详细页面 (#117)。
6. 优化页签功能&支持全屏按钮操作 (#117)。
7. 优化tag全屏为页签内区域 (#117)。
8. 菜单搜索支持文本高亮&数量提示 (#117)。
9. 优化页签显示 (#117)。
10. 优化菜单主题风格 (#117)。
11. 黑暗模式下全屏不需要设置背景 (#117)。
12. 暗黑浅色主题优化 (#117)。
13. 优化快速点击页签刷新出现404问题 (#117)。
14. 代码生成修改拖拽时显示手指样式 (#117)。
15. 优化登录页暗黑模式下样式 (#117)。
16. 优化白名单支持对通配符路径匹配 (#117)。
17. 优化定时任务详情页展示 (#117)。
18. 优化点击任务名称查看详细 (#117)。
19. 更换router4过期方法next (#117)。
20. 优化暗黑模式下主题样式 (#117)。
21. 优化暗黑模式详情样式 (#117)。
22. 优化jwt解析异常处理机制 (#118)。

Full Changelog: v1.9.0...v1.10.0

RuoYi-Vue3-FastAPI v1.9.0

项目依赖

前后端依赖均有升级，请升级依赖或重新创建环境。

新增功能

1.新增AI管理模块 (#69)。
2.新增移动端模块 (#73)。
3.新增多worker运行支持 (#76)。
4.应用新增演示模式 (#78)。

BUG修复

1.修复代码生成controller模板删除接口query_db参数异常的问题 (#63)。
2.修复登录接口response_model声明错误 (#71)。
3.修复无法直接通过后端地址访问API文档的问题 (#74)。
4.修复create_app重复执行的问题 (#84)。

代码重构

1.移除对python3.9的支持 (#67)。

代码优化

1.优化alembic处理表模型逻辑，避免无关表影响 (#68)。
2.优化代码生成后端模板 (#72)。
3.自动注册路由出错时抛出异常以便于调试 (#79)。
4.优化部分页面字段tooltip说明 (#80)。
5.优化项目启动速度 (#82)。
6.优化暗黑模式切换效果 (#83)。
7.优化热重载模式或单worker下scheduler的任务状态同步机制 (#85)。
8.优化防重提交间隔时间可自定义 (#87)。
9.优化验证码计算结果为非负数 (#88)。
10.优化ci测试稳定性 (#90)。

Full Changelog: v1.8.1...v1.9.0

RuoYi-Vue3-FastAPI v1.8.1

新增功能

1.新增E2E测试 (#57)。

BUG修复

1.修复DictTag组件渲染异常的问题 (#59)。

代码优化

1.优化数据权限依赖 (#55)。
2.动态导入定时任务函数，移除eval (#56)。
3.优化pg版本的docker compose配置文件 (#61)。

Full Changelog: v1.8.0...v1.8.1

RuoYi-Vue3-FastAPI v1.8.0

项目依赖

后端

1.后端依赖升级到最新版本，请升级依赖或重新创建环境。

新增功能

1.新增请求上下文管理类。
2.新增PreAuthDependency、CurrentUserDependency、DataScopeDependency、DBSessionDependency、UserInterfaceAuthDependency和RoleInterfaceAuthDependency依赖函数。
3.新增上下文清理中间件。
4.新增公共vo模块。
5.新增配置文档静态资源方法。
6.新增自动注册路由功能。
7.新增docker compose部署方式。
8.菜单导航设置支持纯顶部。

BUG修复

1.修复单账号登录模式下强退功能失效的问题 #52。
2.确保ApschedulerJobs字段类型与apscheduler默认创建的表字段类型一致 #53。
3.修复磁盘存在异常时服务监控无法正常运行的问题。
4.移除代码生成表业务表外键，修复无法删除的问题。
5.修复固定头部时出现的导航栏偏移问题。
6.修复表单构建移除所有控件后切换路由回来空白问题。
7.修复代码生成v3模板时间控件between选择后清空报错问题。

代码重构

1.增强ruff规则，完善类型提示。
2.优化项目结构，新增common模块，原annotation、aspect、constant、enums模块移动至common模块下。
3.重构app与server设计。

代码优化

1.controller层全部使用新依赖项。
2.当前用户信息使用上下文变量。
3.分页模型改为使用公共vo模块的PageModel。
4.优化API文档的响应模型显示。
5.操作响应模型改为使用公共vo模块的CrudResponseModel。
6.优化API文档的接口描述信息。
7.登录/注册页面底部版权信息修改为读取配置。
8.优化生成代码下载的zip文件名。
9.优化表单构建关闭页签销毁复制插件。
10.行内表单默认设置固定宽度。
11.优化操作日志详细请求参数显示。
12.优化index页面标题读取配置。
13.优化字典组件数字类型值处理逻辑。
14.优化字典组件值宽松匹配。
15.默认固定头部。

Full Changelog: v1.7.1...v1.8.0

RuoYi-Vue3-FastAPI v1.7.1

更新内容

项目依赖

1.后端依赖移除passlib，直接使用bcrypt。

BUG修复

1.修复代码生成controller模板编辑接口异常生成字段的问题。
2.移除passlib直接使用bcrypt修复密码校验异常的问题 #48 #49。

代码优化

1.代码生成do模板补充表描述。

Full Changelog: v1.7.0...v1.7.1

RuoYi-Vue3-FastAPI v1.7.0

更新内容

项目依赖

1.前后端依赖升级，请升级依赖或重新创建环境。

新增功能

1.新增alembic支持。
2.文件&图片上传组件支持自定义地址&参数。
3.新增默认打包配置项。
4.显隐列组件支持全选/全不选。
5.添加页签openPage支持传递参数。
6.外链加载时遮罩信息提示。
7.上传组件新增拖动排序属性。
8.图片上传组件新增disabled属性。
9.代码生成列支持拖动排序。
10.新增用户默认初始化密码。
11.新增页签图标显示开关功能。
12.新增底部版权信息及开关。
13.用户归属部门新增清除。
14.用户导入新增验证提示。
15.菜单搜索支持键盘选择&悬浮主题背景。
16.新增apscheduler_jobs表对应sqlalchemy模型类。
17.初始密码支持自定义修改策略。
18.账号密码支持自定义更新周期。
19.注册账号设置默认密码最后更新时间。
20.显示列信息支持对象格式。

BUG修复

1.修复logout接口未按照app_same_time_login配置项动态判断的问题。
2.修复上传组件被多次引用拖动仅对第一个有效的问题。

代码优化

1.优化接口耗时计算。
2.优化启动信息显示。
3.优化前端处理路由函数代码。
4.登录页和注册页表头使用VITE_APP_BASE_API配置值。
5.优化角色禁用不允许分配。
6.优化富文本控制台警告异常。
7.优化checkbox废弃API。
8.优化导航栏显示昵称&设置。

代码重构

1.重构IP归属区域查询为异步调用。
2.调整do与sql使其相互适配以支持alembic。
3.富文本复制粘贴图片上传至url。

Full Changelog: v1.6.2...v1.7.0

RuoYi-Vue3-FastAPI v1.6.2

更新内容

新增功能

1.文件上传组件新增disabled属性。
2.文件上传组件新增类型。

BUG修复

1.修复日志管理时间查询报错 #27。
2.修复定时任务状态暂停时执行单次任务会触发cron表达式的问题 #31。
3.修复修改字典类型时获取dict_code异常的问题。
4.修复修改字典类型时字典数据更新时间异常的问题。
5.修复代码生成模板时间查询问题 #28。
6.修复用户导出缺失部门名称的问题。

代码优化

1.优化代码生成新增和编辑字段显示和渲染。
2.pagination更换成flex布局。
3.优化代码生成vue模板 #23。

Full Changelog: v1.6.1...v1.6.2

RuoYi-Vue3-FastAPI v1.6.1

更新内容

项目依赖

后端

1.新增sqlglot依赖

pip install sqlglot[rs]==26.6.0 -i https://pypi.tuna.tsinghua.edu.cn/simple

BUG修复

1.引入sqlglot修复sql语句解析异常的问题。
2.修复代码生成字段唯一性校验dao层模板判断异常的问题。
3.引入泛型修复as_query和as_form装饰模型文档丢失的问题。
4.修复代码生成主子表vo模板可能缺失NotBlank的问题。

Full Changelog: v1.6.0...v1.6.1

RuoYi-Vue3-FastAPI v1.6.0

更新内容

项目依赖

1.后端依赖升级到最新版本，请升级依赖或重新创建环境。

新增功能

1.新增代码生成功能，支持配置数据库表信息一键生成和下载前后端代码，需要重新执行sql文件，请先备份数据。
2.新增表单构建功能。
3.用户头像新增支持http(s)链接。
4.新增trace中间件强化日志链路追踪和响应头。
5.用户管理支持分栏拖动。
6.菜单面包屑导航支持多层级显示。
7.白名单支持对通配符路径匹配。
8.支持开启暗黑模式。

BUG修复

1.修复默认关闭Tags-Views时，内链页面打不开。
2.修复删除当前登录用户拦截失效的问题。
3.修复定时任务目标字符串规则校验不全的问题。
4.修复执行单次任务时会覆盖已启用任务的问题 #IBEKD2。
5.修复个人中心特殊字符密码修改失败问题。

代码优化

1.优化导出方法。
2.参数键值更换为多行文本。
3.优化日志中操作方法显示。
4.优化日志装饰器获取核心参数的方式。
5.用户管理过滤掉已禁用部门。
6.优化TopNav内链菜单点击没有高亮。
7.ResponseUtil补充完整参数。

Full Changelog: v1.5.1...v1.6.0