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 获取一个令牌，并在登录提示中选择“粘贴令牌”。

“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