第 11 章：軟體下載與安裝指南¶

感謝您對 ATBCmder 的關注與支援！我們提供兩種便捷的安裝方式，滿足不同的使用偏好與場景需求。

1. Mac App Store 商店版（推薦）¶

這是最推薦普通使用者選擇的安裝方式。ATBCmder 現已正式上架 Mac App Store！ 透過官方商店下載，可享受全自動後臺靜默更新、原生 macOS 應用沙盒安全保護以及最深度的系統級整合。

• Mac App Store 官方下載：在 Mac App Store 中下載 ATBCmder

2. 獨立 DMG 安裝包下載¶

若您無法訪問 Mac App Store，或偏好直接使用獨立分發版本，我們同時提供支援 Universal 雙架構（Apple Silicon ARM64 與 Intel x86_64）原生構建的 DMG 磁碟映像安裝包。

• DMG 安裝包直接下載：點選下載最新版 ATBCmder DMG 映象（Universal 通用雙架構：Apple Silicon 與 Intel x86_64）

注意：透過 DMG 首次開啟應用時，macOS 安全機制可能會提示“無法開啟或未驗證的應用”。只需前往 系統設定 > 隱私與安全性，點選“仍要開啟”即可正常執行。

⚠️ 授予“完全磁碟訪問許可權”¶

ATBCmder 作為專業級雙面板檔案管理器，需要訪問並管理您的全盤檔案。為保證全部功能順暢執行，請按照以下步驟授予許可權：

1. 點選螢幕左上角 Apple 圖示（），開啟 系統設定（較早的 macOS 版本中為“系統偏好設定”）。
2. 在左側或主選單中找到並點選 隱私與安全性。
3. 向下滾動列表，點選進入 完全磁碟訪問許可權（Full Disk Access）。
4. 在應用列表中找到 ATBCmder 並開啟右側開關。若列表中未顯示，可點選下方的 + 號按鈕手動新增 。
5. 系統將提示您輸入 Mac 登入密碼或輕觸 Touch ID 確認更改。

3. 版本更新日誌 (Release Notes)¶

2.7.0 (2026-11-09)¶

• MacBook 觸控板雙指滑動歷程導覽：原生支援 MacBook 觸控板雙指橫向滑動（Swipe Gesture）進行目錄歷程的「返回」與「前進」導覽，具備智慧防手震與位移臨界值判定，帶來極致流暢的 macOS 原生級手勢互動體驗（Fixes #185, #195）
• 分頁鎖定機制與相鄰分頁智慧開啟：全面對齊 Total Commander 分頁鎖定模式，支援「鎖定此分頁（禁止變更目錄）」與「鎖定但允許變更目錄（重設回鎖定路徑）」，並於標題列以星號 * 標示（Fixes #180, #189）；新增分頁預設緊鄰目前使用中分頁插入開啟，大幅提升多路徑並行作業效率（Fixes #177, #191）
• 拼音任意字元分界比對與「僅顯示相符項目」篩選模式：快速搜尋拼音比對引擎重大升級，支援在檔案名稱的任意漢字分界處比對拼音首字母及完整拼音，擺脫前綴比對限制（Fixes #182, #194）；新增「僅顯示相符檔案/目錄」獨立篩選模式選項，可在即時游標跳轉與純淨篩選結果間自如切換（Fixes #178, #192）
• 顯示功能表擴充與佔用空間快速鍵人體工學最佳化：「顯示（Show）」功能表新增「顯示所有檔案 (Cmd+F10)」與「顯示自訂檔案/副檔名 (Cmd+F11)」命令（Fixes #181, #193）；將「計算佔用空間」預設全域快速鍵調整為更符合人體工學與傳統習慣的 Alt+Shift+Return，避免與系統熱鍵衝突（Fixes #179, #196）
• App Store 沙盒雲端硬碟與終端機呼叫安全加固：最佳化 OneDrive 及其他雲端硬碟在 macOS App Store 沙盒下的安全作用域書籤（Security-Scoped Bookmarks）偵測與授權流程（Fixes #187, #188）；沙盒環境下終端機呼叫改為安全預先填入命令（Pre-fill）而不自動執行（Fixes #183, #190）；修復終端機多視窗重複開啟與 zsh 工作階段 touch 權限報錯；修復封裝時 Dock 圖示回退問題並完善圖示空值降級保護（Fixes #184, #186）

2.6.0 (2026-11-08)¶

• 語意化檔案圖示系統與共用單例快取：全新設計精美的語意化 Lucide 圖示集，涵蓋程式碼、文件、媒體、資料、設定、壓縮檔等豐富檔案類型（Fixes #166, #176）；引進高效的共用單例圖示快取機制，大幅降低高頻捲動與大目錄瀏覽時的記憶體與 CPU 負載，使檔案面板在面對數萬級檔案時依然保持極致順暢
• 核心模組深度解耦重構與架構升級：徹底重構拆分單體龐大模組，將 fs_model.py 拆解為 fs_entry、fs_loaders、fs_icons，將 file_panel.py 拆解為表格檢視、標籤頁及標籤列獨立元件，將 main_window.py 拆解為 Mixin 擴充集，將目錄同步對話方塊按元件解耦（Refs #130, Fixes #165, #175）；程式碼架構清晰度與可測試性大幅提升，徹底消除循環參照與隱式耦合
• 檔案操作與資料安全防線全方位加固：全方位修復 CopyMoveWorker、StreamCopyWorker、ProcessIOEngine、NetworkTransferWorker 及提權輔助處理程序中的不可分割覆寫、符號連結移動防丟失、同源/重疊路徑覆蓋驗證及資料夾衝突保護（Fixes #109-#112, #122, #157, #159-#161, #170, #171）；文字編輯器採用暫存檔加不可分割取代安全儲存，封存解壓縮前嚴格驗證 7z/ZIP 符號連結防止越界跳脫並避免覆蓋目錄當機（Fixes #164, #174）
• 全非同步 UI 回應與極端情境效能最佳化：重型相依套件與非關鍵模組改為延遲隨選載入，啟動效能顯著躍升（Fixes #107）；階層連結導覽、目錄樹載入、VFS 掛載及縮圖產生全部剝離至背景執行緒，徹底消除介面停頓（Fixes #124, #126, #127, #150, #151）；目錄大小計算器支援即時取消與精準計數（Fixes #158, #168），傳輸佇列與進度快顯視窗支援 Esc 即刻中斷結束（Fixes #163, #173）
• 檢視模型一致性、選取保留與安全網路防護：排序、快速篩選與扁平檢視切換時嚴格透過實體識別錨定並保留游標與選取狀態，修復扁平檢視軟上限與導覽失敗歷程復原（Fixes #113, #114, #128, #162, #172）；機密認證資訊安全儲存防誤抹除，防範 PBKDF2 資源耗盡與 OAuth 回呼 XSS（Fixes #119-#121, #148）；SFTP 嚴格驗證已知主機公鑰（Fixes #117, #138），外部關聯執行實施嚴格的 Shell 參數跳脫防命令插入（Fixes #115, #136）

2.5.0 (2026-11-05)¶

• 文字編輯器工具列圖示化重構與快速鍵暫留提示：文字編輯器（F4）頂部工具列全面重構，將原本單調的純文字按鈕升級為現代精緻的「向量圖示 + 語意 Tooltip」版面配置（Fixes #105, #106）；各功能按鈕（儲存、復原、重做、尋找、取代、編碼切換等）於暫留提示中清楚呈現操作名稱與鍵盤快速鍵，大幅提升版面緊湊度與編輯效率
• 目錄歷程導覽與標籤列功能表快速鍵明確指引：檔案面板「返回」與「前進」歷程導覽按鈕 Tooltip 中明確標註對應的 Alt+Left 與 Alt+Right 鍵盤快速鍵，並實現全量 31 種語言在地化；路徑標籤列快顯功能表各項常用操作（新增標籤頁、關閉標籤頁、關閉其他標籤頁、複製標籤頁等）右側直觀呈現全域快速鍵，引導使用者順暢掌握全鍵盤流操作
• Python 解譯器結束終結安全防護與防當機加固：於 Python 解譯器結束終結階段（sys.is_finalizing()）引入安全短路機制，避免在模組與 C 擴充釋放過程中重複執行 QThread 背景執行緒等待、復活及事件篩選器取消註冊邏輯；徹底防範關閉應用程式時偶發的 SIGABRT 或底層 C++ 物件提前解構導致的致命異常
• 特權橋接系統清理處理程序掃描穩定性加固：最佳化應用程式處理程序與套件中繼資料掃描判定邏輯，徹底防止單一權限受限或非標準應用程式 Bundle 導致整體處理程序狀態誤判，避免將閒置應用程式（Idle）誤標為未知狀態；放寬處理程序列舉與 Plist 解析逾時時間，保障高負載與慢速磁碟環境下的清理可靠性

2.4.6 (2026-11-03)¶

• 系統狀態與清理工具 App Store 沙盒深度適配：在嚴格受限的沙盒環境下，系統狀態面板自動啟用雙模回退機制，透過 NSWorkspace 呈現執行中的 GUI 應用程式，提供高傳真圖示與前景狀態指示（Fixes #102, #104）；徹底解決沙盒下瀏覽器快取深層目錄周遊受阻與未知大小統計異常，準確累加已知容量並回饋真實清理狀態（Fixes #101, #103）
• Finder 顏色標籤規格化與 31 種語言深度在地化：引進標籤規格化與在地化解析引擎（get_canonical_tag_name 與 localize_tag_name），準確剝離系統內部序號；於全量 31 種語言中完整編譯收錄 macOS 7 種標準色彩標籤（紅、橙、黃、綠、藍、紫、灰），檔案面板標籤列暫留 Tooltip 智慧呈現對應語言的標準名稱
• 檔案面板批次反選與搜尋互動細節打磨：支援按住 Shift 鍵按一下連續反選/取消選取檔案，消除複選只能向外擴展的侷限（Fixes #96, #99）；檔案搜尋對話方塊開啟時預設自動聚焦檔案名稱模式輸入框，一鍵直達鍵盤檢索（Fixes #94, #98）；修復搜尋面板 Enter 鍵二次觸發打斷檢索的缺陷（Fixes #95, #97）；最佳化磁碟機下拉方塊與 Tab 標籤列的版面配置間距
• CI/CD 建置與測試工作流程現代化遷移：將 GitHub Actions 雲端 macOS 測試與發布工作流程執行器平滑升級至官方最新的 macos-latest，確保最新系統環境相容與建置相依鏈敏捷性，嚴格保留自我裝載 x86_64 驗證矩陣

2.4.5 (2026-10-31)¶

• 未儲存密碼網路連線智慧彈窗與工作階段憑據保持：全新內建網路驗證對話方塊（NetworkPasswordDialog），支援密碼明暗文切換與儲存至系統鑰匙圈選項；增加憑據預檢調度機制（resolve_or_prompt_network_credentials），於切換或導覽至未記住密碼的 SFTP / FTP / SMB / WebDAV 連線時智慧攔截並彈窗引導輸入，取消則安全回復；修復連線管理員儲存設定時意外清空臨時密碼的問題，並於目前應用程式工作階段（VFSSessionCache）內安全保持憑據，免去重複輸入
• 網路 VFS 虛擬面板全欄點擊排序與指示器雙向同步：為 VfsTableModel 完整實作 sort() 排序方法，與本機檔案清單對齊相同的欄位結構（名稱、副檔名、大小、修改時間、屬性），確保網路目錄在排序時始終置頂；開啟表頭欄位點擊排序手勢（sectionsClickable），並使表頭排序箭頭與主選單及快速鍵排序指令保持雙向即時同步
• 網路連線架構全面安全稽核、錯誤處理與進階設定：徹底消除 VFSSessionCache.disconnect 與 VFSManager.remove_from_cache 於中斷連線重入時的相互遞迴隱患；WebDAV 串流上傳明確補齊 Content-Length 標頭，保障 HTTP 回應安全關閉並於取消時主動清理暫存未完成檔案；加固下載、上傳、刪除與 Samba 掛載工作執行緒的狀態檢查與例外上下文保留；規格化網路連線設定中的進階選項（SSL/TLS 憑證驗證、被動模式 PASV 等），全量同步更新 31 種語言在地化字典

2.4.4 (2026-10-31)¶

• QThread 背景執行緒生命週期安全加固與 GC 崩潰防護：安裝全域 QThread 生命週期安全防護（以 PEP 442 物件復活機制為基礎），徹底消除背景執行緒（目錄載入、路徑探測、檔案傳輸）於記憶體回收（GC）時因 C++ 物件提前解構引發的 SIGABRT（QThread: Destroyed while thread is still running）致命崩潰；強化 FileSystemModel 等模組的結束清理流程（safe_qthread_cleanup），確保所有子執行緒安全退出
• macOS Carbon 免權限全域快速鍵引擎與 Option 鍵規格化：重構 macOS 全域快速鍵架構，全面切換為 Carbon RegisterEventHotKey 原生系統級 API，無需於系統設定中授予「輔助使用」（Accessibility）隱私權限即可開箱即用全域快速鍵喚醒；徹底解決 Option 鍵（⌥）與系統死鍵、重音字元及特殊符號輸入的軌跡衝突，規格化輔助按鍵對應並於偏好設定中提供即時擷取與衝突偵測
• macOS 封裝 Dock 高畫質圖示呈現修復：修復封裝為 .app 應用程式時在 Dock 中圖示邊緣模糊失真的問題；透過 AppKit 原生介面直接注入高傳真圖示資產，杜絕 Qt 內部優先降取樣至低解析度導致的畫質減損
• macOS 12 (Monterey) 相容性恢復與依賴條件最佳化：精細化調整 PySide6 依賴版本限制，嚴格恢復並維持對 macOS 12 (Monterey) 的向下相容支援，保障跨版本系統的平穩運作與純淨部署

2.4.3 (2026-10-30)¶

• 全新「最近變更檔案」進階檢索工具：全新內建「最近變更」系統工具與原生特權橋接指令，支援依時間範圍（1小時、24小時、7天、30天等）與最小檔案大小過濾（>1MB、>10MB、>100MB、>1GB）；融合 macOS Spotlight 中繼資料引擎快速預熱候選項目，檢索結果支援即時篩選、按兩下或右鍵直達實體路徑，並支援一鍵將所選檔案批次移至垃圾桶
• 剪貼簿貼上衝突安全重新命名與雲端儲存加固：貼上檔案或目錄偵測到同名衝突時自動追加序號後置詞（如 name (1).ext）安全重新命名，徹底防範資料意外覆蓋（Fixes #92）；修復 Google Drive 虛擬磁碟機探測資料遺失問題（Fixes #87, #91）；打包鏈路完整配套 Dropbox 雲端儲存相依套件（Fixes #90）
• 全量 31 種語言在地化深度稽核與專業術語統一：全面稽核並精修全量 31 種語言翻譯，徹底修復 PO 檔案換行反斜線跳脫與語法解析錯誤，根除殘留機翻（Fixes #88, #93）；統一定義檔案管理程式專業術語並完善 Dropbox 等設定引導說明，重新編譯全語言二進位 .mo 字典
• macOS 原生互動細節打磨與視覺精細化：全應用程式確認對話方塊按鈕順序統一遵循 macOS 規範（「是/確認」置於「否/取消」之前）；檔案面板標籤列移除上下冗餘髮絲線，凸顯卡片膠囊通透質感；修復 macOS Dock 圖示因 Qt 降取樣導致的模糊缺陷，增強表頭欄位分割線對比度，修復檔案載入執行緒退出的偶發競爭

2.4.2 (2026-10-26)¶

• 系統清理工具全面升級與按應用程式細粒度清理：全新支援按應用程式或按檔案分類雙維度清理系統快取與日誌，支援樹狀展開並自由勾選清理目標（Fixes #85）；分組大小精準累加並排除未知項目，加入掃描權限預檢與執行狀態視覺化回饋（已清理 0 B、失敗原因及 Tooltip 提示）；工具列與右鍵新增「在 Finder 中顯示」與「在面板中定位」快捷操作，支援按兩下直接定位實體路徑；視窗大小與磁碟空間分析器像素級對齊
• atbsys 特權橋接與檔案系統度量安全加固：同步特權清理與應用程式解除安裝安全校驗機制（Fixes #80），嚴格核對預定計畫並保護個人與共用資料，沙盒環境下安全儲存計畫檔案；加固磁碟用量統計與系統監測，完善硬連結、APFS 寫入時複製（CoW）複製卷預檢、CPU 取樣與指令執行逾時保護
• macOS 打包建置流程與跨架構驗證加固：統一各模組版本號與建置中繼資料，鎖定適配 macOS 12+ 的 Go 編譯器與 Qt 執行時期基準線；修復 Universal 橋接二進位在 x86_64 宿主上的 Mach-O 切片驗證邏輯，規避簽章解析中的填補位元組異常，建置或簽署失敗時嚴格熔斷中斷打包流程
• 檔案面板互動增強與多語言介面精細潤色：徹底修復刪除檔案或目錄重新整理後面闆焦點與捲軸跳回頂部的缺陷（Fixes #81, #82），智慧就近順移焦點並完美記憶捲動位置；為檔案面板右鍵快顯選單所有操作統一配置清晰的語意向量圖示（Fixes #83, #84）；修復 CSV 檢視器儲存格狀態列與介面生硬術語翻譯，全量更新 31 種語言本地化字典

2.4.1 (2026-10-24)¶

• 表頭互動重構與 macOS Finder 風格欄位分割線：檔案清單水平表頭引入全新的 DividerHeaderView，在各欄之間繪製縱向置中的半透明髮絲分割線，無需生硬邊框即可清晰界定欄位邊界；全面重構 HeaderResizeCursorController 表頭欄寬調整控制器，設定 8px 寬容命中容差並徹底隔離排序點擊與拖曳手勢，消除調整時的游標閃爍與手勢衝突，大幅提升拖曳手感
• 設定對話方塊樣式防抖與取消邏輯效能最佳化：最佳化偏好設定對話方塊結束與復原邏輯，僅當使用者在即時預覽中實際變更了主題時才在按一下「取消」後執行樣式回復；徹底避免未修改主題時觸發全應用程式樣式表重新解析與全部控制項重複重繪計算，消除對話方塊關閉時的介面瞬間卡頓
• 高畫質應用程式圖示更新與 macOS 打包建置鏈路修復：更新更清晰精緻的官方 Logo 影像資產；修復 macOS DMG / PKG 及 Nuitka 生產建置指令碼中對 AppIcon.icns 的誤清除問題，支援從 .app/Contents/Resources/ 標準路徑自適應探測圖示，確保安裝打包後 Dock 與 Finder 中的高畫質圖示完整呈現

2.4.0 (2026-10-23)¶

• 檔案面板標籤列升級為 macOS 原生卡片式膠囊設計：路徑標籤列全面重構為獨立圓角卡片造型，增加底槽背景與髮絲分割線，修復邊框粗細不一致與邊界裁剪問題；建立雙面板焦點分級指示（現用面板醒目提示藍膠囊，非現用面板中性灰），豐富鎖定標籤、家目錄與搜尋結果等語意向量圖示；統一 28px 高度規格並與磁碟機選擇方塊像素級基準線對齊（Fixes #78, #79）
• 文字檢視器與編輯器中文及多語言編碼智慧識別：全新內建智慧編碼探測模組（encoding_utils），結合 BOM、chardet 機率分析與高頻字元集統計，徹底消除檢視器（F3）與編輯器（F4）開啟 GBK / GB18030 / Big5 / Shift-JIS / EUC-KR 等非 UTF-8 文字時的亂碼問題，保障載入與儲存編碼一致
• 架構深度瘦身與安裝套件體積大幅削減：徹底移除 opencv-python-headless 重型依賴（剝離 70MB+ 依賴包），使用 Pillow 與平台原生 CoreImage 演算法重構影像處理與浮水印消除引擎；清理打包流程中的衍生轉碼動態程式庫（libtesseract、libx265 等），顯著降低 DMG 與 App 安裝套件體積和記憶體佔用
• 核心功能安全稽核與全流程穩定性加固：徹底防範同路徑或跨 VFS 複製同一實體檔案導致的來源檔案意外清空隱患；文字編輯器嚴格保護符號連結原位並完善唯讀權限提示，修復多位元組字元與 Emoji 尋找取代同步問題；增強命令列 cd 相對路徑與特殊字元逸出解析；修復批次重新命名衝突、總和檢查碼取消即時回應、7z 解壓縮穩定性與影像掃描行對齊崩潰

2.3.9 (2026-10-22)¶

• 預設視覺主題精緻化與現代介面體系重構：引入語意化外觀權杖（Semantic Tokens）與對比度排版規範，自動適應系統明暗外觀；恢復經典彩繪圖示與雙面板經典藍色風格，統一直觀清晰的目前列、檔案標記與半透明暫留反白；全尺寸展開預設工具列並支援原生摺疊溢位，升級時安全保留使用者自訂工具列設定；磁碟機選擇列適度加寬，恢復綠色磁碟容量指示條並精準區分未知容量；預設收起語意命令列，書籤彈窗嚴格限定於面板內部，統一底部狀態列與快捷鍵氣泡
• 封存檔案多語言編碼智慧識別與 ZIP 項目擷取：徹底修復非 UTF-8 編碼封存（如 GBK / GB18030 / CP936 等）於壓縮與解壓縮時的中文字元與目錄名稱亂碼缺陷（Fixes #74）；瀏覽與解壓縮 ZIP 檔案時整合智慧內碼探測機制；正式支援直接在 ZIP 虛擬檔案面板中多選項目並執行複製擷取操作
• 目錄同步對話框彈性寬度條件約束與穩定性加固：為目錄同步視窗設定合理的最大寬度限制，防止大量差異檔案比對時表格無限制橫向撐寬破壞介面版面配置（Fixes #76）；加固跨架構（ARM64 / x86_64）及高解析度螢幕下的比對與同步穩定性
• 協助工具 (a11y) 增強與右鍵終端機快捷入口：為主工具列所有操作賦予語意化無障礙名稱並提供完整的鍵盤導覽支援；檔案面板右鍵功能表新增「開啟系統終端機」快捷入口，一鍵直達目前工作目錄；全套最佳化控制項與容量狀態文字同步更新 31 種語言在地化翻譯

2.3.8 (2026-10-20)¶

• 檔案面板互動全面升級與視覺分級：重構檔案列繪製代理，引入半透明暫留反白與圓角邊界，徹底區分滑鼠暫留（Hover）與檔案選取（Selection）視覺樣式（Fixes #72）；最佳化右鍵功能表觸發，消除彈出延遲且右鍵操作不遺失已有選取（Fixes #60）；右鍵捷徑功能表新增「新增檔案」（Shift+F4）與「新增資料夾」（F7）快捷入口，全流程支援 31 種語言（Fixes #61, #70）；路徑切換後自動重設檔案選取狀態，避免跨目錄操作誤觸（Fixes #67）
• 底部命令列 Enter 喚醒系統終端機與路徑導覽增強：於底部命令列輸入任意系統命令後按 Enter，可自動呼叫系統預設終端機（Terminal.app / iTerm2）並於目前工作路徑下立即執行（Fixes #63）；支援直接輸入相對/絕對目錄或 cd 命令無縫切換面板路徑，全面支援空格與特殊字元安全逸出
• 全生命週期深度記憶體治理與系統監控環形緩衝區：通用檢視器（F3）、文字編輯器（F4）及所有強制回應對話框均配置 WA_DeleteOnClose 並於關閉時執行確定性明確解構，根除視窗反覆開啟時的記憶體累積；國際化廣播接入 WeakMethod 避免長生命週期引用循環，解除磁碟分析樹循環依賴並引入 QIcon LRU 快取；系統狀態監控與 AtbSys 橋接引入 120 樣本定長環形緩衝區與就地控制項重用，消除高頻重新整理下的記憶體抖動
• 工具列設定覆寫修復與沙盒狀態列引導對齊：修復於設定選項中編輯中置工具列時可能導致新增按鈕被設定覆寫遺失的問題（Fixes #62）；對齊沙盒完全磁碟存取（FDA）狀態列提示與主設定功能表行為，確保引導一致

2.3.7 (2026-10-16)¶

• macOS 執行階段模組相依性補齊與應用程式結束穩定性加固：補齊平台與日誌模組中缺失的 os、sys 與 traceback 匯入，徹底根除非測試獨立執行環境下觸發的 NameError 隱患；重構主視窗關閉流程（closeEvent），移除多餘的信號斷開邏輯，確保應用程式結束時完全平穩，杜絕偶發 SIGSEGV 區段錯誤
• 完全磁碟存取 (FDA) 引導互動精簡與防禦性回退：最佳化權限引導視窗，在支援原生拖曳授權的環境下智慧隱藏多餘的設定跳轉按鈕，以單一拖曳互動為主要入口，並在偵測到權限生效後即時更新為「已授予完全磁碟存取權限 ✓」狀態；新增健全的防禦性回退機制，在原生拖曳面板呼叫異常時自動還原設定按鈕，保障任何情境下的授權順暢

2.3.6 (2026-10-16)¶

• Nuitka 編譯器鎖定與 Apple Silicon (ARM64) 崩潰根除：在建置與 CI 流水線中鎖定穩定版 Nuitka 4.2.2，徹底規避 Nuitka 4.3 探測機制在 PySide6/Shiboken 下引發的編譯物件懸垂釋放（SIGSEGV / EXC_BAD_ACCESS）；在冒煙測試（smoke_test.py）中新增 Qt 信號槽與編譯器 freelist 記憶體完整性斷言；規範全平台打包腳本參數，確保本機與 CI 環境二進位產物高度一致
• macOS 15 Sequoia 視窗與系統匣生命週期深度加固：重構系統匣視窗還原、啟用（activate_app）與 Dock 列圖示切換邏輯，杜絕 WindowServer 在無頭或測試環境下分派非法 FocusWindowEvent 導致的區段錯誤；妥善隔離並回收 pynput 全域快速鍵監聽執行緒，防止背景執行緒洩漏與 OS 級 CGEventTap 掛鉤懸掛；完善結束清理機制，安全重設剪貼簿以防止靜態 QMimeData 解構異常
• 自動化測試與 CI 流水線效率提升：徹底消除系統匣及主視窗測試在 pytest 結束時的偶發崩潰，完善 Offscreen 平台下的測試適配；最佳化 CI 工作流程，文件更新自動跳過全量打包，顯著提升開發與發布驗證效率

2.3.5 (2026-10-15)¶

• Google Drive 與 Dropbox 雲端儲存原生整合與 OAuth 2.0 授權：全新支援 Google Drive（gdrive://）與 Dropbox（dropbox://）雙雲端硬碟虛擬檔案系統；連線管理員新增雲端儲存專屬設定頁與圖示，支援自訂 Client ID / Client Secret 並提供瀏覽器一鍵式 OAuth 2.0 快捷授權；最佳化串流上傳下載快速通道、儲存配額（Quota）快取與目錄延遲載入機制，連線成功後自動儲存設定
• 鑰匙圈憑證集中安全管理與高強度加密匯入/匯出：整合系統鑰匙圈命名空間，徹底消除啟動時的多餘授權提示，加固授權憑證與授權金鑰的本機持久化；新增連線憑證與密碼的加密匯出/匯入功能，支援設定強密碼加密打包並跨裝置安全移轉；全流程適配 31 種語言互動
• Nuitka 執行穩定性強化與 Zip 串流壓縮最佳化：修復獨立打包環境下偶發的啟動崩潰問題，完善 CI 流水線對獨立打包產物的自動化冒煙測試覆蓋；最佳化封存系統的 Zip 串流壓縮讀寫機制，防止面板重新整理時資料被抹除，增強背景執行緒安全性
• 檔案排序穩定性提升與雲端儲存設定指南更新：修復資料夾優先排序與自然大小寫排序測試中的偶發競爭問題（Fixes #58）；官方使用者手冊第 6 章詳細增補 Google 與 Dropbox 雲端儲存 API 憑證申請、OAuth 組織網域驗證及防警示操作圖文指引

2.3.4 (2026-10-13)¶

• 沙盒權限引導重構與單一按鈕極簡授權：恢復並整合使用者家目錄（~）與 /Volumes 外接儲存的權限授予流程，打造全新的「一鍵授權」工作流程；引入智慧路徑提升機制，自動將深層子目錄存取請求提升至使用者目錄或磁碟機根目錄並持久化安全範圍書籤，徹底消除 macOS 沙盒環境下的重複授權彈窗
• 標準對話框按鈕原生翻譯與 31 語系多語言深化：實現 _GettextQtTranslator 翻譯器，透過 gettext 統一接管並準確翻譯 Qt 標準按鈕（如「是/否/確定/取消/儲存/放棄/套用/關閉/開啟/重設」），自動去除快速鍵加速字元；為偏好設定各分頁（工具列、快速鍵、常用分頁、自動重新整理等）及連線管理員、佇列檢視器等對話框全面補充動態語言重新載入（retranslate_ui）；完善並編譯全部 31 種語言的在地化字典與 .mo 檔案，新增自動化國際化測試案例

2.3.3 (2026-10-10)¶

• 壓縮封存體系全面升級與獨立分別打包：封存對話盒新增「為每個選定項目建立獨立封存檔案」選項，支援一鍵批次將多個選取的檔案或資料夾分別單獨壓縮；針對大檔案（≥1MB）引入串流讀寫進度追蹤，提供平滑精準的百分比進度；支援執行緒安全的檔案衝突處理（覆蓋、略過、自動重新命名），強化批次容錯度並安全處理符號連結與死鏈；同步更新 31 語系翻譯
• 系統匣喚醒與 macOS 全域快速鍵深度加固：完善系統匣喚醒視窗幾何記憶，精準還原隱藏前的位置、尺寸與最大化狀態；系統匣右鍵選單不再干擾主視窗層級；重構 macOS 全域喚醒/隱藏快速鍵，透過虛擬鍵碼規範化 Option 變音鍵並在主執行緒快取按鍵上下文，徹底解決 macOS Sequoia 背景執行緒斷言異常；偏好設定支援即時動態切換最小化至系統匣行為
• 磁碟機選擇器與磁碟容量提示升級：磁碟機工具列全面最佳化，直接呈現原生磁碟卷標（Volume Labels）與硬體磁碟圖示；浮動氣泡提示全面豐富，清晰展示掛載路徑、檔案系統格式、可用空間及總容量統計
• Nuitka 建置封裝體系與自動化冒煙測試：封裝指令碼全量補充 --include-package=atbcmder，徹底根除因對話盒按需惰性載入導致的封裝後執行時期 ModuleNotFoundError；新增無頭 --smoke-test 自動化驗證流程，並在 DMG、App Store 安裝套件與 CI 管線建置後自動執行冒煙測試，確保發行版本零缺陷穩定運作
• 多語言官方產品落地頁全面上線：正式推出現代化官方產品介紹首頁，配備智慧語言路由器（支援繁中/簡中/英/日/韓等多語系流暢切換），全方位展示雙面板雙流操作、原生 macOS 體驗與核心功能矩陣

2.3.2 (2026-10-07)¶

• PySide6 執行時期記憶體深度治理與 macOS 堆積空間主動壓縮：為重型次級對話盒引入惰性代理載入機制（_make_lazy_dialog）與 PEP 562 模組懶匯出，大幅縮減應用程式常駐記憶體；Cocoa 呼叫全量包裹 objc.autorelease_pool()，徹底根除 Finder 顏色標籤輪詢導致的記憶體緩慢堆積；整合 Darwin 原生 malloc_zone_pressure_relief 機制，在閒置與視窗關閉時主動壓縮堆積空間並歸還系統；縮圖並行執行緒限制為 4 個並最佳化圖示快取，全面消除記憶體峰值
• F3 檢視器與 F4 編輯器游標可見性及自動焦點修復：徹底修復開啟檔案檢視器與編輯器時游標遺失、無法直接鍵入的問題，視窗啟用時自動將鍵盤焦點綁定到文字緩衝區；恢復清晰可見的 1px 閃爍游標（caret），解耦檢視器與編輯器的游標配置並支援在通用檢視器中透過快捷鍵 F6（cm_ShowCaret）動態切換游標顯隱
• 資源生命週期加固與說明文件更新：為通用檢視器對話盒配置 WA_DeleteOnClose 屬性，確保視窗關閉時徹底解構並釋放底層圖形資源；同步更新使用者操作指南與說明文件配圖

2.3.1 (2026-10-06)¶

• 沙盒權限引導體驗深度最佳化與智慧視窗避讓：在請求完全磁碟存取權限（FDA）並開啟系統設定時，引導對話盒將自動調整尺寸並智慧停靠於螢幕左側，與 macOS 居中偏右開啟的「系統設定」視窗完美並列呈現、互不遮擋，操作流程更加一目了然
• 清晰步驟指引與權限生效提示：全面重構引導說明文案，提供清晰直觀的 1-2-3-4 步驟指南（清單中尋找或手動新增、開啟開關、關閉設定並重啟應用程式），並突出提醒完全磁碟存取權限需重啟生效，避免疑惑
• 全語言詞典與 31 語系翻譯同步：全面更新專業術語庫（Glossary），重新編譯並同步所有 31 種支援語言的 .po 與 .mo 語言包，確保全球使用者享受精準、友善的引導體驗

2.3.0 (2026-10-05)¶

• macOS Finder 原生色彩標籤與即時同步：深度整合 macOS Foundation API，於檔案清單中呈現原生色彩圓點標籤列；支援按 Finder 原生色彩順序智慧排序，並透過 2 秒視口輪詢實現與系統色彩標籤的毫秒級即時同步；偏好設定提供自適應顯隱開關，顏色名稱全量支援本地化
• 目錄同步功能全方位躍升（cm_SyncDirs）：全面重構目錄同步面板，解決 UI 狀態死鎖並新增獨立同步錯誤報告對話盒（SyncErrorsDialog）；新增一鍵目錄對調、雙向刪除（OP_DELETE_BOTH）、豎線 | 萬用字元排除語法、即時統計、CSV 匯出、選取子選單與「在 Finder 中顯示」；視窗尺寸與欄寬實現持久化記憶
• Apple HIG 毛玻璃互動式豐富提示卡片：全新構建中央提示註冊表架構，引入 80% 半透明毛玻璃卡片（完美自適應 macOS 淺色與深色外觀）；覆蓋工具列、分割列、導覽控制項、底部 Fx 功能鍵列及高頻對話盒，智慧整合 macOS 快捷鍵徽章並抑制重複的原生 Qt 提示
• macOS 快捷鍵規範全契合與衝突自動消除：快捷鍵文案與符號全面契合 macOS 原生約定，功能表與工具列快捷鍵嚴格同步；徹底消除 1 對 1 快捷鍵歷史衝突，並在選項介面、註冊表與 XML 儲存層引入自動去重機制，保障鍵盤流操作的極速響應
• 全介面 31 語系 100% 精修與展示系統擴充：全介面 31 種語言達成 100% 翻譯覆蓋率與複數形式精準校對；通用檔案檢視器（F3）新增「以文字模式開啟」按鈕，長檔名截斷時支援智慧懸浮預覽；展示指令碼擴充涵蓋快速篩選、批次重新命名、透明封存 VFS、目錄同步與樹狀檢視的全景展示

2.2.0 (2026-10-03)¶

• 主工具列視覺與人體工學大升級：主工具列圖示升級至 38px、列高最佳化為 42px，杜絕圖示擠壓變形，在高解析度 Retina 螢幕上帶來更舒適的點擊命中體驗；按鈕圖示全面換裝 Apple HIG 風格的靈動漸層色彩並提升對比度，主工具列與中部分割列尺寸層級更加和諧
• 偏好設定全鏈路貫通與程式碼編輯器設定修復：全面貫通介面字型縮放（Font Zoom）、壓縮封存預設參數、編輯器自動縮排、檢視器文字換行寬度等此前脫節的設定項目；修復內建程式碼編輯器（CodeEditorWidget）製表符寬度（tab_size）與縮排規則，確保配置即時準確載入
• 全域記憶體治理與效能深度最佳化：重構圖示與檔案元資料快取層，針對複雜檢視與重量級元件引入按需惰性初始化；強化元件銷毀與生命週期弱引用管理，消除潛在記憶體流失，確保長時間運行超大目錄瀏覽依然輕快順暢
• 互動對話盒關閉防假死與目錄樹焦點穩定：修復封存壓縮（ArchiveDialog）與檔案分割合併（SplitLinkDialog）關閉時的偶發互動掛起假死問題；在樹狀檢視（Tree View）模式切換與操作時無縫保持目前分頁標籤的鍵盤焦點
• Nuitka 打包體系最佳化與執行崩潰防範：最佳化獨立應用程式與 DMG 打包腳本，顯著降低建置記憶體開銷與安裝包體積；清理編譯參數，徹底消除因測試模組動態載入導致的執行時期崩潰隱患

2.1.0 (2026-10-02)¶

• 磁碟機列與分頁標籤 Apple HIG 全面煥新：磁碟機代號列（Drive Bar）與路徑導覽按鈕深度重構為 Apple 風格無邊框控制項；路徑階層標籤（Breadcrumbs）與檔案分頁標籤升級為 Apple HIG 柔和色調材質（Tonal Surfaces），介面現代質感與操作流暢度全面躍升
• 現代步進器、膠囊提示與分頁元件升級：數值微調方塊（QSpinBox/QDoubleSpinBox）重構為 macOS HIG 一體化內建步進器；引入蘋果風格半透明膠囊浮動提示（Capsule Tooltip）並最佳化為圖示下方智慧對齊；偏好設定分頁與工具列圖示全面適配 HIG 規範
• 雙面板工具列圖示與縮圖圖層最佳化：垂直中部分割工具列新增「使目標面板等於來源面板（cm_TargetEqualSource）」專用圖示；修復縮圖檢視中選取勾選角標（Checkmark Badge）顯示圖層，確保清晰置頂呈現；修復圖片編輯器狀態列縮放按鈕偶發溢出
• 全球 31 種語言本地化與術語全量精修：全面核對並統一 31 種支援語言的介面術語、選單提示及對話方塊文案，徹底消除漏譯與不規範譯名，打造一致、專業、母語級的全球化體驗
• 開發工具鏈與自動化工程最佳化：規範化並引入專案專用多語言擷取與編譯工作流程（atb-python-i18n），最佳化輔助工具權杖解析與測試環境隔離，保障自動化發布流程的高可靠性

2.0.0 (2026-09-28)¶

• 🎉 ATBCmder 2.0 架構成熟與重大里程碑：標誌著全新現代化雙面板檔案管理器架構全面成熟，深度融合經典雙面板高效鍵盤流操作與 macOS 原生體驗，帶來更強效能、極致穩定與現代設計
• 全介面 31 種語言深度全球化本地化：權限引導流程與原生「拖曳即授權」懸浮面板（Drag-to-Grant Panel）現已支援全部 31 種語言的純正母語本地化；重新編譯全量 .mo 字典檔並加入自動化多語言回歸測試，為全球使用者提供無障礙使用體驗
• 完全磁碟存取「拖曳即授權」極致體驗：基於原生 Cocoa NonactivatingPanel 打造獨立拖曳面板，無需啟動視窗直接拖曳圖示至系統設定即可快速授予完全磁碟存取權限（FDA）；引導彈窗自動貼靠系統設定，授權成功後支援從容「結束並重新開啟」，徹底消除焦點干擾與強制倒數
• 雙面板操作流與人機互動全方位打磨：支援按兩下中部分割列/工具列一鍵 5:5 黃金比例重設面板寬度或高度；主工具列預設整合系統狀態監控膠囊並提供快速關閉按鈕與全域右鍵配置選單；深度完善資料夾混排模式（Mixed）確保全欄位即時生效
• 現代文字編輯與高效能系統維護套件：內建編輯器全面支援 macOS 標準 Home/End 與 Smart Home 智慧首字元跳轉；底層深度整合 Go 原生 atbsys 系統引擎，支援 64 位元大檔案安全計量清理與應用程式殘留深度解除安裝

1.9.9 (2026-09-27)¶

• 全磁碟存取權限「拖曳即授權」與互動革新：推出基於原生 Cocoa NonactivatingPanel 的獨立拖曳懸浮窗，不搶焦點直接拖曳圖示至系統設定即可快速授予完全磁碟存取權限（FDA）；引導彈窗自動吸附至系統設定旁，權限授予後支援平滑「結束並重新開啟」，徹底消除生硬的強制重啟與焦點干擾
• 雙面板 5:5 比例快速均分與中部分割列最佳化：按兩下雙面板中間工具列或分割列即可瞬間將雙面板寬度（或上下高度）精準重設為 50:50 等分，附帶多語言動態提示；修復多語言訂閱計數與滑鼠指標流失，最佳化檢視器及彈窗介面細節
• 文字編輯器按鍵體驗升級（Home/End 與智慧行首）：內建文字編輯器完美支援 macOS 標準 Home 與 End 行首/行尾跳轉；引入 Smart Home 智慧邏輯，首次按 Home 鍵跳至首個非空白字元，再次按鍵跳至行首零位
• 工具列系統狀態膠囊便捷管理與右鍵選單：主工具列預設開啟系統狀態膠囊，新增快捷關閉（×）按鈕；新增工具列右鍵關聯選單，隨時一鍵切換工具列各功能元件與系統狀態顯示
• 資料夾混排模式深度對齊與渲染效能加速：徹底完善資料夾混排排序規則（sort_folder_mode = mixed），確保在所有欄位排序下檔案與目錄完全交錯排列並即時生效；剔除樣式表偽字型宣告消除 CoreText 字型解析開銷，最佳化新手引導卡片對齊與原生選單穿透防護

1.9.8 (2026-09-24)¶

• 系統工具大檔案計量修復與應用程式解除安裝增強：修復清理位元組數超過 2GB 時 Qt 32 位元整數訊號溢位及 64 位元精度流失問題；應用程式解除安裝器新增顯示安裝日期並支援按時間排序，全面提升大容量垃圾清理與殘留分析體驗
• Mac App Store 沙盒合規加固與真實目錄透傳：向底層 atbsys 引擎透傳真實使用者主目錄（real_home），確保沙盒環境下精準掃描與清理使用者殘留檔案；全面加固提權、終端機啟動與腳本介面以嚴格符合 App Store 審核規範
• 偏好設定版面控制與路徑收藏夾修復：在一般設定中新增主介面元件版面開關（與主題管理器及主視窗即時連動），預設收起頂部工具列系統狀態膠囊以保持清爽介面；修復路徑收藏夾（Directory Hotlist）設定頁下拉選單空白問題並支援介面語言動態重譯
• 多語言術語統一與語言選擇器優化：將「Directory Hotlist」中文譯名統一規範為「路徑收藏夾」，並在偏好設定語言選擇器中採用「母語名稱 + 目前語言譯名」雙語展示，方便跨語言快速識別與切換
• 鑰匙圈授權靜默保持與串流複製穩定性提升：保留 macOS 鑰匙圈（Keychain）既有存取控制清單（ACL）並消除啟動時的冗餘寫入，避免重複彈出系統鑰匙圈密碼授權視窗；修復 StreamCopyWorker 訊號觸發時序，消除串流檔案複製完成時的競態隱患

1.9.7 (2026-09-23)¶

• 偏好設定執行期即時生效（熱重載）：全面支援檔案操作、文字編輯器、通用檢視器、快速搜尋與過濾、分頁管理、檔案列表圖示顯示、排序規則等 7 大設定頁面的修改即時生效，無需重啟應用程式；新增資料夾排序模式設定，支援資料夾置頂、檔案置頂與混合排列模式
• 目錄同步安全強化與體驗對齊：全面稽核目錄同步（Sync Dirs）功能並對齊經典 Double Commander 互動邏輯；強化雙向比對狀態檢查與安全防護，杜絕非對稱檔案同步風險
• 超長檔案名稱智慧浮動提示：新增列表項目智慧提示氣泡，僅於欄寬不足檔案名稱發生省略截斷時靈敏顯示，完整檔案名稱保持零干擾；最佳化中日韓（CJK）全形字元寬度測算，消除寬字元排版偵測誤差
• 雙面板工作流程與人機互動最佳化：右鍵壓縮與解壓縮的目標路徑預設自動設為對側面板（Peer Directory），對話方塊預設聚焦「開始」按鈕；最佳化刪除確認彈窗按鈕位置與 Enter 鍵回應；恢復雙面板中間分隔工具列按鈕手型游標
• Mac App Store 沙盒主目錄與全磁碟存取強化：引入 real_home 機制精準解析沙盒環境下的真實使用者主目錄與常用目錄（Hotlist）；修復全磁碟存取權限（FDA）偵測誤判，授權成功後自動關閉導引彈窗；系統狀態監控改用 Mach host statistics 適配沙盒環境

1.9.6 (2026-09-21)¶

• 圖片編輯器新增自訂尺寸縮放模式：圖片編輯器的影像縮放對話方塊新增「自訂尺寸（Custom Size）」模式，支援直接輸入寬高目標像素數值，並提供維持外觀比例（Keep Aspect Ratio）一鍵鎖定／解鎖功能，大幅提升影像調整與裁切的精準度
• Mac App Store 沙盒安全與審查合規強化：嚴格遵循 Apple 審查準則 2.4.5(v) 與 2.5.2 規範，在沙盒模式下移除引導使用者授權系統根目錄存取的選項，並關閉對外部行程的強制終止（SIGKILL/SIGTERM）UI 與呼叫，防範沙盒越界風險與遭退審疑慮
• 工具列自適應溢位收納與檔案比較器穩定性：主工具列新增自適應寬度溢位處理，於較小螢幕或緊湊視窗下自動將超出長度的按鈕收納至更多選單，防止排版擠壓；修復 Diff 差異比較器於 macOS x86 環境下的偶發回應停滯
• 30 種語言選單在地化補全：為頂部選單列「工具（Tools）」及相關命令完成全量 30 種語言的深度在地化翻譯
• 介面效能與 CI/CD 流程最佳化：消除文字面板組件殘留以顯著提升主題切換與重繪速度；持續整合支援參數化切換自託管／雲端 ARM64 runner，並為建置產物上傳下載增加自動重試與退避機制

1.9.5 (2026-09-19)¶

• Mac App Store 輔助執行檔沙盒繼承與合規強化：為 Contents/MacOS/ 下的所有輔助執行程式（如 atbsys 等系統工具二進位檔）引入專屬的子行程沙盒權限設定（com.apple.security.app-sandbox 與 com.apple.security.inherit），使輔助行程嚴格遵循並繼承主應用程式的 App Sandbox 安全防護原則，徹底解決提交 Mac App Store 時的沙盒合規性審查需求
• DMG 發行套件輔助程式強化執行期（Hardened Runtime）簽名：全面為 DMG 獨立發行版本中的所有 Mach-O 輔助執行檔啟用 Hardened Runtime（--options runtime）並注入對應權限設定，確保所有子程式嚴格符合 Apple Developer ID 程式碼簽名與公證（Notarization）標準
• 封裝結構最佳化與簽名整合測試：自動清除多餘的內部資源二進位目錄以精簡應用程式包結構並消除審查風險；新增多項輔助行程權限與封裝簽名整合測試，全面提升自動化發布流程的穩定性

1.9.4 (2026-09-19)¶

• 全新 ATBSys 系統工具與維護套件：深度整合原生系統維護工具箱，主工具列常駐系統狀態膠囊（即時 CPU、記憶體、磁碟及網路速率監控，支援右鍵暫停／重新整理頻率調整／隱藏及偏好設定切換），全新系統狀態面板（完整硬體指標監控與高負載行程右鍵終止／強制結束管理），磁碟空間分析器（Treemap 矩形樹狀圖階層視覺化、欄位互動排序、一鍵定位／移動至垃圾桶及 CSV/TXT 分析報告匯出），兩階段安全系統清理器（安全掃描與深度清理快取、日誌、應用程式殘留，新增 Homebrew、CocoaPods、Docker 分類與 ~/.config/mole/whitelist 白名單防護），以及應用程式殘留深度移除工具
• 高效能 Go 原生引擎與安全稽核日誌：底層採用輕量高效的 Go 原生獨立二進位檔 atbsys 橋接引擎，基於非同步 QProcess 進行無阻塞通訊，支援 Universal Binary 通用架構並全面整合至自動化打包與 CI 流程；所有系統清理與軟體移除操作均自動記錄於結構化安全稽核日誌中，兼顧極速效能與操作可追溯性
• 互動式新手教學擴充至 27 步：入門教學全面升級並新增系統工具與維護套件實操教學；重構選單高亮定位引擎，實現 macOS 原生選單列跨語言高精度幾何對齊與無縫導引
• 全球 30 種語言深度在地化與官方手冊完善：ATBSys 全套系統工具、狀態膠囊選單、設定項目及新手教學全面實現 30 種語言精準在地化；官方英文使用者手冊新增第七章《Chapter 7 System Tools & Maintenance》完整使用指南
• 介面細節最佳化與封裝強化：加寬狀態列膠囊與網速標籤，徹底解決高吞吐傳輸時的速率文字截斷問題；最佳化狀態膠囊右側吸附版面配置與快捷鍵解除綁定同步機制；完善封裝腳本中對單一架構與通用架構動態庫及二進位檔注入的安全檢查

1.9.3 (2026-09-17)¶

• 通用檢視器 .ini 設定檔文字預覽：於 F3 通用檢視器與快速檢視（Ctrl+Q / ⌘Q）中新增對 .ini 設定檔的純文字原生預覽支援，無需呼叫外部編輯器即可即時瀏覽設定檔內容
• 應用程式商店打包與動態庫簽名強化：針對 Mac App Store 與 DMG 發行打包自動編譯並注入 libATBLicenseKit.dylib 至 Contents/Frameworks/ 目錄；新增動態庫獨立代碼簽名與公證支援，加強執行期 Frameworks 相對路徑尋找，並穩健處理通用架構（Universal Binary）合併
• 新手教學引擎穩定性修復：解決常用資料夾（Hotlist）教學步驟中的逾時與狀態滯留問題，在步驟切換時即時重置狀態旗標，並解綁已棄用的事件監聽訊號以徹底避免訊號洩漏

1.9.2 (2026-09-17)¶

• StoreKit 2 原生授權與試用系統：內建基於 Swift StoreKit 2 的 Mac App Store 授權與買斷體系，支援本機日曆天試用計數、收據離線驗證與購買還原；主工具列整合授權徽章與買斷付款牆；全面相容 macOS 12+ (Apple Silicon 與 Intel 雙架構)
• 底部 Shell 命令列與終端機連動：底部輸入框支援直接執行 Shell 命令列指令並呼叫系統終端機（Terminal / iTerm2）；支援 Tab 補齊檔名與路徑，純 cd 命令直接導覽面板
• 目錄同步重構與行內字詞級 Diff：目錄同步升級為經典 7 欄對比檢視，整合按兩下 Diff 比較並消除非對稱同步風險；檔案差異比較器新增行內字詞級/字元級差異醒目提示與首尾差異快速跳轉
• macOS 原生儲存空間對齊與網路 VFS 強化：磁碟機總容量與可用空間計算完全對齊 macOS 系統設定的「儲存空間」顯示規範；網路 VFS（SFTP/FTP/Samba/WebDAV）強化保持連線、自動重新連線與 FTPS 支援；系統匣圖示更新為極簡單色自適應風格

1.9.1 (2026-09-14)¶

• 新手教程新增快速搜尋教學：互動式引導系統擴充套件至 25 步，新增快速搜尋與即時過濾（⌘S / Ctrl+S）實操環節，主選單“命令”新增快速搜尋入口，並最佳化覆蓋層的無縫過渡與自動清理
• CI 自動化構建與依賴加固：釋出打包流水線中恢復 ebooklib 依賴以確保完整支援 EPUB 預覽；最佳化工作空間自動清理機制，防止構建快取與許可權衝突

1.9.0 (2026-09-13)¶

• 全新新手互動式引導系統：內建 24 步互動式入門教程，首次啟動提供友好歡迎彈窗（可隨時透過“幫助 → 新手教程”重溫）；配備聚光燈鏤空高亮遮罩、自適應浮動卡片、選單路徑與原生快速鍵雙提示，輕鬆掌握雙面板核心工作流
• SFTP 網路安全性重大升級：廢除不安全的主機金鑰自動接受策略，全面引入 TOFU (首次使用信任) 安全驗證機制；連線未知 SFTP 伺服器時自動彈出 SHA-256 安全指紋確認對話方塊，有效抵禦中間人攻擊 (MITM) 並安全儲存至 known_hosts
• macOS 原生快速鍵與導航最佳化：修復 Command+Up（返回上級目錄）與 Command+Shift+F1（縮圖檢視）在特定鍵盤修飾鍵下的衝突，全面採用 macOS 原生符號（⌘、⌥、⌃、⇧）統一快速鍵指引
• 核心效能與構建體系最佳化：最佳化語義模板匹配與補全響應效率；重構 GitHub Actions 自動化釋出流水線並強化 AppKit 沙盒防崩潰保護

1.8.0 (2026-09-11)¶

• 通用架構安裝包支援：支援 x86_64 與 ARM 架構通用安裝包
• 自動化構建流水線：支援透過 GitHub Actions 自動構建與打包
• 智慧檔案關聯與外部應用支援：新增獨立檔案關聯管理系統（extassoc.xml），支援按副檔名自定義開啟動作、外部編輯器與檢視器；整合智慧回退機制與“開啟方式”選擇，無縫相容 macOS 原生應用
• 超大檔案傳輸與 64 位溢位防護：徹底修復進度訊號與文字面板捲軸中的 32 位整型溢位問題，全面保障 2GB 以上超大檔案在掛載卷與網路驅動器間的穩定傳輸與準確進度顯示
• 全能檢視器退出層級統一：重構檢視器 ESC 快速鍵響應機制（搜尋欄 → 過濾框 → 全屏 → 關閉視窗），消除快速鍵衝突並最佳化多檔案切換與資源回收
• 介面即時動態本地化：底部功能按鍵欄（F3～F8）支援在語言切換時即時重新翻譯，無需重啟應用生效

1.7.0 (2026-09-06)¶

• 全能文件與媒體預覽器：新增 Office 預覽套件（Excel 表格虛擬懶載入、Word 文件分頁與圖片渲染、PowerPoint 幻燈片卡片檢視）；新增 SQLite、Markdown 大綱、Jupyter Notebook、字型、壓縮包、音訊等 8+ 種格式預覽；支援 GB 級超大文字檔案秒級流式無限滾動
• 雙向檔案差異比較器：全新內建側邊雙向 Diff 工具，支援逐行/行內字元高亮、差異塊一鍵合併、撤銷編輯與編碼無損儲存
• 搜尋系統全面重構：預設支援模糊子串與正則搜尋；新增“匯入到列表面板 (Feed to ListBox)”標籤頁功能；最佳化海量結果批次流式渲染，徹底消除 UI 卡頓
• 檔案操作與核心傳輸加固：解決跨裝置移動重複彈窗確認與傳輸佇列死鎖問題；屬性對話方塊新增檔案建立時間；預設啟用居中垂直工具欄並最佳化活動面板視覺指示

1.6.2 (2026-09-03)¶

• 滑鼠框選與選擇互動增強：列表檢視與縮圖檢視全新支援滑鼠拖拽框選多選（Rubberband Drag Selection），並支援點選空白區域快速取消選擇
• 全域性視窗快速鍵與多鍵錄製：新增可自定義的全域性視窗撥出/隱藏快速鍵；修復快速鍵設定中無法正確錄製 4 鍵組合快速鍵的問題
• macOS 托盤與 Dock 恢復修復：修復應用隱藏至系統托盤後從 Dock 圖示點選無法正常還原主視窗或顯示空白視窗的問題
• 穩定性加固與核心健壯性提升：修復多執行緒與物件生命週期中的潛在崩潰，加固 VFS 虛擬檔案系統並全面最佳化測試穩定性

1.6.1 (2026-08-27)¶

• macOS 原生 UI/UX 全面重構：深度遵循 Apple HIG 設計規範，最佳化深淺色主題調色盤、Finder 風格面板高亮、卡片式 ToolTip 與平滑過渡動畫
• 向量圖示引擎與現代控制元件：內建 SF Symbols 風格向量圖示生成器，重構驅動器按鈕、麵包屑導航與下拉控制元件，全面支援高分屏自適應
• 互動與佈局升級：多重重新命名對話方塊重構為雙欄佈局並新增重名實時衝突檢測；縮圖檢視支援 Cmd + 滾輪 動態無級縮放；新增統一的空狀態提示元件

1.6.0 (2026-08-27)¶

• 雙分發渠道流水線：支援面向獨立官網分發 (DMG) 與 Mac App Store 商店版的雙軌自動化構建體系
• 商店版合規與選單適配：在 App Store 版本中自動隱藏外接更新檢查入口，確保嚴格符合 Apple 稽核規範；獨立分發版繼續保留手動更新入口
• 二進位制合規補丁：內建 itms-services 專用二進位制掃描與安全修復工具，徹底解決 Qt/PySide6 構建產物透過 App Store Connect 自動化驗證時的私有協議攔截問題

1.5.6 (2026-08-22)¶

• 標籤頁獨立檢視模式：每個標籤頁支援獨立的檢視配置（平鋪模式 Flat View / 樹形模式 Tree Mode），切換標籤頁自動同步顯示狀態並在會話中完整持久化
• 智慧檔案開啟與系統回退：新增多層級檔案型別檢測器（魔數/MIME/副檔名），內建支援的文件與媒體無縫呼叫內建檢視器，未支援的檔案格式自動回退至系統預設程式開啟

1.5.5 (2026-08-21)¶

• 應用更新檢查策略最佳化：預設禁用啟動時的自動聯網檢查更新，改為純手動觸發檢查（透過選單欄 幫助 -> 檢查更新...），提升軟體啟動速度並最佳化離線使用體驗

1.5.4 (2026-08-21)¶

• 焦點高亮與選擇狀態最佳化：徹底修復雙面板切換時非活動面板殘留焦點框的問題；最佳化跨面板移動檔案後的選擇項重置邏輯，防止殘留選區導致誤操作

1.5.3 (2026-08-19)¶

• 麵包屑級聯子選單互動最佳化：精確對齊多級子目錄選單展開時的高亮行垂直高度，消除多層級穿透時的位置偏移與跳動，極大提升快捷目錄瀏覽體驗

1.5.2 (2026-08-19)¶

• 啟動與版本說明修復：修復每次啟動應用時重複彈出“版本說明”對話方塊的問題；增強配置系統 Config.get 預設值處理，確保僅在首次執行或版本升級後展示新特性提示

1.5.1 (2026-08-19)¶

• 多語言版本說明支援：新增 7 種主流語言 ReleaseNotes（繁中/日/韓/德/法/俄/西），實現多級智慧回退解析與動態自動發現
• 打包簽名機制最佳化：重構 macOS 簽名指令碼與時間戳重試策略，最佳化 Mach-O 二進位制檔案簽名流程，徹底解決構建限流與簽名失敗問題

1.5.0 (2026-08-17)¶

• 全域性會話持久化 (Session Manager)：實現應用級別的會話狀態儲存與恢復機制，無縫恢復上次關閉時的所有左右面板標籤頁、目錄路徑、展開模式 (Flat/Tree View)、面板比例及多顯示器視窗位置
• 配置匯入與匯出：新增全域性配置與資料 一鍵匯出/匯入 ZIP 功能，方便裝置間資料遷移
• 圖片編輯器增強：新增自定義影象尺寸調整 (Resize) 功能，支援按比例縮放鎖定及預設解析度快速縮放

1.4.9 (2026-08-17)¶

• 全新內建圖片編輯器：支援影象裁剪縮放、精細旋轉、多級濾鏡調整，並引入基於 OpenCV 的 AI 去水印及影象修復 (Inpainting) 功能
• 高階圖片檢視器增強：全面支援動態 GIF 播放，新增影象平移、縮放、旋轉、EXIF 屬性檢視以及幻燈片自動播放功能
• 搜尋整合最佳化：深度整合 macOS 原生 Spotlight 搜尋引擎，實現檔案秒搜並最佳化了搜尋結果的焦點定位

1.4.8 (2026-08-16)¶

• 國際化 (i18n) 全面深化：完成介面、F3 檢視器與 F4 編輯器的多語言全面審計與補充翻譯，極大改善了音影片播放器及各類預覽控制元件的本地化體驗
• 快速檢視器 (F3) 最佳化：完善輕量級 EPUB 閱讀器 (SimpleEpubPanel) 的外鏈跳轉與迴圈搜尋邏輯；精簡 PDF 閱讀器工具欄，移除冗餘的旋轉按鈕

1.4.7 (2026-08-16)¶

• 音影片播放器增強：大幅度最佳化內建媒體播放器的互動體驗與穩定性
• 編譯系統重構：重新命名 BUILD_EPUB 環境變數為 BUILD_WEBENGINE，解耦輕量級打包邏輯
• 安裝包依賴修復：確保輕量版 DMG 安裝包也始終內建 ebooklib，保障後備電子書閱讀器 (SimpleEpubPanel) 的可用性

1.4.6 (2026-08-16)¶

• 內建輕量級 EPUB 閱讀器 (SimpleEpubPanel)：新增無需依賴 WebEngine 的後備電子書閱讀引擎，支援章節跳轉與搜尋，並提供 --epub-reader 命令列引數強制指定閱讀引擎
• 麵包屑選單互動重構 (BreadcrumbFolderMenu)：完全重構麵包屑下拉選單為單列滾動樣式，並支援無限級聯子選單直達，徹底解決多級選單展示重疊與滑鼠焦點鎖定問題

1.4.5 (2026-08-15)¶

• 全新程式碼檢視器 (F3)：支援百種語言語法高亮、大檔案動態跟隨 (Tail)、正規表示式搜尋及行號顯示
• 全新程式碼編輯器 (F4)：內建編碼/換行符動態轉換、安全原子寫入、縮排調整與查詢替換功能
• 全域性外部拖拽 (Drag & Drop)：支援將檔案或壓縮包內的深層檔案，直接無縫拖拽至桌面或第三方應用 (例如 VSCode / Sublime)

1.4.4 (2026-08-15)¶

• 介面可讀性增強：全面放大選單欄、按鈕、提示框與設定介面的字型字號，提升視覺舒適度
• 遊標互動修復：修復調整視窗邊緣、面板分割線及表格列寬時滑鼠調整指標(Cursor)丟失的問題
• Mac 原生控制元件修復：解決部分元件(QComboBox下拉框、QGroupBox標題)在 macOS 下背景發黑或溢位的顯示異常

1.4.3 (2026-08-14)¶

• 全新 macOS 原生互動風格 (Aqua Blue Theme)：新增專屬主題並設為預設，引入互動式麵包屑導航 (支援級聯子目錄直達)、Mac 風格儲存容量條 (修復大容量溢位顯示) 及圓角膠囊選擇高亮
• 介面細節深度打磨：重構標籤頁關閉按鈕佈局，修復命令列輸入框重疊問題，併為所有主題(明/暗/經典)統一下巴欄背景、分割線與面板邊框
• 國際化與升級支援：完成全專案 i18n 多語言翻譯覆蓋審計；自動更新模組新增對 AList/OpenList 聚合網盤分享協議的支援

1.4.2 (2026-08-13)¶

• 智慧語義過濾器增強：支援更多常見副檔名解析與單複數匹配，並全面支援多語言 (i18n)
• 語義搜尋體驗最佳化：採用真實的進度條替換等待游標，最佳化按回車鍵觸發補全與執行的互動邏輯
• 核心語義解析最佳化：修復目標型別推斷與關鍵詞過濾邏輯，提升自然語言搜尋準確性

1.4.1 (2026-08-13)¶

• 全域性程式碼質量審查與深度重構 (批次 A-D)
• 安全增強：修復可能存在的路徑遍歷等安全隱患
• 併發與效能最佳化：改善後臺任務執行緒安全與執行效率
• 架構最佳化：提升核心元件的穩定性與資源管理

1.4.0 (2026-08-12)¶

• 深度修復 VFS 網路模組：包括多編碼支援、協議驅動修復、鏈式壓縮包掛載支援與傳輸衝突修復
• 完善應用自動升級模組：修復證書驗證、安裝包驗證與介面整合問題
• 版本更新提示最佳化：自動更新時展示完整的版本歷史日誌

1.3.9 (2026-08-12)¶

• 新增內建 EPUB 電子書閱讀器 (F3 快速預覽)
• 新增應用自動升級檢測與提示機制
• 修復 VFS 檔案衝突處理時的程序卡死問題

1.3.8 (2026-08-08)¶

• 樹狀檢視 (Tree View) UI 最佳化
• 深度重構基於 fsspec 的網路整合
• 最佳化非法檔案字元的處理邏輯

1.3.7 (2026-08-06)¶

• 網路 VFS 引擎重構：基於 fsspec 深度重構網路檔案系統（FTP/WebDAV/SMB），實現非同步目錄載入 VfsTableModel、流式傳輸 StreamCopyWorker、遠端新建/重新命名/刪除/覆蓋衝突提示，以及 F3/F4 遠端預覽與編輯
• 系統托盤與全域性熱鍵：支援最小化到系統托盤、全域性快速鍵 (Option+Cmd+H) 切換托盤、macOS Dock 圖示動態顯隱與原生模板圖示適配
• LLM 配置與 AI 語義過濾：新增 default_llm.xml 配置單例與結構控制，整合 AI 語義過濾器及選項設定頁面
• 快速鍵與導航增強：常用列表彈窗及檔案面板全面支援 PageUp / PageDown / Home / End / Fn 導航快速鍵
• 國際化 i18n 補充：全面封裝 VFS 錯誤提示、快速檢視面板與托盤選單的多語言翻譯與 Catalog 編譯

1.3.6 (2026-08-04)¶

• 網路 VFS 增強：最佳化 FTP 編碼自動檢測 (UTF-8/GBK/Makefile 動態更新)、傳輸降級與 Socket 重置；解決 FTP 連線超時及響應錯位問題
• WebDAV 與 SMB 修復：修復 WebDAV/SMB 根路徑剝離、子目錄異常日誌傳播、連線異常及虛擬檔案系統圖示/標籤標題顯示
• 縮圖檢視導航：實現縮圖網格檢視 (Thumbnail View) 2D 鍵盤方向鍵平滑導航
• 國際化與程式碼質量：修復 zh_CN/zh_TW 語言包中“關閉標籤頁”翻譯損壞問題，完成全程式碼庫審查最佳化與安全硬化

1.3.5 (2026-08-03)¶

• 快速檢視面板：實現快速檢視功能 (cm_QuickView, Cmd+Q/Ctrl+Q)，支援多格式預覽、檔案屬性兜底展示、左右對稱翻轉、顯示選單整合與完整 i18n 多語言
• 快速檢視元件：新增 QuickViewContainer 與 QuickViewPropertiesWidget 容器整合至檔案面板
• 介面細節修復：修復淺色主題下標籤頁頭部對齊及選項設定對話方塊頁面擠壓的問題

1.3.4 (2026-08-02)¶

• 檔案面板介面：新增 Shift+PageUp / Shift+PageDown 批次選擇檔案功能
• 檔案操作修復：修復 F5 複製與 F6 移動檔案/目錄的相關缺陷
• 構建與打包指令碼：修復多張證書匹配歧義錯誤，給簽名加上時間戳並優雅處理 macOS 公證狀態

1.3.3 (2026-08-01)¶

• 核心傳輸引擎：實現 ProcessTransferWorker 實時傳輸速度與剩餘時間 (ETA) 準確計算
• 許可權與沙盒機制：分離 macOS 沙盒機制與完全磁碟訪問許可權 (Full Disk Access) 邏輯流程
• 構建打包指令碼：更新打包指令碼配置，支援 1.3.3 DMG 簽名構建

1.3.2 (2026-08-01)¶

• 修復 Nuitka 獨立打包與 App Store 模式下傳輸子程序凍結/無法啟動的問題
• 程式碼審查 Skill：增加 i18n 多語言完整性審計檢查規範

1.3.1 (2026-08-01)¶

• 修復 macOS 沙盒下因 os.access 校驗導致誤判“完全磁碟訪問許可權已授予”的問題
• 修復併發後臺任務狀態交錯干擾問題
• 補充無垃圾桶刪除確認對話方塊中批次操作核取方塊的中文翻譯
• 增加與更新程式碼審查最佳化審計 Agent Skill

1.3.0 (2026-08-01)¶

• 核心傳輸引擎：實現跨程序隔離的檔案傳輸引擎 (ProcessTransferWorker & ProcessIOEngine)，徹底解決大檔案/Samba 傳輸阻塞 UI 主執行緒問題
• 傳輸效能最佳化：加入 10Hz IPC 頻率限速控制與 macOS F_NOCACHE 檔案快取最佳化，顯著降低 GUI 卡頓與 CPU/記憶體佔用
• 架構與併發重構：完成 4 階段程式碼審查修復、安全硬化、併發互斥鎖與底層引擎重構
• 介面與細節修復：修復 Shiboken C++ 物件銷燬異常、水平雙面板佈局切換與後臺進度指示器訊號斷開問題

1.2.0 (2026-07-30)¶

• 實現全域性 I/O 程序池 (IoWorkerPool)，隔離阻塞式檔案系統 I/O 防止 GUI 卡頓
• 配置檔案版本控制：支援 XML 根節點讀寫 app_version，增加配置自動遷移 Runner 機制
• 拖拽與剪貼簿：整合 macOS Finder 原生橋接，支援檔案拖放及剪貼簿狀態機
• 路徑展開：新增 expand_path 工具，支援 ~、$VAR、%VAR% 及 %COMMANDER_PATH%
• 常用列表：實現獨立 HotlistConfig 單例配置管理及內建預設常用列表

1.1.0 (2026-07-29)¶

• 修正釋出日誌新增順序，確保按最新時間倒序排列在 Release Note 標題下方
• 修正版本管理指令碼，增加對 default_config.xml 中 System/LastVersion 節點的同步更新
• 快速鍵：為標籤切換新增 Meta+Tab 與 Meta+Shift+Tab 預設快速鍵
• 收藏標籤：增加自動遷移與清理主配置中的舊收藏標籤資料
• 檔案檢視器：最佳化大檔案載入效能與記憶體佔用

1.0.1 (2026-07-22)¶

修正了沙盒環境下，無法正常預覽文字檔案的問題

1.0.0 (2026-07-18)¶

TotalCommander MacOS移植版的初始實現。