扫描 · 第一双眼睛
The Scanner
选择一个目录，Luma 在后台递归遍历，统计总大小、文件数与目录数，按图片、视频、文档、代码、压缩包等类别聚合占用。扫描过程实时显示进度，随时可以取消。单个文件出错不会中断整场扫描。
实时进度 · 可取消 · 容错
v0.4.1 已发布 · MACOS + WINDOWS
看得见的，才谈得上理解。
Luma — Local insight for your digital world.
从桌面、下载目录或任意文件夹开始。Luma 扫描不改原文件，再让你在同一目录下分析空间、预览和管理文件。面对堆积的资料，先看整理清单、调整分类，确认后再移动。文件、索引和操作日志都留在这台电脑。
- 项目 / 代码 174 GB
- 影音 143 GB
- 文档 82 GB
- 下载 61 GB
- 其他 52 GB
* 示意数据，用于说明界面呈现方式，非实测统计。
两件事，做扎实
先看清，
先看清，
再理解。
Luma 不急着做一个无所不知的助手。它的第一双眼睛是扫描器，把文件系统看清楚；第二个大脑才是理解，让这些文件真正对你有意义。
理解 · 第二个大脑
The Understanding
扫描结果落进本地 SQLite，重启后依然在。Luma 把零散的文件整理成可查询的空间地图：按名称、分类、大小、修改时间检索并分页排序，识别开发项目，对比同一目录最近三次扫描的容量与分类变化，还能跨页批量选择、复制路径或导出清单。
本地索引 · 检索过滤 · 项目识别 · 历史对比 · 批量导出
透明的发现，而非武断的删除
帮你看见，
帮你看见，
被忽略的角落。
每一条发现都告诉你命中数量、总大小和判定依据，并留一个查看明细的入口。Luma 只报告，不替你做删除的决定。
大文件
默认高于 1 GiB 的文件，阈值可在界面调整。哪些东西悄悄占了最多的地方，一目了然。
长期未整理
超过 180 天未修改的文件，并说明「修改时间不等于最近使用」，让你自己判断去留。
开发体积
识别 node_modules、target、dist 这类常见的开发产物目录，只提示，不建议自动清理。
压缩与安装包
按扩展名聚合压缩包与安装包，提示这里可能是一片值得复查的可释放空间。
重复文件候选
由你主动发起后，Luma 才读取候选文件内容并在本机计算 BLAKE3 哈希，确认内容完全相同的文件组。
项目与历史
识别常见开发项目，并比较同一目录最近三次扫描，查看总容量、文件数和分类变化。
找得到，才用得上
检索与批量，
检索与批量，
都在本地索引上。
扫描建立的本地索引不只是用来看的。你可以在其中检索、筛选，选中一批文件，把它们的路径导出——全部只读，不碰原文件。
检索 · 在索引里找
Search & Filter
按文件名或路径搜索已索引的文件，并叠加分类、扩展名、大小范围、修改时间等条件筛选。结果分页返回、可排序，也能直接在文件管理器中定位。检索只针对当前扫描快照，不触碰未索引的目录，也不读取文件内容。
名称/路径 · 多条件筛选 · 分页排序批量 · 选中后导出
Bulk Selection
搜索结果支持跨分页勾选、复制路径和导出 CSV，不会直接修改文件。需要重命名、移动、复制或移至废纸篓时，必须进入文件管理视图并明确触发对应操作。
跨页选择 · 复制路径 · 导出 CSV
v0.4.1 · 从看清到归位
桌面再乱，
桌面再乱，
也能有序归位。
先选目录，再扫描。空间分析与文件管理共用顶部目录栏，切换视图保留位置；更换目录后重新扫描，让你始终知道正在处理哪一批文件。
先预览，再整理
Preview before moving
桌面与下载整理可细分截图、文档、表格、演示文稿和安装包；也支持按类型、日期或文件名关键词归类。预览中能排除文件、改分类名称和单个文件去向，同名目标可跳过或自动编号。
默认保留已有文件夹与隐藏文件 · 确认后移动看文件，也看清操作
Browse, preview and manage
图片、文本和 PDF 首页可在本地预览。文件管理支持重命名、移动、复制和移至废纸篓；耗时操作显示等待状态并禁止重复提交。重命名、移动和整理记录可跨重启撤销，复制和废纸篓操作暂不提供应用内撤销。
本地预览 · 明确反馈 · 持久化撤销
选好目录，循序整理
从文件，
从文件，
到行动。
从只读扫描开始，在同一目录下查看空间或管理文件，生成整理预览，再决定哪些文件需要移动。每一步都有明确的对象和反馈。
-
Scan
选择桌面、下载或其他目录，只读扫描元数据。
-
Understand
在空间分析与文件管理之间切换，查看分类、文件和内容预览。
-
Remember
索引保存在本机，整理前先核对分类、目标路径与同名冲突。
-
Act
确认后才移动文件，重命名、移动与整理可通过本地记录撤销。
隐私是地基，不是选项
你的文件，
你的文件，
始终只关你的事。
-
扫描不改原文件，整理前预览确认普通扫描读取路径和元数据，并保存本地索引。移动前核对文件数量与目标，规则整理先预览再确认；查重、预览、重命名、复制和撤销均由你主动触发，系统目录受保护。
-
本地索引，占用可管理索引保存在本地数据库，不上传。仅保留最近一次成功扫描的完整索引，历史转为统计摘要；在「本地存储」查看占用、回收空间或确认清理索引，原文件与撤销记录保留。
-
不越界扫描默认不跟随符号链接，不跨越文件系统边界；整理源目录必须位于当前扫描范围内。
-
更新联网，文件留在本机应用启动或手动检查更新时会连接 GitHub Releases，下载更新也需要联网。该过程不上传文件内容、扫描索引或操作日志，安装前校验更新产物签名。
你选择哪个目录，Luma 就只看哪个目录。理解你的数字世界，不等于把它交出去。
原生的分量
为桌面而生，
为桌面而生，
快而克制。
Luma 用原生技术栈构建：繁重的遍历交给 Rust 在后台完成，界面保持轻盈流畅，安装包也不臃肿。
Rust Scanner Core
文件遍历与聚合在 Rust 后台阻塞任务中进行，进度节流上报，不占用界面线程，也不把整份文件清单一次性搬进内存。
Tauri Native Shell
基于 Tauri 2 打包为原生桌面应用，体积小、启动快，权限受控 —— 每一项能力都对应明确的系统授权。
React Interface
React 19 + TypeScript 构建界面，内置简体中文与英文，按系统语言初始化并可手动切换。统一目录工作区、键盘操作与窄窗口布局，让分析和文件管理衔接自然。
诚实的进度
一步一步，
一步一步，
把地基打牢。
v0.4.1 在「看见、复查、整理」之上，补齐本地索引空间管理、移动确认与 macOS 安装引导。我们继续完善平台验收，再探索更深的本地理解能力。
-
扫描原型Milestone 1
选目录、看进度、可取消
选择目录后看到实时的扫描进度与摘要，随时可以取消，坏文件不影响整体结果。
-
可恢复Milestone 2
SQLite 索引与重启恢复
扫描结果落盘为本地索引，重启后仍能查看最近一次成功扫描的完整结果页。
-
可用版Milestone 3
重复候选、项目识别与历史对比
在透明发现之上增加内容重复确认、开发项目识别和同目录历史比较，并提供可安装的桌面版本。
-
检索与多语言Milestone 4
索引检索、批量导出与中英文界面
按名称、分类、大小、时间检索并分页排序；跨页批量选择后复制路径或导出 CSV。搜索保持只读，文件修改在文件管理中主动触发；应用界面内置简体中文与英文。
-
管理与整理Milestone 5
统一工作区、整理预览与撤销 v0.4.1
文件管理和规则整理已发布，v0.4.1 新增本地存储管理、移动前确认与 macOS 安装界面。macOS universal 与 Windows x64 构建通过；此前已确认一次 v0.3.2 → v0.4.0 应用内升级成功，完整设备矩阵和 Windows 真机回归继续完善。
-
远景Beyond
语义层与本地 AI 助手
在数据可靠、持久稳定之后，再让模型基于结构化的本地信息回答问题，而非直接读取整个文件系统。
给你的电脑一张地图
让计算，
让计算，
回归从容。
Luma 0.4.1 提供 macOS 通用版（Apple Silicon 与 Intel）和 Windows x64 安装包。已有版本可通过应用内检查更新；v0.3.2 → v0.4.0 已有用户升级成功。安装包尚未启用 Apple/Windows 平台代码签名或公证，Windows 真机验收仍待补齐；首次打开的放行步骤见下方说明。
首次安装会看到系统安全提示，放行一次即可
macOS
- 拖入「应用程序」后首次启动，若提示「无法验证开发者」，先点「完成」。
- 打开系统设置 → 隐私与安全性，在「安全性」区域点「仍要打开」并验证密码。
- 之后可正常启动，不会重复拦截。
Windows
- 安装时若 SmartScreen 提示「Windows 已保护你的电脑」，点「更多信息」。
- 点「仍要运行」继续完成安装。
- 浏览器提示下载风险时，选择保留文件。
放行一次后即可正常使用；macOS 13 及更早版本也可在应用图标上右键选「打开」。