如何完整移除並重新安裝 Snapzy

部分用戶回報，即使在「系統設定」中開啟了 macOS 權限（螢幕錄製、麥克風、輔助使用），權限依然無法生效。這通常是因為標準移除流程沒有完全清除殘留的 App 資料、快取偏好設定或舊的 TCC 記錄。

從 v1.25.0 更新文章過來的？ 如果 Snapzy 只是在更新到 v1.25.0 後再次要求權限，通常不需要完整移除。請先嘗試重新授權 —— 參見更新到 v1.25.0 後 Snapzy 再次要求權限。只有重新授權無法解決時，再回到本文。

解決方案？使用我們的官方腳本進行完整移除，然後重新安裝。

為什麼需要完整移除？

單純把 Snapzy 拖進垃圾桶並不會清除所有資料。由於 Snapzy 是一款沙盒化 macOS App，其資料分散在多個位置：

沙盒容器 — ~/Library/Containers/com.trongduong.snapzy（沙盒 App 儲存偏好設定、快取與檔案的主要容器）
TCC 權限記錄 — 系統內部資料庫仍會記住舊的授權（或拒絕）記錄
App 偏好設定 — ~/Library/Preferences/com.trongduong.snapzy.plist
快取檔案 — ~/Library/Caches/com.trongduong.snapzy
應用程式支援資料 — ~/Library/Application Support/Snapzy
已儲存的應用程式狀態 — ~/Library/Saved Application State/com.trongduong.snapzy.savedState
HTTP 儲存空間 — ~/Library/HTTPStorages/com.trongduong.snapzy

如果以上任何一項損壞或不同步，你可能會遇到權限開關已開啟但卻未授權，或是首次設定無法正確偵測設定的問題。

步驟 1：完整移除 Snapzy

開啟終端機（你可以在 /Applications/Utilities/Terminal.app 找到，或用 ⌘ + 空白鍵 搜尋「Terminal」），然後執行以下指令：

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/uninstall.sh | bash

如果你已在本地複製 Snapzy 儲存庫，也可以直接在專案根目錄執行 ./uninstall.sh。

移除腳本的功能

這個腳本會進行徹底清理：

終止執行中的 App — 關閉目前開啟的 Snapzy
移除 Snapzy.app 從 /Applications
刪除應用程式支援資料 — 移除 ~/Library/Application Support/Snapzy（暫存的擷取/錄影）
刪除偏好設定 — 移除 com.trongduong.snapzy 的 defaults 與 plist 檔案
清除快取 — 移除 ~/Library/Caches 與 HTTP 儲存空間的資料
移除已儲存的應用程式狀態 — 清除視窗狀態資料
移除 Sparkle 更新資料 — 清除自動更新快取與 defaults
重設 TCC 權限 — 清除 Snapzy 的螢幕錄製、麥克風、輔助使用與輸入監控項目
提示沙盒容器 — 腳本會偵測 ~/Library/Containers/com.trongduong.snapzy，但會提示你視需要用 sudo 手動移除

重要： 腳本執行完畢後，你可能需要登出或重新啟動 Mac，TCC 權限重設才會完全生效。這是 macOS 的要求 — 系統需要重新整理內部權限資料庫。

步驟 2：重新安裝 Snapzy

登出/重新啟動後，選擇以下其中一種方式全新安裝 Snapzy：

選項 A：Shell 腳本（推薦）

curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/v1.25.0/install.sh | bash

將 v1.25.0 替換為 Releases 頁面上的最新版本號。

選項 B：Homebrew

brew tap duongductrong/snapzy https://github.com/duongductrong/Snapzy
brew install --cask snapzy

選項 C：手動下載

前往 Releases 頁面
下載最新的 Snapzy-v<version>.dmg
開啟 .dmg 並將 Snapzy.app 拖曳到 /Applications

步驟 3：授予權限

完成乾淨安裝後，第一次啟動 Snapzy：

螢幕錄製 — macOS 會提示你授予螢幕錄製權限。前往 系統設定 → 隱私權與安全性 → 螢幕錄製，並啟用 Snapzy
麥克風 (選用) — 如果你想在錄影中加入語音，請在提示時授予麥克風權限
輔助使用 (選用) — 如果提示進階功能，請啟用

授予螢幕錄製權限後，macOS 可能會要求你重新啟動 Snapzy — 這是正常的。

疑難排解提示

權限仍然無法運作？ — 確認你在執行移除腳本後已重新啟動。macOS 會積極快取 TCC 權限
出現「App 已損毀」錯誤？ — 這通常發生在較舊的 ad-hoc 構建上。從 v1.25.0 開始，Snapzy 已通過 Apple 公證，不應再出現此錯誤。如果仍遇到，請前往 系統設定 → 隱私權與安全性，在 Snapzy 的訊息旁點擊**「仍要開啟」**
Homebrew 版本過舊？ — 執行 brew update && brew upgrade snapzy 以取得最新版本

快速參考

以下是完整流程的整理：

# 步驟 1：移除
curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/master/uninstall.sh | bash

# 步驟 2：重新啟動 Mac，然後重新安裝
curl -fsSL https://raw.githubusercontent.com/duongductrong/Snapzy/v1.25.0/install.sh | bash

如果完整重新安裝後仍遇到問題，請在 GitHub 上開啟 Issue — 我們很樂意協助！