Tubearchivist项目文件大小单位转换功能实现解析

背景介绍

Tubearchivist作为一个开源的媒体管理工具，在处理视频文件时经常需要显示文件大小信息。传统的文件大小显示方式存在二进制（Binary）和公制（Metric）两种单位制式，这对不同背景的用户可能造成理解上的困扰。

功能需求分析

项目团队决定在用户设置中增加文件大小单位转换选项，主要实现以下目标：

1. 将单位选择功能从临时界面迁移至用户设置页面
2. 在用户配置中新增文件大小单位设置项
3. 统一项目中所有文件大小显示逻辑
4. 确保整个应用中的文件大小显示一致性

技术实现方案

后端实现

后端采用以下技术方案：

1. 在用户配置对象中新增file_size_unit字段
2. 支持两种单位制式：
   • binary：二进制单位（KiB、MiB、GiB等）
   • metric：公制单位（KB、MB、GB等）
3. 默认值由系统自动设置
4. 通过标准用户配置API进行更新：

   POST /api/user/me/
   {"file_size_unit": "binary"}
   

前端实现

前端需要完成以下工作：

1. 将单位选择器移至用户设置页面
2. 在所有显示文件大小的位置使用统一的humanFileSize格式化函数
3. 从用户配置中获取useSI标志并应用到所有大小显示位置

实现细节

单位制式说明

• 二进制单位(Binary)：

  • 基于1024进制
  • 使用KiB、MiB、GiB等单位
  • 更适合计算机系统内部处理

• 公制单位(Metric)：

  • 基于1000进制
  • 使用KB、MB、GB等单位
  • 更符合日常使用习惯

格式化函数设计

项目中应实现统一的humanFileSize函数，该函数需要：

1. 接收原始字节数作为输入
2. 根据用户配置的单位制式选择适当的转换方式
3. 自动选择最合适的单位级别
4. 返回格式化后的字符串

应用场景

该功能将应用于以下场景：

1. 视频文件信息展示
2. 频道聚合数据统计
3. 存储空间使用情况
4. 下载进度显示
5. 任何涉及文件大小显示的位置

版本发布

此功能已在Tubearchivist v0.5.1版本中实现并发布，为用户提供了更灵活、更个性化的文件大小显示方式。

总结

通过实现文件大小单位转换功能，Tubearchivist项目提升了用户体验的一致性，允许用户根据自己的偏好选择最适合的单位制式。这种细心的设计考虑体现了项目团队对用户体验的重视，也展示了良好的技术实现能力。