Skip to content

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.8Java 运行基线从 17 升级到 25
  • 后端全面推进 ORM 向 JPA 迁移,移除 MyBatis 依赖,并清理 nativeQuery 的使用,为后续多数据库兼容和维护奠定基础。
  • 后端重构系统配置项、版本检查与数据迁移初始化逻辑,增强版本升级过程中的可维护性。
  • 前端升级 Vuetify4.0.0,并修复插件构建打包范围异常及多项 CSS / Vite / TS 警告。
  • 前后端共同完善构建与发布链路,包括前端资源打包控制、GitHub Actions 自动发布、标签发布流程与配套文档。

2. 文件管理、文件系统与异步任务体验

  • 前端文件视图新增/完善:支持 grid / tile / list 多视图、虚拟滚动、Ctrl+A 全选、Backspace 返回上级、Enter 打开、Tab 连续聚焦、字母键实时搜索。
  • 前端上传能力增强:支持拖拽/选择文件夹上传整目录;文件上传与文件收集逐步切换到统一上传接口。
  • 前端文件属性增强:新增扩展段、支持默认展开控制;挂载点信息迁移到文件属性扩展区;视频信息入口整合到文件属性。
  • 后端新增文件复制异步任务支持,并补充任务创建、立即执行、进度查询等接口;同时优化复制/移动过程回调机制,支持更细粒度的进度跟踪与中断控制。
  • 后端实现统一的附属数据存储接口,并补充头像、缩略图缓存、视频字幕缓存等 3.1.0 升级迁移逻辑。
  • 后端增加文件系统事件推送能力,增强文件操作过程中的联动扩展能力。

3. 压缩 / 解压与归档能力升级

  • 前端对接新版压缩接口,重构压缩/解压相关数据结构与表单,新增压缩包密码支持、解压高级选项(格式/引擎选择)与在线预览能力。
  • 后端引入基于引擎的归档 API 与新的归档管理机制,并将归档控制器与相关实现下沉到 sfc-archive 模块。
  • 后端新增压缩包资源列表接口,支持读取压缩包内部文件列表,并补充压缩格式加解密算法特性声明与多引擎匹配能力。
  • 后端为压缩/解压异步任务补充进度回调、任务消息输出和中断处理能力,并增强对 7zgzxzbz2jar 等格式的支持。
  • 前后端共同完成 ArchiveResourceListArchiveResourcesRequest 等归档能力的整合,支撑压缩任务资源管理与交互体验。

4. 视频增强与多媒体能力

  • 前端视频播放能力增强:新增视频播放器与字幕选择;补充 srt / pgs 等字幕支持;ass 字幕渲染方案升级并优化帧率与切换体验。
  • 前端视频转码能力增强:支持更多 ffmpeg 参数、批量创建转码任务、转码任务列表与通用异步任务明细联动。
  • 前端图片浏览器升级:新增独立 ImageViewer 组件,支持旋转、全屏适配、双击缩放自动居中、移动端兼容与交互细节优化。
  • 后端视频增强链路继续扩展,支持视频缩略图、字幕提取优化、批量转码任务、更多 ffmpeg 参数以及相关缓存和存储迁移能力。
  • 网络工具插件继续增强,增加 UPnP 设备发现、服务调用与视频投屏相关能力。

5. OAuth、登录认证与开放平台生态

  • 后端新增开放平台第三方应用的增删改查、密钥管理、授权管理相关接口,并实现第三方 OAuth 应用授权流程、Access TokenAPI Ticket 签发及权限校验流程。
  • 后端新增撤销授权、授权列表、退出登录等接口能力,并新增 Google 第三方登录支持。
  • 前端新增第三方 OAuth 应用管理页面、第三方应用授权页面与个人中心授权管理能力。
  • 前后端共同增强第三方登录配置体验,支持回调代理、绑定流程优化、错误提示修复和入口样式优化。
  • 后端同步优化第三方平台账号头像缓存、本地代理与跨域访问体验。

6. 插件、扩展能力与部署体系

  • 后端初步实现 WebDAV 服务插件,并持续补强兼容性、认证方式、属性支持与根目录行为;同时新增 webdav-store 插件,支持挂载第三方 WebDAV 服务。
  • 前端新增 WebDAV 配置组件与参考手册说明组件,补齐插件使用配置入口。
  • 前后端共同新增 WebRTC 插件能力,并补充相关前端资源与接入支持。
  • 前端菜单扩展能力增强,引入 MenuHelper,并对部分菜单结构进行调整。
  • 后端完善 Dockerfiledocker-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.8Vuetify 4.0.0 及相关依赖升级后,需关注兼容性与构建行为变化。
  • 数据迁移:包含头像、缩略图缓存、视频字幕缓存、配置字段调整等升级迁移逻辑。
  • 文件系统与挂载点:涉及 WebDAV、Samba、OSS、委托存储、挂载点复制/移动等核心链路,建议重点回归。
  • 归档与多媒体链路:建议重点验证压缩包预览、压缩/解压、打包下载、视频缩略图、字幕提取、视频转码等场景。
  • 发布与部署流程:建议同步验证 Docker 构建、容器部署、环境变量配置启动流程以及 CI/CD 自动发布链路。