概述
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 打开定价页面，如果您需要更多额度。