Bytesweep 安装 Bytesweep
Bytesweep 使用 Apple Developer ID 签名并通过苹果公证，因此 macOS 打开它时不会出现「无法验证开发者」的警告。在下方选择你的下载 —— 整个过程约一分钟。
我需要哪个文件？
在 macOS 上，DMG 和 ZIP 里装的是完全相同的应用。DMG 会给你那个拖到「应用程序」的窗口；ZIP 更小更快，适合你想自己移动应用的情况。
苹果菜单 → 关于本机。如果 芯片 一行写着 Apple M1、M2、M3 或 M4，就选 Apple 芯片版本。如果写的是 处理器 · Intel，就选 Intel 版本。下错了并不危险，只是运行更慢，或者根本无法启动。
目前还没有 Windows 版本 — 正在开发中。发邮件到 support@bytesweep.app 发布当天我就会通知你。现在购买的授权届时同样适用，无需额外付费。
每个 macOS 版本都使用 Developer ID 证书签名并通过苹果公证。Bytesweep 在这里发布而不是通过 Mac App Store，因为沙盒应用无法扫描整块磁盘，而那正是这个产品的全部意义。
macOS · 从 DMG 安装
熟悉的方式。双击磁盘映像，把一个图标拖到另一个上。
-
打开下载好的 .dmg
双击「下载」文件夹里的
Bytesweep-1.0.1-AppleSilicon.dmg。macOS 会挂载它并打开这个窗口。 -
把 Bytesweep 拖到「应用程序」文件夹
把左边的 Bytesweep 图标拖到右边的「应用程序」快捷方式上。这会把应用复制到
/Applications。双击 .dmg 之后出现的磁盘映像窗口。 -
推出磁盘映像，然后从「应用程序」打开
点击访达边栏中 Bytesweep 旁边的推出箭头，然后从「应用程序」文件夹打开 Bytesweep，而不是从挂载的映像里打开。之后可以删掉 .dmg。
macOS · 从 ZIP 安装
ZIP 没有安装窗口 —— 它只是给你应用本身，由你自己移动。三个步骤。
-
解压
Safari 会自动解压下载内容，所以你可能已经在「下载」文件夹里看到 Bytesweep.app 了。在 Chrome、Firefox 或 Arc 里，双击
.zip一次，macOS 就会把它解压到压缩包旁边。 -
把 Bytesweep.app 移到「应用程序」
打开访达窗口，按 ⇧⌘A 跳到「应用程序」，然后把 Bytesweep.app 从「下载」拖进去。或者选中应用并按 ⌘C，再在「应用程序」里按 ⌥⌘V 来移动它。
如果你更喜欢用终端：
mv ~/Downloads/Bytesweep.app /Applications/ -
从「应用程序」打开它
在「应用程序」文件夹里双击 Bytesweep。下面这个首次启动对话框你只会看到一次，之后再也不会。
macOS 会把带隔离标记的应用放在一个随机的只读位置运行（Gatekeeper 的 App Translocation），而这个路径每次启动都会变。由于 macOS 是 按路径授予完全磁盘访问权限的，授予给被转移应用的权限在你下次打开时会悄悄失效 —— 于是扫描结果不断为空或不完整。先把应用移到 /Applications 才能让权限稳定生效。
首次启动
由于应用已通过公证，macOS 只会在第一次问你一个确认问题 —— 而不是未签名应用会遇到的「无法验证开发者」拦截。
给 Bytesweep 完全磁盘访问权限
macOS 把「邮件」、「信息」、Safari 数据、Time Machine 快照和其他应用的容器都放在权限门后面。没有这个权限，Bytesweep 仍然可以扫描 —— 只是会把那些文件夹报告为零字节，并悄悄漏掉占用你磁盘的很大一部分。
-
打开设置项
苹果菜单 → 系统设置 → 隐私与安全性 → 完全磁盘访问权限。在 macOS 12 及更早版本上，路径是「系统偏好设置 → 安全性与隐私 → 隐私」标签页。
-
打开 Bytesweep 的开关
首次启动之后，Bytesweep 会出现在列表里。把开关打开。如果列表里没有，点击 +，然后从「应用程序」中选择 Bytesweep。
「隐私与安全性 → 完全磁盘访问权限」，Bytesweep 的开关已打开。 -
退出并重新打开 Bytesweep
macOS 只会把新权限应用到新启动的进程。按 ⌘Q，然后重新打开应用并进行扫描。
完全磁盘访问权限只是让 Bytesweep 能够 测量 那些文件夹。扫描、可视化、查重和清理全部在本地进行；应用唯一的网络请求就是授权校验。请参阅 隐私政策。
Linux
两种版本：可在任何地方运行的便携 AppImage，以及面向 Debian、Ubuntu 及其衍生版的 .deb 。
任何发行版。无需安装，无需 root。
chmod +x Bytesweep-1.0.1.AppImage
./Bytesweep-1.0.1.AppImage在 Ubuntu 22.04 及更新版本上，这一步会因为 dlopen(): error loading libfuse.so.2 而中断 —— AppImage 需要 FUSE 2，而 Ubuntu 现在只提供 FUSE 3。要么安装一次，要么不用它运行：
sudo apt install libfuse2t64 # libfuse2 before Ubuntu 24.04
# or, with nothing to install:
./Bytesweep-1.0.1.AppImage --appimage-extract-and-run在 Ubuntu 24.04 及更新版本上，接着会卡在 chrome-sandbox … mode 4755。加上 --no-sandbox，或者查看下面的故障排查条目以保留沙盒。想要菜单项的话，请安装 AppImageLauncher。
在 Ubuntu 上，.deb 是更顺畅的选择 —— 它会安装到 /opt，在那里沙盒辅助程序无需上述任何折腾即可工作。
Debian、Ubuntu、Mint、Pop!_OS。
sudo apt install ./bytesweep_1.0.1_amd64.deb安装到 /opt/Bytesweep 并在「实用工具」下添加启动项。
Linux 没有完全磁盘访问权限的提示 —— 它使用普通的文件权限。以你自己的用户身份运行时，Bytesweep 能看到你能看到的一切。属于 root 或其他用户的文件夹会被报告为不可读，而不是悄悄跳过，因此总计数字仍然诚实。需要 root 的系统工具会在你运行时通过 pkexec 询问你的密码。
如果出了问题
「Bytesweep 已损坏，无法打开。你应该将它移到废纸篓。」
这几乎总是意味着下载内容在传输途中被改动过 —— 企业代理、杀毒软件或重新压缩了归档的文件分享服务 —— 这会破坏代码签名。删掉它，从本站重新下载。如果仍然如此，清除隔离标记并重新打开：
xattr -dr com.apple.quarantine /Applications/Bytesweep.app对于直接从 bytesweep.app 下载的文件，你永远不该需要这条命令。
「无法打开 Bytesweep，因为无法验证开发者。」
你不该看到这个 —— 应用已通过公证。如果出现了，说明这份副本不是来自本站，或者下载不完整。请重新下载。作为一次性处理，你可以右键点击应用 → 打开 → 打开，或者进入「系统设置 → 隐私与安全性」，在关于 Bytesweep 的提示下点击 仍要打开 。
扫描瞬间就结束了，或者整个文件夹显示为 0 字节
两个原因，按这个顺序排查。第一，应用不在 /Applications 中 —— 把它移过去并重新打开。第二，完全磁盘访问权限没开；打开它，然后退出并重新打开应用，因为 macOS 只会把权限应用到新启动的进程。
双击应用没有任何反应
检查你下载的架构是否正确。仅限 Intel 的版本在 Apple 芯片上没有 Rosetta 就无法启动，而 Apple 芯片版本在 Intel Mac 上根本无法启动。苹果菜单 →「关于本机」会告诉你是哪一种；原生版本不需要 Rosetta。
它一直要我输入管理员密码
只有系统工具会要 —— 精简 Time Machine 本地快照、释放非活跃内存以及少数包管理器缓存确实需要 root。macOS 会显示自己的验证提示；Bytesweep 从不会看到或保存你的密码，而普通的扫描和清理从不需要它。
Linux：「dlopen(): error loading libfuse.so.2」
AppImage 通过 FUSE 2 挂载，而 Ubuntu 22.04 及更新版本只提供 FUSE 3，因此在默认系统上缺少这个库。用 sudo apt install libfuse2t64 安装一次即可（在 Ubuntu 24.04 之前这个包叫 libfuse2 —— 改名是随 64 位 time_t 的迁移一起来的）。它可以与 FUSE 3 共存，不会破坏任何东西。
如果你不想安装任何东西，就用 --appimage-extract-and-run运行 AppImage，它会把内容解包到临时文件夹而不是挂载。启动更慢，但没有依赖。
Linux：「The SUID sandbox helper binary … is not configured correctly」
Ubuntu 24.04 及更新版本通过 AppArmor 阻止了非特权用户命名空间。Bytesweep 所基于的 Chromium 更偏好那种沙盒，退而使用一个必须属于 root 且权限为 4755 的辅助程序 —— 这在 AppImage 内部不可能实现，因为 FUSE 是以 nosuid方式挂载的。三种出路，最优先的在前。
改装 .deb。 它会解包到普通文件系统上的 /opt ，辅助程序在那里能获得所需权限，问题也就不会发生。
或者重新允许用户命名空间 并保留沙盒： sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0，若要永久生效，把 kernel.apparmor_restrict_unprivileged_userns=0 写进 /etc/sysctl.d/60-apparmor-userns.conf。这会放松一项系统级的加固设置，请据此权衡。
或者用 --no-sandbox。 运行
最简单，而且立刻就能启动，但这会为该应用关闭 Chromium 的渲染器沙盒。
Bytesweep 自己的数据放在哪里？ ~/Library/Application Support/Bytesweep 快照、设置和还原点在 macOS 上位于 ~/.config/Bytesweep ，在 Linux 上位于 ~/.bytesweep-trial，另外还有一个小的试用标记文件在
。没有任何内容会被上传。
我可以装在多台机器上吗？
卸载
可以 —— 一个 Pro 密钥可在三台设备上激活。在应用内的「授权」界面管理激活，你可以停用不再使用的机器来释放名额。 Bytesweep Bytesweep 是一个自包含的应用包。把
从「应用程序」文件夹拖到废纸篓 —— 这就是全部的卸载过程。
rm -rf ~/Library/Application\ Support/Bytesweep ~/.bytesweep-trial如果还想清除它保存的设置、快照和还原点： sudo apt remove bytesweep 在 Linux 上，.deb 用 rm -rf ~/.config/Bytesweep ~/.bytesweep-trial。
如果你想要回空间，请先清空还原点。 「撤销与还原」会把清理掉的文件在同一卷上保留七天供你撤销。删除应用并不会删掉它们。请在卸载前打开 Bytesweep →「还原」→ 立即清除