v3.1.0 版本更新记录
变更概览
| 项目 | 内容 |
|---|---|
| 发布版本 | v3.1.0 |
| 提交范围 | master..develop |
| 后端代码规模 | 588 files changed, 32741 insertions(+), 5476 deletions(-) |
| 前端代码规模 | 274 files changed, 19396 insertions(+), 3285 deletions(-) |
| 后端时间范围 | 2025-12-21 ~ 2026-05-07 |
| 前端时间范围 | 2025-11-07 ~ 2026-05-07 |
主要功能更新
1. 核心架构与工程基础升级
- 后端版本升级至
3.1.0,并将Spring Boot升级到3.5.8,Java运行基线从17升级到25。 - 后端全面推进 ORM 向
JPA迁移,移除MyBatis依赖,并清理nativeQuery的使用,为后续多数据库兼容和维护奠定基础。 - 后端重构系统配置项、版本检查与数据迁移初始化逻辑,增强版本升级过程中的可维护性。
- 前端升级
Vuetify到4.0.0,并修复插件构建打包范围异常及多项 CSS / Vite / TS 警告。 - 前后端共同完善构建与发布链路,包括前端资源打包控制、GitHub Actions 自动发布、标签发布流程与配套文档。
2. 文件管理、文件系统与异步任务体验
- 前端文件视图新增/完善:支持 grid / tile / list 多视图、虚拟滚动、Ctrl+A 全选、Backspace 返回上级、Enter 打开、Tab 连续聚焦、字母键实时搜索。
- 前端上传能力增强:支持拖拽/选择文件夹上传整目录;文件上传与文件收集逐步切换到统一上传接口。
- 前端文件属性增强:新增扩展段、支持默认展开控制;挂载点信息迁移到文件属性扩展区;视频信息入口整合到文件属性。
- 后端新增文件复制异步任务支持,并补充任务创建、立即执行、进度查询等接口;同时优化复制/移动过程回调机制,支持更细粒度的进度跟踪与中断控制。
- 后端实现统一的附属数据存储接口,并补充头像、缩略图缓存、视频字幕缓存等
3.1.0升级迁移逻辑。 - 后端增加文件系统事件推送能力,增强文件操作过程中的联动扩展能力。
3. 压缩 / 解压与归档能力升级
- 前端对接新版压缩接口,重构压缩/解压相关数据结构与表单,新增压缩包密码支持、解压高级选项(格式/引擎选择)与在线预览能力。
- 后端引入基于引擎的归档 API 与新的归档管理机制,并将归档控制器与相关实现下沉到
sfc-archive模块。 - 后端新增压缩包资源列表接口,支持读取压缩包内部文件列表,并补充压缩格式加解密算法特性声明与多引擎匹配能力。
- 后端为压缩/解压异步任务补充进度回调、任务消息输出和中断处理能力,并增强对
7z、gz、xz、bz2、jar等格式的支持。 - 前后端共同完成
ArchiveResource、ListArchiveResourcesRequest等归档能力的整合,支撑压缩任务资源管理与交互体验。
4. 视频增强与多媒体能力
- 前端视频播放能力增强:新增视频播放器与字幕选择;补充
srt/pgs等字幕支持;ass字幕渲染方案升级并优化帧率与切换体验。 - 前端视频转码能力增强:支持更多 ffmpeg 参数、批量创建转码任务、转码任务列表与通用异步任务明细联动。
- 前端图片浏览器升级:新增独立
ImageViewer组件,支持旋转、全屏适配、双击缩放自动居中、移动端兼容与交互细节优化。 - 后端视频增强链路继续扩展,支持视频缩略图、字幕提取优化、批量转码任务、更多 ffmpeg 参数以及相关缓存和存储迁移能力。
- 网络工具插件继续增强,增加
UPnP设备发现、服务调用与视频投屏相关能力。
5. OAuth、登录认证与开放平台生态
- 后端新增开放平台第三方应用的增删改查、密钥管理、授权管理相关接口,并实现第三方 OAuth 应用授权流程、
Access Token与API Ticket签发及权限校验流程。 - 后端新增撤销授权、授权列表、退出登录等接口能力,并新增
Google第三方登录支持。 - 前端新增第三方 OAuth 应用管理页面、第三方应用授权页面与个人中心授权管理能力。
- 前后端共同增强第三方登录配置体验,支持回调代理、绑定流程优化、错误提示修复和入口样式优化。
- 后端同步优化第三方平台账号头像缓存、本地代理与跨域访问体验。
6. 插件、扩展能力与部署体系
- 后端初步实现
WebDAV服务插件,并持续补强兼容性、认证方式、属性支持与根目录行为;同时新增webdav-store插件,支持挂载第三方WebDAV服务。 - 前端新增
WebDAV配置组件与参考手册说明组件,补齐插件使用配置入口。 - 前后端共同新增
WebRTC插件能力,并补充相关前端资源与接入支持。 - 前端菜单扩展能力增强,引入
MenuHelper,并对部分菜单结构进行调整。 - 后端完善
Dockerfile、docker-compose、环境变量配置与 GitHub Actions 自动发布流程,提升容器化部署与版本发布的稳定性和一致性。
7. UI、主题、文档与协作规范
- 前端系统样式支持毛玻璃效果及相关参数独立配置(背景图 / 抽屉 / 卡片),并优化深色模式下可读性、左侧菜单导航与整体视觉一致性。
- 后端更新
README.md,补充 OAuth 开放平台、第三方登录、插件、Docker 与部署说明。 - 后端新增和完善 Docker、压缩引擎、异步任务、插件开发、Git 提交规范等文档;前端同步补充 README、Nginx gzip 与代理配置说明。
- 后端补充
AGENTS.md相关协作规范说明,并更新 Postman API 文档,标注后续不再以 Postman 作为主要维护方式。
关键修复与稳定性提升
- 后端修复多处挂载点、委托存储、跨文件系统复制/移动、并发创建目录等场景下的稳定性问题。
- 后端修复多个归档相关问题,包括
7z时间戳读取、LZMA2 参数、ZIP 编码、大文件压缩中断、compressionLevel 参数映射等,并优化解压遍历与流处理性能。 - 后端修复文件搜索、文件收集、用户头像默认响应、下载任务创建、插件版本更新钩子触发、WebShell Linux 环境会话创建等问题。
- 后端持续修复 WebDAV、OSS、Samba、挂载点代理存储记录、事务隔离与并发场景问题,提升文件系统链路稳定性。
- 前端修复多个文件列表与布局交互问题(空白区域点击、表格换行错乱、遮罩层级、无文件高度等)。
- 前端修复 markdown 编辑器粘贴图片、用户搜索无结果报错、多处第三方登录与配置保存异常等问题。
- 前端修复系统日志按日期查询未能包含截止日期当天数据的问题,并优化异步任务日志刷新性能,降低大量日志场景下的卡顿风险。
发布说明
本次版本为一次前后端同时累积较多改动的集中发布,建议先在预发环境完成全链路测试后再上线,重点关注以下事项:
- 运行环境升级:后端
Java 17 -> Java 25,部署环境需提前确认 JDK 版本。 - 框架与依赖升级:
Spring Boot 3.5.8、Vuetify 4.0.0及相关依赖升级后,需关注兼容性与构建行为变化。 - 数据迁移:包含头像、缩略图缓存、视频字幕缓存、配置字段调整等升级迁移逻辑。
- 文件系统与挂载点:涉及 WebDAV、Samba、OSS、委托存储、挂载点复制/移动等核心链路,建议重点回归。
- 归档与多媒体链路:建议重点验证压缩包预览、压缩/解压、打包下载、视频缩略图、字幕提取、视频转码等场景。
- 发布与部署流程:建议同步验证 Docker 构建、容器部署、环境变量配置启动流程以及 CI/CD 自动发布链路。