Never 文件自由:文件归档流程与桌面开发记录

介绍目录选择、类型筛选、重名处理与文件排除,以及桌面文件归档的实现边界。

适用版本

合并 2023 年 1 月功能介绍与 2 月使用说明,适用原 macOS 版本。

本文目录
  1. 从目录到文件清单
  2. 移动命令与重名处理
  3. 按文件名排除条目
  4. Flutter 桌面交互的实现思路
  5. 项目来源

Never 文件自由是一个用 Flutter 编写的 macOS 文件归档工具。它读取目录、按文件类型筛选条目,再生成移动命令供用户查看和执行。本文记录 2023 年 1 月至 2 月版本的功能与实现经验。

从目录到文件清单

源文件夹和目标文件夹各有独立输入区,支持点击「选择」打开目录选择窗口,也支持把文件夹拖进界面。

源文件夹选好后,点击「检索源文件地址目录」,程序列出目录及其子目录中的文件,并显示文件类型、文件名和路径。用户按类型选择需要归档的文件,再指定目标文件夹。

这一步的结果是一份可查看的清单。文件名和完整路径需要分别保留,因为不同子目录可能出现同名文件;仅凭文件名无法确定实际操作对象。

移动命令与重名处理

旧版点击「操作已选择文件」后,会生成命令行文本并复制到剪贴板。应用本身不执行这段移动命令,实际移动发生在用户将命令粘贴到终端执行之后。

早期版本提供是否保留重名文件的选项。2023 年 2 月的更新改为保留同名文件,并给重名项添加时间戳以作区分。这个规则解决的是生成清单中的命名问题;执行前仍需处理目标目录已经存在的同名文件,不能把时间戳视为无条件避免冲突的保证。

原项目面向 macOS,相关命令格式也按 macOS 编写。旧文章中的命令通过字符串拼接产生,文件路径中含引号等字符时需要额外处理。旧命令输出不适合直接用于重要目录。

按文件名排除条目

检索完成后,在文件列表中右键点击条目,选择「拉黑文件名」并确认,即可把该名称加入排除列表。

Never 文件自由的文件黑名单界面,展示加入时间、文件名和移除入口

这项规则按文件名生效。同一目录树中所有使用该名称的文件,都会被后续检索和命令生成流程排除。它适合反复跳过固定名称的文件,但不能用来区分不同路径下的同名条目。

原版用 sqflite_common_ffi 保存排除记录,表中包含名称、添加时间等字段。持久化后,用户不必在每次检索时重复设置。右上方的「文件黑名单」入口用于查看已有记录,列表中的「移除」用于撤销排除。

Flutter 桌面交互的实现思路

原项目把目录选择、拖入和文件类型筛选分开实现。

功能原项目使用的组件或方式
打开目录选择窗口file_picker 的 getDirectoryPath
接收拖入的文件夹desktop_drop 的 DropTarget
显示文件类别mime 的 MIME 类型识别
保存排除名单sqflite_common_ffi
提交移动操作生成文本,由用户在终端执行

拖入时,onDragEntered 和 onDragExited 改变接收区域的背景,onDragDone 接收路径并更新目录选择。取消目录选择窗口时,返回值可能为空,界面应保留原有选择。

文件系统对象类型与 MIME 类型需要分开判断。lookupMimeType 返回 null 仅表示未识别出 MIME 类型,不能据此认定路径是文件夹。目录识别可以使用 Dart 的 FileSystemEntity.type,并明确是否跟随符号链接。MIME 类型查询、文件系统类型查询

dart
import 'dart:io';

Future<bool> isDirectory(String path) async {
  final type = await FileSystemEntity.type(path, followLinks: false);
  return type == FileSystemEntityType.directory;
}

这里的 followLinks: false 使符号链接保持为链接类型,不会把指向目录的链接当作普通目录接收。

若把文件操作改为应用内执行,可将可执行文件与参数列表分别传给 Process.run,避免把文件路径拼成一整段 Shell 文本。文件移动还要单独处理目标重名、权限、失败结果与跨文件系统等情况。Dart 的 File.rename 在目标文件已存在时会移除目标,并且在部分平台不能跨文件系统移动,调用方式必须与产品的重名策略一致。Process.run、File.rename

项目来源

作者:NeverOuO。功能介绍发表于 2023 年 1 月 14 日,使用说明发表于 2023 年 2 月 15 日。

查看 Never 文件自由源码与历史更新记录

作者:NeverOuO。原载 NeverOuO 个人小站,现收录于云屿来文章与教程。

返回全部文章

把好用的工具分享给朋友

分享

发送链接,让朋友直接打开这个页面。

访问统计

我们统计页面浏览、渠道来源、产品入口点击与分享次数,用于了解产品如何被发现。这项统计不使用用户标识、Cookie 或跨站追踪,也不读取上传文件或表单内容。