跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt

Use this file to discover all available pages before exploring further.

​
启动 Devin CLI

默认情况下，会话会在 REPL 中进行。REPL 是一种图形化终端界面，你可以在其中来回对话并观察 Devin 的操作。 
devin                            # 启动交互式 REPL（无提示）
devin -- your prompt here        # 启动带初始提示的 REPL
devin -p "prompt"                # 单轮模式，无 REPL：将响应输出到标准输出并退出
devin -p -- prompt words here    # 同上，使用 -- 分隔符（同样有效）
在提示前加上 --，这样它会被识别为提示，而不是子命令。
单轮模式 (-p) 非常适合脚本和自动化。
在提示输入框中键入 @，即可打开本地文件/目录的自动补全。选择一项后，会将其作为上下文添加到你的消息中。
你可以用 Ctrl+V 从剪贴板粘贴图片。附加的图片会显示在输入区域中，可使用 左/右方向键 切换，并用 Backspace 删除。

​
运行 shell 命令

Devin 在工作过程中可能会运行 shell 命令。如果某个命令在默认等待时间过后仍未结束，Devin 会将其转入后台，并显示已等待的时长以及后台 shell ID。这样，Devin 就可以继续工作，并在稍后检查该命令的输出。

​
模式

Devin CLI 有 4 种内置权限模式：Normal、Accept Edits、Bypass 和 Autonomous，以及 3 种 Agent 模式：Normal、Plan 和 Ask。如需使用 Plan 和 Ask，请使用 /plan 和 /ask。

Normal

会自动批准当前目录内的只读工具，并在执行写入/执行操作时请求权限。
/normal
# 或
/mode normal
这是默认模式。
会自动批准 工作区 内的文件编辑，但仍会对 shell 命令和其他操作进行提示。我们预计用户大多数时间都会使用这个模式。
/accept-edits
# 或
/mode accept-edits
会自动批准所有工具调用，包括写入和 shell 命令。
/bypass
# 或
/mode bypass
你也可以以 bypass 模式启动：
devin --permission-mode bypass
别名：/yolo、/dangerous
Bypass 模式绝不会覆盖你的 Admin 通过 团队设置 配置的组织级权限。由 Admin 强制执行的 deny 和 ask 规则始终优先。
大致相当于在当前 工作区 中使用 Accept Edits，并额外支持在 OS-level 沙盒 内运行任意 shell 命令 (以限制这些命令实际能够访问的内容) 。
devin --sandbox --permission-mode autonomous
使用 --sandbox 运行时，Autonomous 是唯一可用的权限模式，并会自动选中——Normal、Accept Edits 和 Bypass 会在 沙盒 session 中隐藏。在 Autonomous 模式下…
  • 系统会针对能力而非命令向你发出提示。
    • 命令会通过文件系统沙盒遵循 Write 和 Read 作用域。
    • 当命令尝试连接网络资源时，系统会提示你。
  • 当前目录内的只读操作会自动批准。
Autonomous 依赖 沙盒 来保障安全。未启用 --sandbox 时，此模式不可用——如果你希望在没有 OS 级隔离的情况下进行无人值守执行，请使用 Bypass。有关直接对比，请参阅下方的 Bypass vs Autonomous。

​
Bypass 与 Autonomous 的区别

Bypass 和 Autonomous 都能减少审批提示，但它们采用的安全机制不同：
BypassAutonomous
需要 --sandbox否是 (仅在 沙盒 会话中可用)
Shell 命令自动批准，不受限制自动批准，但受 沙盒 约束
通过 edit/write 工具写入文件在任何位置都会自动批准仍会提示 (授予某个作用域会扩展 沙盒)
网络访问不受限制受 沙盒 的域名允许/拒绝列表过滤
遵循 Admin 团队设置是是
当你信任 Agent 操作整台机器时，选择 Bypass。若你希望无人值守执行，同时由操作系统强制限制 Agent 可访问的文件和域名，请选择 --sandbox (这会启用 Autonomous) 。如果你喜欢 bypass 的使用体验，但又希望 Agent 拥有自己独立的电脑，不妨试试 cloud Devin！

​
会话历史

你的对话历史会被保存，以便你稍后继续之前的会话。 
devin -c              # 继续当前目录中最近的会话
devin --continue

devin -r              # 从最近的会话中选择
devin --resume
devin -r brisk-otter  # 通过 ID 恢复指定会话

​
斜杠命令

你可以在当前会话中使用这些命令。
命令描述
/help查看所有可用命令
/exit or /quit退出应用
/clear or /new清除对话历史 (重新开始)
你也可以直接输入 exit 或 quit 作为普通文本 (不带 / 前缀) 来退出。

​
模式切换

命令说明
/mode显示当前模式
/mode <name>切换模式 (normal、accept-edits、plan、bypass；在沙盒会话中还可使用 autonomous)
/normal切换到 Normal 模式 (默认)
/plan切换到 Plan 模式
/ask <question>仅提问而不进行代码修改 (oneshot)
/bypass切换到 Bypass 模式 (别名：/yolo、/dangerous)

​
模型切换

命令说明
/model显示模型选择器

​
会话管理

命令描述
/resume打开交互式会话选择器
/resume <id>按 ID 恢复会话
/ls列出当前目录中最近的会话 (别名：/list-sessions)
/ls --all列出所有目录中的会话
/continue恢复最近一次会话
/continue <id>按 ID 恢复会话
/rm-session <id>按 ID 永久删除会话

​
工作区

命令描述
/workspace列出工作区目录 (别名：/workspaces)
/add-dir <path>添加额外的工作区目录
/undo-add-dir <path>移除工作区目录

​
自动化

命令说明
/loop <prompt>运行提示，并循环自动审查 diff (开始前要求 git 处于干净状态)

​
可扩展性

命令说明
/hooks列出所有已加载的 hook，以及它们的 ID、事件类型和源路径

​
账户与系统

命令说明
/login登录 Devin
/logout清除已存储的凭据并退出
/update检查并安装更新
/upgrade升级你的订阅套餐
/bug向 Devin CLI 开发者报告 bug
/compact强制压缩会话
如果你通过 Homebrew 安装了终端版 Devin，/update 会提示你改用 brew upgrade devin，而不是执行自更新。

​
键盘快捷键

以下是最重要的键盘快捷键。更多快捷键请参见 键盘快捷键。
快捷键描述
Shift+Tab在各模式间循环切换 (Normal、Accept Edits、Plan、Bypass、Autonomous)
Ctrl+C清除输入文本，或取消正在运行的 Agent
Esc取消正在运行的 Agent
Shift+Enter插入换行 (多行输入)
Ctrl+V 或 Shift+Insert从剪贴板粘贴
Ctrl+G打开外部编辑器
Ctrl+O打开全屏思考轨迹查看器
@提及文件，将其添加到上下文中