概述
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，完成登录后，令牌会自动传回 CLI。使用 PKCE，因此令牌不会出现在浏览器 URL 栏中。
- 粘贴令牌。适用于 SSH 或无头会话。在 dropstone.io/account 获取令牌并粘贴。
在 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 打开定价页面。