Bytesweep 安裝 Bytesweep
Bytesweep 以 Apple Developer ID 簽署並經蘋果公證，所以 macOS 開啟時不會出現「來自未識別開發者」的警告。請在下方選擇要下載的檔案 — 整個過程約需一分鐘。
我需要哪個檔案？
在 macOS 上，DMG 與 ZIP 裡是完全相同的應用程式。DMG 會出現拖曳到「應用程式」的視窗；ZIP 較小也較快，適合你想自己搬移的情況。
蘋果選單 → 關於這台 Mac。如果 晶片 那一行寫著 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 後出現的磁碟映像檔視窗。 -
退出磁碟映像檔，再從「應用程式」開啟
在 Finder 側邊欄點按 Bytesweep 旁邊的退出箭頭，然後從「應用程式」資料夾開啟 Bytesweep — 而不是從已掛載的映像檔。之後 .dmg 就可以刪掉了。
macOS · 從 ZIP 安裝
ZIP 沒有安裝視窗 — 它只給你應用程式，得由你自己搬。三個步驟。
-
解壓縮
Safari 會自動解壓下載項目，所以你可能已經在「下載項目」中看到 Bytesweep.app 。在 Chrome、Firefox 或 Arc 中，點兩下
.zip一次，macOS 就會把它解壓在壓縮檔旁邊。 -
把 Bytesweep.app 搬到「應用程式」
開啟 Finder 視窗，按下 ⇧⌘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 版本在沒有 Rosetta 的 Apple 晶片上無法啟動，而 Apple 晶片版本在 Intel Mac 上完全無法啟動。「蘋果選單 → 關於這台 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： --appimage-extract-and-run，它會把內容解壓到暫存資料夾而不是掛載。啟動較慢，但沒有相依需求。
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 自己的資料放在哪裡？
快照、設定與還原點在 macOS 上位於 ~/Library/Application Support/Bytesweep 在 Linux 上位於 ~/.config/Bytesweep ，另外還有一個小小的試用標記位於 ~/.bytesweep-trial。不會上傳任何東西。
我可以安裝在多台機器上嗎？
可以 — 一組 Pro 金鑰可在三台裝置上啟用。請在應用程式內的「授權」畫面管理啟用狀態，你可以停用不再使用的機器並空出名額。
移除
Bytesweep 是自成一體的應用程式套件。從「應用程式」資料夾把 Bytesweep 拖到垃圾桶即可 — 移除就這麼簡單。
若要一併清除設定、快照與留下的還原點：
rm -rf ~/Library/Application\ Support/Bytesweep ~/.bytesweep-trial在 Linux 上，.deb 請執行 sudo apt remove bytesweep 若是 AppImage 直接刪除檔案，接著執行 rm -rf ~/.config/Bytesweep ~/.bytesweep-trial。
復原與還原會把清理掉的檔案在同一磁碟區上保留七天，讓你可以復原。移除應用程式並不會刪掉它們。請在解除安裝前開啟 Bytesweep → 還原 → 立即清除 ，或刪除該畫面上顯示的還原資料夾。