AlistClient N

基于 AlistClient 的增强版 Android 客户端，用于连接和管理 Alist 文件列表服务。感谢原作者 BFWXKJGS 的开源贡献。

特性概览

• 📁 文件浏览与管理（列表/网格视图、多选、排序、批量操作）
• 🎬 多种视频播放模式（标准播放器、TikTok 短视频、STRM 流媒体、MediaKit/libmpv）
• 🎵 音频播放器（经典黑胶唱片 / 新风格两种 UI、LRC 歌词、睡眠定时器）
• 🎤 LRC 歌词系统（自动匹配获取、双风格视图、编码自动检测）
• 📺 IPTV 直播（M3U/M3U8/TXT 播放列表）
• 🖼️ 图片画廊（EXIF 信息、幻灯片、HEIC 支持）
• 📖 文档阅读（TXT/Markdown/PDF/Office）
• 🔒 安全锁（手势锁/密码锁）
• ⭐ 收藏夹与最近访问
• 📥 下载管理器（并发下载、断点续传）
• 🌐 多服务器/多账户管理
• 💬 外挂字幕支持
• 🔗 SmartStrm 联动删除（v1.4.0 新增）：删除 .strm 文件自动通知 SmartStrm 同步删除云盘媒体文件
• 🔍 设置搜索（v1.4.0 新增）：快速搜索定位设置项
• 🎲 Emby 随机播放（v1.4.4 新增）：支持多 Emby 服务器/媒体库管理，从媒体库一键随机抽取视频进入“视界流”上下滑动播放，支持对媒体进行标记

下载

GitHub Releases https://github.com/nu1lkali/AlistClientN/releases

蓝奏云 https://wwanb.lanzoum.com/b016kpl6ub 密码:cwc3

系统要求

项目	要求
Android 版本	8.0（API 26）及以上
架构	arm64-v8a / armeabi-v7a / x86_64
Alist 服务端	需自行部署 Alist 服务

应用导航

底部导航栏包含四个主要页面：

Tab	名称	功能
📁	文件	文件浏览、目录导航、文件操作
⏱	最近	最近浏览的文件记录，快速回访
⭐	收藏	收藏的文件和目录，支持随机播放/查看
⚙️	设置	账户管理、播放器配置、界面个性化等

新增功能

音频播放器

• 两种 UI 风格：
  • 新风格（默认）：圆形封面卡片、曲线波形进度条、LRC 歌词全屏展开
  • 经典黑胶风格（停止维护）：旋转黑胶唱片 + 唱针动画、全屏模糊封面背景
• 专辑封面与艺术家：从音频文件元数据自动提取（支持本地及远程流媒体 Range 请求）
• 播放模式：列表循环 / 单曲循环 / 随机播放
• 后台播放：通过 audio_service 支持通知栏控制和后台持续播放
• 自定义音量指示器：替代系统音量 HUD，半透明圆角色块 + 进度条 + 百分比，1.5 秒自动隐藏
• 播放进度记忆：自动记录播放位置，下次打开从上次位置继续

LRC 歌词系统

• 自动匹配获取：根据音频文件路径自动在 Alist 服务端查找同名 .lrc 文件（支持精确匹配 + 模糊匹配如 song.chs.lrc / song.ja.lrc）
• 本地缓存：下载后的歌词缓存到本地，二次访问无需重复下载
• 多编码自动检测：UTF-8 / Shift-JIS / GBK / EUC-JP / Latin-1，自动识别并正确解码
• 两种视觉风格：
  • 流线型风格：居中滚动、当前行放大加粗高亮、上下渐隐边缘效果
  • 时间轴风格：左对齐 + 时间戳列、当前行圆角矩形背景高亮
• 手动滚动锁定：手动滚动歌词暂停自动跟踪，3 秒后自动恢复，支持震动反馈
• 点击封面切换：播放器封面区域点击即可在封面和歌词视图之间切换

睡眠定时器

• 预设时长：10 / 20 / 30 / 45 / 60 / 90 分钟快速选择
• 自定义时长：小时 + 分钟滚轮选择器（最长 23 小时 59 分钟）
• 播完当前曲目后停止：移除队列中其他曲目，仅播放完当前曲目后自动停止
• 倒计时显示：顶部栏实时显示剩余时间
• 一键取消：随时取消已设置的定时器

TikTok 短视频播放器（v1.3.2 新增）

• 双入口集成：
  • 目录级入口：文件夹「更多」菜单 → "TikTok模式播放此文件夹视频"，异步获取目录下所有视频
  • 单文件入口：视频文件「更多」菜单 → "TikTok模式播放"，自动加载同目录所有视频并定位到当前文件
• 全屏 PageView.builder 上下滑动容器
• 视频控制器智能管理：前后 2 个视频预加载，超出 3 个范围自动 dispose 释放内存
• 双击点赞动效
• 单击暂停/恢复
• 进度条拖拽
• 右侧悬浮工具栏：
  • 收藏/取消收藏（复用 FavoriteDao 数据库，支持双击点赞联动）
  • 不喜欢/取消不喜欢（复用 DislikedVideoDao）
  • 循环模式切换（单视频循环 ↔ 自动播放下一个）
  • 横竖屏强制切换（SystemChrome.setPreferredOrientations）
  • 截图保存到相册（/Pictures/AlistClient/）
  • 视频信息查看（黑色 BottomSheet 弹窗显示元数据）
• 随机排序联动：文件列表开启随机排序时，TikTok 播放列表同步随机
• 控件透明度可调：设置页 → TikTok控件透明度（0%~100%），所有 UI 控件统一透明度
• 防抖 DB 写入：收藏/不喜欢状态乐观更新 UI，切换视频或退出播放器时批量写入数据库
• 生命周期安全：退出时恢复竖屏、重置 SystemUI、关闭 Wakelock、释放所有控制器

安全锁（v1.3 新增）

• 支持手势锁和密码锁两种方式
• 自动锁定超时设置（0 = 不自动锁）
• 安全锁验证页面

文件列表

• 目录过滤：不过滤 / 仅视频 / 仅图片

• 网格视图文件夹封面（优先视频 thumb，其次图片）

• 视频文件显示观看进度条

• 本地视频缩略图生成（基于视频帧截图）

• 图片/视频按日期分组显示

• 多选模式：批量下载、删除、移动

• 文件夹详情支持计算大小

• 排序新增随机模式、按文件大小排序

• 随机排序按类型分组（设置中可开启）

• 一键按文件类型分类

• 提取并整理：递归提取子文件夹文件并按类型归类

• 清理空文件夹

• 随机播放视频：当前目录随机选择视频播放

• 随机播放N个视频：可配置数量（默认10个）

• 递归随机播放：使用随机路径探测算法在子目录中查找视频并播放

  随机路径探测算法是一种以空间换时间的优化策略，通过牺牲"找到所有视频"的完整性，换取"快速找到一个视频"的效率。配合 LRU 路径惩罚机制（80% 概率跳过最近访问过的目录），避免重复探索同一目录。

• 智能预加载缓存：局域网环境下自动预加载子目录（可在设置中关闭/仅WiFi）

• 路径导航增强：

  • 点击 AppBar 路径显示完整导航菜单
  • 支持直接跳转到根目录
  • 保留页面栈，避免重复页面创建
  • 优化返回逻辑，确保返回操作正确导航到预期页面

• 扩展名过滤：可配置过滤的文件扩展名（默认 nfo）

• 浮动菜单按钮（FAB）可开关

• 文件列表浮动菜单改为底部弹窗卡片式设计

• 文件上传：支持从本地选择文件/照片上传到 Alist 服务器

• 文件复制/移动：支持跨目录复制和移动文件

• 文件重命名：支持在线重命名文件和文件夹

• 新建文件夹：支持在当前目录创建新文件夹

• 目录密码记忆：输入过的目录密码自动保存，下次访问无需重复输入

• 目录收藏：收藏当前目录，快速访问常用路径

IPTV 直播

• 支持 M3U/M3U8/TXT 播放列表，可从 Alist 文件 URL 或直接 URL 导入
• 按 group-title 分组显示频道，保持原始分类顺序，左侧分组导航 + 右侧频道列表
• 频道 Logo 显示
• 使用 media_kit 播放 HLS/m3u8 直播流，支持 rtmp/rtsp/mms 等协议
• 自动检测 HLS 流，直接跳转播放器无需解析频道列表
• 大文件（>500KB）使用 Isolate 异步解析，不阻塞 UI
• 播放器支持上一个/下一个频道切换，控制栏 4 秒无操作自动隐藏

STRM 流媒体播放

• .strm 文件解析：自动读取 .strm 文件内容，提取视频流 URL
• 专用播放器：基于 video_player 的全功能播放器
  • 手势控制：左右滑动 seek、左侧上下滑动调节亮度、右侧上下滑动调节音量
  • 播放列表侧边栏（支持按文件名/大小排序）
  • 横竖屏自由切换
  • 单视频循环模式
  • 截图保存到相册
  • 视频信息查看
  • 控件透明度可调
  • 亮度记忆：下次播放自动恢复上次亮度
  • 横屏自动隐藏控件（2秒无操作）
• .strm 主机替换：将 .strm 文件中的内网地址替换为 FRP/代理后的公网地址，实现非局域网环境下的视频流播放

视频播放器

• 播放列表侧边栏（顶部栏按钮触发，支持全屏模式）
• 视频截图保存到相册
• 播放中删除当前视频
• 视频信息查看：文件名、大小、时长、分辨率、目录路径
• 冷门格式（rmvb/avi/wmv 等）自动切换 ijkplayer 内核
• 新增更多视频格式支持（webm/divx/m2ts 等）
• 全屏模式下所有按钮完全适配
• 播放进度自动记录，下次打开从上次位置继续
• MediaKit（libmpv）播放器选项（设置中开启）
• 自动画中画（按 Home 键自动进入 PiP）
• MediaKit 播放器增强：
  • 视频填充模式切换（包含/覆盖/填充）
  • 播放失败自动重试（最多 3 次）
  • 手势控制：左右滑动 seek、左侧上下滑动调节亮度、右侧上下滑动调节音量
  • 亮度记忆：下次播放自动恢复上次亮度
  • 收藏/不喜欢联动

图片画廊

• 图片旋转
• 幻灯片自动播放（间隔时间可配置：1~30秒）
• 图片信息弹窗（分辨率、大小、EXIF 信息等）
  • 相机型号、拍摄时间
  • ISO、光圈、快门速度、焦距
  • GPS 位置信息
• 智能预加载：前后各预加载 5 张图片
• 内存与磁盘缓存优化
• HEIC/HEIF 格式支持（Android 自动转换为 JPEG 显示）
• HEIC 文件使用 Android 原生查看器
• HEIC 预热转换：文件列表跳转前提前触发 HEIC 转换缓存

文件搜索

• 搜索结果支持多选批量下载
• 搜索历史记录
• 快速重复搜索
• 一键清空历史
• 搜索路径过滤规则

文档阅读器

• TXT 阅读器：纯文本文件在线查看，支持编码切换（UTF-8/GBK/GB2312 等），支持复制链接
• Markdown 渲染：基于 InAppWebView 的 Markdown 渲染，支持代码高亮和样式
• PDF 阅读器：基于 flutter_pdfview 的 PDF 在线查看，支持夜间模式和链接跳转
• Office 文件阅读：支持 Word/Excel/PPT 等 Office 文档在线预览
• 内置网页浏览器：InAppWebView 内置浏览器，支持混合内容加载

最近访问

• 自动记录浏览过的文件
• 快速回访最近查看的文件
• 支持滑动删除记录

下载管理

• 并发下载任务管理（默认最多 5 个同时下载）
• 下载进度实时显示
• 支持暂停/恢复/取消下载
• 下载记录持久化存储
• 下载完成后可直接打开文件

多服务器/多账户管理

• 支持添加多个 Alist 服务器
• 快速切换不同服务器和账户
• 支持编辑和删除已保存的服务器配置
• 游客模式登录支持

外挂字幕

• 本地字幕库：指定本地字幕目录，自动匹配视频文件
• 字幕下载直接存入字幕目录
• 全局字幕开关

缓存管理

• 视频缓存统计与清理
• 一键清除全部缓存

收藏夹

• 多收藏夹管理：创建、重命名、删除自定义收藏夹，文件分类整理
• 侧边面板导航：左侧收藏夹列表，快速切换不同收藏夹，宽屏主从布局 / 窄屏抽屉模式自适应
• 默认收藏夹：可设置默认收藏夹，新收藏默认存入
• 文件移动：支持将收藏文件在不同收藏夹之间移动
• 全部收藏视图：查看所有收藏夹中的全部文件
• 批量清空：一键清空指定收藏夹的全部内容
• 随机打开收藏的图片
• 随机播放收藏的视频
• 左滑删除 / 更多菜单操作

不喜欢视频列表

• 查看所有标记为"不喜欢"的视频
• 支持取消不喜欢

设置

• 智能预加载开关 + 仅WiFi预加载
• 播放器选择：ExoPlayer / MediaKit（libmpv）/ 外部播放器
• 音频播放器风格切换（新风格 / 经典黑胶风格（停止维护））
• 歌词视图风格切换（流线型 / 时间轴）
• 主题颜色选择（12种预设颜色）
• 显示浮动按钮开关
• 随机排序按类型分组开关
• 扩展名过滤配置
• 随机播放数量配置
• 文件名最大行数配置
• 幻灯片间隔时间配置
• TikTok 控件透明度配置
• 安全锁设置（手势/密码）
• 搜索过滤规则设置
• 字幕匹配模式选择（精确 / 模糊 / 双模式）
• 字幕下载自动存入字幕目录
• 流媒体地址直接播放
• .strm 主机替换配置（内网→公网地址映射）
• STRM 预加载下一个视频开关
• SmartStrm 联动删除（v1.4.0）：Emby 模拟删除 Webhook 配置与测试
• 设置搜索（v1.4.0）：搜索按钮动态过滤设置项
• 外挂字幕开关与配置
• 设置页分组重构：账户与存储、网络与预加载、播放器配置、本地字幕、界面与个性化、过滤器与高级、.strm 设置、影视联动删除、关于

UI 优化

• 圆角卡片设计，增强视觉层次
• 优化图标透明度和配色
• 改进颜色选择器交互体验
• 音乐播放器支持获取音频封面文件
• 音频新风格播放器：波形进度条

UI 截图

项目界面预览

界面预览 1	界面预览 2	界面预览 3

技术栈

类别	技术
框架	Flutter 3.13.8 (Dart)
状态管理	GetX
数据库	Floor ORM (SQLite)
网络	Dio
视频播放	video_player / media_kit (libmpv) / flutter_aliplayer
图片加载	extended_image
PDF	flutter_pdfview
WebView	flutter_inappwebview
崩溃上报	Bugly (仅 Release)
本地化	GetX Translations (中文/英文)

项目结构

lib/
├── main.dart              # 应用入口
├── router.dart            # 路由配置
├── database/              # Floor ORM 数据库层
│   ├── dao/               # 数据访问对象
│   └── table/             # 数据表定义
├── entity/                # API 响应实体
├── generated/             # 生成代码（颜色方案、图片引用等）
├── l10n/                  # 国际化（中文/英文）
├── net/                   # HTTP 网络层（Dio 封装）
├── screen/                # 页面/屏幕（30+ 页面）
│   ├── file_list/         # 文件列表相关
│   ├── iptv/              # IPTV 直播
│   └── security/          # 安全锁
├── util/                  # 工具类和控制器
└── widget/                # 可复用组件

构建

环境要求

• Flutter 3.13.8（推荐使用 FVM 管理）
• Java 11 及以上
• Android SDK：compileSdk 36, minSdk 26, NDK 26.1.10909125

使用 FVM（推荐）

fvm install 3.13.8
fvm use 3.13.8
fvm flutter pub get
fvm dart run build_runner build    # 重新生成 Floor 数据库代码（修改数据库表/DAO 后必须执行）
fvm flutter build apk --release --no-tree-shake-icons

使用全局 Flutter

flutter pub get
dart run build_runner build       # 重新生成 Floor 数据库代码（修改数据库表/DAO 后必须执行）
flutter build apk --release --no-tree-shake-icons

⚠️ 重要：修改 lib/database/ 下的 @Entity 表或 @Dao 类后，必须运行 dart run build_runner build 重新生成 lib/database/alist_database.g.dart，否则构建会失败。

构建产物

构建产物位于 build/app/outputs/flutter-apk/ 目录，包含以下 APK：

文件	架构	说明
app-arm64-v8a-release.apk	ARM 64位	推荐大多数手机
app-armeabi-v7a-release.apk	ARM 32位	旧设备
app-x86_64-release.apk	x86 64位	适用于模拟器
app-release.apk	通用	包含所有架构，体积最大

签名配置

在 android/local.properties 中配置签名信息：

keyAlias=your_key_alias
keyPassword=your_key_password
storeFile=/path/to/your/keystore.jks
storePassword=your_store_password

开发注意事项

• flutter_aliplayer 来自 Git 仓库（GeekTR/flutter_aliplayer，分支 feature/5.5.6.0），非 pub.dev
• dependency_overrides 中固定了 win32、sqflite_common、sqflite、sqflite_common_ffi 的版本，请勿随意移除
• flutter_aliplayer 和 media_kit 都包含原生 .so 文件，packagingOptions 使用 pickFirst 解决冲突
• Bugly 崩溃上报仅在 Release 模式下初始化
• 数据库当前版本为 8，包含 8 个实体表，Schema 变更时必须在 alist_database.dart 中添加 Migration

致谢

本项目基于 AlistClient 开发，感谢原作者的开源贡献。

开源许可证

本项目采用 GNU Affero General Public License v3.0 开源许可证。

---

更新记录

v1.4.4

• Emby 随机播放（新功能）：从 Emby 服务器媒体库随机抽取视频，进入“视界流”上下滑动播放
  • 设置页新增「Emby 随机播放」分组：Emby 服务器管理 / 媒体库管理 / 每次随机数量 / 使用说明
  • 多服务器管理：备注名、协议(http/https)、地址端口、API Key 掩码，支持一键“测试连接”(GET /Users)，点选切换主服务器
  • 媒体库一键拉取：GET /Users/{userId}/Views 拉出全部媒体库（名称/Id/类型），点选即添加，无需手工查询 ParentId
  • 手动填写 ParentId 时可按 Id 反查媒体库名称并自动填入备注
  • 首页文件列表右上角新增「随机播放」按钮：自动获取用户并缓存 → SortBy=Random 随机抽取 → 拼接播放直链 → 无缝进入“视界流”
  • 服务器/媒体库配置本地持久化(SharedPreferences)，切换后即时生效，无需重启 App
  • 支持对媒体库媒体进行收藏/标记，调用Emby接口。

v1.4.3

• 多收藏夹管理：收藏页新增侧边面板，支持创建、重命名、删除自定义收藏夹
  • 数据库新增 favorite_folder 表，favorite 表新增 folder_id 字段关联收藏夹
  • 默认收藏夹：首次启动自动创建"默认收藏夹"，已有收藏自动归入
  • 可设置任意收藏夹为默认，新收藏默认存入
  • 收藏文件可在不同收藏夹之间移动
  • 宽屏主从布局 / 窄屏抽屉模式自适应
  • 全部收藏视图：查看所有收藏夹中的全部文件
  • 批量清空：一键清空指定收藏夹的全部内容
  • 长按收藏夹弹出菜单：重命名、设为默认、删除
• 收藏夹面板 UI 优化：顶部圆角卡片设计、状态栏自适应间距、标题升级为 titleLarge、图标优化

v1.4.0

• SmartStrm 联动删除：删除 .strm 文件时自动发送 Emby 格式 Webhook 通知 SmartStrm 同步删除网盘媒体文件
  • 独立设置页面：功能总开关、Webhook URL 配置、群晖 strm 目录配置、路径转换预览
  • 五级渐进式路径匹配算法，兼容各种 AList 挂载前缀命名（NAS/NASABCD/群晖 等）
  • 空路径安全拦截，防止误删整个网盘
  • 连通性测试按钮（发送 Emby 标准 system.notificationtest 事件）
  • 文件日志系统：记录每次发送的 Payload 和响应，最多保留 300 行，支持查看和清空
  • 发送方式从 multipart/form-data 改为 application/json，与 SmartStrm 官方格式一致
  • 批量删除改造为并发批次发送（每批 3 条，批间 100ms）
  • 覆盖所有删除入口：左滑删除、更多菜单删除、多选批量删除、不喜欢列表单条/全部删除
  • 仅对 .strm 文件生效，普通视频不触发
• 设置页面搜索：AppBar 右侧新增搜索按钮，输入关键词动态过滤设置项
  • 设置页重构为数据模型驱动（SettingsItemData / SettingsSectionData）
  • 支持中英文搜索词、拼音别名
  • 无匹配项时显示空状态提示
• 致谢 SmartStrm 作者

v1.3.10

• 修复大目录视频数据丢失 Bug：主加载方法 _loadFilesInner() 从分页模式（per_page: 500）改为全量获取（per_page: 0），修复因 Alist API 不返回 has_more / pages_total 字段导致分页提前终止、大量视频文件丢失的问题
  • 受影响场景：文件数量超过 500 的目录（如 896 文件目录只加载 250 个视频、3958 文件目录只加载 375 个视频）
  • 新增缓存保护：预加载缓存中的全量数据不会被不完整数据覆盖
  • 超时时间从 15s 延长至 30s，适应大目录全量返回
• 修复进入文件列表时反复弹出"获取文件链接失败"Toast：StrmParser 后台预加载 .strm 文件时未静默调用 makeFileLink，当 basePath 未就绪时每个 .strm 文件都会弹出一个 Toast，目录中文件越多弹得越久
  • 为 parseStrmUrl() 和 batchParseStrmUrls() 中的 makeFileLink 调用添加 toastShowTips: false，后台预加载失败不再打扰用户
• 音频播放器风格默认值改为新风格：audioPlayerUiStyle 默认值从 0（经典黑胶）改为 1（新风格），新用户首次使用直接看到新版播放器 UI

v1.3.7

• 音频播放器布局修复：
  • 新风格播放器动态布局：修复歌词模式下进度条占用歌词空间导致仅显示半屏的问题
  • 修复 Android 系统侧滑返回手势失效问题（移除 edgeToEdge 模式 + 添加 WillPopScope 显式声明手势处理）
  • 经典黑胶风格歌词可读性优化：添加半透明深色背景层，高亮字体改为纯白色
  • 音量指示器位置调整
  • 经典黑胶风格标记为停止维护，不推荐使用
• 后台播放稳定性修复：
  • 添加 AppLifecycle 生命周期监听，后台时暂停歌词定时器、唱片动画、数据库写入
  • 封面图片缓存限制为最多 12 条，防止长时间播放内存耗尽导致手机死机
  • 修复后台持续 CPU 唤醒问题（300ms 歌词定时器 + 200ms 位置流 + 每 10 秒 DB 写入）
• 歌词视图风格切换：设置页新增「歌词视图风格」选项，支持流线型（居中放大高亮）和时间轴（左对齐时间戳）两种风格
• LRC 歌词优化：手动滚动 FAB 按钮样式调整，拖拽状态管理优化

v1.3.6

• 睡眠定时器：
  • 预设时长：10 / 20 / 30 / 45 / 60 / 90 分钟快速选择
  • 自定义时长：小时 + 分钟滚轮选择器（最长 23 小时 59 分钟）
  • 播完当前曲目后停止模式
  • 顶部栏实时倒计时显示，可随时取消
• 字幕匹配模式：支持精确匹配 / 模糊匹配 / 双模式（先精确后模糊）三种策略
• 外挂字幕：本地字幕库支持
  • 指定本地字幕目录，自动匹配视频文件
  • 字幕下载直接存入字幕目录
  • 全局字幕开关

v1.3.5

• LRC 歌词系统：
  • 自动匹配获取：根据音频路径在 Alist 服务端查找 .lrc 文件（精确 + 模糊匹配）
  • 多编码自动检测：UTF-8 / Shift-JIS / GBK / EUC-JP / Latin-1
  • 本地缓存，二次访问免下载
  • 两种视觉风格：流线型（居中放大高亮 + 渐隐边缘）、时间轴（左对齐时间戳 + 高亮背景）
  • 手动滚动锁定 + 震动反馈，3 秒无操作自动恢复跟踪
  • 点击播放器封面切换歌词视图
• 自定义音量指示器：替代系统音量 HUD，半透明圆角色块 + 进度条 + 百分比，1.5 秒自动隐藏
• 音频新风格播放器：圆形封面卡片、曲线波形进度条、SafeArea 安全区域适配

v1.3.4

• STRM 流媒体播放：.strm 文件解析与专用播放器
  • 手势控制（seek/亮度/音量）
  • 播放列表侧边栏（支持排序）
  • 横竖屏切换、循环模式、截图
  • 亮度记忆、控件透明度可调
  • .strm 主机替换（内网→公网地址映射）

v1.3.3

• TikTok 短视频播放器：全新的上下滑动短视频播放模式
  • 双入口（目录级/单文件）集成
  • 双击点赞动效（心形在点击位置弹出）
  • 单击暂停/恢复播放
  • 进度条拖拽
  • 循环模式切换（单视频循环/自动下一个）
  • 横竖屏强制切换
  • 截图保存到相册
  • 视频信息查看
  • 右侧工具栏（收藏/踩/循环/横竖屏/截图/信息）
  • 控件透明度可调（设置页）
  • 防抖 DB 写入（切换视频或退出时批量持久化）
  • 视频控制器智能管理（预加载+自动释放防内存泄漏）

v1.3.0

• 安全锁：手势锁和密码锁两种方式，自动锁定超时
• 不喜欢视频列表：标记/取消不喜欢，独立管理页面
• 搜索过滤规则：按路径规则过滤搜索结果和文件列表
• 扩展名过滤配置（默认过滤 nfo 文件）
• 随机播放数量可配置
• 浮动菜单按钮可开关
• 随机排序按类型分组选项
• MediaKit（libmpv）播放器选项
• 自动画中画支持
• 音频播放器风格切换

v1.2.0

• 文件列表浮动菜单改为底部弹窗卡片式设计
• 常用操作网格 + 播放与工具网格 + 排序方式chips
• 目录收藏功能（收藏当前目录）
• 安全锁快捷入口
• 按类型归类（一键将文件移动到对应子文件夹）
• 提取并整理（递归提取子文件夹文件并按类型归类）
• 清理空文件夹
• 文件组织操作进度页面（带进度条）

v1.1.0

• IPTV 直播功能
• 视频播放进度自动记录
• 视频截图保存到相册
• 收藏夹随机播放
• HEIC/HEIF 格式支持
• 本地视频缩略图生成
• 网格视图文件夹封面