快速入门

安装 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）。该二进制文件会在启动时检查更新并自动安装，因此你无需重新运行安装程序即可保持最新。如果你使用 Homebrew 安装，请改用 brew upgrade dropstone —— Homebrew 拥有该二进制文件，Dropstone 不会触碰它。

第 2 步：登录

进入任意项目目录并启动 Dropstone：

cd /path/to/your/project
dropstone

首次启动时，系统会提示你登录。有两种选择：

在浏览器中继续（推荐）。打开 dropstone.io/login，登录后将令牌自动交回 CLI。使用 PKCE，因此令牌永远不会出现在你的浏览器 URL 栏中。
粘贴令牌。适用于 SSH 或无头会话。在 dropstone.io/account 获取令牌并粘贴。

首次登录后，你的凭据会存储在磁盘上。之后如需切换账户，请在 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 级别的工作流（打开拉取请求、生成 PR 描述、发布审查评论），请参阅 GitHub 集成。

第 7 步：修复错误或添加功能

用自然语言描述你的需求。Dropstone 将定位代码、理解上下文、实施更改并验证。

有一个错误：空搜索查询返回所有结果——修复它

向 API 服务器添加一个返回构建信息的 /healthz 端点

登录表单在缺少电子邮件时崩溃——找出原因并修复

如果任务涉及多个文件，Dropstone 将编写一个简短计划并逐步执行。你可以随时按 Esc 中断并引导。

第 8 步：尝试其他常见工作流

Dropstone 擅长的一些模式：

重构

将 auth 模块重构为使用 async/await 而不是回调

编写测试

为计算器函数编写单元测试

代码审查

审查我暂存的更改并标记任何风险

文档

更新 README 安装说明，加入 WSL 路径

Tip

像对待队友一样与 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