Luma开源文件整理工具上线，支持预览确认与操作撤销，macOS与Windows双平台可用

一款名为 Luma 的开源文件整理工具近日在 GitHub 上线，其设计哲学直指本地文件管理中的核心痛点：用户既需要清晰洞察磁盘空间构成，又不愿将文件操作权完全交给自动化工具。开发者 Rain9 将其定位为“本地优先”的空间分析与整理工具，强调“把‘看清楚’和‘动手’放进同一个工作区，中间隔着一层预览和确认，动手之后还能反悔”。

Luma 的技术实现围绕“安全可控”展开。扫描阶段仅读取文件元数据（名称、扩展名、大小、修改时间），不跟随符号链接，且单个文件权限不足时仅计入错误数，不影响整体任务。扫描结果以 SQLite 数据库存储，支持 FTS5 + BM25 的本地全文搜索——用户可输入如“大于 1GB 的最近一年的 PDF”这类自然语言条件，系统将其解析为确定性 SQL 查询（如 size_bytes > 1073741824 AND mtime >= ? AND extension = 'pdf'），全程不依赖大模型，确保可解释性与可测试性。

重复文件检测采用两阶段策略：先按文件大小筛选候选集，再对候选文件计算 BLAKE3 内容哈希，仅当哈希一致时才归为一组。值得注意的是，Luma 不自动删除文件，仅提供去重建议，并精确计算“可节省空间”为每组去重后的净释放量（例如两个 10MB 重复文件仅计 10MB 节省，而非 20MB）。

真正体现其差异化设计的是“规则整理”工作流。用户可选择预设方案（如桌面、下载目录整理），或自定义按类型、修改日期、扩展名等规则分类。整个流程分为三步：首先生成完整的 dry-run 计划（仅预览，不触碰文件系统）；其次在预览清单中可排除个别文件、修改分类名、处理同名冲突（跳过或自动编号）；最后确认执行。所有成功操作均写入 SQLite 操作日志，支持任意时刻撤销——撤销记录持久化存储，即使重启应用仍有效。

为避免自身成为磁盘负担，Luma v0.4.1 新增了“本地存储管理”功能：用户可在应用内查看索引占用空间、回收空闲空间、清理历史扫描数据。策略上仅保留最近一次完整扫描的索引，旧扫描降级为统计摘要；单次扫描写入设有 256 MiB 预算上限，超限时回退至上次成功结果。

工程层面，Luma 采用前端 React 19 + TypeScript + Vite，后端由 Rust 编写并通过 Tauri 2 框架集成。核心模块分工明确：scanner.rs 负责遍历与分类，database.rs 管理 SQLite Schema 与 FTS5 索引，search.rs 实现搜索抽象与条件解析，duplicates.rs 处理重复检测，file_ops.rs 封装文件操作与撤销状态机，organizer.rs 支撑规则整理逻辑。扫描任务在 Rust 阻塞线程中运行，文件按 500 条一批写入数据库，前端通过事件节流（约 100ms 一次）接收进度更新，避免内存溢出。

与同类工具相比，Luma 的关键优势在于“零信任”设计：无后台常驻进程、不上传任何数据、无 AI 介入、无网络请求。这使其特别适合对隐私敏感的用户，如开发者、设计师或处理机密文档的专业人士。目前提供 macOS Universal（Apple Silicon + Intel）与 Windows x64 安装包，界面支持中英文切换。

在文件管理工具生态中，Luma 填补了一个微妙但重要的空白。传统工具如 WinDirStat、DaisyDisk 侧重“可视化分析”，但缺乏安全的操作闭环；而部分自动化整理工具（如某些商业清理软件）则因直接修改文件引发用户顾虑。Luma 通过引入“dry-run → 确认 → 撤销”三段式流程，将操作风险降至最低，同时保持高效——用户无需在多个窗口间切换，所有决策均可在统一界面完成。

值得关注的是，该工具的出现也折射出本地化、隐私优先工具链的复兴趋势。随着云存储普及与 AI 工具泛滥，越来越多用户重新重视本地数据主权。类似思路已在其他领域显现：如 OrangeLen（另一款 macOS 文件预览工具）聚焦于 AI 生成内容的快速浏览，强调“只读展示，不执行自动化”；而 Linux 社区长期存在的大文件审计脚本，则从命令行层面提供轻量级清理建议。Luma 的价值不仅在于功能本身，更在于它用现代工程方法（Rust 性能、SQLite 可靠性、Tauri 跨平台）重构了这一经典需求。

目前 Luma 已开源（MIT 协议），GitHub 仓库持续更新。其作者在技术博客中坦言，开发过程中踩过不少坑，例如 FTS5 external-content 索引与触发器同步的事务一致性问题、Windows 下长路径处理的兼容性、以及撤销状态机在跨会话持久化时的边界情况。这些细节虽未在产品界面呈现，却构成了工具稳定性的基石。

对于普通用户而言，Luma 提供了一种更安心的磁盘整理方式：不再需要在“手动拖拽耗时费力”与“一键清理心惊胆战”之间二选一。而对于开发者，其模块化架构与清晰的工程实践也具备参考价值——尤其在构建需高可靠性的本地应用时，如何平衡性能、安全与用户体验，Luma 给出了一个务实的答案。

工具已上线官网 luma.raingpt.top 与 GitHub 仓库，用户可直接下载体验。未来版本计划支持更多文件类型识别、自定义规则模板及更精细的冲突解决策略，但核心原则——“先预览，能反悔”——预计将持续不变。