第 6 章：虛擬檔案系統與網路互連¶

在現代數字化工作流中，檔案管理早已超越了單塊物理硬碟的邊界。軟體工程師需要透過 SFTP 維護雲端測試與生產叢集；系統管理員要管理基於 SMB/CIFS 的區域網企業共享儲存；創作者常常藉助 WebDAV 存取私有云 NAS 和媒體資源；而極客與技術人員更是每天都要在本地檢視、修改並打包動輒數以 GB 計的各類壓縮包。

傳統桌面作業系統往往強迫使用者在割裂的應用之間來回切換：開啟專門的解壓工具將 ZIP 解包到臨時目錄，改完後再重新打包；開啟第三方 FTP/SFTP 客戶端上傳檔案；或者透過作業系統掛載彈窗把遠端網路盤散亂堆放在互不相通的訪達 (Finder) 視窗中。

ATBCmder 透過其強大的 虛擬檔案系統 (Virtual File System, 簡稱 VFS) 引擎徹底消除了這種割裂。基於統一的 vfs:// URI 抽象層，ATBCmder 將遠端伺服器和壓縮包一視同仁地視為標準資料夾。您可以直接回車進入 .tar.gz 壓縮包，按 F3 預覽程式碼檔案，按 F4 原地編輯深層配置檔案（並在儲存時自動無感重新打包回寫），甚至直接在兩個面板之間按下 F5，把檔案從加密 SFTP 伺服器高速流式拷入內網 SMB NAS——全程無需任何手動解壓或臨時檔案落地！

1. 快速入門：VFS 架構總覽與命令矩陣¶

ATBCmder 將所有底層檔案系統的讀寫邏輯收斂到統一抽象層。無論是本地 APFS 固態硬碟分割槽、多層巢狀 .zip 壓縮包內部的子目錄，還是遠在大洋彼岸 Linux 節點上的 SFTP 目錄，雙面板均提供完全一致的操作互動。

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              ATBCMDER 雙面板主介面                                     │
│            左側面板 (當前啟用)                  右側面板 (對側閒置 / 目標)             │
│  [1] 本地物理檔案系統                    │  [2] 壓縮包虛擬檔案系統 (Archive VFS)       │
│      file:///Users/brain/projects/       │      vfs:///Users/brain/backup.tar.gz/src/  │
│      直接高速訪問本地 APFS 固態硬碟      │      原地免解壓瀏覽、F3檢視、F4實時編輯回寫 │
│                                          │                                             │
│  [3] 遠端網路檔案系統 (SFTP / SSH)       │  [4] 區域網網路儲存 (SMB / WebDAV)          │
│      vfs://sftp://deploy@aws.prod/app/   │      vfs://smb://admin@truenas/Pool/Media/  │
│      Paramiko / SSH 金鑰 / 鑰匙串安全認證│      macOS 原生 mount_smbfs / WebDAV 客戶端 │
│                                          │                                             │
├────────────────────────────────────────────────────────────────────────────────────────┤
│                         統一 VFS 路由排程分發引擎 (vfs://)                             │
│     FileSystemModel ➔ VFSManager ➔ SessionCache ➔ StreamCopyWorker / RepackWorker      │
└────────────────────────────────────────────────────────────────────────────────────────┘

VFS 與網路雙矩陣速查表¶

2. 統一的 vfs:// URI 抽象規範¶

傳統檔案管理器往往把遠端網路盤和壓縮包視為次等公民，必須依賴第三方掛載工具或先全量解壓到臨時目錄。ATBCmder 將所有檔案源全部收斂至標準化、結構嚴謹的統一資源定位符 (URI)：

vfs://[協議型別]://[使用者名稱]@[主機地址]:[埠號]/[遠端絕對路徑]

2.1 虛擬路徑兩大正規化¶

根據不同的資料載體與應用場景，vfs:// URI 主要呈現為兩種規範格式：

1. 壓縮包虛擬路徑 (Archive Virtual Paths)：

   vfs:///Users/brain/Documents/release_v1.7.zip/src/main.py
   

2. 外層協議頭：vfs:// 告知底層 FileSystemModel 攔截物理檔案系統呼叫。

3. 物理容器路徑：/Users/brain/Documents/release_v1.7.zip 精準定位本地磁碟上實際存在的歸檔檔案。

4. 包內虛擬成員：src/main.py 定位壓縮包內部層級深處的虛擬目標檔案。

5. 網路伺服器路徑 (Network Server Paths)：

   vfs://sftp://developer@staging.internal.net:2222/var/www/html/index.php
   vfs://smb://admin@192.168.1.50/StoragePool/Backups/2026/
   vfs://webdavs://user@cloud.mycompany.com:443/remote.php/dav/files/user/
   

6. 協議識別符號：指定具體的傳輸驅動（sftp、ftp、ftps、smb、webdav、webdavs、gdrive、dropbox）。

7. 身份驗證憑據：編碼使用者名稱與指定埠號。
8. 遠端目標路徑：對應遠端伺服器主機上的絕對目錄或檔案系統路徑。

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              VFS 路徑解析全流程示意                                    │
├────────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                        │
│   輸入示例: vfs://sftp://deploy@aws.infra:22/var/log/nginx/access.log                  │
│                 │      │        │        │   └────────────────────► 遠端絕對路徑       │
│                 │      │        │        └────────────────────────► 埠 (預設 22)     │
│                 │      │        └─────────────────────────────────► 遠端主機 / 域名    │
│                 │      └──────────────────────────────────────────► 登入使用者名稱         │
│                 └─────────────────────────────────────────────────► 網路傳輸協議驅動   │
│                                                                                        │
│   輸入示例: vfs:///Volumes/Data/Archive.zip/docs/manual.pdf                            │
│                 │                      │        └─────────────────► 壓縮包內部檔案     │
│                 │                      └──────────────────────────► 物理壓縮包檔案     │
│                 └─────────────────────────────────────────────────► 虛擬檔案系統協議頭 │
└────────────────────────────────────────────────────────────────────────────────────────┘

2.2 雙面板無縫協同互動¶

因為所有虛擬路徑在 ATBCmder 內部都遵循統一的抽象目錄模型，所以您能享受到完整的雙面板互動能力：

• 多標籤虛擬工作區：在左側面板標籤頁 1 開啟遠端 SFTP 伺服器，標籤頁 2 開啟本地加密 ZIP 包，標籤頁 3 開啟本地 ~/Downloads 目錄，多源自由切換。
• 定向雙向複製 (F5)：在本地啟用面板中選中檔案並按下 F5，即可將其直接推送到對側面板展示的遠端伺服器或壓縮包內部。
• 直接拖拽傳輸 (Drag-and-Drop)：跨越面板邊界，在本地磁碟、網路共享以及歸檔內部層級之間直接拖拽檔案，無需中間繁瑣落地。
• 動態互動式麵包屑導航條：麵包屑路徑欄能夠智慧解析虛擬 URI 為可點選的層級按鈕。點選任何父級目錄或根伺服器徽標，即可瞬間折躍至對應層級。

3. 壓縮包虛擬檔案系統 (Archive VFS)：免解壓原地暢遊¶

在 ATBCmder 中開啟壓縮包完全無需先解壓到臨時目錄或藉助第三方解壓軟體。只需高亮選中的壓縮包並按下 Enter（回車鍵）或雙擊滑鼠，ATBCmder 便會瞬間在原地掛載該歸檔，將當前面板轉化為高效的虛擬目錄瀏覽器。

圖 6.1：將多層巢狀壓縮包視為普通虛擬目錄原地瀏覽，清晰展現未壓縮體積、時間戳與子目錄層級。

3.1 原生支援的歸檔與壓縮格式¶

ATBCmder 原生內建工業級主流歸檔與壓縮格式驅動：

3.2 原地暢遊的日常操作流¶

在壓縮包內部漫遊瀏覽時：

1. 進入子目錄：在壓縮包內的任何資料夾上按下 Enter（回車），立即展開深層巢狀目錄。
2. 返回上一級 (..)：按下 Backspace（退格鍵 ⌫）或雙擊 .. [上一層目錄] 返回上級。到達壓縮包的根目錄後再按退格鍵，即可優雅返回包含該壓縮包的外部物理資料夾。
3. 即時預覽 (F3 / Fn+F3)：在包內的任何文件、圖片或原始碼檔案上按下 F3，ATBCmder 會在沙箱中僅流式提取該單項，並在全能檢視器中毫秒級展現。
4. 按需單項提取 (F5 / Fn+F5)：不必為了取出幾個小檔案而解壓幾十 GB 的龐大壓縮包。直接在包內選中需要的檔案並按下 F5，ATBCmder 會單獨將選中的條目解壓並投遞到對側面板中。

4. 實時重打包 (Live Repacking)：在壓縮包內原地編輯¶

ATBCmder 最受極客歡迎的核心功能之一就是 實時重打包 (Live Repacking)。在傳統工作流中，修改壓縮包內的一個配置檔案需要極度繁瑣的六個步驟：解壓整個包 ➔ 找到目標檔案 ➔ 編輯並儲存 ➔ 重新壓縮為同名檔案 ➔ 刪除原壓縮包 ➔ 清理臨時解壓目錄。

ATBCmder 讓修改壓縮包內的檔案變得像修改本地普通檔案一樣直觀自然。

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              實時重打包 (LIVE REPACKING) 生命週期                      │
├────────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                        │
│  1. 使用者在 "package.zip" 內部對 "config.json" 按下 F4 編輯                             │
│     │                                                                                  │
│     ├──► ATBCmder 提取 "config.json" 到沙箱: /tmp/dc_repack_xyz/config.json            │
│     └──► 喚起內建 EditorDialog，視窗標題顯示: "config.json — Editor"                   │
│                                                                                        │
│  2. 使用者在編輯器中修改配置並按下 Cmd+S (儲存)                                          │
│     │                                                                                  │
│     ├──► 編輯器發出 file_saved 訊號                                                    │
│     └──► RepackWorker 後臺執行緒比對原壓縮包體積與 ArchiveRepackWarningMB 安全閾值       │
│                                                                                        │
│  3. 原子級重打包執行 (Atomic Repack)                                                   │
│     │                                                                                  │
│     ├──► 將修改後的流式資料寫入暫存歸檔: /tmp/package.zip.tmp                          │
│     ├──► 校驗新生成容器的完整性與內部簽名                                              │
│     ├──► 執行原子替換: os.replace("/tmp/package.zip.tmp", "/original/package.zip")     │
│     └──► 自動重新整理當前啟用面板，並徹底清理臨時沙箱 /tmp/dc_repack_xyz/                  │
│                                                                                        │
└────────────────────────────────────────────────────────────────────────────────────────┘

4.1 分步實操：修改壓縮包內的配置檔案¶

1. 按 Enter 回車進入壓縮包（如 application_bundle.zip）。
2. 定位到需要調整的配置檔案（如 settings.yaml）。
3. 按下 F4（或 Fn+F4）。ATBCmder 會自動將該檔案提取到沙箱快取中，並調出內建全功能程式碼編輯器。
4. 在編輯器中按需修改內容。
5. 按下 Cmd+S（⌘S）儲存檔案。
6. 按 Cmd+W 或 Esc 關閉編輯器。
7. ATBCmder 的 RepackWorker 守護程序會自動捕獲變更，在後臺將更新後的檔案重新打包裝入原歸檔，執行原子替換，並實時重新整理檔案列表。

5. 建立與提取壓縮包 (Alt+F5 / Alt+F9)¶

ATBCmder 為歸檔的建立與提取配置了獨立的後臺工作執行緒，確保在執行耗時數分鐘的大體積壓縮任務時，雙面板介面依然流暢可用、絕不假死卡頓。

圖 6.2：壓縮打包對話方塊 (Alt+F5 / cm_PackFiles)，支援目標路徑定製、格式切換、壓縮級別調優與 AES-256 密碼加密。

5.1 壓縮打包檔案 (Alt+F5 / ⌥F5 / cm_PackFiles)¶

建立新歸檔只需以下幾步：

1. 在當前啟用面板中，選中一個或多個需要打包的檔案或資料夾。
2. 按下 Alt+F5（⌥F5），或從頂部選單欄選擇 檔案 ➔ 打包壓縮...。
3. 彈出 打包壓縮 對話方塊：
4. 目標歸檔路徑：生成歸檔的儲存路徑。預設自動指向對側閒置面板所在的目錄，並以當前焦點條目命名。
5. 歸檔格式：自由選擇 ZIP、TAR、TAR.GZ、TAR.BZ2、TAR.XZ 或 7Z。
6. 壓縮級別：
   • 儲存 (Store)：僅打包不壓縮；適合用於本身已高度壓縮的媒體檔案（MP4、JPEG、MKV）。
   • 極速 (Fast)：CPU 佔用極低，優先保證打包速度。
   • 標準 (Normal Deflated)：兼顧壓縮比與執行效能（日常通用推薦配置）。
   • 最大 (Maximum)：極限壓縮模式（在支援的格式下啟用 LZMA/Bzip2 極限演算法）。
7. 保護密碼 (僅限 ZIP)：輸入加密口令，對歸檔內的檔案進行加密保護。
8. 點選 確定（或回車）。壓縮任務將在非阻塞的後臺執行緒中平穩執行，同時呈現精確的進度條與逐檔案處理狀態。

工業級 AES-256 密碼加密防護¶

傳統的 ZIP 加密方式（老舊的 ZipCrypto）在密碼學上已被證實極易被破解，存在嚴重的明文已知字典攻擊漏洞。在 ATBCmder 中為 ZIP 壓縮包設定密碼時，系統原生採用基於 pyzipper 的 AES-256 工業級高強度加密（遵循 WZ_AES 國際標準）。該標準不僅完全相容 macOS 原生解壓機制、WinZip 與 7-Zip，還能有效阻斷暴力破解與中間人刺探。

超大檔案跨介質分卷壓縮與合併¶

若您需要透過郵件附件傳送大檔案，或將大體積素材分發到受 FAT32 單檔案 4GB 限制的 U 盤與雲端儲存：

1. 先使用 Alt+F5 (cm_PackFiles) 將檔案完整打包。
2. 游標停留在生成的 .zip 或 .tar 檔案上，按下 Alt+F6 喚起檔案分割器 (cm_FileSpliter)。
3. 選擇預設分卷大小（如 100 MB、4.7 GB DVD、CD 700 MB，或輸入自定義位元組大小）。
4. ATBCmder 會批次生成帶序列編號的分卷切片（如 archive.zip.001、archive.zip.002 等）並附帶 CRC32 校驗清單。接收方在任何電腦上隨時可以透過 cm_FileLinker（檔案合併器）將其無損復原。

5.2 解壓提取歸檔 (Alt+F9 / ⌥F9 / cm_ExtractFiles)¶

將壓縮包批次解壓落地到磁碟中：

1. 在啟用面板中選中一個或多個壓縮包檔案。
2. 按下 Alt+F9（⌥F9），或從頂部選單欄選擇 檔案 ➔ 解壓...。
3. 彈出 解壓檔案 對話方塊：
4. 待解壓檔案：顯示當前選中的歸檔路徑。
5. 解壓目標路徑：解壓落地目錄（預設自動對齊對側閒置面板的當前路徑）。
6. 包內預覽列表：支援在彈窗內動態檢視壓縮包內部的檔案清單。
7. 解壓密碼：針對受密碼保護的歸檔輸入解密口令。
8. 點選 確定。解壓過程中若遇到目標目錄已有同名檔案，ATBCmder 會主動暫停並彈出互動式衝突處理視窗：
9. 覆蓋：替換當前衝突的單個目標檔案。
10. 跳過：保留現有目標檔案不動，繼續解壓下一個條目。
11. 全部覆蓋：後續所有重名檔案全部靜默覆蓋。
12. 全部跳過：後續所有重名檔案全部自動跳過。
13. 取消：安全中止解壓任務，保留已解壓好的部分。

6. 遠端網路檔案系統：主流協議與遠端儲存¶

ATBCmder 原生內建對多主流網路傳輸協議的支援，無需任何第三方外掛或中間服務，即可直接在雙面板中無縫掛載並操作遠端伺服器。

圖 6.3：透過高安全性 SFTP 協議瀏覽遠端 Linux 伺服器目錄，直觀顯示檔案屬性、所屬許可權並支援面板間雙向流式複製。

圖 6.4：支援豐富的網路連線型別：安全 SFTP、傳統 FTP/FTPS、WebDAV 雲端儲存以及區域網 SMB 共享。

6.1 支援的網路傳輸協議¶

6.2 協議深度解析與專屬特性¶

SFTP (SSH 檔案傳輸協議)¶

基於業界標杆級 paramiko SSH 核心引擎，ATBCmder 的 SFTP 驅動在埠 22 上建立加密隧道：

• 主機指紋安全防護 (WarningPolicy)：嚴格遵循安全準則，ATBCmder 會自動調閱本地 ~/.ssh/known_hosts。連線已知主機時自動校驗公鑰指紋；遇到未知伺服器時，系統會彈出明確的安全告警，絕不靜默信任來歷不明的公鑰。
• SSH 私鑰免密登入：除了傳統密碼登入外，完全支援載入本地 SSH 私鑰（如 ~/.ssh/id_rsa、~/.ssh/id_ed25519）。
• UNIX 檔案屬性無損對映：完整保留遠端檔案的八進位制檔案許可權模式 (chmod)、所屬使用者/使用者組屬性以及精確的 POSIX 修改時間戳。

FTP 與 FTPS (明文 / TLS 加密傳輸)¶

基於 Python 內建 ftplib 深度重構的 FTP 驅動支援：

• 被動傳輸模式 (PASV)：預設強制開啟被動模式，確保在穿透複雜 NAT 家用路由器與企業級防火牆時依然保持穩定通訊。
• 多語言編碼自適應切換：徹底告別跨平臺中文亂碼！支援在 UTF-8、ISO-8859-1、GB18030 與 Windows-1252 字元編碼之間一鍵切換。

SMB / Samba (Windows 區域網共享與 NAS 裝置)¶

不同於傳統的慢速純使用者態 Python SMB 庫，ATBCmder 採用了混合加速架構：

• macOS 原生核心級硬體加速 (mount_smbfs)：在 macOS 上，ATBCmder 的 SambaMounter 深度聯動系統底層的 /sbin/mount_smbfs。它將遠端網路共享直接掛載進 macOS 原生 VFS 樹（/Volumes/ 或隔離掛載點），釋放出純原生硬體加速的 SMB3 極致吞吐頻寬。
• 現存掛載點智慧感知：若 macOS 訪達或系統開機指令碼已經掛載了目標 SMB 卷，ATBCmder 會自動從系統的 mount 掛載表中嗅探並瞬間定位進入，避免重複建立冗餘連線。

WebDAV 與 WebDAVS (Nextcloud 私有云與雲端儲存)¶

基於 webdavclient3 驅動，提供與現代私有云儲存的雙向同步通道：

• SSL 證書校驗模式：對公網 WebDAVS 服務執行嚴苛的 SSL 證書鏈驗證；針對家庭自建的區域網自簽名證書服務，提供一鍵信任跳過開關。
• 遞迴深層目錄建立 (makedirs)：在批次上傳檔案時，若遠端不存在父級多層目錄，驅動會自動執行遞迴建構，防止批次上傳失敗。

6.3 Google Drive 雲端儲存配置指南¶

在網頁端管理 Google Drive 時，上傳大檔案或整理多層資料夾往往會感到繁瑣遲緩；而 Google Drive 官方桌面客戶端又通常傾向於將整個雲端資料夾全量同步到本地 Mac 固態硬碟，白白擠佔寶貴的儲存空間。

ATBCmder 巧妙地將 Google Drive 虛擬化為實時直連磁碟 (gdrive://)。您可以在雙面板中直接穿透瀏覽雲端檔案、按 F3 全能預覽、按 F5 在 Mac 與雲端之間高速雙向複製——全程無需將整個雲盤下載同步到本地。

圖 6.5：透過連線管理器配置 OAuth2 客戶端憑據直連 Google Drive，在雙面板中與本地資料夾並行瀏覽與傳輸。

為什麼需要 "Client ID" 和 "Client Secret"？¶

為了捍衛您的隱私與賬戶安全，Google 嚴格禁止第三方桌面軟體索取或儲存您的 Google 賬戶明文密碼，統一強制採用 OAuth 2.0 官方授權機制。

透過在 Google Cloud Console 中免費申請屬於您個人的 OAuth 憑據：

• 100% 隱私與直連：所有資料均在您的 Mac 與 Google 官方伺服器之間點對點傳輸，絕無任何第三方伺服器中轉或窺探您的檔案與金鑰。
• 獨享專屬頻寬與配額：擁有完全私有的 API 呼叫配額，不會與其他任何使用者搶佔速度。
• 隨時可吊銷：控制權始終在您手中，您可以隨時在 Google 賬戶安全控制檯中一鍵撤銷 ATBCmder 的訪問許可權。

整個配置流程耗時不超過 3 分鐘，且只需一次性配置！

步驟 1：在 Google Cloud 中免費建立憑據（耗時 2 分鐘）¶

1. 在瀏覽器中開啟 Google Cloud Console — 憑據頁面，並登入您的 Google 賬號。
2. 選擇或新建專案：
3. 點選頁面頂部的組織/專案下拉選單。
4. (企業/組織提示：如果您擁有 Google Workspace 或 Cloud Identity 組織（如 aitobox.com），請在下拉選單中選擇該組織，以便將專案建立在企業域名下)。
5. 如果尚未建立專案，點選 新建專案，輸入任意專案名稱（如 ATBCmder），點選 建立。
6. 啟用 Google Drive API：
7. 在左側選單欄或頂部搜尋框中進入 已啟用的 API 和服務（或點選 + 啟用 API 和服務）。
8. 搜尋 Google Drive API，點選進入後點選藍色的 啟用 按鈕。
9. 配置 OAuth 同意螢幕 (首次建立時若提示)：
10. 若系統提示配置同意螢幕，選擇 外部 (External) 並點選 建立。
11. 填寫 應用名稱（如 ATBCmder），填寫用於技術支援與開發者聯絡的電子郵件地址。
12. 在 應用網域 下，將 應用首頁 設定為您需要的域名（如 https://cmder.aitobox.com）。
13. 在 已獲授權的網域 下，新增根域名（如 aitobox.com）。
14. 一路點選 儲存並繼續 完成後續配置。
15. 建立桌面端憑據：
16. 返回 API 和服務 ➔ 憑據。
17. 點選頂部 + 建立憑據，選擇 OAuth 客戶端 ID。
18. 在 應用型別 下拉選單中選擇 桌面應用 (Desktop app)。
19. 在 名稱 欄位中輸入 ATBCmder Desktop（或任意名稱）。
20. 點選 建立。
21. 複製您的專屬金鑰：
22. 彈窗將展示生成的 客戶端 ID (Client ID)（以 .apps.googleusercontent.com 結尾）與 客戶端金鑰 (Client Secret)。
23. 點選複製兩串金鑰（或保持網頁開啟，後續亦可隨時在憑據列表中檢視）。

自定義企業品牌：理解“訪問許可權授予物件” (Access Granted To)¶

當您在 Google 賬戶安全中心 (myaccount.google.com/connections) 檢視已繫結的第三方應用時，Google 會展示 ATBCmder 的應用詳情卡片：

• 應用名稱：ATBCmder
• 訪問許可權授予物件 (Access granted to)：例如 aitobox.com 或 oplist.org
• 首頁：https://cmder.aitobox.com

為什麼 Google 會顯示特定的組織名稱？¶

“訪問許可權授予物件” (Access granted to) 一行是由 Google 根據建立 OAuth 客戶端 ID 所在 GCP 專案歸屬的 Google Cloud 組織（或 Google Workspace 機構主域）自動決定的：

• 如果客戶端 ID 是在掛靠某第三方組織（如 oplist.org）的 GCP 專案下建立的，Google 便會展示該組織的域名以警示使用者 API 客戶端的歸屬方。
• 如果專案建立在個人 Google 賬戶名下，Google 則會展示您的開發者聯絡人身份。

如何將授予物件繫結為自有企業域名（如 aitobox.com）¶

若您希望 Google 賬戶安全頁面中顯示您自有的公司域名（如 aitobox.com）：

1. 在企業組織下建立專案：
2. 使用屬於企業域名的管理員賬號（如 admin@aitobox.com）登入 Google Cloud Console。
3. 在頂部組織選擇框中，確認已選定企業主域（如 aitobox.com），再在此組織下新建專案。
4. 在 OAuth 同意螢幕中設定企業品牌：
5. 前往 API 和服務 ➔ OAuth 同意螢幕。
6. 將 應用主頁 填寫為官方主頁（如 https://cmder.aitobox.com）。
7. 在 已獲授權網域 中登記根域名（如 aitobox.com）。
8. 將 支援郵箱 與 開發者聯絡郵箱 均設定為域名郵箱。
9. 重新簽發桌面應用客戶端 ID：
10. 前往 API 和服務 ➔ 憑據，新建 桌面應用 型別的 OAuth 客戶端 ID。
11. 在 ATBCmder 中更新金鑰並重新授權：
12. 將全新的 Client ID 與 Client Secret 貼上入 ATBCmder 連線管理器，點選 重新授權...。
13. 授權成功後，Google 賬戶安全中心即會清爽地將您的企業域名 (aitobox.com) 顯示為授予方！

步驟 2：在 ATBCmder 中錄入並一鍵授權¶

拿到金鑰後，在 ATBCmder 中新增連線只需幾秒：

1. 在 ATBCmder 頂部選單欄選擇 網路 ➔ 連線管理器...（或快速鍵 cm_ManageConnections）。
2. 點選左下角的 + 新建 按鈕開始建立新配置。
3. 在右側 連線詳細配置項 表單中：
4. 連線別名：輸入直觀名稱（如 我的 Google Drive 或 工作雲盤）。
5. 連線協議：在下拉選單中選擇 gdrive。
6. 客戶端 ID：貼上在 Google Cloud 複製的 Client ID。
7. 客戶端金鑰：貼上在 Google Cloud 複製的 Client Secret。
8. (貼心提示：您亦可隨時點選輸入框下方的藍色快捷連結 Create OAuth 2.0 credentials in Google Cloud Console 直達 Google Cloud)。
9. 點選 授權（或 重新授權...）按鈕：
10. ATBCmder 會自動調起系統預設瀏覽器開啟 Google 官方授權頁面。
11. 核心安全提示（完全正常與預期）：
    由於您使用的是自己在 GCP 開發者後臺私有簽發的 Client ID，而非從 Google 官方公開商業應用市場下載的預稽核 App，Google 會彈出警示頁面提示 “Google 尚未驗證此應用” / “存在安全風險”。
    這完全屬於正常現象且極其安全。 頁面中點選 高階 (Advanced)，選擇展開選項底部的 “轉到應用/仍然繼續 (unsafe)” 即可進入下一步授權。
12. 選擇您的 Google 賬號，確認授予 Google Drive 讀寫許可權。
13. 點選 繼續 / 允許。
14. 授權完成後瀏覽器將提示成功。切回 ATBCmder，狀態將更新為：
    ✓ Authorized (your_account@gmail.com)！

1. 點選 💾 儲存 將該連線加入書籤，隨後點選 🔗 立即連線（或在左側列表中雙擊它）。
2. 當前面板將瞬間開啟一個新標籤頁，路徑直指：

   vfs://gdrive://your_account@gmail.com//
   

   您的所有 Google Drive 雲端檔案與多層資料夾已盡在眼前！

步驟 3：像操作本地硬碟一樣暢遊 Google Drive¶

建立連線後，Google Drive 的互動與本地資料夾毫無二致：

• 免下載極速預覽：雙擊或回車進入資料夾。選中任意圖片、PDF、程式碼檔案或文件，按 F3 即可在全能檢視器中瞬間流式開箱預覽，無需預先儲存到本地。
• 上傳到雲端 (F5)：在本地面板中（如 Mac 的 Downloads 目錄）選中檔案或目錄，按下 F5 即可直傳到當前 Google Drive 遠端路徑。
• 下載到本地 (F5)：在 Google Drive 面板中選中遠端檔案，按下 F5 即可流式下載至對側本地資料夾。
• 滑鼠拖拽自由互動：支援直接在本地面板與 Google Drive 面板之間用滑鼠隨意拖拽檔案與資料夾。
• 一鍵極速重新整理 (F9 / Ctrl+R)：當同事分享了新檔案或您在手機端有新改動時，按下 F9（或工具欄重新整理按鈕）即可毫秒級同步最新雲端變動。
• 實時雲端配額監視：頂部工具欄右側的狀態膠囊實時顯示 Google Drive 的剩餘儲存容量（例如 259.7 GB free of 994.7 GB），雲盤用量一目瞭然。
• 多賬號無縫穿梭：您可在連線管理器中新增多個 Google Drive 賬號（如 個人雲盤 與 工作雲盤），甚至可以左側面板開啟賬號 A，右側面板開啟賬號 B，直接在兩套雲盤之間對拷檔案！
• 蘋果安全飛地硬體加密：客戶端金鑰與 OAuth 重新整理令牌直接由 macOS 系統鑰匙串 (ATBCmder_VFS) 與 Apple Secure Enclave 硬體加密保護，絕不會在磁碟上以明文留存。

6.4 Dropbox 雲端儲存配置指南¶

與 Google Drive 類似，直接在 ATBCmder 中接入 Dropbox，讓您擺脫數以百計 GB 雲端檔案對 Mac 本地固態硬碟的無端侵佔，盡享輕裝上陣的極速雲端漫遊體驗。

ATBCmder 將 Dropbox 作為實時線上的虛擬磁碟 (dropbox://)，支援使用 F3 全能預覽照片與文件、F5 高效能分塊流式上傳與下載，並在頂部工具欄實時呈現雲盤配額。

為什麼需要 "App Key" 和 "App Secret"？¶

為了徹底保護您的資料隱私與賬號安全，Dropbox 不允許第三方桌面工具索取或儲存您的 Dropbox 登入密碼，全程採用 OAuth 2.0 授權機制。

透過在官方 Dropbox App Console 中免費建立專屬於您的 App Key 與 App Secret：

• 100% 隱私與直連：所有網路通訊均在您的 Mac 與 Dropbox 官方伺服器之間點對點加密傳輸，絕無任何第三方伺服器代理或窺探。
• 獨享專屬頻寬與配額：擁有完全私有的 API 配額限制，告別公共應用的高峰擁堵與頻控限制。
• 隨時可吊銷：控制權完全在您手中，您可以隨時在 Dropbox 賬戶安全設定中一鍵撤銷訪問許可權。

配置整個流程耗時不足 2 分鐘，且一次配置永久生效！

步驟 1：在 Dropbox App Console 中建立應用¶

1. 在瀏覽器中開啟 Dropbox App Console，登入您的 Dropbox 賬號。
2. 點選右上角藍色的 Create app 按鈕。
3. 參考下圖所示配置您的應用引數：

圖 6.6：在 Dropbox 開發者中心建立全新 App，選擇 Scoped access 並開啟 Full Dropbox 全量訪問許可權。

• 1. Choose an API：選擇 Scoped access。
• 2. Choose the type of access you need：選擇 Full Dropbox（允許訪問整個 Dropbox 內的所有檔案與資料夾）。
  (注：若僅希望 ATBCmder 訪問獨立的沙盒資料夾，亦可按需選擇 "App folder")。
• 3. Name your app：為應用起一個獨一無二的名稱（如 ATBCmder 或 ATBCmder-YourName）。
• 勾選 I agree to Dropbox API Terms and Conditions 協議核取方塊。
• 點選右下角藍色的 Create app 按鈕。

步驟 2：配置重定向回撥 URI 並複製金鑰 (Settings 標籤頁)¶

建立成功後系統會自動跳轉至應用詳情頁。點選頂部的 Settings 標籤頁。

圖 6.7：配置本地迴環回撥地址 (http://127.0.0.1:53682/callback) 並複製獲取 App key 與 App secret。

1. 設定 OAuth 2 重定向回撥 URI：
2. 向下滾動找到 OAuth 2 配置區域。
3. 定位到 Redirect URIs 輸入框。

4. 輸入或貼上以下準確 URL：

   http://127.0.0.1:53682/callback
   

5. 點選輸入框旁的 Add 按鈕新增該 URI。
   (原理解析：ATBCmder 在發起授權請求時會在本地 53682 埠建立臨時安全迴環監聽服務。登記該 URI 能夠讓 Dropbox 在授權完畢後瞬間自動回撥啟用 ATBCmder，實現一鍵無感閉環)。

6. 允許公共客戶端 (PKCE)：
7. 確認 Allow public clients (Implicit Grant & PKCE) 選項保持為 Allow（或預設值）。
8. 複製您的 App Key 與 App Secret：
9. 在 Settings 標籤頁上方，找到 App key 並點選複製。
10. 在其正下方找到 App secret，點選 Show 連結顯示出完整金鑰並複製儲存。
    (保持該瀏覽器頁面開啟或臨時儲存這兩串金鑰，稍後將在步驟 4 中貼上至 ATBCmder)。

步驟 3：配置所需授權範圍與許可權 (Permissions 標籤頁)¶

接下來，點選應用設定頁面頂部的 Permissions 標籤頁。

圖 6.8：在 Permissions 標籤頁勾選必要的許可權範圍，包含 files.metadata.read/write 與 files.content.read/write。

1. 在 Account Info 區域：
2. account_info.read：檢視 Dropbox 賬戶基本資訊（預設已勾選，讓 ATBCmder 連入後可自動感知並顯示您的賬戶郵箱）。
3. 在 Files and folders 區域，確保勾選以下許可權項：
4. files.metadata.write：讀取並修改 Dropbox 檔案與資料夾的後設資料資訊。
5. files.content.write：修改 Dropbox 檔案與資料夾的內容（支援上傳與寫入檔案）。
6. files.content.read：讀取 Dropbox 檔案與資料夾的內容（支援下載與檢視檔案）。

步驟 4：在 ATBCmder 中新增 Dropbox 並一鍵授權¶

配置好 Dropbox 開發者應用後，接入 ATBCmder 僅需寥寥數步：

1. 在 ATBCmder 選單欄選擇 網路 ➔ 連線管理器...（或快速鍵 cm_ManageConnections）。
2. 點選左下角的 + 新建 按鈕開啟新配置。
3. 在右側 連線詳細配置項 表單中：
4. 連線別名：輸入別名（如 我的 Dropbox 或 團隊 Dropbox）。
5. 連線協議：下拉選單選擇 dropbox。
6. App Key：貼上從 Dropbox Settings 標籤頁複製的 App key。
7. App Secret：貼上從 Dropbox Settings 標籤頁複製的 App secret。
8. (貼心提示：您亦可隨時點選輸入框下方的輔助連結 Create app in Dropbox App Console 直達開發者後臺)。
9. 點選 瀏覽器登入...（或 授權）按鈕：
10. ATBCmder 會自動在系統預設瀏覽器中喚起 Dropbox 官方授權審批頁。
11. 檢查請求的許可權範圍，點選 Allow (允許)。
12. 批准後瀏覽器將提示成功。切回 ATBCmder，狀態指示器將更新為：
    ✓ Authorized (your_account@email.com)！
13. 點選 💾 儲存 將配置固化，隨後點選 🔗 立即連線（或在左側列表中雙擊該項）。
14. 當前面板將立即彈出全新標籤頁並導航至：

    vfs://dropbox://your_account@email.com//
    

    所有 Dropbox 檔案與目錄盡收眼底！

常見故障排查與急救¶

步驟 5：像操作本地硬碟一樣暢遊 Dropbox¶

接入成功後，Dropbox 的操作體驗與高速本地磁碟高度一致：

• 雙面板極速複製 (F5)：在本地面板選中檔案（如 Mac 的 Documents 或 Downloads），按下 F5 直接上傳至 Dropbox；反之選中遠端檔案按下 F5 即可高速下載到本地。
• 智慧分塊流式傳輸：後臺採用非阻塞分塊流式傳輸會話，配合毫秒級動態進度指示，從容應對數 GB 級的大型影片或壓縮包，絕不溢位系統記憶體。
• 免下載瞬時預覽 (F3)：在 Dropbox 面板中選中任意圖片、PDF、Markdown 或文字檔案，按下 F3 即可調出全能檢視器原地檢視，無需預先落地儲存。
• 建立遠端目錄 (F7)：按下 F7 快速建立遠端新目錄，支援自動遞迴建立缺失的各級父目錄。
• 滑鼠拖拽自由互通：支援透過滑鼠直接在本地面板與 Dropbox 面板之間任意拖拽複製檔案與資料夾。
• 實時雲端容量膠囊：右上角工具欄實時呈現 Dropbox 的剩餘空間與總容量（如 1.8 GB free of 2.0 GB），配額狀況盡在掌握。
• 一鍵極速重新整理 (F9 / Ctrl+R)：輕按快速鍵即刻獲取在其他裝置上的雲端變動或同步最新配額。
• 蘋果硬體級安全加固：OAuth 重新整理令牌與憑據全程經由 macOS 系統鑰匙串 (ATBCmder_VFS) 與 Apple 晶片的 Secure Enclave 硬體加密儲存。

6.3 App Store 沙盒雲端儲存（OneDrive、Google Drive、iCloud）¶

在 Mac App Store 沙盒版本的 ATBCmder 中，對第三方本地雲同步目錄（如 Microsoft OneDrive、Google Drive 桌面端、Dropbox 和 iCloud Drive）的直接檔案系統存取受到 Apple 沙盒安全機制的管理：

• 安全作用域書籤 (Security-Scoped Bookmarks)：位於 ~/Library/CloudStorage/OneDrive-*、~/Library/CloudStorage/GoogleDrive-* 或 ~/Library/Mobile Documents/com~apple~CloudDocs/ 的雲同步目錄需要系統簽發的安全存取權杖。
• 磁碟機代號選擇器與路徑無縫整合：ATBCmder 會全自動發現本機已設定的本地雲端儲存目錄，並在磁碟驅動器選擇器（Alt+D / ⌥D）、驅動器按鈕列與路徑麵包屑中直觀呈現。
• 持久授權憑據儲存：首次點選進入某個雲端儲存目錄時，macOS 系統會自動彈出授權確認工作表。一旦使用者選擇授權，ATBCmder 會將加密的安全作用域書籤持久化儲存在偏好設定中，在應用重啟後依然保持讀寫暢通，無需反覆彈出授權對話方塊。

7. 快速連線 vs 連線管理器¶

ATBCmder 為連線遠端主機提供了兩套相輔相成的方案：針對臨時除錯的 快速連線，以及面向固定伺服器資產的 連線管理器。

7.1 快速臨時連線 (cm_NetworkConnect)¶

當您需要臨時連入某臺裝置處理突發問題，不想把配置持久儲存汙染書籤時：

1. 選擇選單欄 網路 ➔ 快速連線...（或執行命令 cm_NetworkConnect）。
2. 彈出精簡輕快的快速撥號彈窗：
3. 協議：選擇 sftp、ftp、ftps、smb、webdav、webdavs、gdrive 或 dropbox。
4. 伺服器地址與埠：輸入主機 IP 或域名（埠隨協議自動回填預設值）。
5. 使用者名稱與密碼：輸入遠端認證資訊。
6. 遠端起始路徑：指定登入後的初始目錄（預設為 /）。
7. 記住密碼：臨時連線建議保持不勾選。
8. 點選 測試連線，在正式載入前先行驗證網路握手與身份認證是否通暢。
9. 點選 連線。ATBCmder 會立即在當前面板新建一個標籤頁，直連遠端伺服器。

7.2 連線管理器 (cm_ManageConnections)¶

對於日常頻繁往來的開發叢集、測試機與公司 NAS，連線管理器提供了全維度的配置中樞：

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                              網路連線管理器 (CONNECTION MANAGER)                       │
├──────────────────────────────┬─────────────────────────────────────────────────────────┤
│  已儲存的書籤列表            │  連線詳細配置項                                         │
│  ┌────────────────────────┐  │  連線別名:     [ AWS 生產叢集跳板機                   ] │
│  │ 🔐 AWS 生產叢集跳板機  │  │  連線協議:     [ SFTP (port 22)                     ▼ ] │
│  │ 🖧 辦公區主力群暉 NAS  │  │  主機地址:     [ ec2-54-210-10-2.compute.amazonaws.com] │
│  │ 🌐 Nextcloud 私有云盤  │  │  埠號:       [ 22                                   ] │
│  │ 📂 實驗室舊版歸檔 FTP  │  │  使用者名稱:       [ ubuntu                               ] │
│  │                        │  │  登入密碼:     [ ••••••••••••••••••                   ] │
│  │                        │  │  遠端起始路徑: [ /var/www/production                  ] │
│  │                        │  │  [✓] 將安全密碼存入 macOS 系統鑰匙串 (Keychain)         │
│  └────────────────────────┘  │                                                         │
│  [➕ 新建] [⧉ 克隆] [🗑 刪除]  │  [🔍 測試連通性]             [💾 儲存]  [🔗 立即連線] │
└──────────────────────────────┴─────────────────────────────────────────────────────────┘

維護伺服器連線配置¶

• 新建 (➕ 新建)：清空右側表單，錄入全新伺服器的連線引數。
• 克隆 (⧉ 克隆)：快速複製當前選中的連線模板。對於配置相同、僅 IP 或埠不同的開發、測試、預發多套環境，能夠極大減少重複輸入。
• 刪除 (🗑 刪除)：安全移除該連線書籤，並同步清理系統中繫結的鑰匙串安全密碼。
• 測試連通性 (🔍 測試連通性)：在後臺派遣 ConnectionTestWorker 發起連通性探針，校驗認證有效性，不影響當前面板的正常操作。
• 立即連線 (🔗 立即連線)：儲存改動，立即建立遠端會話並在新標籤頁中開啟。

選單欄動態書籤直達¶

所有在管理器中儲存的連線，都會自動同步對映到 macOS 頂部選單欄的 網路 ➔ 已儲存的連線 中。只需一次點選，即可像開啟本地書籤一樣快速掛載：

• 網路 ➔ 已儲存的連線 ➔ 🔐 AWS 生產叢集跳板機
• 網路 ➔ 已儲存的連線 ➔ 🖧 辦公區主力群暉 NAS

8. 憑據安全與 macOS 鑰匙串原生整合¶

在各類針對開發者的網路安全攻擊中，檔案管理器的配置檔案往往是重災區。許多傳統檔案管理工具把 FTP/SFTP 密碼明文存放在使用者家目錄的 XML 或 INI 文字中，極易被惡意掃描指令碼盜取。

ATBCmder 承諾：絕不在磁碟配置檔案中以任何明文形式儲存敏感憑據！

8.1 憑據安全儲存架構¶

┌────────────────────────────────────────────────────────────────────────────────────────┐
│                           憑據多層安全儲存體系架構                                     │
├────────────────────────────────────────────────────────────────────────────────────────┤
│                                                                                        │
│   持久化配置 XML 文字                           macOS 系統原生安全鑰匙串               │
│   (~/.config/atbcmder/atbcmder.xml)            (服務標識: "ATBCmder_VFS")              │
│   ┌─────────────────────────────────────┐      ┌─────────────────────────────────────┐ │
│   │ <connection>                        │      │ 標識: "AWS 生產叢集跳板機"          │ │
│   │   <label>AWS 生產叢集跳板機</label> │      │ 密文: 硬體安全區高強度加密口令      │ │
│   │   <scheme>sftp</scheme>             │      │ 訪問: 受 Apple 安全晶片硬體隔離守護 │ │
│   │   <host>aws.infra.net</host>        │      └─────────────────────────────────────┘ │
│   │   <user>deploy</user>               │                         ▲                    │
│   │   <password></password>             │                         │                    │
│   │ </connection>                       │                         │                    │
│   └─────────────────────────────────────┘                         │                    │
│         ▲                                                         │                    │
│         │ 儲存時強制剔除密碼置空                                   │ 經由系統          │
│         └─────────────────── ConnectionManager ───────────────────┘ keyring 安全存入   │
│                                                                                        │
└────────────────────────────────────────────────────────────────────────────────────────┘

1. XML 配置檔案明文脫敏：無論在任何時候將連線配置序列化落盤到 atbcmder.xml，ConnectionManager.save() 方法均會在執行前強制執行 d["password"] = "" 置空。即便配置檔案被意外讀取或洩漏，也不會暴露任何伺服器密碼。
2. Apple 原生 Keychain 硬體加密：若勾選了 記住密碼，系統會呼叫 Python keyring 模組直接把密碼存入 macOS 鑰匙串，服務名為 ATBCmder_VFS。金鑰派生與資料加解密全程受 Apple 晶片硬體 Secure Enclave 保護。
3. 動態會話記憶體保護：若未勾選“記住密碼”，憑據僅儲存在當前執行期的動態記憶體結構（VFSSessionCache）中，在退出 ATBCmder 的瞬間即被徹底抹除。

9. ⚡ 高手進階：高效能遠端與歸檔實戰技巧¶

技巧 1：非阻塞後臺傳輸佇列 (cm_OperationsPanel)¶

當跨越遠端伺服器複製海量目錄，或透過 SFTP 下載數十 GB 的系統映象時，切勿讓介面凍結。ATBCmder 的所有網路與歸檔操作均原生接入 後臺任務佇列系統：

• 按 F5 啟動傳輸時，可直接點選 後臺 按鈕將任務派入佇列。
• 透過選單欄 顯示 ➔ 後臺任務面板（cm_OperationsPanel）隨時調出監視視窗，檢視實時傳輸速率曲線、逐檔案進度與剩餘時間估算。
• 您可以隨時對任務進行暫停、繼續或調整先後次序，期間完全不影響雙面板對本地檔案的正常瀏覽與操作。

技巧 2：異構協議間的點對點流式直傳¶

ATBCmder 內建的 stream_copy_file 引擎支援跨協議直接管道流式傳輸。例如將左側面板 SFTP 伺服器上的大資料夾直接拖拽到右側面板的內網 SMB 共享盤中：

• ATBCmder 不會先將龐大的目錄全量下載到本地 Mac 固態硬碟，再重新上傳到 SMB。
• 系統在記憶體中構建環形緩衝區，將源端 Socket 讀取到的資料塊直接管道寫入目標端 Socket。不僅減少了對本地 SSD 壽命的磨損，而且即使 Mac 本地磁碟可用空間不足，也能從容完成遠端之間海量資料的無縫遷移！

技巧 3：網路長連線保活與自動重連機制¶

複雜的企業級硬體防火牆或家庭 NAT 路由常會在閒置 60 到 300 秒後強制切斷空閒 TCP 連線。為避免在瀏覽深層遠端樹形目錄時連線斷開：

• ATBCmder 的 BaseNetworkVFS 基類會自動在空閒時段向遠端傳送輕量級心跳探針包，維持會話活性。
• 若遭遇偶發性網路抖動，內部的 _retry() 故障恢復機制會自動執行最多 3 次重試，採用平滑的指數退避策略（每次間隔 2^attempt 秒），確保在弱網環境下依然堅如磐石。

技巧 4：遠端程式碼檔案的編輯與自動回傳流水線¶

需要直接修改遠端 Linux 伺服器上的 nginx.conf 或 Python 指令碼？

1. 在 SFTP 或 WebDAV 面板中選中目標遠端檔案。
2. 按下 F4（Fn+F4）。
3. ATBCmder 會將該檔案快速拉取到隔離臨時沙箱（/tmp/）並在內建編輯器中開啟。
4. 每次按下 Cmd+S（⌘S）儲存時，系統都會觸發 _upload_vfs_temp() 非同步將修改後的檔案推回遠端伺服器，並在狀態列輕量提示上傳成功。
5. 關閉編輯器後，本地臨時沙箱檔案會被安全擦除。

10. 系統許可權與安全警示¶

11. 雙矩陣快速鍵全景速查表¶