Dropstone Docs

欢迎使用 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 会提出计划、跨文件编辑，并在任何修改落地前展示差异。

运行、测试和验证

当存在类型检查、测试和 lint 时，它们会自动运行。失败会反馈到计划中，确保你看到结果时一切正常。

创建提交和拉取请求

生成符合规范的提交信息、推送分支，并通过 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 "为这个差异编写 PR 描述"

# 在无 TTY 的 CI 中驱动
dropstone run --json "根据最近 20 个提交生成发布说明"

工作原理

Dropstone 以单个二进制文件在你的终端中运行。无需配置，无需安装运行时——你在项目内启动它，它就会操作你工作目录中的文件。如果你希望它作为面板出现在代码旁边，还有 Dropstone for VS Code 可用。

每一轮对话都遵循相同的循环：

1

你用自然语言描述任务

无需特殊语法。"添加一个返回构建信息的 /healthz 端点" 就足够了。

2

Dropstone 收集上下文

它会读取文件、搜索符号、检查结构，直到有足够的信息可以行动。

3

它提出并执行计划

编辑以差异形式展示。除非你已将其加入白名单，否则 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 切换。

提示:

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

下一步去哪里

1

启动并运行

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

2

选择模型层级

模型 深入介绍 Fast、Pro 和 Heavy，以及何时使用它们。

3

按需配置

配置 涵盖全局和项目级设置；权限 和 按键绑定 涵盖其余内容。

4

查看新内容

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

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

正在构建需要阅读这些文档的 Agent 或 LLM 应用？请将 /llms.txt 作为站点索引，或使用 /llms-full.txt 获取包含全部内容的单一文件。

Ctrl+I