Dropstone Docs

交互式会话

如何在 Dropstone 会话中工作。文件引用、shell 转义、斜杠命令和编辑器集成。

Dropstone 在您的终端中作为交互式会话运行。每个会话都绑定到您启动它的目录，保存对话历史记录，并保持打开状态直到您退出。本页介绍如何驱动会话：如何引用文件、运行 shell 命令、使用斜杠命令以及连接外部编辑器。

启动会话

从项目内部运行 dropstone：

dropstone

或将其指向特定目录：

dropstone /path/to/project

Dropstone 启动后，输入任何自然语言提示：

Give me a quick summary of the codebase.

文件引用

在消息中使用 @ 引用文件。这会对当前工作目录进行模糊搜索。

How is auth handled in @src/api/index.ts?

文件的内容会自动添加到对话中，因此代理可以读取它而无需先进行 grep。

Shell 命令

以 ! 开头的消息来运行 shell 命令。输出作为工具结果添加到对话中，以便代理可以对其做出反应。

!ls -la

!git diff

斜杠命令

输入 / 后跟命令名称来执行快速操作。大多数命令都有使用 ctrl+x 作为前导键的键盘快捷键（可通过 Keybindings 配置）。

/help

compact

压缩当前会话。较旧的上下文被总结，以便为较新的工作腾出空间。别名： /summarize。

键盘快捷键： ctrl+x c

details

切换是否内联显示工具执行详情。

editor

打开外部编辑器来撰写更长的消息。使用在 EDITOR 中设置的编辑器。请参阅 Editor setup。

键盘快捷键： ctrl+x e

effort

调整活跃模型的推理深度。打开一个选择器，有四个级别：low、medium、high、xhigh。更高的努力级别会产生更深入的推理，但代价是更多的积分和略高的延迟。别名： /thinking。

exit

退出 Dropstone。别名： /quit、/q。

键盘快捷键： ctrl+x q

export

将当前对话导出为 Markdown 并在编辑器中打开（使用 EDITOR）。

键盘快捷键： ctrl+x x

help

显示帮助对话框，包含每个斜杠命令和键盘快捷键。

init

创建或更新 AGENTS.md 的引导式设置。请参阅 Rules (AGENTS.md)。

models

列出此会话的可用模型。

键盘快捷键： ctrl+x m

new

在当前目录中启动新会话。别名： /clear。

键盘快捷键： ctrl+x n

redo

重做之前撤销的消息。仅在 /undo 之后可用。文件更改会作为重做的一部分恢复。

需要 Git:

撤销和重做使用 Git 来管理文件状态快照，因此您的项目必须是 Git 存储库。

键盘快捷键： ctrl+x r

sessions

列出并切换会话。别名： /resume、/continue。

键盘快捷键： ctrl+x l

undo

撤销对话中的最后一条消息。删除最近的用户消息、所有后续响应以及这些轮次中所做的任何文件更改。

需要 Git:

撤销使用 Git 来恢复文件更改，因此您的项目必须是 Git 存储库。

键盘快捷键： ctrl+x u

upgrade

打开 Dropstone 定价页面以升级您的计划。当您需要更多每周积分或访问高级层级（Dropstone Pro、Dropstone Heavy）时，请使用此命令。

计划升级 vs CLI 升级:

/upgrade 是计划升级。要更新 Dropstone CLI 二进制文件本身，请从 shell 运行 dropstone update。

usage

显示当前周的积分消耗、计划名称、每周限制以及积分何时重置。

编辑器设置

/editor 和 /export 命令会启动您的 EDITOR 环境变量中的编辑器。

# Terminal editors
export EDITOR=nano
export EDITOR=vim

# GUI editors (VS Code, Cursor, VSCodium, Windsurf, Zed, etc.)
# require --wait so the editor process blocks until closed
export EDITOR="code --wait"

要使其永久生效，请将其添加到您的 shell 配置文件（~/.bashrc、~/.zshrc 等）。

常见选项：

  • code 用于 Visual Studio Code
  • cursor 用于 Cursor
  • windsurf 用于 Windsurf
  • nvim 用于 Neovim
  • vim 用于 Vim
  • nano 用于 Nano
  • subl 用于 Sublime Text
  • notepad 用于 Windows Notepad

--wait 标志:

GUI 编辑器（如 VS Code）默认会立即返回，这会跳过您的消息。--wait 标志使编辑器进程阻塞直到您关闭文件，以便 Dropstone 可以读取您写的内容。

自定义

一些会话级别的首选项位于命令面板（Ctrl+P）中。搜索您想要更改的内容；该设置会在会话间记住。

  • Hide username：从聊天消息中删除您的用户名
  • Diff style：在自适应（默认）和单列堆叠 diff 之间选择
  • Mouse capture：切换终端是否处理鼠标选择本身，或 Dropstone 是否处理

对于其他所有内容（键盘绑定、格式化程序、配置文件格式），请参阅专用页面：Keybindings、Formatters、Configuration。

隐私和数据保留

您的提示、代码和对话记录永远不会用于训练模型，也不会在会话生命周期之外保留。Dropstone 使用会话范围的提示缓存来降低成本和延迟，与 Anthropic 和 OpenAI 的方式相同：缓存的内容被隔离到您自己的账户，会自动过期，并且永远不会被重复用于任何其他用户或发送给模型训练。

这些控制由 Dropstone 的母公司 Blankline 执行和审查。Blankline 的合规团队定期审计 Dropstone 的数据处理，并保留对违反政策的任何个人或系统的生产访问权限的撤销权。

有关完整的安全态势（包括子处理器披露和运行时安全边界），请参阅 Trust page。

Ctrl+I