疑難排解指南

系統化診斷 Dropstone CLI 問題。收集正確資訊、找到日誌，並在聯絡支援前先隔離問題根源。

大多數問題都歸結為四件事之一：舊版建置、過期的快取、錯誤的憑證，或網路問題。本頁面說明檢查這些項目的順序，以及當問題都不屬於這些類別時該收集什麼資訊。

若遇到特定錯誤訊息，請改從常見問題開始。有關執行時期行為和各功能的除錯，請參閱CLI 疑難排解。

首先嘗試的三件事

在進行其他操作前先執行這些指令。它們能解決相當多回報的問題。

# 1. 取得最新版本
dropstone update

# 2. 查看 Dropstone 實際在做什麼
dropstone --log-level DEBUG --print-logs

rm -rf ~/.cache/dropstone

在 Windows 上，按下 WIN+R 並刪除 %USERPROFILE%\.cache\dropstone。

在刪除其他任何內容之前

上述三個指令是安全的。刪除 ~/.local/share/dropstone 則不安全——那是你的憑證和會話歷史存放的位置。在移除該目錄之前，請參閱狀態存放位置。

Dropstone 存放在磁碟上的所有內容都位於兩個目錄中。

內容	macOS / Linux	Windows
憑證和會話	`~/.local/share/dropstone/`	`%USERPROFILE%\.local\share\dropstone`
日誌	`~/.local/share/dropstone/log/`	`%USERPROFILE%\.local\share\dropstone\log`
快取	`~/.cache/dropstone/`	`%USERPROFILE%\.cache\dropstone`

在資料目錄內：

日誌檔案以寫入時間命名，例如 2026-05-23T123456.log。最新的一個就是你需要的。

預設情況下，日誌層級是安靜的。兩個旗標可以改變這一點：

# 詳細輸出寫入日誌檔案
dropstone --log-level DEBUG

# 相同的輸出即時串流到你的終端機
dropstone --print-logs

當你想親眼觀察失敗發生過程，同時仍保留檔案時，請同時使用兩者。

如果問題是啟動時當機，--print-logs 才是最有幫助的：日誌檔案可能在程序結束前根本不會寫入，但 stderr 永遠會輸出。

一份包含以下五項內容的回報通常只需一次回覆即可解決。缺少這些內容的回報通常需要四次來回。

你執行的確切指令。 不是轉述——而是包含旗標的原始指令行。
你預期的結果，以及實際發生的情況。 兩者都要。「它失敗了」無法縮小任何範圍。
你的版本和平台。
```
dropstone --version
```
加上你的作業系統和版本，以及你是在原生 Windows 還是 WSL 內執行。
相關的日誌摘錄。 錯誤前後幾行即可，不需要整個檔案。請遮蓋任何敏感內容——會話日誌可能包含檔案路徑和程式碼。
問題是否可重現。 總是、有時，或僅一次。「有時」值得說明；這指向時序或狀態問題，而非錯誤輸入。

請將回報傳送至 dropstone.io/contact。

如果原因仍不明顯，請一次消除一個變數。以下每一項都能排除一整類問題。

是專案的問題嗎？ 在空目錄中執行 Dropstone。如果在那裡正常運作，問題就與專案相關——很可能是設定檔、規則檔，或 agent 正在讀取的儲存庫中的某些內容。

是你的設定問題嗎？ 暫時將 dropstone.json 移開並重新啟動。請參閱設定以了解全域和專案設定檔的位置。

是 MCP 伺服器的問題嗎？ 啟動時掛起的伺服器會拖住整個會話。列出它們並停用，然後一次重新啟用一個：

dropstone mcp list

是網路的問題嗎？ 企業代理伺服器是看起來像其他問題的失敗最常見的原因。請檢查：

curl -I https://dropstone.io

如果該指令失敗或回傳意外結果，請參閱網路和代理。常見的修復方式是設定 HTTPS_PROXY，以及重要的 NO_PROXY=localhost,127.0.0.1——Dropstone 在互動式會話期間會使用本機迴路，將該流量導向代理會造成迴圈。

是憑證的問題嗎？ 登出再重新登入：

dropstone auth logout
dropstone auth login

是終端機的問題嗎？ 在 Linux 上，複製和貼上需要安裝剪貼簿工具。請參閱CLI 疑難排解。

是 Windows 的問題嗎？ 原生 Windows 上的檔案存取緩慢、終端機異常和路徑問題，通常在 WSL 下會消失。請參閱Windows 和 WSL。