總覽
Dropstone CLI 是一款在終端機中執行的代理式編碼工具。你可以直接從 shell 要求它閱讀程式碼、執行命令、規劃變更及編輯檔案。
如果你習慣在終端機中工作，Dropstone 是通往代理式編碼的最快路徑。本頁將引導你完成安裝、登入，並展開第一場對話。
前置需求
- 一個現代化的終端模擬器。任何一款皆可；我們針對 WezTerm、Alacritty、Ghostty 和 Kitty 進行測試。
- 一個 Dropstone 帳號。前往 dropstone.io 註冊，即可使用內建的模型陣容（Fast、Pro、Heavy）。
安裝
Homebrew（建議）：
brew tap blankline-org/dropstone-cli
brew install dropstone
或使用安裝腳本：
curl -fsSL https://dropstone.io/install | bash
兩種方式都會在 PATH 中放入單一的 dropstone 二進位檔。無需 Node，也無需任何執行時期依賴。
驗證安裝：
dropstone --version
登入
進入任何專案目錄並啟動 Dropstone：
cd /path/to/your/project
dropstone
首次啟動時，系統會提示你登入。有兩種方式：
- 在瀏覽器中繼續（建議）。會開啟 dropstone.io/login，完成登入後自動將 token 交回 CLI。使用 PKCE，因此 token 不會出現在瀏覽器的網址列中。
- 貼上 token。適用於 SSH 或無頭（headless）工作階段。前往 dropstone.io/account 取得 token 並貼上。
之後若要切換帳號，可在 Dropstone 內執行 /login。
選擇模型
Dropstone 提供三個模型等級。三者皆託管於美國基礎設施，並針對編碼進行調校。
| 等級 | 最適合的情境 |
|---|---|
| Fast | 快速編輯、建立專案骨架、單一檔案重構。預設等級。 |
| Pro | 多檔案重構、跨領域變更、更廣泛的推理。 |
| Heavy | 架構決策、大型遷移、模糊或研究密集的除錯。 |
在工作階段中可使用 /effort low、/effort medium、/effort high 或 /effort xhigh 切換等級。Ctrl+T 可循環切換。更多資訊請參閱 模型。
初始化專案
在專案根目錄中執行：
/init
Dropstone 會掃描你的專案結構，並在儲存庫根目錄建立 AGENTS.md 檔案。請將它提交至 git：這是你編寫專案慣例、建置命令和注意事項的地方，Dropstone 會在每次提示時參考這些內容。
完整的格式請參閱 規則（AGENTS.md）。
第一場對話
你已準備就緒。可以提出問題、要求變更或規劃功能。
詢問程式碼相關問題
How is authentication handled in @src/auth/session.ts?
使用 @ 進行模糊搜尋檔案，並將其釘選到提示中。
先規劃再建置
按下 Tab 切換至 規劃模式。在規劃模式中，Dropstone 無法編輯檔案；它只會描述它打算做的事。
Add a "deleted_at" column to the notes table. Then build a screen that
lists recently deleted notes with restore and permanent-delete buttons.
反覆調整計畫。當你滿意後，再次按下 Tab 返回 建置模式，並指示它執行。
直接編輯
對於小幅變更，可略過規劃：
Add auth to /settings the same way it is handled in /notes.
復原與重做
/undo
/redo
/undo 會還原上一次的編輯循環，並重新顯示你的提示，方便你調整。可多次執行以逐步回退。/redo 則會重播已復原的步驟。
使用量與限制
輸入 /usage 可查看每週使用量、方案等級和重置倒數。若需要更多額度，輸入 /upgrade 可開啟定價頁面。