> ## 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 Local 模式

> 在 Devin Desktop 中让 Devin 本地智能体在代码、智能、提问、规划和 Bypass 权限模式之间切换，并在实施前先做规划。

Devin Local 会话提供五种模式。每种模式决定了智能体可以执行哪些操作，以及执行前需要征求多少确认。

| 模式 | 适用场景 | 智能体的行为 |
| - | - | - |
| [代码](#code-mode) | 功能开发、重构、修复 | 编写和编辑代码；自动批准 workspace 内的编辑 |
| [智能](#smart-mode) | 处理日常工作时减少打断 | 与代码模式相同，另由一个快速模型自动批准其判断为安全的其他操作 |
| [提问](#ask-mode) | 学习、提问、探索 | 回答问题，不修改代码 |
| [规划](#plan-mode) | 需要先制定计划的复杂功能 | 以只读方式探索，并编写计划供你批准 |
| [Bypass 权限](#bypass-permissions) | 你完全信任的无人值守运行 | 自动批准所有工具调用，除非你的组织策略要求批准 |

通过输入框下方的模式选择器切换模式。Devin Local 与 Devin CLI 共享同一套智能体运行框架，其模式与 Devin CLI 的 Agent 模式和[权限模式](https://docs.devinenterprise.com/zh/cli/reference/permissions.md)相对应。你也可以在 Devin Local 输入框中输入 `/code`、`/smart`、`/ask`、`/plan` 或 `/bypass` 来切换模式。

无论处于哪种模式，你的[权限规则](https://docs.devinenterprise.com/zh/desktop/devin-local/permissions.md)以及组织强制执行的规则都仍然有效。即使在 Bypass 权限模式下，管理员强制执行的拒绝规则和询问规则也优先生效。

## 代码模式

**代码模式**是用于更改代码库的默认模式。

在代码模式下，智能体可以：

* 创建、编辑和删除文件
* 运行终端命令
* 搜索和分析您的代码库
* 安装依赖
* 自主执行包含多个步骤的任务

workspace 内的编辑会自动获得批准。Shell 命令、网络获取操作和 MCP 工具在执行前会请求批准，除非已有允许规则涵盖它们。如果您的组织不允许自动批准编辑，代码模式也会在编辑前请求批准。

> [!TIP]
>
> 我们建议将代码模式作为大多数任务的默认模式。

## 智能模式

**智能模式**保留了代码模式中自动批准的编辑操作，并新增一个快速模型，由它判断其余每项操作能否无需询问即可安全运行。凡是未被明确判定为安全的操作仍会弹出提示；高风险类别 (安装软件包、会修改状态的 `git` 命令、`rm`、`sudo`、具有破坏性的 cloud CLI 操作、涉及敏感文件的操作) 则始终会提示确认。

> [!NOTE]
>
> 智能模式正在逐步推出，因此可能暂未出现在您的模式选择器中。完整行为说明请参阅[智能模式](https://docs.devinenterprise.com/zh/cli/reference/permissions.md#smart-mode)。

## 提问模式

**提问模式**是一种只读模式，专为提问和探索场景优化。

在提问模式下，智能体可以搜索和分析您的代码库，但不能做任何更改。

## 规划模式

**规划模式**会在编写任何代码之前先制定详细的实现计划，帮助你理清复杂任务的思路。

在规划模式下，智能体会：

* 探索你的代码库，了解当前状态
* 提出澄清问题，确保计划符合你的目标
* 通过交互式界面提供多个选项供你选择
* 在外部 Markdown 文件中给出一份包含实现步骤的详细计划

计划文件存放在你的代码仓库之外，并在整个会话期间保留，因此规划可以跨越多条消息进行。智能体完成规划后，会询问是否开始实现；你也可以直接点击计划文件上的 **Implement**，切换到代码模式并开始实现。

### 深度规划

只要在消息中的任意位置加入关键词 `megaplan`、`ultraplan` 或 `masterplan`，对话就会切换到规划模式，智能体也会进行更全面的规划：在撰写计划之前，它至少会提出一个澄清问题。移除该关键词后，对话将恢复为之前的模式。

### 基于计划继续工作

在规划模式中创建的 Markdown 文件特别适合用于跨多个会话继续工作。

计划存储在 `~/.devin/plans/` 中，并可在 [@提及](https://docs.devinenterprise.com/zh/desktop/chat/overview.md#%40-mentions) 菜单中找到。提及某个计划文件后，你就可以在全新的上下文中继续实现。

当最初的实现偏离预期时，这一点尤其有用：丢弃原有更改，调整计划文件，然后点击 **Implement**，即可在新的对话中重新尝试实现。

### 退出规划模式

从规划阶段转入实现阶段有多种方式：

* 点击计划文件上的 **Implement** 按钮
* 计划就绪后，批准智能体退出规划模式的请求
* 在输入框中将模式切换为代码模式

## Bypass 权限

**Bypass 权限**会自动批准所有工具调用，包括文件写入和 Shell 命令。

> [!WARNING]
>
> 仅在你完全信任的任务中使用 Bypass 权限。它绝不会覆盖管理员配置的组织级权限：管理员强制执行的拒绝规则和询问规则始终优先生效。

## 沙盒会话

启用[沙箱隔离](https://docs.devinenterprise.com/zh/desktop/devin-local/overview.md#sandboxing)后，会话将以**自主**模式运行，而非上述任一模式：操作系统级沙箱会限制命令可访问的范围，系统会针对能力 (例如网络访问) 而非单个命令向你请求授权。请参阅[自主模式](https://docs.devinenterprise.com/zh/cli/reference/permissions.md#autonomous-mode)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.