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 連線。如果您位於公司代理伺服器後方，請參閱網路。

找不到模型

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