常见问题

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

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"但没有任何反应

这通常意味着自动安装程序对二进制文件目录没有写入权限。使用您的原始方法重新安装：

卡在旧版本上

检查已安装的版本：

dropstone --version

与 download.dropstone.io/latest.txt 中的最新版本进行比较。如果不匹配，请使用上面的平台命令重新安装。

仍有问题？

如果上述方法都无法解决您的问题，请参阅更详细的 CLI 故障排除 页面，或在 dropstone.io/contact 提交问题，并包含以下信息：

• 您的操作系统和版本
• dropstone --version 的输出
• 完整的错误消息和您运行的确切命令