ShichiZip 是一款专为 macOS 打造的 7-Zip 衍生压缩包工具，其中的**一键智能解压（Smart Quick Extract）**功能会自动挑选最合适的解压目标位置，并智能去除重复的顶层文件夹，让新手也能零配置、无脑解压。本文带你弄明白它的判断逻辑与各种使用入口。

为什么需要智能解压？

日常解压时，你是否遇到过这些烦恼：

• 文件散落一地：压缩包内有多个顶层文件，全倒进当前目录，把文件夹弄得一团糟；
• 套娃目录：解压后出现项目/项目/文件这样的重复嵌套，多套了一层没用的文件夹；
• 同名冲突：目标位置已经存在同名文件夹，解压直接失败或文件被覆盖。

ShichiZip 的智能解压把这三件事全部自动化了：它先扫描压缩包内容，制定一套"解压计划"，再执行解压，全程无需你手动指定任何参数。

三种入口：在哪里触发一键智能解压

智能解压是 SmartExtractRunner.swift 中的共享逻辑，以下入口都会调用它：

相关实现可参考 AppQuickActionHandler.swift 与 LaunchOpenHUDController.swift。

自动选择目标位置的判断逻辑

智能解压的核心在计划函数 plan(for:archiveItems:eliminateDuplicates:)。它会统计压缩包内所有条目的"顶层名称"，然后按以下规则决策：

举个直观的例子：下载了photo-pack.zip，里面只有一个叫photo-pack的文件夹：

photo-pack.zip └── photo-pack/ ├── a.jpg └── b.jpg

智能解压会识别出"顶层文件夹名 == 压缩包名"，于是直接生成photo-pack/目录并剥离重复前缀，最终就是干净的：

photo-pack/ ├── a.jpg └── b.jpg

多了一层没用的嵌套就这样被消除了。

去重前缀：什么时候会剥掉顶层文件夹？

"去除重复顶层文件夹"由eliminateDuplicates选项控制（默认开启），在解压对话框中对应「排除重复的根目录」复选框，见 ExtractDialogContentController.swift 与本地化文案 App.strings。

真正的判断逻辑在 ArchiveItem.duplicateRootPrefixToStrip 中，只有同时满足这些条件才会剥除前缀：

1. 压缩包包含多个顶层条目；
2. 所有条目路径中、位于目标文件夹名之前的那一层目录，名称完全一致；
3. 剥除后不会把某个条目变成"悬空"的单个文件冲突。

只要有一个条目的结构不符合预期，就会放弃剥除，按原路径解压——宁可保留原样，也不破坏结构。

同名位置已存在时：自动加后缀而不是覆盖

当你想解压的目标位置已经被占用时，ShichiZip 会自动寻找一个可用的唯一名称。这段逻辑在 FileManagerUniqueDestination.swift 中：

• 目标不存在 → 直接使用该位置；
• 目标已存在 → 依次尝试名称 1、名称 2、……，直到找到空位；
• 因此多次解压同一个压缩包，会得到photo-pack/、photo-pack 1/、photo-pack 2/等互不干扰的目录，绝不会误覆盖旧文件。

解压完成后的贴心收尾

计划执行完毕后，SmartExtractRunner 还会做两件小事：

• 自动定位结果：在 Finder 中自动选中（或打开）刚刚解压出的目标位置，不用手动去找；
• 可选清理：根据设置可把源压缩包移入废纸篓，保持下载目录清爽。

写在最后

ShichiZip 把"解压到哪里、要不要套娃、重名怎么办"这三个常见麻烦全部内置成了默认行为：自动建同名文件夹、剥离重复顶层、冲突自动加序号。对于新手来说，双击右键「智能快速解压」就够了；想微调行为时，再打开解压对话框按需取消「排除重复的根目录」即可。更多构建与安装方式可参考项目内的 BUILD.md 与 README.md。