Dropstone Docs

互動式工作階段

如何在 Dropstone 工作階段中工作。檔案參考、shell 逃逸、斜線命令和編輯器整合。

Dropstone 在您的終端中以互動式工作階段的形式運行。每個工作階段都與您啟動它的目錄相關聯，保存對話歷史記錄，並保持開啟直到您退出。本頁涵蓋如何驅動工作階段：如何參考檔案、執行 shell 命令、使用斜線命令以及連接外部編輯器。

啟動工作階段

從專案內部執行 dropstone：

dropstone

或將其指向特定目錄：

dropstone /path/to/project

Dropstone 啟動後，輸入任何自然語言提示：

Give me a quick summary of the codebase.

檔案參考

在您的訊息中使用 @ 參考檔案。這會對目前工作目錄進行模糊搜尋。

How is auth handled in @src/api/index.ts?

檔案的內容會自動新增到對話中，因此代理可以讀取它而無需先進行 grep。

Shell 命令

以 ! 開始訊息以執行 shell 命令。輸出會作為工具結果新增到對話中，以便代理可以對其做出反應。

!ls -la

!git diff

斜線命令

輸入 / 後跟命令名稱以執行快速操作。大多數命令都有使用 ctrl+x 作為前導鍵的鍵盤快捷鍵（可透過 Keybindings 配置）。

/help

compact

壓縮目前工作階段。較舊的上下文會被摘要化，以便為較新的工作騰出空間。別名： /summarize。

鍵盤快捷鍵： ctrl+x c

details

切換是否內聯顯示工具執行詳細資訊。

editor

開啟您的外部編輯器以撰寫較長的訊息。使用在 EDITOR 中設定的編輯器。請參閱 Editor setup。

鍵盤快捷鍵： ctrl+x e

effort

調整活躍模型的推理深度。開啟一個選擇器，有四個級別：low、medium、high、xhigh。更高的努力會產生更深入的推理，但代價是更多的點數和稍高的延遲。別名： /thinking。

exit

退出 Dropstone。別名： /quit、/q。

鍵盤快捷鍵： ctrl+x q

export

將目前對話匯出為 Markdown 並在您的編輯器中開啟（使用 EDITOR）。

鍵盤快捷鍵： ctrl+x x

help

顯示幫助對話框，其中包含每個斜線命令和鍵盤快捷鍵。

init

用於建立或更新 AGENTS.md 的引導式設定。請參閱 Rules (AGENTS.md)。

models

列出此工作階段的可用模型。

鍵盤快捷鍵： ctrl+x m

new

在目前目錄中啟動新工作階段。別名： /clear。

鍵盤快捷鍵： ctrl+x n

redo

重做先前撤銷的訊息。僅在 /undo 之後可用。檔案變更會作為重做的一部分被還原。

需要 Git:

撤銷和重做使用 Git 來管理檔案狀態快照，因此您的專案必須是 Git 儲存庫。

鍵盤快捷鍵： ctrl+x r

sessions

列出並切換工作階段。別名： /resume、/continue。

鍵盤快捷鍵： ctrl+x l

undo

撤銷對話中的最後一條訊息。移除最近的使用者訊息、所有後續回應以及在這些輪次中所做的任何檔案變更。

需要 Git:

撤銷使用 Git 來還原檔案變更，因此您的專案必須是 Git 儲存庫。

鍵盤快捷鍵： ctrl+x u

upgrade

開啟 Dropstone 定價頁面以升級您的方案。當您需要更多每週點數或存取高級層級（Dropstone Pro、Dropstone Heavy）時，請使用此命令。

方案升級 vs CLI 升級:

/upgrade 是方案升級。若要更新 Dropstone CLI 二進位檔本身，請從您的 shell 執行 dropstone update。

usage

顯示目前週的點數消耗、方案名稱、每週限制以及點數何時重設。

編輯器設定

/editor 和 /export 命令會啟動您 EDITOR 環境變數中的編輯器。

# Terminal editors
export EDITOR=nano
export EDITOR=vim

# GUI editors (VS Code, Cursor, VSCodium, Windsurf, Zed, etc.)
# require --wait so the editor process blocks until closed
export EDITOR="code --wait"

若要使其永久生效，請將其新增到您的 shell 設定檔（~/.bashrc、~/.zshrc 等）。

熱門選項：

  • code 用於 Visual Studio Code
  • cursor 用於 Cursor
  • windsurf 用於 Windsurf
  • nvim 用於 Neovim
  • vim 用於 Vim
  • nano 用於 Nano
  • subl 用於 Sublime Text
  • notepad 用於 Windows Notepad

--wait 旗標:

VS Code 等 GUI 編輯器預設會立即返回，這會跳過您的訊息。--wait 旗標使編輯器程序阻塞直到您關閉檔案，以便 Dropstone 可以讀取您寫的內容。

自訂

一些工作階段級別的偏好設定位於命令面板（Ctrl+P）中。搜尋您想要變更的內容；該設定會在工作階段之間被記住。

  • Hide username：從聊天訊息中移除您的使用者名稱
  • Diff style：在自適應（預設）和單欄堆疊差異之間選擇
  • Mouse capture：切換終端是否自行處理滑鼠選擇，或由 Dropstone 處理

對於其他所有內容（鍵盤快捷鍵、格式化程式、設定檔格式），請參閱專用頁面：Keybindings、Formatters、Configuration。

隱私和資料保留

您的提示、程式碼和對話記錄永遠不會用於訓練模型，也不會在您的工作階段生命週期之外保留。Dropstone 使用工作階段範圍的提示快取來降低成本和延遲，與 Anthropic 和 OpenAI 的方式相同：快取的內容與您自己的帳戶隔離，會自動過期，並且永遠不會被重複用於任何其他使用者或傳送給模型訓練。

這些控制由 Dropstone 的母公司 Blankline 強制執行和審查。Blankline 的合規團隊定期審計 Dropstone 的資料處理，並保留對任何違反政策的個人或系統的生產存取權的撤銷權。

請參閱 Trust page 以了解完整的態勢，包括子處理器披露和執行時安全邊界。

Ctrl+I