4.4.0
✨ 新功能
架构迁移完成:从 QML 单体架构完整迁移至 Electron + React + FastAPI 双进程架构,前端 8 个页面全部 React 化
左侧固定 Sidebar 导航:替代顶部 tab,含红点徽章(1-9 圆点 / 10-99 胶囊 / ≥100 显示 99+)
Liquid Glass 设计语言:3D 字标 + 蓝青色主题 + 柔和光球 + 大圆角,整体克制的高端质感
系统托盘菜单:自定义 BrowserWindow 实现 Liquid Glass 风格托盘菜单 + 关闭确认弹窗(最小化/退出/取消)
内置媒体预览对话框:图片缩放/平移/多图切换 + 视频/音频播放器 + 缩略图三级回退
小红书 Live Photo 支持:实况图返回图片+视频双项,前端蓝色横幅提示 + LIVE 徽章标识
Collection 智能操作:素材卡片右下角按钮根据视图自动切换(全部/收藏视图显示「📁+」加入菜单,具体分类视图显示「✕」直接移除)+ Collection 右键菜单支持重命名/删除
前端 i18n 双语:全页面接入中英即时切换,延迟加载避免首屏阻塞
主题切换:Light/Dark 主题持久化,切换时 unpolish/polish 强制刷新
自动更新机制:electron-updater + UpdateDialog 弹窗 + 后台下载 + 重启安装提示;macOS 不支持自动重启时回退手动下载
CI/CD 自动发布:GitHub Actions 三平台矩阵构建(windows-x64 / macos-arm64 / linux-x64),--publish always 自动上传 Release
跨平台原生安装包:Windows NSIS(安装向导+路径选择+卸载清理)+ macOS DMG(x64/arm64 分架构)+ Linux AppImage/deb/rpm
lumio-file:// 自定义协议:本地视频流式播放(支持 Range 请求)+ MIME 推断 + bypassCSP
⚡ 性能优化
启动速度:splash 秒开 + FastAPI spawn 前移到模块顶层与 Electron 主进程并行启动(节省 1-3 秒)+ React 页面延迟到 FastAPI ready 后加载避免首次 fetch 失败
V8 调优:--max-old-space-size=2048 --gc-interval=100 限制老生代堆上限提高 GC 频率
Chromium 启动开关裁剪:关闭 extensions/plugins/background-networking/default-apps/hang-monitor/PDF 子进程等不需要的子系统
thumb-proxy 深度优化:CDN 失败返回 1x1 透明 GIF(避免 502 抛异常破坏 CORS)+ persist 缓存分级(素材库/历史页持久化,临时预览仅内存)
虚拟列表:长列表用 react-window 虚拟滚动,避免 DOM 节点爆炸
WebSocket 增量更新:避免全量轮询,事件驱动刷新
横向列表滚动优化:移除 scroll-behavior: smooth / will-change: transform / 过度 contain,添加固定宽高 + decoding="async" + overscroll-behavior-x: contain
安装包体积:compression: "maximum" + asar: true,安装包从 ~600MB 降至 ~140MB
🏗️ 架构迁移
PySide6 依赖剥离:业务 manager(Download/History/Library/Inbox/Notification)全部剥离 QObject/Signal,纯 Python 实现
数据库迁移机制:PRAGMA user_version + migrations/ 目录 + 启动时自动迁移
PyInstaller + electron-builder 联合打包:Python 后端打包成 LumioAPI.exe,electron-builder 通过 extraResources 嵌入安装包
FastAPI 包装层:零业务逻辑改动,只读现有 manager,WebSocket 推送进度/事件
动态端口 + Token 鉴权:每次启动随机端口(38910-38999)+ 48 字符 hex token,防止本机其他进程误调
IPC 通信:sandbox 模式下用 ipcRenderer.sendSync 同步获取 FastAPI 配置,避免 preload process.env polyfill 限制
后端去重:_yt_opts 统一到 utils/yt_opts.py + Apify 死代码清理 + 重复 IG/X helper 函数合并
配置路径分流:dev 模式写项目目录缓存,packaged 模式用平台默认 userData 路径(符合各平台惯例)
目录隔离回滚保护:新代码全部在 frontend/ 和 api_fastapi.py,删除即回滚到 QML 版本
抖音超高清原画档位(60帧 H.265)仍需 app API 或登录态,web API 无法获取
X GraphQL API query ID 会定期轮换,422 报错时需从 yt-dlp 源码更新硬编码
📦 安装说明
Windows:下载 Lumio-Setup-4.4.0.exe(~140MB),双击按向导安装
macOS:根据架构下载 Lumio-4.4.0-arm64.dmg(Apple Silicon)或 Lumio-4.4.0-x64.dmg(Intel)
Linux:下载 Lumio-4.4.0.AppImage(直接运行)/ .deb(Debian 系)/ .rpm(RedHat 系)
首次启动会显示 splash 加载页(3-8 秒),FastAPI 后端就绪后自动进入主界面
已安装旧版本的用户可通过应用内「检查更新」自动下载并安装新版本