下載與安裝

在 macOS、Linux 或 Windows 上安裝 Dropstone CLI。所有安裝方式、如何驗證安裝，以及如何升級或移除。

Dropstone CLI 是一個位於 PATH 上的單一 dropstone 二進位檔。不需要 Node、不需要執行時期依賴、也沒有安裝精靈。這個頁面是取得它和移除它的所有方式的參考。

如需引導式的首次執行，請從快速入門開始。

系統需求


macOS	Homebrew 或 `curl`
Linux	`curl`。支援 Debian、Ubuntu、Fedora、RHEL、Alpine 和 Arch
Windows	PowerShell 或 CMD。建議使用 WSL2

沒有桌面應用程式，也沒有 IDE 外掛。Dropstone 在你的終端機中執行，並操作你工作目錄中的檔案。

Windows：WSL 值得一試

原生 Windows 二進位檔適合日常使用。WSL2 提供與 macOS 和 Linux 相同的 shell 體驗，並避免在兩個檔案系統之間執行 agent 時可能出現的路徑和換行問題。請參閱 Windows 與 WSL。

Homebrew：

brew tap blankline-org/dropstone-cli
brew install dropstone

或安裝腳本：

curl -fsSL https://dropstone.io/install | bash

curl -fsSL https://dropstone.io/install | bash

套件管理員支援（apt、dnf、apk）已在規劃中。

PowerShell：

irm https://dropstone.io/install.ps1 | iex

從 CMD：

curl -fsSL https://dropstone.io/install.cmd -o install.cmd && install.cmd

dropstone --version

若要檢查你是否位於目前版本，請與 download.dropstone.io/latest.txt 比對。

二進位檔在啟動時會檢查並下載更新，因此你無需做任何事即可保持在最新版本。

例外是 Homebrew。Homebrew 擁有該二進位檔，因此 Dropstone 不會更新它——請自行更新：

# Homebrew
brew upgrade dropstone

# 任何其他安裝方式，如果你想立即更新而不是等待下次啟動檢查
dropstone update

自動更新可在 dropstone.json 中設定：

{
  "autoupdate": true
}

將其設為 false 可完全關閉更新，或設為 "notify" 以在存在新版本時收到通知而不安裝它。請參閱設定。

dropstone uninstall

這會移除 Dropstone 及其相關檔案。在 Homebrew 上：

brew uninstall dropstone

Dropstone 將其狀態保存在兩個目錄中，沒有其他內容：

內容	macOS / Linux	Windows
憑證與工作階段	`~/.local/share/dropstone/`	`%USERPROFILE%\.local\share\dropstone`
快取	`~/.cache/dropstone/`	`%USERPROFILE%\.cache\dropstone`

dropstone uninstall 會清除兩者。若要手動移除它們——或在不重新安裝的情況下強制乾淨登入——請參閱疑難排解指南。

常見原因包括缺少 Homebrew、過時的 tap，或在 PowerShell 中執行 CMD 指令。常見問題會逐一說明每個問題及確切的修正方式。