Dropstone Docs

歡迎使用 Dropstone

Dropstone 是一款在終端機中運作的代理式編碼工具。它會讀取你的程式碼庫、跨檔案進行協調編輯、執行命令，並在運作過程中解釋其推理過程。

Dropstone 在終端機中執行

你描述你想要什麼，Dropstone 就會讀取相關程式碼、規劃變更、編輯檔案、執行命令，並解釋它做了什麼。它適用於真實專案，而非玩具範例，並且始終以你既有的程式碼為基礎。

這個頁面讓你了解這個產品的樣貌。快速入門 會引導你完成安裝並交付你的第一個變更。

幾秒內完成安裝

Homebrew（建議）：

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

或使用安裝腳本：

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

然後進入任何專案：

cd /path/to/your/project
dropstone

使用 dropstone --version 驗證安裝。首次啟動時會提示你登入；完整的登入說明請見快速入門頁面。

你可以做些什麼

理解程式碼庫

詢問驗證流程如何貫穿整個系統、錯誤可能隱藏在哪裡，或某個模組是如何串接起來的。Dropstone 會按需讀取檔案，並附上實際程式碼的引用來回答。

建立功能與修復錯誤

用一般語言描述變更。Dropstone 會提出計畫、跨檔案編輯，並在套用任何變更前顯示差異。

執行、測試與驗證

當型別檢查、測試和 lint 存在時會自動執行。失敗會回饋到計畫中，確保你讀到結果時一切正常。

建立提交與拉取請求

透過 GitHub 或 GitLab 整合產生 Conventional Commits 訊息、推送分支並開啟 PR。包含程式碼審查摘要。

透過 MCP 連接你的工具

串接資料庫、內部 API、工單系統，或任何 Model Context Protocol 伺服器。Dropstone 將它們視為一級工具。

使用規則與技能進行自訂

在儲存庫根目錄放置 AGENTS.md 來教導 Dropstone 你的慣例。將可重複使用的工作流程封裝為技能。

與 Shell 組合使用

Dropstone 是 Unix 的公民。互動式工作階段是預設介面，但每項功能都可以透過一次性呼叫來使用，這使得它可以在 CI、pre-commit hooks 和你自己的工作流程中撰寫腳本。

# 一次性：提出問題並結束
dropstone run "解釋 auth 中介軟體如何運作"

# 將檔案透過管道輸入
dropstone run "找出安全性問題" < src/auth.ts

# 在 shell 管道中使用
git diff main | dropstone run "為這個 diff 撰寫 PR 描述"

# 在沒有 TTY 的情況下從 CI 驅動
dropstone run --json "從最近 20 個提交產生發行說明"

運作方式

Dropstone 以單一二進位檔在你的終端機中執行。無需設定，也無需安裝執行時期——你在專案內啟動它，它就會對你工作目錄中的檔案進行操作。如果你希望它像面板一樣出現在程式碼旁，也有 Dropstone for VS Code。

每一輪都遵循相同的迴圈：

1

你用一般語言描述任務

不需要特殊語法。「新增一個回傳建置資訊的 /healthz 端點」就足夠了。

2

Dropstone 收集上下文

它會讀取檔案、搜尋符號、檢查結構，直到有足夠的資訊可以行動。

3

它提出並執行計畫

編輯會以 diff 顯示。除非你已將命令加入白名單，否則 Shell 命令會要求許可。

4

它驗證結果

當型別檢查、測試和 lint 存在時會自動執行。失敗會回饋到計畫中。

整個互動過程都留在你的終端機中。你的程式碼只會傳送到 Dropstone 自家的推論服務，該服務在「不保留、不訓練」的政策下運作。詳情請見信任頁面。

隨處使用 Dropstone

我想要……最佳選項
開始一個互動式編碼工作階段在你的專案目錄中執行 dropstone
不開啟工作階段就提出一次性問題dropstone run "..." 或使用 < 將檔案透過管道輸入
恢復上次的工作階段dropstone --continue（或 dropstone -c）
串接自訂工具或內部 APIMCP 伺服器
教導 Dropstone 你的儲存庫慣例在儲存庫根目錄放置 AGENTS.md
封裝可重複使用的工作流程技能 與外掛
在 CI 或 pre-commit 中使用 Dropstonedropstone run 搭配 --json 和權限模型
為任務選擇正確的模型層級模型（Fast / Pro / Heavy）
在沙箱或受限 shell 中執行權限

圍繞三個模型層級建構

你選擇適合工作的模型。三者都託管在美國基礎設施上，並針對編碼進行調校。

Fast

Dropstone Fast

快速編輯、建立骨架、單一檔案重構，以及對話式除錯。次秒級首個 token。新工作階段的預設層級。
Pro建議

Dropstone Pro

多檔案重構、跨領域變更，以及需要更廣泛推理的任務。使用 /effort high 切換。
Heavy

Dropstone Heavy

架構決策、大型遷移，以及困難的除錯。最深入的推理、最長的思考預算。使用 /effort xhigh 切換。

提示:

你不需要事先考慮模型選擇。從 Fast 開始，並在任務需要更多深度時，在 Dropstone 內使用 /effort 升級。

接下來去哪裡

1

開始使用

快速入門涵蓋安裝、登入和你的第一個任務。

2

選擇模型層級

模型深入探討 Fast、Pro 和 Heavy，以及何時該使用哪一個。

3

依喜好設定

設定涵蓋全域與專案層級的設定；權限和按鍵綁定涵蓋其餘部分。

4

看看有什麼新功能

更新日誌列出每個版本的使用者可見變更。

設定完成後，CLI 參考和斜線命令指南是你最常回來看的兩個頁面。

正在建置需要閱讀這些文件的 Agent 或 LLM 應用程式？請將它指向 /llms.txt 取得網站索引，或 /llms-full.txt 取得單一檔案中的完整語料庫。

Ctrl+I