CLI
Dropstone CLI 选项和命令。
Dropstone CLI 在无参数运行时，默认会启动一个交互式会话。
dropstone
但它也接受本页所述的命令。这使您可以以编程方式与 Dropstone 交互。
dropstone run "解释 JavaScript 中闭包的工作原理"
tui
启动一个交互式 Dropstone 会话。当您运行不带子命令的 dropstone 时，这是默认行为；dropstone tui 是显式形式。
dropstone [project]
标志
| 标志 | 简写 | 描述 |
|---|---|---|
| -c | 继续上一个会话 |
| -s | 要继续的会话 ID |
| 继续时派生会话（与 --continue 或 --session 一起使用） | |
| 要使用的提示 | |
| -m | 要使用的模型（dropstone/dropstone-fast、dropstone/dropstone-pro 或 dropstone/dropstone-heavy） |
| 要使用的代理 | |
| 监听的端口 | |
| 监听的主机名 | |
| 启用 mDNS 发现 | |
| 自定义 mDNS 域名 | |
| 允许 CORS 的额外浏览器来源 |
命令
Dropstone CLI 还具有以下命令。
agent
管理 Dropstone 的代理。
dropstone agent [command]
create
使用自定义配置创建新代理。
dropstone agent create
此命令将指导您使用自定义系统提示和权限配置创建新代理。在生成的代理的 frontmatter 中，您未允许的任何内容都会被拒绝。
标志
| 标志 | 简写 | 描述 |
|---|---|---|
| 写入代理文件的目录（默认为全局或基于提示的 .dropstone/agent） | |
| 代理应执行的操作 | |
| 代理模式：all、primary 或 subagent | |
| 允许的权限的逗号分隔列表（默认：全部）。可用：bash、read、edit、glob、grep、webfetch、task、todowrite、websearch、lsp、skill。任何省略的内容都会被拒绝。别名：--tools | |
| -m | 要使用的模型（dropstone/dropstone-fast、dropstone/dropstone-pro 或 dropstone/dropstone-heavy） |
传递所有 --path、--description、--mode 和 --permissions 将非交互式运行该命令。
list
列出所有可用的代理。
dropstone agent list
attach
将终端附加到已通过 serve 或 web 命令启动的正在运行的 Dropstone 后端服务器。
dropstone attach [url]
这使您可以将交互式会话指向在另一台机器上运行的 Dropstone 服务器。例如：
# 在主机上，启动服务器
dropstone web --port 4096 --hostname 0.0.0.0
# 在另一台机器上，将会话附加到它
dropstone attach http://10.20.30.40:4096
标志
| 标志 | 简写 | 描述 |
|---|---|---|
| 启动会话的工作目录 | |
| -c | 继续上一个会话 |
| -s | 要继续的会话 ID |
| 继续时派生会话（与 --continue 或 --session 一起使用） | |
| -p | 基本认证密码（默认为 DROPSTONE_SERVER_PASSWORD） |
| -u | 基本认证用户名（默认为 DROPSTONE_SERVER_USERNAME 或 dropstone） |
auth
管理提供商的凭据和登录的命令。
dropstone auth [command]
login
使用 dropstone auth login 登录 Dropstone。您的凭据存储在 ~/.local/share/dropstone/auth.json。
dropstone auth login
Dropstone 在每次启动时都会从此文件读取凭据。
标志
| 标志 | 简写 | 描述 |
|---|---|---|
| -p | 要登录的提供商 ID 或名称 |
| -m | 要使用的登录方法标签，跳过方法选择 |
list
列出凭据文件中存储的所有已认证提供商。
dropstone auth list
或使用简写版本。
dropstone auth ls
logout
通过从凭据文件中清除提供商来注销。
dropstone auth logout
github
管理用于仓库自动化的 GitHub 代理。
dropstone github [command]
install
在您的仓库中安装 GitHub 代理。
dropstone github install
这将设置必要的 GitHub Actions 工作流，并指导您完成配置过程。了解更多。
run
运行 GitHub 代理。这通常用于 GitHub Actions。
dropstone github run
标志
| 标志 | 描述 |
|---|---|
| 要为其运行代理的 GitHub 模拟事件 |
| GitHub 个人访问令牌 |
mcp
管理模型上下文协议服务器。
dropstone mcp [command]
add
将 MCP 服务器添加到您的配置中。
dropstone mcp add
此命令将指导您添加本地或远程 MCP 服务器。
list
列出所有已配置的 MCP 服务器及其连接状态。
dropstone mcp list
或使用简写版本。
dropstone mcp ls
auth
使用支持 OAuth 的 MCP 服务器进行身份验证。
dropstone mcp auth [name]
如果您不提供服务器名称，系统将提示您从可用的支持 OAuth 的服务器中进行选择。
您还可以列出支持 OAuth 的服务器及其身份验证状态。
dropstone mcp auth list
或使用简写版本。
dropstone mcp auth ls
logout
移除 MCP 服务器的 OAuth 凭据。
dropstone mcp logout [name]
debug
调试 MCP 服务器的 OAuth 连接问题。
dropstone mcp debug <name>
models
列出您的帐户可用的 Dropstone 模型层级。
dropstone models
输出格式为 dropstone/<tier>。Dropstone 提供三个层级：
| 模型 ID | 层级 | 最适合 |
|---|---|---|
dropstone/dropstone-fast | Fast | 默认日常驱动。快速编辑、脚手架搭建、对话式调试。 |
dropstone/dropstone-pro | Pro | 多文件重构、跨领域更改、更广泛的推理。 |
dropstone/dropstone-heavy | Heavy | 架构决策、大型迁移、困难调试。 |
有关完整细分以及如何设置默认值，请参阅模型。
标志
| 标志 | 描述 |
|---|---|
| 刷新缓存的模型列表 |
| 包含元数据（上下文窗口、功能） |
run
通过直接传递提示以非交互模式运行 Dropstone。
dropstone run [message..]
这对于脚本编写、自动化或当您想要快速答案而无需打开交互式会话时非常有用。例如：
dropstone run 解释 Go 中 context 的用法
您还可以附加到正在运行的 dropstone serve 实例，以避免每次运行时 MCP 服务器冷启动时间：
# 在一个终端中启动无头服务器
dropstone serve
# 在另一个终端中，运行附加到它的命令
dropstone run --attach http://localhost:4096 "解释 JavaScript 中的 async/await"
标志
| 标志 | 简写 | 描述 |
|---|---|---|
| 要运行的命令，使用消息作为参数 | |
| -c | 继续上一个会话 |
| -s | 要继续的会话 ID |
| 继续时派生会话（与 --continue 或 --session 一起使用） | |
| 共享会话 | |
| -m | 要使用的模型（dropstone/dropstone-fast、dropstone/dropstone-pro 或 dropstone/dropstone-heavy） |
| 要使用的代理 | |
| -f | 要附加到消息的文件 |
| 格式：默认（格式化）或 json（原始 JSON 事件） | |
| 会话的标题（如果未提供值，则使用截断的提示） | |
| 附加到正在运行的 Dropstone 服务器（例如，http://localhost:4096） | |
| -p | 基本认证密码（默认为 DROPSTONE_SERVER_PASSWORD） |
| -u | 基本认证用户名（默认为 DROPSTONE_SERVER_USERNAME 或 dropstone） |
| 要运行的目录，或附加时远程服务器上的路径 | |
| 本地服务器的端口（默认为随机端口） | |
| 模型变体（特定于提供商的推理努力） | |
| 显示思考块 | |
| 自动批准未被明确拒绝的权限（危险！） |
serve
启动无头 Dropstone 服务器以供 API 访问。查看服务器文档以了解完整的 HTTP 接口。
dropstone serve
这将启动一个无头 HTTP 服务器，提供对 Dropstone 的编程访问，而无需打开交互式会话。设置 DROPSTONE_SERVER_PASSWORD 以启用 HTTP 基本认证（用户名默认为 dropstone）。
标志
| 标志 | 描述 |
|---|---|
| 监听的端口 |
| 监听的主机名 |
| 启用 mDNS 发现 |
| 自定义 mDNS 域名 |
| 允许 CORS 的额外浏览器来源 |
session
管理 Dropstone 会话。
dropstone session [command]
list
列出所有 Dropstone 会话。
dropstone session list
标志
| 标志 | 简写 | 描述 |
|---|---|---|
| -n | 限制为最近 N 个会话 |
| 输出格式：table 或 json（table） |
delete
删除一个 Dropstone 会话。
dropstone session delete <sessionID>
stats
显示您的 Dropstone 会话的令牌使用量和成本统计信息。
dropstone stats
标志
| 标志 | 描述 |
|---|---|
| 显示最近 N 天的统计信息（全部时间） |
| 要显示的工具数量（全部） |
| 显示模型使用情况细分（默认隐藏）。传递数字以显示前 N 个 |
| 按项目筛选（所有项目，空字符串：当前项目） |
export
将会话数据导出为 JSON。
dropstone export [sessionID]
如果您不提供会话 ID，系统将提示您从可用会话中进行选择。
标志
| 标志 | 描述 |
|---|---|
| 编辑敏感的成绩单/文件数据 |
import
从 JSON 文件或 Dropstone 分享 URL 导入会话数据。
dropstone import <file>
您可以从本地文件或 Dropstone 分享 URL 导入。
dropstone import session.json
dropstone import https://dropstone.io/s/abc123
web
启动带有 Web 界面的无头 Dropstone 服务器。
dropstone web
这将启动一个 HTTP 服务器，并打开 Web 浏览器以通过 Web 界面访问 Dropstone。设置 DROPSTONE_SERVER_PASSWORD 以启用 HTTP 基本认证（用户名默认为 dropstone）。
标志
| 标志 | 描述 |
|---|---|
| 监听的端口 |
| 监听的主机名 |
| 启用 mDNS 发现 |
| 自定义 mDNS 域名 |
| 允许 CORS 的额外浏览器来源 |
acp
启动 ACP（代理客户端协议）服务器。
dropstone acp
此命令启动一个通过 stdin/stdout 使用 nd-JSON 进行通信的 ACP 服务器。
标志
| 标志 | 描述 |
|---|---|
| 工作目录 |
| 监听的端口 |
| 监听的主机名 |
| 启用 mDNS 发现 |
| 自定义 mDNS 域名 |
| 允许 CORS 的额外浏览器来源 |
plugin
安装插件并更新您的配置。
dropstone plugin <module>
或使用别名。
dropstone plug <module>
标志
| 标志 | 简写 | 描述 |
|---|---|---|
| -g | 在全局配置中安装 |
| -f | 替换现有插件版本 |
pr
获取并检出 GitHub PR 分支，然后运行 Dropstone。
dropstone pr <number>
db
数据库工具。
dropstone db [query]
标志
| 标志 | 描述 |
|---|---|
| 输出格式：json 或 tsv |
path
打印数据库路径。
dropstone db path
debug
调试和故障排除工具。
dropstone debug [command]
uninstall
卸载 Dropstone 并删除所有相关文件。
dropstone uninstall
标志
| 标志 | 简写 | 描述 |
|---|---|---|
| -c | 保留配置文件 |
| -d | 保留会话数据和快照 |
| 显示将删除的内容而不删除 | |
| -f | 跳过确认提示 |
upgrade
将 Dropstone CLI 更新到最新版本或特定版本。dropstone update 是别名，行为相同。
dropstone upgrade [target]
# 或
dropstone update [target]
要升级到最新版本：
dropstone upgrade
要安装特定版本：
dropstone upgrade 1.0.5
在 Windows 上，如果 Dropstone 当前正在运行，安装程序会将新构建暂存为 dropstone.exe.pending。新版本将在下次启动时自动激活：无需手动移动文件。
标志
| 标志 | 简写 | 描述 |
|---|---|---|
| -m | 要使用的安装方法：curl、npm、pnpm、bun、brew、scoop、choco |
全局标志
Dropstone CLI 接受以下全局标志。
| 标志 | 简写 | 描述 |
|---|---|---|
| -h | 显示帮助 |
| -v | 打印版本号 |
| 将日志打印到 stderr | |
| 日志级别（DEBUG、INFO、WARN、ERROR） | |
| 在没有外部插件的情况下运行 |
环境变量
Dropstone 在启动时读取以下环境变量。这些是受支持的用户可见变量；此处未列出的任何内容都是内部的，可能会更改或删除，恕不另行通知。
| 变量 | 类型 | 描述 |
|---|---|---|
DROPSTONE_API_KEY | string | 用于无头 / CI 使用的 Dropstone API 密钥（跳过浏览器登录） |
DROPSTONE_CONFIG | string | dropstone.json 配置文件的路径 |
DROPSTONE_TUI_CONFIG | string | 会话配置文件的路径（tui.json） |
DROPSTONE_DISABLE_AUTOUPDATE | boolean | 禁用自动 CLI 更新检查 |
DROPSTONE_GIT_BASH_PATH | string | Windows 上 Git Bash 的路径（用作 shell 工具） |
DROPSTONE_SERVER_PASSWORD | string | 在 dropstone serve / dropstone web 上启用 HTTP 基本认证 |
DROPSTONE_SERVER_USERNAME | string | 覆盖基本认证用户名（默认 dropstone） |