Dropstone CLI

故障排除

常见问题及其解决方法。

要调试 Dropstone 的问题，请先检查日志以及它存储在磁盘上的本地数据。

日志

日志文件写入以下位置：

  • macOS / Linux：~/.local/share/dropstone/log/
  • Windows：按 WIN+R 并粘贴 %USERPROFILE%\.local\share\dropstone\log

日志文件以时间戳命名（例如 2026-05-23T123456.log），并保留最近 10 个日志文件。

您可以使用 --log-level 命令行选项设置日志级别，以获取更详细的调试输出：

dropstone --log-level DEBUG

--print-logs 还会实时将日志流式传输到 stderr：

dropstone --print-logs

存储

Dropstone 将会话数据和其他应用程序数据存储在磁盘上的以下位置：

  • macOS / Linux：~/.local/share/dropstone/
  • Windows：按 WIN+R 并粘贴 %USERPROFILE%\.local\share\dropstone

此目录包含：

  • auth.json：身份验证凭据
  • log/：应用程序日志
  • project/：项目特定数据，如会话历史记录
    • 如果项目位于 Git 仓库中，则存储在 ./<project-slug>/storage/
    • 否则存储在 ./global/storage/

常见问题

Dropstone 无法启动

  1. 检查日志中的错误消息。
  2. 尝试使用 --print-logs 运行，将日志流式传输到 stderr。
  3. 确保您使用的是最新版本：dropstone update。

如果在 macOS 上它立即退出且没有打印任何内容，那是另一种故障——请参阅 在 macOS 上启动时被终止。

在 macOS 上启动时被终止

在 Apple Silicon 上，Dropstone 1.0.50 在打印任何内容之前就被 macOS 终止了，因此每个命令看起来都像这样：

dropstone --version
# zsh: killed     dropstone --version

没有日志可读，也没有错误可搜索：进程在启动前就被停止了，这就是为什么 --print-logs 和 dropstone upgrade 也会被终止。macOS 在运行二进制文件之前会验证其签名，而该构建中嵌入的签名不匹配。macOS 26 及更早版本容忍了这一点；macOS 27 则不允许。Windows 和 Linux 从未受到影响。

要在重新安装前确认：

codesign --verify --verbose=4 "$(readlink -f "$(which dropstone)")"
# /opt/homebrew/bin/dropstone: invalid signature (code or signature have been modified)

然后替换二进制文件。Homebrew 和安装程序都可以在已安装副本未运行的情况下工作：

# Homebrew
brew update && brew upgrade dropstone

# 单行安装程序
curl -fsSL https://dropstone.io/install.sh | bash

要解除您已有副本的阻止而不是重新安装：

codesign --force --sign - "$(readlink -f "$(which dropstone)")"

1.0.51 及更高版本的签名方式已被 macOS 接受，并且每个版本在发布前都会检查该签名。

身份验证问题

如果登录或令牌验证失败：

  1. 重新运行 dropstone 并通过浏览器流程再次登录。
  2. 如果您处于无头环境，请从 dropstone.io/account 颁发的令牌设置 DROPSTONE_API_KEY。
  3. 确认您的网络允许出站 HTTPS 连接到 dropstone.io。如果您位于企业代理后面，请参阅 网络。

模型未找到

如果您看到 ModelNotFoundError，则可能是引用了不存在的模型 ID。请使用以下之一：

  • dropstone/dropstone-fast
  • dropstone/dropstone-pro
  • dropstone/dropstone-heavy

运行 dropstone models 以确认您的账户可用的模型。

初始化错误

如果您在启动时看到 InitError，则存储的凭据可能无效或已损坏。

  1. 清除存储的数据：

    rm -rf ~/.local/share/dropstone

    在 Windows 上：按 WIN+R 并删除 %USERPROFILE%\.local\share\dropstone。

  2. 重新运行 dropstone 并再次登录。

API 调用错误

如果您在会话期间看到 API 调用错误，则磁盘上的缓存可能已过期。

  1. 清除缓存：

    rm -rf ~/.cache/dropstone

    在 Windows 上：按 WIN+R 并删除 %USERPROFILE%\.cache\dropstone。

  2. 重新启动 Dropstone。

在 Linux 上复制/粘贴不起作用

Linux 用户需要安装以下剪贴板工具之一才能使用复制/粘贴功能：

X11

apt install -y xclip
# 或
apt install -y xsel

Wayland

apt install -y wl-clipboard

无头环境

apt install -y xvfb
# 然后
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

Dropstone 在 Wayland 上优先使用 wl-clipboard，在 X11 上回退到 xclip，然后是 xsel。

Windows：一般性能问题

如果您在原生 Windows 上遇到性能缓慢、文件访问问题或终端故障，请切换到 WSL。WSL 为您提供 Linux 环境，以原生文件系统速度和完整的终端支持运行 Dropstone。

获取帮助

Ctrl+I