Skip to content

v2.7.3: 路径管理与界面优化重大更新

此版本是一个重要的功能增强版本,引入了完整的视频源路径重设系统,同时对用户界面进行了重大优化,为用户提供更加智能和便捷的管理体验。

🌟 主要新功能

🗂️ 视频源路径重设系统 - 革命性的路径管理 ⭐

完整的路径管理解决方案!

  • API端点POST /api/video-sources/{type}/{id}/reset-path
  • 四步重命名原则:采用安全的文件移动策略,彻底避免数据丢失和文件名冲突
  • 智能文件移动:基于模板系统重新生成路径,支持批量文件迁移
  • 空文件夹清理:移动完成后自动检测并清理空的原始目录
  • 详细统计反馈:返回移动文件数量、更新视频数量、清理文件夹数量等详细信息

技术实现亮点

rust
/// 四步重命名原则实现
async fn move_video_files_to_new_path(
    video: &video::Model,
    old_base_path: &str,
    new_base_path: &str,
    clean_empty_folders: bool,
) -> Result<(usize, usize), std::io::Error> {
    // 1. 重命名为临时名称(避免冲突)
    // 2. 移动到目标目录(使用临时名称)
    // 3. 重命名为最终名称
    // 4. 清理临时文件和空目录
}

🎨 侧边栏界面革新 - 空间利用率提升60%

从三个按钮到一个展开菜单的优雅转变

  • 展开式操作菜单:将启用/禁用、重设路径、删除三个独立按钮整合为紧凑的展开菜单
  • 动态图标反馈:展开时显示向上箭头,收起时显示三个点,提供清晰的状态指示
  • 智能空间管理:界面空间利用率提升约60%,显著减少视觉噪音
  • 完整功能保留:所有原有功能完全保持,仅改变了触发方式
  • 内联菜单设计:操作选项在视频源下方展开,保持操作的上下文关联性

📐 模板渲染系统升级

增强的跨平台兼容性和智能处理

  • 跨平台兼容性:大幅增强模板渲染在不同操作系统上的兼容性
  • 智能文件名生成:基于模板系统动态生成视频和分页文件名
  • 文件夹结构优化:支持智能去重和文件夹结构自动重组
  • 路径冲突检测:确保生成的文件名唯一性,防止文件覆盖问题

🛠️ 技术架构改进

🔧 API 系统扩展

新增路径管理API

typescript
// 请求结构
interface ResetVideoSourcePathRequest {
    new_path: string;           // 新的基础路径
    apply_rename_rules: boolean; // 是否应用四步重命名
    clean_empty_folders: boolean; // 是否清理空文件夹
}

// 响应结构
interface ResetVideoSourcePathResponse {
    success: boolean;
    source_id: number;
    source_type: string;
    old_path: string;
    new_path: string;
    moved_files_count: number;    // 移动的文件数量
    updated_videos_count: number; // 更新的视频数量
    cleaned_folders_count: number; // 清理的文件夹数量
    message: string;
}

🎭 前端组件架构

新增核心组件

  • reset-path-dialog.svelte:用户友好的路径重设对话框
  • 展开菜单系统:基于状态管理的智能菜单控制
  • 动态图标组件MoreVerticalIconChevronUpIcon 的智能切换

🗃️ 数据库层优化

增强的数据一致性

  • 路径更新时同时更新 video 表和 page 表的路径字段
  • 基于模板系统重新生成完整路径信息
  • 确保数据库与文件系统的完全同步

🎯 用户体验提升

✨ 操作流程优化

路径重设流程

  1. 用户点击视频源旁的"更多操作"图标
  2. 选择"重设路径"选项
  3. 在对话框中设置新路径和相关选项
  4. 系统自动执行文件移动和数据库更新
  5. 显示详细的操作结果统计

界面交互改进

  • 悬停显示操作图标,减少界面干扰
  • 点击即时展开选项,提供直观的操作反馈
  • 语义化图标设计,提高操作识别度

🔒 安全性保障

数据安全机制

  • 四步重命名原则确保文件移动过程中的数据安全
  • 操作前检查目标路径的可用性和权限
  • 失败时的完整回滚机制
  • 详细的操作日志记录

🐛 问题修复与优化

🔧 核心修复

  • 文件名冲突处理:完善文件重命名时的覆盖问题检测
  • 模板渲染兼容性:修复跨平台模板渲染的兼容性问题
  • 路径生成逻辑:优化文件名和文件夹结构的生成算法
  • 状态编辑器:完善互锁逻辑,提升用户体验

🎨 界面优化

  • 视觉层次:优化侧边栏的视觉层次结构
  • 响应式设计:确保在不同屏幕尺寸下的良好显示
  • 动画效果:添加平滑的展开/收起过渡动画
  • 无障碍支持:改进键盘导航和屏幕阅读器支持

📊 性能与兼容性

⚡ 性能提升

  • 批量操作优化:路径重设支持批量文件处理
  • 异步处理:大型文件移动操作采用异步处理机制
  • 内存使用优化:减少大量文件操作时的内存占用

🌐 兼容性增强

  • 跨平台支持:Windows、Linux、macOS 全平台兼容
  • 文件系统适配:支持不同文件系统的特性和限制
  • 路径编码处理:正确处理各种字符编码的文件路径

🚀 未来展望

📈 功能扩展基础

此次更新为后续功能扩展奠定了坚实基础:

  • 批量路径管理:支持多个视频源的批量路径重设
  • 路径模板系统:更加灵活的路径模板定制功能
  • 自动路径优化:基于使用模式的智能路径建议
  • 增量同步:支持路径变更后的增量文件同步

🎯 用户体验持续改进

  • 操作引导系统:为新用户提供操作指引
  • 批量操作界面:支持更多批量管理功能
  • 高级设置面板:提供更精细的控制选项

版本号: v2.7.3
发布日期: 2025年6月23日
更新类型: 功能增强 + 界面优化
兼容性: 完全向后兼容
推荐指数: ⭐⭐⭐⭐⭐

📋 升级建议

强烈推荐升级:此版本引入的路径管理系统和界面优化将显著提升使用体验,特别适合需要频繁调整存储路径的用户。

注意事项

  • 路径重设功能默认启用四步重命名原则,确保数据安全
  • 首次使用建议先在测试环境验证路径重设功能
  • 大量文件移动时建议在低峰时段操作