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. 確認您的網路允許對 dropstone.io 進行外送的 HTTPS 連線。如果您位於公司代理伺服器後方，請參閱 網路。

找不到模型

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