常見問題
安裝與授權
AppPorts 需要什麼權限？
AppPorts 需要完全磁盤訪問權限來讀取和修改 /Applications 目錄。首次啓動時會引導授權，也可在系統設置 → 隱私與安全性 → 完全磁盤訪問權限中手動添加。
支持哪些 macOS 版本？
最低支持 macOS 12.0 (Monterey)。macOS 15.1（Sequoia）及以上版本額外支持 App Store 應用安裝到外置硬盤並原地更新。
應用遷移
遷移後應用打不開怎麼辦？
- 確認外部存儲已連接且可訪問
- 檢查應用狀態徽章：如果是「孤立鏈接」，說明外部應用已丟失，需手動解除鏈接
- 如果出現「已損壞」提示，右鍵點擊應用選擇「重簽名」
- 如果仍無法解決，在外部應用庫中選擇「遷回本地」
出現「已損壞」提示怎麼辦？
macOS 的代碼簽名機制檢測到應用包結構變更。解決方法：
- 在 AppPorts 中右鍵點擊應用
- 選擇「重簽名」
- AppPorts 會自動備份原始簽名並執行 Ad-hoc 重簽名
詳細機制請參閱重簽名與崩潰防護。
外部存儲拔掉後應用會不會崩潰？
本地入口（Stub Portal）會嘗試調用 open 打開外部應用。如果外部存儲未連接，應用無法啓動，但不會崩潰。重新連接外部存儲後即可正常使用。
遷移後能不能更新應用？
取決於應用類型：
| 應用類型 | 能否自動更新 | 說明 |
|---|---|---|
| 原生應用（無自更新） | ✓ | 正常更新 |
| Chrome、Edge（自定義更新器） | ✓ | 更新安裝到本地，AppPorts 檢測到版本差異後標記「待遷移」 |
| Sparkle / Electron 應用 | ✗ | 鎖定後阻止應用內更新，需通過 AppPorts 遷回本地後更新 |
| App Store 應用（macOS 15.1+） | ✓ | App Store 可在外置硬盤原地更新 |
| App Store 應用（macOS <15.1） | ✗ | 需手動二次遷移 |
App Store 應用怎麼遷移到外置硬盤？
macOS 15.1+：在 App Store 設置中開啓「下載並安裝大型 App 到獨立存儲盤」，選擇與 AppPorts 相同的外置存儲。
macOS <15.1：在 AppPorts 設置中開啓「App Store 應用遷移」，手動遷移後應用更新需二次遷移。
遷移速度慢/卡住怎麼辦？
- 遷移至 100% 時可能會停頓一至兩秒，這是在創建本地入口
- 大型應用（如 Xcode、Adobe）遷移時間較長屬於正常
- 如果長時間卡住，檢查外部存儲連接是否穩定
- USB 2.0 接口速度較慢，建議使用 USB 3.0 及以上或 Thunderbolt
數據目錄遷移
數據目錄遷移後應用數據會不會丟失？
不會。AppPorts 採用符號鏈接策略：先將數據完整複製到外部存儲，確認複製成功後才刪除本地原始目錄。任何步驟失敗都會自動回滾。
什麼情況下數據目錄遷移可能導致應用異常？
- 使用文件鎖或 SQLite WAL 日誌的應用
- 跨符號鏈接時擴展屬性可能丟失
- 同一 Team 下多應用共享的 Group Containers 目錄
如何恢復遷移的數據目錄？
在 AppPorts 的數據目錄管理界面，選擇已遷移的目錄，點擊「恢復」即可。AppPorts 會刪除符號鏈接，將數據從外部存儲複製回本地。
其他
AppPorts 會收集我的數據嗎？
不會。AppPorts 完全離線運行，不收集、不上傳任何用戶數據。日誌文件保存在本地 ~/Library/Application Support/AppPorts/ 目錄下。
如何反饋問題？
請在項目 Issues 頁面提交。建議附帶診斷包（菜單欄 → 日誌 → 導出診斷包）以加快問題定位。