Dropstone Docs

故障排除

常见问题及其解决方法。

要调试 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。

身份验证问题

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

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

模型未找到

如果您看到 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