共计 840 个字符，预计需要花费 3 分钟才能阅读完成。
一个基于 Tauri 的本地硬盘视频管理工具，支持封面展示、多文件夹管理、视频播放等功能。
核心功能
视频管理
- 自动扫描指定文件夹中的视频文件
- 支持多种视频格式 (MP4, AVI, MKV, MOV, WMV, FLV, WebM 等)
- 自动关联同名封面图片
- 视频信息展示 (文件名、路径、大小、时长、分辨率、编码格式等)
- 一键唤起系统默认播放器播放视频
- 视频元数据解析 (使用 ffprobe 外部工具)
- 支持视频时长、帧率、比特率等详细信息
文件夹管理
- 支持添加多个根文件夹作为视频源
- 每个根文件夹支持多级子目录结构
- 按根文件夹和目录层级筛选
- 支持跨文件夹的全局搜索
- 文件夹的启用 / 禁用状态管理
- 删除已添加的根文件夹
- 并行目录扫描 (多线程处理)
- 目录树缓存机制 (提升性能)
- 面包屑导航系统
- 文件夹历史记录（对象化：path/rootId/volumeKey/addedAt）
- 根 ID 幂等（UUID v5：基于卷标识 + 标准化路径）
- Windows 卷标识支持（vol 获取序列号，跨硬盘缓存隔离）
- 扫描性能优化：使用 DirEntry::file_type() 减少额外 metadata 调用
缓存与启动体验
- 本地缓存：按 volumeKey + rootId 命名空间存储目录树
- 扫描策略：SWR（命中缓存即刻渲染，可选后台刷新）
- scanDirectory(rootId, revalidate?)：支持跳过刷新（命中缓存不请求后端）
- 冷启动：从历史最新项直接从缓存 hydrate 界面
- 封面管理
- 自动检测封面文件 (JPG, PNG, BMP, WebP)
- 智能匹配视频和封面文件
- 图片预览功能 (base64 编码)
- 封面文件信息展示
- 支持多种图片格式
用户界面
- 响应式设计，支持不同屏幕尺寸
- 网格视图和列表视图切换
- 动态背景和动画效果 (Magic UI 组件)
- 加载状态和错误提示
- 模态对话框操作
- 图片预览弹窗
- 成功 / 错误消息提示
- 文件夹操作确认对话框
系统集成
- 系统默认播放器集成
- 系统文件夹浏览器集成
- 跨平台文件路径处理
- 系统命令执行支持核心功能
正文完
