更新日誌
按版本查閱變化；已停用功能另有歷史歸檔。
這裡記錄各版本當時的變化。歷史條目中的功能可能已經停用，不應直接當作當前操作步驟。 當前正文按 2.0.0（build 50）整理；舊功能的行為、版本和替代方法儲存在歷史功能歸檔。
v2.0.0
以下依據目前 2.0.0 build 50 的程式碼與介面整理；版本號不代表已在下載管道發布。
- 微信帳號支援全部遷移或僅媒體拆分遷移，資料庫與設定可保留本機；切換方式前需完整還原。
- 支援加密 APFS 目標，為新資料卷宗獨立設定密碼，可選儲存到本機鑰匙圈；未儲存時需手動解鎖。
- 增加外接磁碟應用索引排除與大小快取重新整理，減少重複搜尋入口，並能核對快取時間。
- 新增「任務中心」，統一查看應用、資料、工具和自選目錄任務，支援加入背景、暫停、繼續、取消及歷史管理；資源衝突的任務排隊處理。
- 總體進度改為包含各階段的估算，目前目錄單獨顯示準備、掃描、複製、驗證、切換和收尾；多目錄任務不再用總體百分比代替目前階段。
- 異常處理區分重試、稍後處理和保留舊副本；應用異常另提供明確確認的結束任務及不做內容驗證的強制回遷。
- 新增整塊外接磁碟退出入口，先暫停自動掛載再請求 Finder 退出；重新插入裝置後恢復自動掛載。
- 資料遷移或遷回期間，更新後的原生 macOS 啟動入口會提示等待，減少誤開啟；不能涵蓋直接啟動真實應用等其他方式。
- 目標磁碟能力提示說明無法儲存的應用檔案屬性，可從提示開啟對應說明頁；普通應用與容器掛載遷移的儲存要求分別說明。
- 調整資料掃描和小檔案複製的並行讀取，保留內容驗證、入口切換前檢查與安全清理；不承諾所有儲存上的固定提速。
- 延續遷移與手動簽名分離、外接磁碟儲存官方原包，以及所有系統停用登入自動重簽的方式；補齊新增介面的多語言提示。
操作說明：任務中心 · 異常恢復 · 退出外接磁碟 · 啟動保護
v1.9.1（開發階段記錄）
以下保留先前 1.9.1 build 31 開發階段的變更記錄，這些行為已由 2.0.0 延續：
- 應用資料列表預設隱藏不可遷移的鎖定結構，可開啟“顯示鎖定目錄結構”檢視原因；狀態統計支援篩選，個人目錄快捷入口單獨標識，不再計入應用資料大小或提供遷移操作。
- 遷移進度分別顯示準備、複製、校驗和收尾等階段。複製百分比到達 100% 後，仍需等待整次操作完成；長時間沒有進展時會顯示最後活動資訊。
- 資料遷移與手動重簽名分開，遷移不再自動附帶簽名操作。
- 手動重簽前的完整官方原包自動儲存到外接磁碟可見的
AppPorts Backups資料夾，附中英文說明；無需選擇新位置，沒有合適外接磁碟時在修改正式應用前停止。內建磁碟應用操作時仍需臨時空間。 - 舊內建磁碟有效原包在條件滿足時自動遷出，冗餘原包和失效舊記錄按核驗結果清理；仍有恢復價值或來源不明的材料繼續保留，外接磁碟離線不視為備份丟失。
- 簽名選單隨狀態變化：已重簽的應用保留“恢復原始簽名”，隱藏重複重簽入口；恢復官方狀態後重新顯示符合條件的重簽操作。
- 所有 macOS 版本停用開機自動重簽名，並移除常駐設定卡。開啟 AppPorts 時處理舊登入任務，僅清理失敗時顯示重試。
- 加強複製核驗和容器結構保護，在切換或清理前再次檢查資料狀態。
- 保留經核對的原始應用恢復材料，區分“簽名已替換”與“簽名待檢查”，透過修復面板處理舊遷移。
- 修復官方原包驗籤失敗後仍可能繼續重簽的問題；校驗失敗或超時會停止。改進簽名中斷後的恢復，避免已撤回的操作被背景繼續提交，或對已完成操作重複重簽。
相關內容：遷移資料 · 簽名原包 · 升級與修復 · 舊版自動簽名歸檔
v1.9.0
- 容器資料預設採用掛載遷移：符合條件的資料進入未加密 APFS 專用卷，接到原目錄，保留應用簽名。
- 預設限制沙盒應用重簽，保留需要確認風險的經典模式，並提供舊簽名檢查、完整備份與修復入口。
- 增加準備狀況和遷移前檢查，說明權限、安裝位置、外接磁碟格式、加密及空間要求。
- 改善登入和插盤後的資料接回，核對真實掛載位置；等待時間仍取決於磁碟和系統授權。
- 完善還原、備份和清理失敗後的處理，改進資料目錄樹、行內操作、彈窗、本地化及專案支援入口。
- 當時在 macOS 27 上停用登入自動重簽；1.9.1 開發版進一步在所有系統停用。
檢視 v1.9.0 釋出。當時保留的遷移後重簽與早期登入任務行為現已歸入歷史功能說明。
v1.8.0
新功能
- 新增自定義本地掃描目錄：「Mac 本地應用程式」標題欄新增「+」按鈕，可新增額外的本地應用掃描目錄。適用於 JetBrains Toolbox、Steam 等將應用安裝在非
/Applications目錄的工具。新增的目錄會持久儲存，並自動監控檔案變化（#48）。 - 新增 Stub Portal 版本自動同步：外接硬碟上的應用透過 App Store 更新後，本地 Stub Portal 的版本資訊會自動同步更新，並重新整理 macOS Launch Services 快取，「開啟方式」選單不再顯示舊版本號（#50）。
- 新增工具目錄識別：支援 Gradle（
~/.gradle）、Android 開發資料（~/.android）和 Flutter/Dart Pub 快取（~/.pub-cache）（#49）。 - 新增目錄遷移：可在「目錄遷移」標籤中新增任意使用者資料夾，將大型專案、模型、素材庫或工具快取遷移到外部儲存，並支援接回和還原（#54）。
- 新增受保護應用遷移預警：遷移 App Store 應用或 root 歸屬應用前，會提示這類應用可能因權限不足無法自動刪除或替換，並建議先透過 Finder 手動遷移後再建立連結（#55）。
改進
- 應用掃描效能最佳化：每個應用的 Info.plist 讀取次數從 7 次降低到 1 次（透過記憶體快取），整體掃描速度顯著提升。
- 掃描超時保護：codesign 子程序新增 10 秒超時，避免大型應用簽名檢查卡死導致掃描掛起。
- 目錄體積計算安全上限：遞迴計算應用體積時新增 50 萬檔案數量上限，防止 Electron 等超大應用包無限遍歷。
- 掃描過程可追蹤：掃描迴圈新增逐應用 TRACE 日誌，便於定位掃描卡在哪個應用。
- 資料目錄掃描精準匹配：修復 bundle ID 字尾提取邏輯，過濾 app、com、org 等通用詞彙，避免誤匹配系統容器目錄導致掃描變慢。
- 工具目錄接回檢測更完整：本地工具目錄缺失但外部儲存規範位置仍有受管目錄時，會顯示「待接回」；切換外部儲存會自動重新整理工具目錄狀態。
- 本地化與無障礙完善：應用/資料目錄/自定義目錄狀態、排序與篩選標籤、設定開關和狀態徽章會更穩定地跟隨當前語言，並提供更明確的輔助功能標籤。
- 應用體積改為會話級快取，減少重新整理後重新顯示「計算中」或體積丟失的情況（#55）。
- 資料目錄遷移回滾更安全：建立連結前先把本地源目錄改名為隱藏安全備份；建立連結或清理備份失敗時會盡量保留本地備份和外部副本，避免兩端資料同時丟失（#54）。
修復
- 修復 Trae 等應用掃描極慢的問題 — bundle ID 中的通用字尾
app導致~/Library/Containers/下大量不相關目錄被誤掃描。 - 修復外接硬碟應用透過 App Store 更新後，本地 Stub Portal 版本資訊不更新、「開啟方式」選單顯示舊版本的問題。
- 修復點選重新整理按鈕不會觸發 Stub Portal 版本同步的問題。
- 修復資料目錄接回或規範化時可能把外部普通檔案當作目錄處理的問題；現在會拒絕普通檔案並保留原檔案。
- 修復多行彈窗正文在部分語言下回退顯示中文的問題，並補全俄語介面翻譯；Stub Portal 的「外部儲存未連線」系統彈窗也會按系統語言顯示（#55）。
v1.7.0
新功能
- 新增「待遷出」狀態：當本地真實應用版本高於外部儲存中的同名應用時，AppPorts 會標記為「待遷出」，提示可將本地新版遷移到外部儲存並替換舊副本。
- 新增資料遷移重簽名確認：遷移應用容器內資料前，可選擇是否在遷移完成後自動對關聯應用執行 Ad-hoc 重簽名，以降低容器資料遷移後應用無法識別資料、提示異常或啟動異常的風險（#44）。 此處記錄舊版行為，自動簽名流程現已停用，見歸檔。
介面改進
- 頂部工具欄重排：應用頁和資料目錄頁切換按鈕改為更緊湊的圖示 + 文字樣式，減少空間佔用。
- 資料目錄頁操作欄最佳化：「工具目錄 / 應用資料」切換、遷移後重簽名開關、恢復原始簽名按鈕和重新整理按鈕統一放入頂部工具欄。 此處記錄舊版行為，自動簽名流程現已停用，見歸檔。
- 應用狀態徽章新增「待遷出」，方便識別本地版本高於外部舊副本、可以遷出替換的應用。
- 資料目錄遷移重簽名確認彈窗完成本地化，標題、正文和按鈕會跟隨當前語言顯示。 此處記錄舊版行為，自動簽名流程現已停用，見歸檔。
改進
- 應用遷移安全策略增強：外部目標已存在時，僅在目標被識別為 AppPorts 管理的舊入口、舊遷移殘留，或當前應用處於「待遷出」狀態時，才會自動清理並繼續遷移。
- 資料目錄恢復校驗增強：不再使用目錄大小接近作為自動恢復依據，必須完整匹配 AppPorts metadata 後才會自動接回或恢復。
- 應用資料掃描更穩定：快速切換應用時，舊掃描任務結果不會覆蓋當前選中應用的資料目錄列表。
- 管理員命令和 AppleScript 轉義增強：路徑包含引號、反斜槓、空格或中文時，Finder 刪除和管理員修復權限命令會更安全地處理。
- 本地化完善：修復切換語言後部分幫助內容、提示彈窗和資料遷移確認內容仍顯示中文或翻譯不完整的問題，並補齊所有支援語言的相關翻譯（#43）。
修復
- 修復資料目錄遷移可能將外部真實目錄誤判為可恢復目標的問題。
- 修復應用遷移時可能錯誤刪除外部同名真實應用的問題。
- 修復外部舊 AppPorts portal / 舊遷移殘留無法被穩定識別和清理的問題。
- 修復路徑包含特殊字元時 AppleScript 或管理員命令可能構造錯誤的問題。
- 修復應用資料遷移流程中，背景遷移或遷移後重簽名可能讀取到已切換應用的問題。 此處記錄舊版行為，自動簽名流程現已停用，見歸檔。
- 修復「待遷出」狀態未在應用列表中顯示狀態徽章的問題。
v1.6.2
- 新增：開機自動重簽名功能。每次使用者登入時，自動對簽名已失效的已遷移應用執行 Ad-hoc 重簽名，無需手動操作。預設開啟，可在設定中關閉。 此處記錄舊版行為，自動簽名流程現已停用，見歸檔。
- 改進：Stub Portal 改用原生 Mach-O 二進位制啟動器替代舊版 bash 指令碼，修復透過 Finder 雙擊關聯文件無法開啟外部應用的問題（#42）。
- 改進：最佳化關於頁佈局，內容區域改為可滾動佈局，解決視窗尺寸不足時內容被截斷的問題。
- 修復：原生 Stub Portal 被誤識別為普通本地應用的問題。
- 修復：遷回本地時無法正確清理原生 Stub Portal 的問題。
- 修復：連結回本地時應用殼被當作完整應用處理的邏輯漏洞。
- 修復：AutoResignInstaller 安裝失敗時靜默成功的問題。
v1.6.1
- 修復：資料目錄遷移後的自動重簽名現在會正確簽名外部真實應用，而非本地殼（Stub Portal）。 此處記錄舊版行為，自動簽名流程現已停用，見歸檔。
- 修復：重簽名和簽名恢復操作現在會正確解析已連結應用的真實路徑。
- 修復：已連結應用的「已重簽名」狀態檢測現在能正確識別外部真實應用的簽名狀態。
- 最佳化：日誌輸出增加結構化錯誤碼和關聯路徑資訊。
v1.6.0
- 遷移後的應用不再顯示快捷方式箭頭角標。
- 自動更新應用遷移後，不再因更新破壞外部副本。
- 新增應用簽名管理功能，解決遷移後出現「已損壞」提示的問題。
- 外部儲存拔出後，應用列表會以紅色狀態提示「孤立連結」。
- macOS 15.1+ 使用者可直接將 App Store 應用安裝到外部儲存。
- 資料目錄遷移更安全：防止誤遷移系統目錄，中斷後可自動恢復。
- 掃描和大小計算更快，列表不再反覆跳動。
- 複製檔案到外部儲存更穩定，不再因中斷報錯。
- 應用狀態標籤重新設計，資訊更豐富，點選可檢視詳情。
- 應用列表重新整理後不再丟失選中狀態，資料目錄支援樹形展示。
- 最佳化介面細節，包括搜尋、排序、分組卡片和圖示載入等。
- 新增火星文語言選項。
- 更新自動化測試。
v1.5.5
- 支援 macOS 12 及以上的作業系統
- 新增火星文語言
v1.5.0
- 新增 macOS 15.1+ App Store 應用外接安裝支援
- 新增自動重簽名功能（資料目錄遷移後自動執行） 此處記錄舊版行為，自動簽名流程現已停用，見歸檔。
- 新增
LocalizationAuditTests本地化審計測試 - 改進 Stub Portal 的 Info.plist 生成邏輯
- 修復部分應用遷移後 Launchpad 圖示丟失的問題
v1.4.0
- 新增資料目錄樹形檢視
- 新增工具目錄識別（30+ 種開發工具）
- 新增診斷包匯出功能
- 改進自更新檢測（Chrome、Edge 等自定義更新器）
- 修復遷移中斷後的自動恢復機制
v1.3.0
- 新增資料目錄遷移功能
- 新增程式碼簽章管理（備份/恢復原始簽名）
- 新增 Sparkle 和 Electron 應用自動檢測
- 改進鎖定遷移保護（
chflags uchg） - 修復 Finder 中角標顯示問題
v1.2.0
- 新增 Stub Portal 遷移策略（替代 Deep Contents Wrapper）
- 新增 iOS 應用遷移支援（Mac 版 iOS 應用）
- 改進批次遷移效能
- 修復部分應用還原後無法啟動的問題
v1.1.0
- 新增多語言支援（20+ 種語言）
- 新增應用套件目錄遷移（如 Microsoft Office）
- 改進外部儲存離線檢測
- 修復 Deep Contents Wrapper 策略的符號連結穿透問題
v1.0.0
- 首個正式版本
- 支援應用遷移至外部儲存（Deep Contents Wrapper / Whole App Symlink）
- 支援應用還原和連結管理
- 支援 FolderMonitor 實時監控檔案系統變化