快速入門

安裝 Dropstone、登入，並在五分鐘內完成你的第一個變更。本指南帶你從零開始，建立一個可運作的代理循環。

完成本指南後，你將安裝好 Dropstone、完成登入，並在你選擇的專案中產生實際的編輯。

開始之前

你需要：

一個終端機或命令提示字元
磁碟上的一個專案，供 Dropstone 指向（任何語言、任何規模皆可）
一個 Dropstone 帳戶，你可以在 dropstone.io 建立

步驟 1：安裝 Dropstone

為你的平台選擇安裝方式。

Homebrew（建議）：

brew tap blankline-org/dropstone-cli
brew install dropstone

或使用安裝腳本：

curl -fsSL https://dropstone.io/install | bash

兩種方法都會在你的 PATH 上安裝一個 dropstone 二進位檔。不需要 Node，也沒有執行時期依賴。

驗證安裝：

dropstone --version

你應該會看到版本號碼（目前版本為 1.0.8）。二進位檔會在背景自動更新，因此你無需重新執行安裝程式即可保持最新狀態。

步驟 2：登入

進入任何專案目錄並啟動 Dropstone：

cd /path/to/your/project
dropstone

首次啟動時，系統會提示你登入。有兩個選項：

在瀏覽器中繼續（建議）。開啟 dropstone.io/login，完成登入後，會自動將 token 交回 CLI。使用 PKCE，因此 token 永遠不會出現在瀏覽器的網址列中。
貼上 token。適用於 SSH 或無頭（headless）工作階段。在 dropstone.io/account 取得 token 並貼上。

你的憑證會在首次登入後儲存在磁碟上。之後若要切換帳戶，請在 Dropstone 內執行 /login。

步驟 3：開始你的第一個工作階段

你現在看到的是 Dropstone 的首頁畫面。有三件事需要注意：

目前的模型等級顯示在右上角（預設：Dropstone Fast）
底部的輸入框是你輸入文字的地方
斜線指令以 / 開頭。試試 /help 查看所有指令

輸入任何自然語言提示即可開始工作階段。無需學習任何特殊語法。

步驟 4：提出你的第一個問題

讓 Dropstone 為你瀏覽專案。試試以下其中一個：

這個專案是做什麼的？

主要的進入點有哪些？

解釋一下資料夾結構

Dropstone 會按需讀取檔案，並附上實際程式碼的引用來回答。你不需要手動貼上檔案或撰寫上下文。

你也可以詢問 Dropstone 關於它自己：

你在這個專案中能做什麼？

你被授予執行哪些指令的權限？

步驟 5：進行你的第一個程式碼變更

現在描述一個小變更。對於新專案，請嘗試低風險的變更：

新增一個 README，內容包含一段專案描述

對於現有專案：

為建立使用者的函式新增輸入驗證

Dropstone 會：

找到相關檔案
以 diff 形式顯示建議的變更
在寫入前徵求你的核准
驗證結果（型別檢查、測試、lint（如有））

權限:

Dropstone 在第一次想要編輯檔案或執行 shell 指令時會徵求核准。核准一次後，同一工作階段中的相同操作將不再重複提示。使用 /permissions 檢視或撤銷你已允許的操作。

步驟 6：使用 git 工作

Dropstone 將 git 視為一級工具：

我變更了哪些檔案？

用描述性的訊息提交我的變更

建立一個名為 feature/health-endpoint 的分支並切換到它

顯示最近五次提交

幫我解決 src/auth.ts 中的合併衝突

如需 PR 層級的工作流程（開啟 pull request、產生 PR 描述、發布審查評論），請參閱 GitHub 整合。

步驟 7：修復錯誤或新增功能

用平實的語言描述你想要的內容。Dropstone 會定位程式碼、理解上下文、實作變更並進行驗證。

有一個錯誤：空的搜尋查詢會回傳所有結果——請修復它

在 API 伺服器上新增一個 /healthz 端點，回傳建置資訊

登入表單在缺少電子郵件時會當機——找出原因並修復

如果任務橫跨多個檔案，Dropstone 會撰寫簡短計畫並逐步執行。你可以隨時按 Esc 中斷並引導方向。

步驟 8：嘗試其他常見工作流程

以下是 Dropstone 擅長的幾種模式：

重構

將 auth 模組重構為使用 async/await 而非 callback

撰寫測試

為計算機函式撰寫單元測試

程式碼審查

審查我暫存的變更，並標記任何有風險的部分

文件

更新 README 安裝說明，加入 WSL 路徑

提示:

像對待隊友一樣與 Dropstone 交談。描述你想達成的目標，而不是達成目標的確切步驟。當你把實作選擇留給代理時，它在規劃方面表現最佳。

基本指令

你實際上會用到的少數指令：

指令	功能	範例
`dropstone`	在目前目錄中啟動互動式工作階段	`dropstone`
`dropstone run "task"`	執行一次性任務並結束	`dropstone run "explain auth.ts"`
`dropstone -c`	繼續此目錄中的上一個工作階段	`dropstone -c`
`dropstone --session ID`	依 ID 恢復特定工作階段	`dropstone --session 7f3a...`
`/help`	顯示所有斜線指令	在工作階段內
`/effort`	切換此工作階段的模型等級	`/effort high`
`/clear`	清除目前的對話	在工作階段內
`/login`	切換帳戶	在工作階段內
`exit` 或 `Ctrl+D`	結束 Dropstone