快速入门

在五分钟内安装 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，登录后将令牌自动交回 CLI。使用 PKCE，因此令牌永远不会出现在浏览器地址栏中。
粘贴令牌。适用于 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 步：修复 Bug 或添加功能

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

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

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

登录表单在邮箱缺失时崩溃——找出原因并修复

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

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

以下是 Dropstone 擅长的几种模式：

重构

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

编写测试

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

代码审查

审查我暂存的更改，并标记任何有风险的地方

文档

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

提示:

像对待队友一样与 Dropstone 交流。描述你想要达成的目标，而不是实现它的具体步骤。当你把实现选择留给代理时，它最擅长规划。

基本命令

你实际会用到的一些命令：

命令	作用	示例
`dropstone`	在当前目录启动交互式会话	`dropstone`
`dropstone run "任务"`	运行一次性任务并退出	`dropstone run "解释 auth.ts"`
`dropstone -c`	继续此目录中的上一个会话	`dropstone -c`
`dropstone --session ID`	按 ID 恢复特定会话	`dropstone --session 7f3a...`
`/help`	显示所有斜杠命令	在会话内
`/effort`	切换此会话的模型层级	`/effort high`
`/clear`	清除当前对话	在会话内
`/login`	切换账户	在会话内
`exit` 或 `Ctrl+D`	退出 Dropstone