CLI
Dropstone CLI 選項和命令。
Dropstone CLI 在沒有任何參數的情況下運行時，預設會啟動一個互動式工作階段。
dropstone
但它也接受本頁面所記錄的命令。這允許您以程式設計方式與 Dropstone 互動。
dropstone run "Explain how closures work in JavaScript"
tui
啟動互動式 Dropstone 工作階段。這是在沒有子命令的情況下運行 dropstone 時的預設行為；dropstone tui 是明確的形式。
dropstone [project]
旗標
| 旗標 | 簡寫 | 描述 |
|---|---|---|
| -c | 繼續上一個工作階段 |
| -s | 要繼續的工作階段 ID |
| 繼續時分叉工作階段（與 --continue 或 --session 搭配使用） | |
| 要使用的提示詞 | |
| -m | 要使用的模型（dropstone/dropstone-fast、dropstone/dropstone-pro 或 dropstone/dropstone-heavy） |
| 要使用的代理 | |
| 要監聽的連接埠 | |
| 要監聽的主機名稱 | |
| 啟用 mDNS 探索 | |
| 自訂 mDNS 網域名稱 | |
| 允許 CORS 的其他瀏覽器來源 |
命令
Dropstone CLI 也有以下命令。
agent
管理 Dropstone 的代理。
dropstone agent [command]
create
使用自訂配置建立新代理。
dropstone agent create
此命令將引導您建立具有自訂系統提示和權限配置的新代理。您不允許的任何內容都會在生成的代理的前置資料中被拒絕。
旗標
| 旗標 | 簡寫 | 描述 |
|---|---|---|
| 寫入代理檔案的目錄（根據提示預設為全域或 .dropstone/agent） | |
| 代理應執行的操作 | |
| 代理模式：all、primary 或 subagent | |
| 要允許的逗號分隔權限清單（預設：全部）。可用項目：bash、read、edit、glob、grep、webfetch、task、todowrite、websearch、lsp、skill。任何省略的項目都會被拒絕。別名：--tools | |
| -m | 要使用的模型（dropstone/dropstone-fast、dropstone/dropstone-pro 或 dropstone/dropstone-heavy） |
傳遞 --path、--description、--mode 和 --permissions 全部會以非互動方式運行命令。
list
列出所有可用的代理。
dropstone agent list
attach
將終端連接到已運行的 Dropstone 後端伺服器，該伺服器是透過 serve 或 web 命令啟動的。
dropstone attach [url]
這讓您可以將互動式工作階段指向在另一台機器上運行的 Dropstone 伺服器。例如：
# 在主機上啟動伺服器
dropstone web --port 4096 --hostname 0.0.0.0
# 在另一台機器上，將工作階段連接到它
dropstone attach http://10.20.30.40:4096
旗標
| 旗標 | 簡寫 | 描述 |
|---|---|---|
| 啟動工作階段的工作目錄 | |
| -c | 繼續上一個工作階段 |
| -s | 要繼續的工作階段 ID |
| 繼續時分叉工作階段（與 --continue 或 --session 搭配使用） | |
| -p | 基本驗證密碼（預設為 DROPSTONE_SERVER_PASSWORD） |
| -u | 基本驗證使用者名稱（預設為 DROPSTONE_SERVER_USERNAME 或 dropstone） |
auth
用於管理認證和提供者登入的命令。
dropstone auth [command]
login
使用 dropstone auth login 登入 Dropstone。您的認證儲存在 ~/.local/share/dropstone/auth.json。
dropstone auth login
Dropstone 在每次啟動時都會從此檔案讀取認證。
旗標
| 旗標 | 簡寫 | 描述 |
|---|---|---|
| -p | 提供者 ID 或名稱以登入 |
| -m | 要使用的登入方法標籤，跳過方法選擇 |
list
列出儲存在認證檔案中的所有已驗證提供者。
dropstone auth list
或簡短版本。
dropstone auth ls
logout
透過從認證檔案中清除提供者來登出。
dropstone auth logout
github
管理用於儲存庫自動化的 GitHub 代理。
dropstone github [command]
install
在您的儲存庫中安裝 GitHub 代理。
dropstone github install
這會設定必要的 GitHub Actions 工作流程並引導您完成配置過程。深入了解。
run
運行 GitHub 代理。這通常在 GitHub Actions 中使用。
dropstone github run
旗標
| 旗標 | 描述 |
|---|---|
| 要為其運行代理的 GitHub 模擬事件 |
| GitHub 個人存取令牌 |
mcp
管理 Model Context Protocol 伺服器。
dropstone mcp [command]
add
將 MCP 伺服器新增到您的配置。
dropstone mcp add
此命令將引導您新增本機或遠端 MCP 伺服器。
list
列出所有已配置的 MCP 伺服器及其連線狀態。
dropstone mcp list
或使用簡短版本。
dropstone mcp ls
auth
使用啟用 OAuth 的 MCP 伺服器進行驗證。
dropstone mcp auth [name]
如果您未提供伺服器名稱，系統會提示您從可用的啟用 OAuth 的伺服器中選擇。
您也可以列出啟用 OAuth 的伺服器及其驗證狀態。
dropstone mcp auth list
或使用簡短版本。
dropstone mcp auth ls
logout
移除 MCP 伺服器的 OAuth 認證。
dropstone mcp logout [name]
debug
偵錯 MCP 伺服器的 OAuth 連線問題。
dropstone mcp debug <name>
models
列出您帳戶可用的 Dropstone 模型層級。
dropstone models
輸出格式為 dropstone/<tier>。Dropstone 提供三個層級：
| 模型 ID | 層級 | 最適合 |
|---|---|---|
dropstone/dropstone-fast | Fast | 預設日常驅動程式。快速編輯、支架、對話式偵錯。 |
dropstone/dropstone-pro | Pro | 多檔案重構、跨領域變更、更廣泛的推理。 |
dropstone/dropstone-heavy | Heavy | 架構決策、大型遷移、困難的偵錯。 |
請參閱模型以取得完整明細以及如何設定預設值。
旗標
| 旗標 | 描述 |
|---|---|
| 重新整理快取的模型清單 |
| 包含中繼資料（內容視窗、功能） |
run
透過直接傳遞提示詞在非互動模式下運行 dropstone。
dropstone run [message..]
這對於指令碼、自動化或當您想要快速答案而不打開互動式工作階段時很有用。例如：
dropstone run Explain the use of context in Go
您也可以連接到運行中的 dropstone serve 實例，以避免每次運行時的 MCP 伺服器冷啟動時間：
# 在一個終端中啟動無頭伺服器
dropstone serve
# 在另一個終端中，運行連接到它的命令
dropstone run --attach http://localhost:4096 "Explain async/await in JavaScript"
旗標
| 旗標 | 簡寫 | 描述 |
|---|---|---|
| 要運行的命令，使用訊息作為參數 | |
| -c | 繼續上一個工作階段 |
| -s | 要繼續的工作階段 ID |
| 繼續時分叉工作階段（與 --continue 或 --session 搭配使用） | |
| 共享工作階段 | |
| -m | 要使用的模型（dropstone/dropstone-fast、dropstone/dropstone-pro 或 dropstone/dropstone-heavy） |
| 要使用的代理 | |
| -f | 要附加到訊息的檔案 |
| 格式：default（已格式化）或 json（原始 JSON 事件） | |
| 工作階段的標題（如果未提供值，則使用截斷的提示詞） | |
| 連接到運行中的 dropstone 伺服器（例如 http://localhost:4096） | |
| -p | 基本驗證密碼（預設為 DROPSTONE_SERVER_PASSWORD） |
| -u | 基本驗證使用者名稱（預設為 DROPSTONE_SERVER_USERNAME 或 dropstone） |
| 要運行的目錄，或連接時遠端伺服器上的路徑 | |
| 本機伺服器的連接埠（預設為隨機連接埠） | |
| 模型變體（提供者特定的推理工作量） | |
| 顯示思考區塊 | |
| 自動批准未明確拒絕的權限（危險！） |
serve
啟動無頭 Dropstone 伺服器以進行 API 存取。查看伺服器文件以取得完整的 HTTP 介面。
dropstone serve
這會啟動無頭 HTTP 伺服器，提供對 Dropstone 的程式設計存取，而不打開互動式工作階段。設定 DROPSTONE_SERVER_PASSWORD 以啟用 HTTP 基本驗證（使用者名稱預設為 dropstone）。
旗標
| 旗標 | 描述 |
|---|---|
| 要監聽的連接埠 |
| 要監聽的主機名稱 |
| 啟用 mDNS 探索 |
| 自訂 mDNS 網域名稱 |
| 允許 CORS 的其他瀏覽器來源 |
session
管理 Dropstone 工作階段。
dropstone session [command]
list
列出所有 Dropstone 工作階段。
dropstone session list
旗標
| 旗標 | 簡寫 | 描述 |
|---|---|---|
| -n | 限制為 N 個最近的工作階段 |
| 輸出格式：table 或 json (table) |
delete
刪除 Dropstone 工作階段。
dropstone session delete <sessionID>
stats
顯示 Dropstone 工作階段的令牌使用量和成本統計資料。
dropstone stats
旗標
| 旗標 | 描述 |
|---|---|
| 顯示過去 N 天的統計資料（全部時間） |
| 要顯示的工具數量（全部） |
| 顯示模型使用量明細（預設隱藏）。傳遞數字以顯示前 N 個 |
| 按專案篩選（所有專案、空字串：目前專案） |
export
將工作階段資料匯出為 JSON。
dropstone export [sessionID]
如果您未提供工作階段 ID，系統會提示您從可用工作階段中選擇。
旗標
| 旗標 | 描述 |
|---|---|
| 編輯敏感的文字記錄/檔案資料 |
import
從 JSON 檔案或 Dropstone 共享 URL 匯入工作階段資料。
dropstone import <file>
您可以從本機檔案或 Dropstone 共享 URL 匯入。
dropstone import session.json
dropstone import https://dropstone.io/s/abc123
web
啟動具有網頁介面的無頭 Dropstone 伺服器。
dropstone web
這會啟動 HTTP 伺服器並開啟網頁瀏覽器以透過網頁介面存取 Dropstone。設定 DROPSTONE_SERVER_PASSWORD 以啟用 HTTP 基本驗證（使用者名稱預設為 dropstone）。
旗標
| 旗標 | 描述 |
|---|---|
| 要監聽的連接埠 |
| 要監聽的主機名稱 |
| 啟用 mDNS 探索 |
| 自訂 mDNS 網域名稱 |
| 允許 CORS 的其他瀏覽器來源 |
acp
啟動 ACP（Agent Client Protocol）伺服器。
dropstone acp
此命令啟動使用 nd-JSON 透過 stdin/stdout 通訊的 ACP 伺服器。
旗標
| 旗標 | 描述 |
|---|---|
| 工作目錄 |
| 要監聽的連接埠 |
| 要監聽的主機名稱 |
| 啟用 mDNS 探索 |
| 自訂 mDNS 網域名稱 |
| 允許 CORS 的其他瀏覽器來源 |
plugin
安裝外掛程式並更新您的配置。
dropstone plugin <module>
或使用別名。
dropstone plug <module>
旗標
| 旗標 | 簡寫 | 描述 |
|---|---|---|
| -g | 在全域配置中安裝 |
| -f | 取代現有外掛程式版本 |
pr
擷取並簽出 GitHub PR 分支，然後運行 Dropstone。
dropstone pr <number>
db
資料庫工具。
dropstone db [query]
旗標
| 旗標 | 描述 |
|---|---|
| 輸出格式：json 或 tsv |
path
列印資料庫路徑。
dropstone db path
debug
偵錯和疑難排解工具。
dropstone debug [command]
uninstall
解除安裝 Dropstone 並移除所有相關檔案。
dropstone uninstall
旗標
| 旗標 | 簡寫 | 描述 |
|---|---|---|
| -c | 保留配置檔案 |
| -d | 保留工作階段資料和快照 |
| 顯示將移除的內容而不移除 | |
| -f | 跳過確認提示 |
upgrade
將 Dropstone CLI 更新到最新版本或特定版本。dropstone update 是別名，行為相同。
dropstone upgrade [target]
# 或
dropstone update [target]
升級到最新版本：
dropstone upgrade
安裝特定版本：
dropstone upgrade 1.0.5
在 Windows 上，如果 Dropstone 目前正在運行，安裝程式會將新組建暫存為 dropstone.exe.pending。新版本在下次啟動時自動啟動：無需手動移動檔案。
旗標
| 旗標 | 簡寫 | 描述 |
|---|---|---|
| -m | 要使用的安裝方法：curl、npm、pnpm、bun、brew、scoop、choco |
全域旗標
dropstone CLI 採用以下全域旗標。
| 旗標 | 簡寫 | 描述 |
|---|---|---|
| -h | 顯示說明 |
| -v | 列印版本號 |
| 將日誌列印到 stderr | |
| 日誌層級（DEBUG、INFO、WARN、ERROR） | |
| 在沒有外部外掛程式的情況下運行 |
環境變數
Dropstone 在啟動時讀取以下環境變數。這些是支援的使用者面向變數；此處未列出的任何內容都是內部的，可能會在沒有通知的情況下變更或移除。
| 變數 | 類型 | 描述 |
|---|---|---|
DROPSTONE_API_KEY | string | Dropstone API 金鑰用於無頭/CI 使用（跳過瀏覽器登入） |
DROPSTONE_CONFIG | string | dropstone.json 配置檔案的路徑 |
DROPSTONE_TUI_CONFIG | string | 工作階段配置檔案的路徑（tui.json） |
DROPSTONE_DISABLE_AUTOUPDATE | boolean | 停用自動 CLI 更新檢查 |
DROPSTONE_GIT_BASH_PATH | string | Windows 上 Git Bash 的路徑（用作 shell 工具） |
DROPSTONE_SERVER_PASSWORD | string | 在 dropstone serve / dropstone web 上啟用 HTTP 基本驗證 |
DROPSTONE_SERVER_USERNAME | string | 覆寫基本驗證使用者名稱（預設 dropstone） |