上週，我們完成了 Proton Drive SDK 的發佈。這是一個共享引擎，旨在協調所有平台上的 Proton Drive，並更快為您帶來所需的功能。今天，我們邁出了下一步：Proton Drive CLI 正式推出，支援 Windows、macOS 和 Linux。
CLI 將我們的雲端儲存空間和端對端加密功能帶入指令碼、備份和部署管道，無需繁瑣地撰寫代碼。它基於與官方 Proton Drive 用戶端應用程式相同的 Proton Drive SDK 構建，且與其完全相容。
致我們的開發者社群：雖然我們正在開發功能完備的 Linux 應用程式，但 CLI 已經允許您從最喜愛的指令碼編寫環境中，為 Proton Drive 的許多關鍵功能編寫指令碼（甚至可以使用 cron 來安排排程工作）。CLI 旨在補充 Proton Drive 應用程式。它並非完全替代方案 —— 例如，只有應用程式才包含在背景執行的完整同步引擎 —— 而是從輕量級指令碼編寫環境中實現許多目標的一種方式。
什麼是 CLI？
命令列介面 (CLI) 是您從 Shell（例如終端機、PowerShell 或 SSH）執行的程式。您傳遞命令和引數，它執行工作並結束。與其他 Unix 命令列工具一樣，您可以將 Proton Drive CLI 與其他工具用管線連接並編寫指令碼，以納入更大的工作流程中。
Proton Drive CLI 是一個單一的二進位檔案，您可以直接將其放入該環境中。它支援常見的磁碟操作，例如列出資料夾、上載和下載檔案、垃圾桶、共享或邀請。預設情況下，結果會以純文字、易讀的文字顯示 —— 如果您正在其上建置自動化，您可以使用 --json (或 -j) 參數切換為機器友善的格式。
Proton Drive CLI 有何幫助？
在此之前，將 Proton Drive 做為自動化工作流程的一部分（與部署指令碼、備份工作、cron 或內部運作手冊等工具一起使用）意味著要麼手動執行（例如打開應用程式或拖曳檔案），要麼逆向工程磁碟的內部結構以撰寫自訂指令碼，而這些指令碼既脆弱又難以維護。CLI 改變了這一點，允許您直接從終端機執行 Proton Drive 操作。例如，它可以在建置完成後上載檔案、按排程備份資料夾、邀請審查者或檢查已共享的內容。
當您需要在特定時間執行特定操作，而不是保持資料夾持續同步時，這特別有用。例如，在發佈後發佈檔案、在審計前對共享資料夾進行快照，或者在有人離職時撤銷存取權限。CLI 會執行操作，告訴您是否成功，然後結束。
這非常適合已經在終端機中工作的人員，以及希望將其磁碟工作流程記錄為可重複命令、而不是需要記住的一系列點擊操作的團隊。
開始使用 Proton Drive CLI
推出時，CLI 涵蓋了基本功能：登入和登出、瀏覽和管理檔案與資料夾（包括垃圾桶），以及處理共享和邀請。
一些典型流程：
proton-drive auth login
# 將檔案從本機目錄上載至我的檔案中的資料夾
proton-drive filesystem upload ./reports/* /my-files/Reports --conflict-strategy skip
# 查看誰擁有存取權限，然後邀請同事
proton-drive sharing status /my-files/Reports
proton-drive sharing invite --user example@pm.me --role editor --message "Please review reports" /my-files/Reports
# 下載至本機備份目錄
proton-drive filesystem download /my-files/Reports ./backups
如需完整的命令集和旗標，請執行 proton-drive help 或 proton-drive --help。例如，proton-drive filesystem upload --help。
深入了解有關使用 Proton Drive CLI 的資訊。
後續規劃
Proton Drive CLI 即將新增的功能包括支援：
- 相片與相簿
- 使用安全的公開連結共享檔案和資料夾
- 為大型團隊和託管服務供應商提供多帳號支援
我們的長期目標是將您在 Proton Drive 應用程式中可以執行的所有操作帶到命令列。
下載 Proton Drive CLI
最快的開始方法是下載適用於您平台的預建二進位檔案：
在 macOS 和 Linux 上，下載後您需要將該檔案設為可執行檔案 (chmod +x proton-drive)。完成後，執行 proton-drive version 以確認組建。
登入是透過您的瀏覽器進行的 —— 命令列上不需要輸入密碼。您的工作階段已由您的作業系統（Windows 憑證管理員、macOS 鑰匙圈或 Linux 上的 libsecret）安全地儲存。
從原始碼建置
更偏好從原始碼建置？該 CLI 使用 TypeScript 實作，並使用 Bun(新視窗) 進行封裝，可在 Drive SDK 儲存庫(新視窗)中下載。複製該儲存庫後，您可以安裝相依性並從主目錄建置 CLI：
cd js/cli
bun install
bun run build
./release/proton-drive auth login
./release/proton-drive filesystem list /my-files
請參閱儲存庫中的 CLI README 以取得更多詳細資料。
公平使用和速率限制
Proton Drive CLI 遵循與所有 Proton Drive 用戶端相同的公平使用政策。為了不超出限制，請僅上載或下載實際已變更的內容 —— 請勿重複上載相同的檔案，或在只有少數檔案是新檔案時重寫整個資料夾。產生異常高流量的帳號會被暫時限流，以保護所有人的服務品質。
現在即可在您的終端機中使用，並享有相同層級的隱私保護
Proton Drive CLI 已於今天推出，更多功能將在不久後跟進。您透過終端機進行的所有操作都受到與 Proton Drive 其他部分相同的端對端加密保護。下載並試用它，然後讓我們知道您建置了什麼。如果您使用的是 Linux：具有同步功能、功能完備的桌面用戶端也即將推出。
