> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin Local Agent

> 可直接在 Devin Desktop 中使用与 Devin CLI 相同的 Agent 运行框架。

Devin Local 是我们的新一代 Agent 运行框架，与 [Devin CLI](https://cli.devin.ai) 共用同一套框架。

它在你的机器上运行，可访问你的本地文件、工具和环境，并计划最终取代 Cascade，成为主要的本地 Agent。

<Note>
  Devin Local 目前仍处于预览阶段，与 Cascade 相比还有一些[限制](#limitations)。Devin Desktop 的 JetBrains 插件目前不支持 Devin Local。
</Note>

<div id="key-improvements">
  ## 主要改进
</div>

自 Cascade 首次发布以来，模型能力已经显著提升。Devin Local 从一开始就围绕高效利用这些进步而构建。

<div id="token-efficiency">
  ### 令牌效率
</div>

Devin Local Agent 的令牌使用效率显著更高，也更侧重于提示缓存。与 Cascade 相比，在完成相同结果的情况下，大多数任务最多可减少 30% 的令牌消耗。

<div id="subagents">
  ### 子 Agent
</div>

Devin Local agent 可以生成独立的[子 Agent](https://cli.devin.ai/docs/subagents)来处理子任务，可在前台或后台运行。子 Agent 与父 Agent 共享工具和代码库上下文，但会在各自独立的对话链中工作。

<div id="sandboxing">
  ### 沙盒
</div>

Devin Local Agent 支持操作系统级沙盒。启用后，沙盒会实施以下限制：

* **文件系统隔离** — 可读写路径根据你的权限作用域确定
* **网络过滤** — 域名允许列表和拒绝列表控制 Agent 可访问的范围

Enterprise Admin 可以通过[团队设置](https://cli.devin.ai/docs/enterprise/team-settings#sandbox-enforcement)在整个组织范围内强制实施沙盒行为，包括要求所有用户启用沙盒模式，以及配置组织范围内的域名过滤规则。

<div id="quick-review">
  ### 快速审查
</div>

[快速审查](/zh/desktop/quick-review) 是 Devin Local Agent 提供的专用子 Agent，用于快速获取变更反馈。

<div id="switching-your-agent">
  ## 切换你的 Agent
</div>

在大多数情况下，当你通过 Devin Desktop 右下角的 Agent 选择器开始*新的*会话时，都可以将 Agent 切换为 `Devin Local`。

<Frame>
  <img src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-switcher.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=5206df1ec64b71ae0463d56f7453aff3" width="844" height="252" data-path="desktop/assets/windsurf/devin-local-agent-switcher.png" />
</Frame>

<div id="agent-settings">
  ### Agent 设置
</div>

如果 Devin Local 没有出现在 Agent 选择器中，你可能需要在 `Devin Settings` 中启用它：

1. 使用 `Cmd+Shift+P` (macOS) 或 `Ctrl+Shift+P` (Windows/Linux) 打开 Command Palette
2. 打开 `Devin User Settings`
3. 点击 “Agents” 选项卡
4. 打开 “Devin Local” Agent 开关
5. 重启 Devin Desktop

<Frame>
  <img src="https://mintcdn.com/cognitionai/WE51TvKjsiyk1ZHl/desktop/assets/windsurf/devin-local-agent-settings.png?fit=max&auto=format&n=WE51TvKjsiyk1ZHl&q=85&s=b0f42c5d3d679c55c450fd9067c34303" width="1200" height="200" data-path="desktop/assets/windsurf/devin-local-agent-settings.png" />
</Frame>

你也可以通过 `devin.cascade.enabled` 设置完全禁用 Cascade。

<div id="differences">
  ## 差异
</div>

<div id="permissions-model">
  ### 权限模型
</div>

Devin Local 用更细粒度的权限系统取代了[自动执行级别](/zh/desktop/terminal#auto-execution-levels)，以控制 Agent 可以执行哪些操作：

* **Deny** 规则会完全阻止操作 (最高优先级)
* **Ask** 规则始终会请求批准
* **Allow** 规则会自动批准操作，无需提示

权限可限定在文件读取、文件写入、命令执行、HTTP 请求和 MCP 工具等范围内。它们可以在项目、用户或组织级别进行配置。

<div id="mcp-permissions">
  ### MCP 权限
</div>

与 Cascade 不同，Devin Local Agent 的默认配置会在调用任何 MCP 工具前提示批准。当 Agent 想要调用某个 MCP 工具时，你可以允许该特定工具，或该 MCP 服务器上的所有工具；可以仅对当前会话生效，也可以永久允许。

<Frame>
  <img src="https://mintcdn.com/cognitionai/awLyB8V-RSMAHpBB/desktop/assets/windsurf/devin-local-mcp-permissions.png?fit=max&auto=format&n=awLyB8V-RSMAHpBB&q=85&s=c10aa13cbe249f0aa4f67d502c25ebf4" width="1300" height="486" data-path="desktop/assets/windsurf/devin-local-mcp-permissions.png" />
</Frame>

Enterprise Admin 可以默认允许特定的 MCP 服务器或工具，这样受信任的集成就无需每次都提示。有关如何配置这些规则，请参阅[基于工具的权限](/zh/cli/reference/permissions#tool-based-permissions)。

<div id="mcp-server-configuration">
  ### MCP 服务器配置
</div>

使用 Devin Local Agent 时，可通过你本地计算机上的[配置文件](https://cli.devin.ai/docs/extensibility/mcp/configuration)配置 MCP 服务器。

文件位置由作用域决定：

| 作用域  | 位置                            | 与团队共享？              |
| ---- | ----------------------------- | ------------------- |
| 项目   | `.devin/config.json`          | 是 (会提交到版本控制中)       |
| 本地覆盖 | `.devin/config.local.json`    | 否 (已被 gitignore 排除) |
| 用户   | `~/.config/devin/config.json` | 否                   |

<div id="skills">
  ## 技能
</div>

技能是可复用、由模型调用的一组指示 (以及可选脚本) ，可扩展 Devin Local agent 的能力。由于 Devin Local 与 [Devin CLI](https://cli.devin.ai) 共享同一套 Agent 运行框架，因此使用相同的技能格式和发现机制。

技能也是迁移 Cascade 记忆和工作流程的推荐方式，而 Devin Local agent 目前不支持这些功能 (请参见[限制](#limitations)) ——只需将可复用的步骤整理一次，Agent 就会在相关时自动调用。

有关如何创建、配置和设置技能作用域的详细信息，请参阅 [Devin CLI 技能文档](/zh/cli/extensibility/skills/overview)。

<div id="limitations">
  ## 限制
</div>

以下功能目前在 Devin Local agent 中尚不支持：

* **记忆** — Devin Local agent 不会在不同会话之间持久保留记忆。请将你的关键记忆迁移到 [技能](/zh/desktop/cascade/skills)。
* **工作流程** — Devin Local agent 不支持工作流程。请将你的工作流程迁移到 [技能](/zh/desktop/cascade/skills)。
* **Codemaps** — Devin Local agent 目前还不能读取 [codemaps](/zh/desktop/codemaps)。
* **代码透镜** - 目前，[代码透镜](/zh/desktop/command/windsurf-related-features) 还无法触发 Devin Local agent。
* **快速上下文** - Devin Local 会使用子 Agent 来探索代码，但没有像 Cascade 那样的快速上下文 UI。
* **应用部署** - Devin Local agent 不支持应用部署。
* **浏览器预览** - Devin Local agent 目前尚不支持 IDE 内的[浏览器预览](/zh/desktop/previews)，包括 DOM 元素选择器工具。
* **对话共享** - Devin Local agent 目前还不支持对话共享。

Devin Local agent 支持使用 [rules and AGENTS.md files](https://cli.devin.ai/docs/extensibility/rules) 以及 [技能](https://cli.devin.ai/docs/extensibility/skills/overview) 来提供持久上下文和可复用的工作流程。

<div id="analytics">
  ### 分析
</div>

Devin Local agent 尚未上报 Cascade 收集的全部分析数据。以下数据会为 Cascade 收集，但**不会**为 Devin Local 收集：

* **工具用量** — [`cascade_tool_usage`](/zh/desktop/accounts/api-reference/cascade-analytics) 数据源 (按工具统计的调用次数，例如 Code Edit、Run Command、Search Web 和 MCP Tool) 仅包含 Cascade 会话。Devin Local agent 发起的工具调用不会被上报。若要监控或限制 Devin Local agent 的工具用量，请改用[钩子](/zh/cli/extensibility/hooks/overview)和[权限](/zh/cli/reference/permissions)。
* **建议和已接受的代码行数** — [`cascade_lines`](/zh/desktop/accounts/api-reference/cascade-analytics) 数据源 (按天统计建议和已接受的代码行数) 不包含 Devin Local agent 编写的代码。
* **写入/读取模式** — Devin Local agent 不会上报 Cascade 模式，因此 `cascade_runs` 数据源中的 `mode` 字段不会为 Devin Local 活动填充值。

Devin Local 活动仍包含在 [`cascade_runs`](/zh/desktop/accounts/api-reference/cascade-analytics) 数据源中 (模型用量、已发送消息数和额度消耗) ，也包含在自定义分析 API 的 [Cascade Data source](/zh/desktop/accounts/analytics-api#cascade-data) 中。

Devin CLI 不会为[混合部署](https://devin.ai/blog/self-hosted-deployment-maintenance-mode)上报分析数据。

<div id="enterprise-controls">
  ### 企业级控制
</div>

企业管理员可以通过[团队设置](https://windsurf.com/team/settings)配置 Devin Local agent，其中包括[仅适用于 Devin Local agent 的新控制项](https://cli.devin.ai/docs/enterprise/team-settings)：

* **沙盒强制执行** - 要求所有用户使用沙盒模式，并配置组织范围内的域名过滤规则
* **细粒度权限** - 通过更细化的权限控制 Agent 可执行的操作
* **网络强制执行** - 通过允许和拒绝的域名来控制网络访问

此外，还可以使用“Enable Cascade”控制项来完全禁用旧版 Cascade agent，以确保你的团队遵循 Devin CLI 中提供的新控制项。

<div id="unsupported-enterprise-controls">
  #### 不支持的企业级控制项
</div>

以下旧版企业级控制项在 Devin Local agent 中不可用：

* **将工具调用限制在工作区内** - 默认情况下，Devin Local agent 只能读取/编辑工作区内的文件。
  自定义[权限](https://cli.devin.ai/docs/reference/permissions)是更灵活的替代方案，可用于实现相同的规则。
* **应用部署** - Devin Local agent 尚不支持应用部署。
* **对话共享** - Devin Local agent 尚不支持会话共享。
* **为你的团队启用或禁用 Cascade** - 此设置仅控制旧版 Cascade agent，不适用于 Devin Local agent 或 Devin CLI。
* **全局工具调用已禁用** - 如果你之前完全禁用了工具调用，请改为为 Devin CLI 编写等效的[权限策略](https://cli.devin.ai/docs/reference/permissions)。

如果你尚未实现企业级 CLI 权限配置，以下旧版控制项仍会作为回退继续生效：

* **自动运行终端命令** - Devin Local agent 使用自己的[权限模型](https://cli.devin.ai/docs/reference/permissions)，而不是自动执行级别；我们建议使用这种方式，但旧控制项仍会作为回退继续生效。
* **终端允许列表** - 为 Devin CLI 配置等效的[权限策略](https://cli.devin.ai/docs/reference/permissions)，以允许特定终端命令。
* **终端拒绝列表** - 为 Devin CLI 配置等效的[权限策略](https://cli.devin.ai/docs/reference/permissions)，以拒绝特定终端命令。

<div id="further-reading">
  ## 延伸阅读
</div>

* [Devin CLI 快速开始](https://cli.devin.ai/docs)
* [必备命令](https://cli.devin.ai/docs/essential-commands)
* [扩展性概览](https://cli.devin.ai/docs/extensibility)
* [团队设置](https://cli.devin.ai/docs/enterprise/team-settings)