FileSnap FileSnap

快速上手

1. 添加扫描位置（⌘O）

   点工具栏「添加位置」，在系统文件夹选择器里选中要观察的文件夹（例如 ~/Projects）。FileSnap 会用安全作用域书签记住这个授权——书签严格只读，应用不会改动里面的任何文件。如果新位置包含在已有位置之内，应用会提示包含关系，避免两张独立快照被误加总。

2. 创建第一张快照（⌘R）

   点「创建快照」，FileSnap 开始扫描：显示已扫描数量、当前路径与耗时，可暂停、继续或取消（取消会回滚本次记录）。工具栏可按需切换 轻量／均衡／快速 资源级别，默认「均衡」。扫完即得到这条位置的基准记录。

3. 文件变化后再扫一次

   过一段时间（构建了几次项目、导出了几批素材）再点一次「创建快照」。也可以点右侧菜单选「增量扫描」（⇧⌘R）：依据系统变更记录复用未变的子目录，更快得到一张同样完整的新快照。

4. 选择基准开始对比

   在对比选择器里选任意两张记录：较早的自动作为基准。页面默认打开「增长来源」——新增文件、已有文件变大、跨路径移入分开统计，按下一层路径聚合出最大的 8 项；切到「路径明细」可看逐条路径的前后大小与变化状态。

5. 逐层下钻定位到文件

   点增长来源里的任一目录即可进入下一层，面包屑随时返回上级；点击文件行末按钮直接在 Finder 中定位。行内的图表按钮（或右键「查看历次快照」）打开路径历史，看同一路径每次扫描的大小变化。

6. 导出或管理

   位置菜单里可「导出路径明细 CSV」（当前浏览、搜索与筛选条件下的全部记录）；「快照历史 → 管理快照库」查看数据库占用、按数量或天数批量清理旧记录，最新两张与当前对比始终受保护。

常用功能详解

资源级别

工具栏三档：轻量（单路读取、后台优先级，适合一边工作一边扫）、均衡（默认，最多两路）、快速（最多四路，想尽快出结果，磁盘活动与耗电会增加）。级别只影响读取并发与调度让步，三档统计口径完全一致；本次扫描固定开始时的级别。

排除路径

位置菜单 →「排除路径」：按相对路径精确排除（如 Projects/demo/build），也可以在明细里右键任意路径直接加入。规则对子项整体生效、区分大小写，保存后从下一次扫描生效，历史快照不受影响；被排除的范围会出现在扫描覆盖报告里，不会被当成「删除」。

扫描覆盖报告

对比页可打开覆盖报告：权限不足、主动排除、其他磁盘卷、特殊文件、扫描中消失、读取失败分类列出，支持搜索、分页与复制路径。凡是没有读到的范围，相关差异都会标注「未完整扫描」——FileSnap 不猜测没读到的内容。

快照库管理

「快照历史 → 管理快照库」：顶部是整个库的磁盘占用与记录数；展开存储详情可看数据库与日志文件长度、可复用空闲页，并主动回收空间。清理旧记录前先预览、确认后执行，事务保证与预览一致，删除快照不会影响原文件。

进阶用法

两种大小口径

默认展示分配大小（磁盘实际占用的块），可切换逻辑大小（文件内容长度）。稀疏文件、压缩文件与云端占位文件的逻辑长度可能远大于实际占用；分配大小不等于整盘已用空间，也不等于删除后可回收的容量，可能与系统「储存空间」显示不同。

移动与改名识别

对比时 FileSnap 按卷身份、inode 与出生时间识别一对一移动/改名：路径明细保留各路径增减并注明原/新位置，增长摘要剔除搬动的原有大小——移动后增大只计真实差额，不会把「挪了个位置」当成「涨了」。

CSV 报告

导出的 CSV 为 UTF-8 带 BOM，Excel 可直接打开；每行包含当前/基准快照身份、时间、统计口径、浏览与筛选条件，以及路径类型、前后大小、覆盖与去重信息。读取不完整的范围不输出推断的增减数字。

遇到没覆盖到的问题？请前往技术支持页面获取帮助。