Dropstone CLI

欢迎使用 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 验证安装。首次启动时会提示你登录；完整的登录说明请参阅快速开始页面。

你可以做什么

理解代码库

询问认证在系统中如何流转、bug 可能藏在哪里，或某个模块是如何串联起来的。Dropstone 按需读取文件，并引用实际代码来回答。

构建功能与修复 bug

用自然语言描述变更。Dropstone 会提出计划、跨文件编辑，并在任何改动落地前展示 diff。

运行、测试与验证

类型检查、测试和 lint 在存在时会自动运行。失败会反馈回计划中，确保你看到结果时一切已是绿色。

创建提交与拉取请求

生成 conventional commit 消息、推送分支，并通过 GitHub 或 GitLab 集成打开 PR。包含代码审查摘要。

通过 MCP 连接你的工具

接入数据库、内部 API、工单系统或任何 Model Context Protocol 服务器。Dropstone 将它们视为一等公民工具。

使用规则与技能进行定制

在仓库根目录放置一个 AGENTS.md 来教会 Dropstone 你的约定。将可复用的工作流打包为技能。

与 Shell 组合使用

Dropstone 是 Unix 公民。交互式会话是默认界面，但每项能力都可以通过一次性调用来使用，这使得它可以在 CI、pre-commit 钩子和你自己的工作流中脚本化。

# 一次性调用：提问并退出
dropstone run "解释认证中间件是如何工作的"

# 通过管道传入文件
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 切换。

Tip

你无需事先考虑模型选择。从 Fast 开始，在 Dropstone 内部使用 /effort，当任务需要更多深度时逐步升级。

下一步去哪里

1

启动并运行

快速开始 涵盖安装、登录和你的第一个任务。

2

选择模型层级

模型 深入介绍 Fast、Pro 和 Heavy，以及何时使用每个层级。

3

按需配置

配置 涵盖全局和项目级设置；权限 和 快捷键 涵盖其余部分。

4

查看新内容

更新日志 列出每个版本及用户可见的变更。

设置完成后，CLI 参考 和 斜杠命令指南 是你最常回看的两个页面。

正在构建需要阅读这些文档的 agent 或 LLM 应用？请指向 /llms.txt 获取站点索引，或 /llms-full.txt 获取单文件完整语料。

Ctrl+I