Dropstone CLI

常見問題

修復 Dropstone CLI 安裝與執行時的常見問題。針對安裝失敗、驗證問題與更新錯誤的逐步解決方案。

Dropstone 使用者最常遇到的問題，以及修復步驟。若需執行時期錯誤與各功能的除錯資訊，請參閱 CLI 疑難排解 頁面。

macOS 安裝失敗

「Command not found: brew」

您需要先安裝 Homebrew。只需安裝一次：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

在 Apple Silicon 上，還需要將 Homebrew 加入 PATH：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

然後重新執行 Dropstone 安裝：

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

「Cannot install: package already exists」

強制覆寫現有安裝：

brew uninstall dropstone
brew install dropstone

Homebrew tap 重新整理失敗

清除快取並重新加入 tap：

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

執行 dropstone 時出現「zsh: killed」

適用於 Apple Silicon 的 1.0.50 版本在 macOS 27 上完全無法啟動——macOS 在它輸出任何內容前就將其終止，因此 dropstone --version 和 dropstone upgrade 也會被終止。重新安裝即可解決；相關指令請參閱 macOS 上啟動時被終止。

Windows 安裝失敗

「irm is not recognized as an internal or external command」

您目前位於 CMD，而非 PowerShell。請切換至 PowerShell：

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

或使用 CMD 安裝程式：

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

「The token '&&' is not a valid statement separator」

您正在 PowerShell 中嘗試執行 CMD 指令。請改用上述的 PowerShell 指令。

待處理更新未生效

如果 dropstone update 回報成功，但 dropstone --version 仍顯示舊版本，請重新啟動您的終端機。在 Windows 上，新二進位檔會在下次啟動時替換。

如果仍然無效，請強制重新安裝：

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

驗證

「Failed to sign in」

  1. 再次執行 dropstone。首次啟動時，它會開啟 dropstone.io/login 進行基於 PKCE 的登入。
  2. 如果瀏覽器流程失敗，請改為貼上權杖。前往 dropstone.io/account 取得權杖，並在登入提示中選擇「Paste a token」。

「Session expired」

在 Dropstone 內部執行 /login 以重新整理您的憑證。

卡在錯誤的帳號

若要切換帳號，請在 Dropstone 內部執行 /login，並在瀏覽器提示中選擇正確的帳號。

更新問題

dropstone update 回報「Update Available」但沒有任何動作

這通常表示自動安裝程式對二進位檔所在的目錄沒有寫入權限。請使用您原本的安裝方式重新安裝：

平台指令
macOS（Homebrew）brew upgrade dropstone
macOS / Linux（腳本）curl -fsSL https://dropstone.io/install | bash
Windows（PowerShell）irm https://dropstone.io/install.ps1 | iex

卡在舊版本

檢查目前安裝的版本：

dropstone --version

與 download.dropstone.io/latest.txt 上的最新版本比對。如果不相符，請使用上方對應平台的指令重新安裝。

仍有問題？

如果上述方法都無法解決您的問題，請參閱更詳細的 CLI 疑難排解 頁面，或在 dropstone.io/contact 開啟問題回報，並附上：

  • 您的作業系統與版本
  • dropstone --version 的輸出
  • 完整的錯誤訊息以及您執行的確切指令
Ctrl+I