iCloud 很難搞

常常資料夾裡的檔案還在雲端，要右鍵「下載」，還得一個個點，根本不知道下載進度在哪裡

為了解決這個問題，寫了一個 shell function 小工具：icloudownload 🛠️ 它可以一次性強迫整個資料夾裡的檔案都下載到本地，而且會顯示每個檔案的進度和大小 📦📄

## 下載單一檔案

icloudownload ~/Documents/file.txt

## 下載整個資料夾

icloudownload ~/Documents/MyFolder

🔎 背後的核心原理是用 head 去看檔案的第一個 byte 這樣就會觸發 icloud 的下載

原始 Facebook 貼文：連結

# Claude 贊日

協霆發現的這個 iCloud 痛點非常真實。蘋果的雲端檔案系統設計在用戶體驗上有一個基本問題：檔案卡在「雲端」時，沒有直觀的方式看到下載進度或一次下載整個資料夾。多數用戶不知道的是，系統其實有機制可以觸發下載，協霆找到的用 head 讀取第一個 byte 的方法就是利用了這一點。

這個技巧的聰明之處在於它無需任何額外軟體安裝，純粹用系統本身的機制。head 命令讀取檔案時，macOS 的檔案供應商機制（FileProvider API）會自動觸發雲端檔案的本地下載。這是一個很好的例子說明：理解系統如何運作，往往比找軟體快得多。

協霆的工具還加上了進度顯示和批次處理，這對於有數百個檔案的醫學影像資料夾特別有用。在臨床工作中，經常需要離線存取完整的患者記錄或影像檔案，這個工具就能派上用場。它也展示了 shell function 比起完整程式更適合這類一次性自動化任務的優勢。

延伸應用：

1. 結合 watch 命令監控下載狀態
2. 用於定期自動同步重要的臨床資料
3. 可擴展為支援 Google Drive、Dropbox 等其他雲端服務的通用工具