> ## 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.

# 变更日志（稳定版）

> 稳定通道的发布说明

<Update label="v3000.1.27" description="2026 年 7 月 6 日">
  ### 修复

  * 修复了自主模式下查看 diff 的问题。
</Update>

<Update label="v3000.1.23" description="2026 年 7 月 4 日">
  ### 新增

  * 新增了一个带有实时 MCP 服务器状态面板的 `/mcp` 斜杠命令。
  * `/usage` 命令中现在会显示 ACU 用量。
  * CLI 现在会强制执行 Enterprise 登录策略。
  * 新增了 `sandbox.excluded` allow/ask/deny 配置 (用户和团队设置) ，用于在沙盒外运行特定命令；被排除的命令也会跳过沙盒代理环境。

  ### 更改

  * 自主模式下生成的编辑现在会产生可审查的 diff。
  * skill `permissions:` frontmatter 现在也会应用于自动批准。

  ### 修复

  * 修复了对 PowerShell `$variable` 赋值前缀的命令批准解析问题。
</Update>

<Update label="v2026.8.18" description="2026 年 6 月 23 日">
  ### 新增

  * 现在可以为子 Agent 配置默认模型。
  * 在 Devin Local [配置文件](/zh/cli/reference/configuration/config-file) 中新增了一个 `attribution` 选项；将其设为 `false` 可禁止在 commit message 中提及 Devin。

  ### 更改

  * MCP Registry 缓存现在会在启动期间预热，因此 MCP 服务器能更快就绪。

  ### 修复

  * 在 Windows 上，`bash` 现在会解析到 Git Bash，而不是 WSL 启动器 stub。
  * 注入的上下文不再包含在自动生成的 session 标题中。
  * 修复了 CLI 问答回复的全角换行问题。
</Update>

<Update label="v2026.7.23" description="2026 年 6 月 18 日">
  ### 修复

  * 提高了 MCP Registry 解析对旧版和不一致 schema 的容错性。
</Update>

<Update label="v2026.7.19" description="2026 年 6 月 17 日">
  ### 修复

  * 修复了加载使用替代字段的 skill 文件时的一个 bug。
</Update>

<Update label="v2026.7.16" description="2026 年 6 月 16 日">
  ### 插件

  可从 GitHub repo、git URL 或本地文件夹安装成组的 技能，并在多个项目间共享。插件是指任何包含 `.devin-plugin/plugin.json` 清单和 `skills/` 目录的 source；其 技能 会以 `/<plugin>:<skill>` 的形式可用。一个插件可以依赖其他插件 (自动安装) 、推荐可选插件，并禁止其他插件——因此插件可以作为经过策展和治理的集合。插件目前处于 beta 阶段，且对企业客户为选择加入功能，因此其行为和配置可能会在未来版本中发生变化。详见[插件概览](/zh/cli/extensibility/plugins/overview)。

  ### Enterprise 控制

  为 admins 扩展了控制能力，以管理 Devin Local 能做什么以及可以访问哪些工具。

  * 团队可以定义终端命令 allow/deny list，并通过 CLI permission scopes 强制执行，支持精确命令匹配和 `*` 通配符。
  * 可通过组织级控制禁用 Devin CLI 插件：设置后，CLI 将拒绝安装或更新插件，并跳过任何已安装插件中的 技能。
  * “Disable CLI access” 团队设置现在也会对 Devin Local (托管在 Windsurf 中的 CLI) 生效，包括内置的 Agent registry 和 allowed-MCP-server allowlist。

  ### 新增

  * `devin plugins install <source>` 可从 GitHub `owner/repo`、git URL 或本地路径安装插件 (以及其所需插件) 。
  * `devin plugins list` 会显示已安装的插件、其版本，以及它们当前是否被策略阻止。
  * `devin plugins info <plugin>` 会显示插件提供的技能，以及其必需、可选和禁止列表。
  * `devin plugins update [plugin]` 会以最新版本重新拉取某个插件 (或所有插件) ；本地插件会链接到其源文件夹，因此修改后无需重新安装即可立即生效。
  * `devin plugins remove <plugin>` 会卸载插件，同时保留任何自动安装的必需插件。
  * `forbiddenPlugins` 条目除了精确标识和单独的 `*` 锁定外，还支持 glob 模式 (例如 `acme/*`、`*/secrets`、`https://gitlab.com/acme/*`) 。

  ### 更改

  * 改进了第三方 ACP 客户端 (包括 JetBrains 和 Zed) 中的身份验证：浏览器登录和手动登录现在都使用 Devin 身份验证流程，因此手动 `/login` fallback 现在可在之前失败的情况下正常工作。
</Update>

<Update label="v2026.5.26-8" description="2026 年 6 月 9 日">
  ### 已修复

  * 现在登录 Devin 时会遵循 `config.json` 中的 `proxy` 设置 (`mode`、`url`、`no_proxy`) 。此前，登录时的令牌交换始终会直接连接 (`HTTP_PROXY`/`HTTPS_PROXY` 环境变量除外) ，忽略已配置的 `manual` 代理 URL、`off` 模式以及配置级别的 `no_proxy`。
</Update>

<Update label="v2026.5.26-7" description="2026 年 6 月 8 日">
  ### 已修复

  * 自定义 HTTP 标头现在会在 MCP OAuth 自动发现和授权流程中透传，因此位于需要额外标头 (例如授权标头) 的网关之后的 MCP 服务器现在也可以完成 OAuth 登录。
  * 内置 MCP OAuth 策略 (例如 Figma 的策略) 现在会根据签发者而非网关 hostname 进行匹配，因此当服务器通过网关或代理访问时，也能正确解析。
</Update>

<Update label="v2026.5.26-6" description="2026 年 6 月 5 日">
  ### 已修复

  * IDE 编辑器上下文 (当前活动文件、光标位置、打开的选项卡) 现在包含了明确的相关性说明，因此 Agent 不再将被动浏览代码误认为是要求其对当前聚焦文件采取操作的请求。
  * IDE 编辑器上下文 (当前活动文件、光标位置、打开的选项卡) 现在会随每条用户消息一并注入一次，而不是在每次模型响应前重复注入，因此 Agent 不再说明已打开的 IDE 文件是否与该请求相关。
</Update>

<Update label="v2026.5.26-5" description="2026 年 6 月 3 日">
  ### 已修复

  * 启动 Devin CLI 后如果未发送消息就退出，将不再在 `devin list` 中留下一个空的“Untitled”会话；会话会在你发送第一条消息后保存。
</Update>

<Update label="v2026.5.26-0" description="2026年5月26日">
  ### 新增

  * 支持 Gemini 3.5 Flash 模型。
  * 新增 `/cloud-attach <session-id>` 命令，可连接到现有的云端 Devin 会话，并完整呈现 TUI (工具调用、消息、计划、文件编辑) 。现有的 `/handoff` 行为保持不变。
  * 新增 `/cloud-sessions [--all]` 命令，用于列出最近的云端 Devin 会话及其可连接的会话 ID。
  * 自定义子 Agent Profile 现在可通过 `max-nesting` frontmatter 字段选择启用嵌套子 Agent 生成，从而覆盖默认深度限制。
  * 受支持的编辑器集成 (包括 Windsurf) 现在会将你当前打开的文件、你的游标位置以及其他已打开的编辑器选项卡作为上下文的一部分提供给 Agent。
  * 用于以 ATIF 格式导出对话历史的 `--export` 开关。
  * 新增 `/fast` 斜杠命令，可快速切换到 SWE-1.6 Fast，并显示与当前模型的价格对比。
  * Figma MCP 服务器现在可通过 `devin mcp add figma --url https://mcp.figma.com/v1` 完成身份验证，无需额外配置。
  * 当系统提示你为某个 MCP 工具授予权限时，现在还会额外提供两个服务器级选项：为当前会话批准该服务器上的所有工具，或永久批准。这样你就可以授予更广泛的访问权限，而无需逐个重新批准每个工具。
  * 在具有 Shell 集成的 terminals 中支持提示导航和可折叠命令区段。VS Code、Windsurf、Ghostty、iTerm2、kitty、WezTerm 和 Windows Terminal 用户现在可以使用键盘快捷键在提示之间跳转 (例如 VS Code 中的 Ctrl+Shift+Up/Down) ，在滚动条中查看提示标记，并折叠 Agent 输出区段 (iTerm2) 。提示标记在会话恢复后也会保留。
  * 回退预览现在会针对所有 action 类型 (restore、delete、recreate) 显示行 diff 统计信息 (`+N -M`) 以及“查看 diff”按钮。
  * `show_hints` 配置选项，用于隐藏轮次之间的“Did you know”提示 (默认：开启)

  ### 已更改

  * 长对话现在会更早在后台压缩，因此当上下文接近满载时，Agent 因等待而暂停的时间更短。
  * ATIF 导出现在包含更丰富的每步骤转录详情，包括遥测数据和耗时指标。
  * 超时后仍在后台继续运行的 Shell 命令，现在会报告 Devin 在返回前实际等待了多长时间。
  * 内置的 Explore 子 Agent 现在除了可使用其只读 codebase 工具外，还能通过网页搜索研究 codebase 之外的主题。它仍然无法抓取任意 URL 或编辑文件。
  * Homebrew 安装现在改为由外部管理。`/update` 命令将引导用户通过 `brew upgrade devin` 升级，而不是尝试自行更新。
  * HTTP MCP 服务器现在会优先尝试 Streamable HTTP，并在服务器返回 HTTP 4xx 错误时根据 [MCP 规范](https://spec.modelcontextprotocol.io/specification/2025-03-26/basic/transports/#backwards-compatibility)自动回退到旧版 SSE。
  * MCP OAuth 回调页面现在会显示带有 Devin 品牌的成功和失败页面，而不再是纯文本。
  * 在面向用户的 UI、REPL 欢迎与启动横幅、斜杠命令说明 (`/bug`) 、错误报告输出、云端交接消息、版本自管理消息、提示和公开文档中，产品名称已从“终端版 Devin”更名为“Devin CLI”。二进制名称、配置路径和安装 URL 保持不变。
  * 回退预览现在会针对不可逆操作显示说明性警告，而不再是空白占位符。
  * 只读 Shell 命令 (如 `ls`、`cat`、`pwd`) 在回退期间不再触发不可逆操作警告。
  * Shell 集成 启动速度更快，减少了打开 shell 时的明显延迟。
  * 精简了 Devin CLI 的首次运行欢迎消息。
  * Windows：默认的非交互式 shell 现在改为 PowerShell，而不是 Git Bash。在 Windows 上运行 Devin CLI 不再需要 Git for Windows。

  ### 已修复

  * Windsurf 中的图片附件现在会在所选的 Devin CLI 模型不支持图片时显示正确的警告。
  * 当模型达到最大输出 `token` 限制而导致响应被静默截断时，现在会显示警告，并在管道模式下以非零状态退出，而不是像完整输出一样返回部分结果。
  * 在 HTTP 413 之后跨轮次保留降低后的尾部图片上限；这样可防止该上限在每轮重置为 20，并反复触发 413
  * 现在会在 message-forest chokepoint 将 bmp/tiff/ico 图片重新编码为 PNG，而不是以不受支持的 `mime_type` 将它们转发给 Anthropic；此前这会表现为 `messages.N.content.0.image.source.base64.media_type: Input should be 'image/jpeg', 'image/png', 'image/gif' or 'image/webp'` 400 错误。
  * 现在会丢弃那些字节无法被完全解码的超大 (>5 MB) 图片，而不是原样传递它们；此前这会表现为 `image exceeds 5 MB maximum` 400 错误。
  * 在多项选择题的 "Other (type your own)" 字段中输入时，不再会丢掉 `e`/空格，或将 `j`/`k`/数字识别为快捷键；现在所有字符都会插入到答案中。
  * 当你的组织要求使用沙箱模式时，Plan mode 现已可用。此前 `/plan` 和 `/mode plan` 会被拒绝，并显示 "Plan mode is not available"，尽管 Plan mode 是只读的。
  * 现在，退出代码为 2 的用户提示前钩子会正确阻止提示，而不是被静默忽略。
  * 回退某个步骤时，对于 Agent 在 IDE 中的编辑被拒绝的文件，不再错误地报告 "file was modified externally" 冲突。
  * 回退或编辑已取消的提示 (在任何输出开始流式传输前停止) 不再会因 "could not resolve step." 而失败。
  * 沙箱模式在命令完成后不再会在项目目录中留下空的幽灵点文件 (`.bashrc`、`.gitconfig`、`.mcp.json` 等) 。
  * 会话内的 `skill` 工具现在可以找到 `.windsurf/skills/`、`.agents/skills/` 和 `.claude/skills/` 下通过符号链接目录访问到的 skills，与 `devin skills list` 保持一致。
  * `/handoff` 现在会收集整个代码仓库中的未跟踪文件，而不只是当前子目录中的文件
  * `/handoff` 现在会将未跟踪文件包含在发送到 cloud Devin 的 git diff 中，而不只是已跟踪的更改
  * Windsurf 中的 "Always Allow" 权限授权现在会跨会话保留。此前，在 ACP 权限对话框中选择 "Always Allow" 只会为当前会话授予该作用域。
</Update>

<Update label="v2026.5.6-1" description="2026 年 5 月 8 日">
  ### 网页搜索

  直接在你的 Devin CLI 会话中搜索网页。Agent 可以
  查阅文档、寻找解决方案，并从互联网获取相关信息，
  而无需离开终端。

  ### 已新增

  * 为 GitHub MCP 服务器提供内置 OAuth 设备流。`devin mcp add github --url https://api.githubcopilot.com/mcp/` 现在会通过设备流进行身份验证 (在 github.com/login/device 输入代码) ，无需 `--oauth-client-id`。
  * 新增 `/copy` 命令，可将上一条 Agent 响应复制到系统剪贴板。支持通过 SSH 连接使用，也支持 Linux 桌面环境。
  * 选择提示中的编号选项现在可以直接按 `1`-`9` 键选择，无需再用方向键移动后按 Enter。在非搜索提示中，此快捷方式会显示为每个选项前的数字前缀。
  * 新增 `web_search` 工具，可在 Agent 会话期间搜索网页。

  ### 已修复

  * 现在取消会话时，也会停止正在运行的子 Agent，而不是让它们继续在后台运行
  * 将输出重定向到 `/dev/null` 的 Shell 命令 (例如 `2>/dev/null`、`>/dev/null`、`&>/dev/null`) 不再提示需要 `/dev/null` 的写入权限。
  * 编辑工具预览现在会显示正确的文件行号，而不再总是从 1 开始。
  * 输出令牌限制已从 16k 提升，以匹配各模型的实际容量 (Opus 为 128k，Sonnet 为 64k) ，从而防止响应被过早截断。
  * 在 BS 模式终端中，Option+Backspace 现在会在选择菜单 (用户问题的 “Other” 字段和搜索) 中正确删除单词，而不是插入 'h'。
  * 斜杠命令的输出现在与提示之间具有一致的视觉间隔，与 Agent 响应的显示方式保持一致。
</Update>

<Update label="v2026.5.5-0" description="2026 年 5 月 5 日">
  ### 已新增

  * `skill search` 现在可以在项目路径下递归查找可由模型调用的 技能，并按关键词进行筛选。

  ### 已更改

  * 默认模型现为 SWE 1.6 Fast，而不是 Adaptive。

  ### 已修复

  * `apply_patch` 的 diff 现在会在补丁写入过程中逐步显示，而不再只在完成后才显示。无论是新建文件还是修改现有文件的补丁，diff 都会逐步呈现。
  * 现在，如果通过重命名后的二进制文件、符号链接或别名运行 Devin CLI，命令提示会显示实际用于启动 Devin CLI 的二进制名称。
  * 修复了 MCP OAuth 动态客户端注册失败时进程卡住的问题。发生错误时，本地回调 server 未被正确关闭，导致进程会一直阻塞，等待一个永远不会发生的浏览器重定向。
  * `/steps`、`/revert` 和 `/fork` 现在会显示压缩前的步骤，并且可对这些步骤进行操作。此前，会话压缩后，所有更早的步骤都会变得不可见且无法回退。
  * 现在，当文本和工具调用在同一次流式返回中同时产生时，文本会在滚动历史中正确显示在工具调用之前。
</Update>

<Update label="v2026.4.30-4" description="2026 年 5 月 1 日">
  ### 已修复

  * `/usage` 命令现在会向采用配额计费的用户显示剩余配额百分比和超额余额，而不再显示“未消耗积分”。
</Update>

<Update label="v2026.4.30-0" description="2026 年 4 月 30 日">
  ***

  bumps:
  chisel: minor
  config-importers: minor
  -----------------------

  新增了对 OpenCode、VS Code 和 Zed 编辑器的 MCP 配置导入支持。
  新增了 Cursor 全局 MCP 配置加载 (`~/.cursor/mcp.json`)。
  现在可以通过用户配置中的 `read_config_from` 切换新的提供商。

  ### 已新增

  * `apply_patch` 进行的文件编辑现在会在 Windsurf 中显示为行内 diff，与 `edit` 工具已显示的 diff 预览保持一致。

  * 新增 `/login-status` 命令，用于显示登录调试信息 (电子邮件、套餐、团队) 。

  * 新增 `post_compaction` 钩子事件，会在上下文压缩后触发，并可通过 stdin 获取压缩摘要。

  ### 已更改

  * Permission 提示现在对“始终允许”的命令选项采用了更清晰的表述，并且在组织策略允许时，可提供切换到 Bypass 的选项。

  * 后台 shell 命令现在会显示为一张带加载动画的单个 exec 卡片，而不是在每次 `get_output` 和 `kill_shell` 轮询时分别显示单独的“Command Read”/“Killing shell”卡片。

  * Ctrl+L 现在会像 bash 和其他 shell 一样正确清屏。可见内容会滚动到终端的滚动缓冲区中，因此你仍然可以向上滚动查看。完整重绘 (从头重新渲染所有内容) 现已改为 Ctrl+Shift+L。

  * 启动横幅不再显示用户的电子邮件地址。

  * 从其他目录恢复会话时，现在会提示你选择使用会话的原始目录、永久切换到当前目录，或仅本次使用当前目录。

  * 改进了模型输出的流式视图。

  * 已更新启动时的盲文 Logo，以匹配 devin.ai/terminal 上的设计。

  ### 已修复

  * 使用 `devin -r` 恢复 Windsurf 会话时，现在会显示会话历史记录，而不是空白屏幕。
  * MCP OAuth 自动发现现在可用于仅支持 POST 的服务器，以及 `.well-known` 路径位于 SSO 后面的服务器。
  * 恢复会话时，现在会正确恢复所选模式 (Plan、Ask、Code) ，而不是静默切回 Code。
  * Skill 自动发现不再会从 skill 文件夹内嵌套的配置目录中识别出重复的 技能，从而减少会话开始时的令牌用量。
  * 企业账户现在可使用 Shell integration 设置 (`devin shell setup`)。
</Update>

<Update label="v2026.4.24-9" description="2026 年 4 月 27 日">
  ### 已修复

  * 在将 BS 发送为退格键的终端上，Opt+backspace 不再插入“h”。
</Update>

<Update label="v2026.4.24-1" description="2026年4月24日">
  ### `/revert` 的交互式步骤选择器

  不带参数的 `/revert` 现在会打开一个可交互搜索的选择器，显示所有对话步骤。选择某个步骤即可回退到该步骤。在 Agent 空闲时双击 Esc 可打开同一选择器。

  ### 新增

  * 现已全面支持配置为 `"transport": "sse"` (传统 SSE 协议) 的 MCP 服务器。此前，这些服务器会报错并被拒绝；现在会通过传统 SSE 协议连接 (事件流使用 GET，消息使用 POST) 。已存储的 OAuth 令牌会自动注入，401 响应会触发交互式 OAuth 流程。

  * 身份验证成功后会发送终端通知 (响铃 + 桌面通知) ，方便你在通过浏览器登录后返回终端。

  * `/btw <prompt>` 可利用当前对话上下文向 Agent 快速提出一个顺带问题。回答会流式显示在 Agent 输出下方的框中，不会把这个问题加入主对话，因此你可以在不打断 Agent 当前工作的情况下随时确认进展。

  * 新增 `devin cloud drs` 子命令，可直接通过 CLI 管理环境蓝图、沙箱会话和构建。

  * 新增首次启动欢迎框，提供终端版 Devin 的入门提示。

  * 在执行 `devin setup` 期间新增 Git 提供商连接提示：会检测本地已登录的 `gh` CLI 账户，并提供将其连接到 Devin 的选项，或打开浏览器来设置 GitHub App 或其他提供商。

  * 在空提示处输入 `&` 会进入交接模式，这是 `/handoff` 的快捷方式，与 `!` 的 bash 模式用法相对应。

  * 输入框中的上下文感知占位文本会根据 Agent 状态提供引导：空闲时提示向 Devin 寻求帮助、工作时建议你给 Devin 更多指引，并说明如何发送排队中的消息。

  * 支持通过 MCP 配置中的 `disabledTools` 按服务器禁用单个 MCP 工具。被禁用的工具会对 Agent 隐藏，并在调用时被拒绝。

  * 新增 `devin mcp enable` 和 `devin mcp disable` 子命令，无需移除即可切换 MCP 服务器的启用/禁用状态。支持 `--scope` (user、local、project) 。已禁用的服务器会在 `devin mcp list` 中显示 `(disabled)` 标签，并在 `devin mcp get` 中显示状态行。

  * 支持需要预先注册 OAuth 客户端的 MCP 服务器 (例如 GitHub) 。可向 `devin mcp add` 和 `devin mcp login` 传递 `--oauth-client-id` (以及可选的 `--oauth-client-secret`) ，或在你的 MCP 配置中设置 `oauthClientId` / `oauthClientSecret`。

  * 组织选择现已成为设置向导的一部分。属于多个 Devin 组织的用户会在初始引导期间被提示选择一个；单组织用户则会被自动选定。

  * 新增 `/org` 命令，用于在终端中选择 Devin 组织。

  * 新增选项：退出计划模式时，可将计划交接给 cloud Devin 会话，适用于使用 Devin 账户登录的用户。

  * 新增 `Ctrl+R` 模糊搜索，可将之前的提示插入输入框。

  * 在 `config.json` 中新增代理配置部分，用于控制 CLI 如何路由出站 HTTP 流量。可将 `proxy.mode` 设置为 `"system"` (默认) 、`"manual"` 或 `"off"`，为手动模式提供 `proxy.url`，并使用 `proxy.no_proxy` 绕过特定主机。

  * 为 16 色终端主题新增 `terminal-light` 和 `terminal-dark` 主题名称。`16color` 和 `terminal-colors` 仍然受支持，以保持与 `terminal-dark` 的向后兼容性。

  * `/theme` 现可接受可选主题名称，例如 `/theme dark` 或 `/theme light`。

  * 当你在带有 Devin wiki 的 repo 中打开 CLI 时，该 wiki 现在会在后台下载，并在后续会话中提供给 Agent，因此它可以使用 explore 子 Agent 回答项目相关问题。

  ### 变更

  * 浏览器身份验证页面已重新设计，会显示你的计算机与 Devin 之间的连接状态，并与 devin.ai 网站风格保持一致。

  * 登录和 API 密钥身份验证标签现在改用 Devin 或通用 API 密钥表述，不再使用仅适用于旧版 Windsurf 的表述。

  * 代码模式现在会自动批准工作区目录中的文件编辑。原先独立的 "Accept Edits" 模式现已并入代码模式；两者在模式选择器中都显示为 "Code"，并且当组织策略允许时，会使用自动批准变体。

  * 默认模型现已改为 Adaptive，它会自动为每一轮选择最适合当前任务的模型。你仍然可以使用 `/model` 或通过在配置中设置 `agent.model` 来选择特定模型。

  * 声明式仓库设置 (DRS) 现在是内置的 Agent 技能，而不是 `/drs` 斜杠命令。当你询问环境设置时，Agent 会自动调用它。`devin cloud drs` 子命令将继续像以前一样工作。

  * Shell 命令预览现在使用更清晰的标题，并在预览正文中以提示符前缀显示命令。

  * cloud 交接现在会在可展开的部分中发送已收集的终端上下文。

  * `/handoff` 现在会在所选组织没有已连接的 Git 提供商时停止，并要求用户先运行 `devin setup` 后再重试。

  * 新的 Devin CLI 会话现在使用易记的双词 ID。

  * 模型选择器现在会在高亮模型上显示带标签的定价 (例如 "$5 / MTok In · $25 / MTok Out")，而不是不带标签的美元金额。

  * 斜杠命令现在会在通过交互式选择器切换模型、主题或模式时显示确认消息。

  * 已清理斜杠命令输出：移除了不必要的颜色，改进了间距，并简化了进度消息。

  * 改进了 Agent 提问中对自由填写的 "其他" 答案的处理方式。现在，输入的不匹配预定义选项的回复会被自动识别为自定义答案。

  * `/resume` 现在会在未提供会话 ID 时打开交互式会话选择器。

  * 规则文件现在使用更严格的注入限制，并在触发的规则超出可用上下文预算时切换为仅提供路径指引。

  * 选择提示现在使用中性的高亮行，提供更清晰的对比度，并且会一致地显示项目描述。

  * 统一了工具预览中的动词时态：流式预览现在使用现在进行时 ("正在编辑 file.rs")，已完成的预览使用过去时 ("已编辑 file.rs")。

  * 状态消息 (警告、错误、提示) 现在会通过 Alert 组件渲染，并带有正确的图标和适配主题的颜色。

  * 为错误消息添加了有意义的标题："出了点问题"、"配额已耗尽"、"已达到轮次限制"、"无法打开浏览器"。

  * 已将所有面向用户的字符串中的 "cancelled" 统一为 "canceled" (单个 L)。

  * "连接已断开，正在重试..." 取代了 "推理在流式过程中失败，正在重试..."。

  * 静音文本现在在深色和浅色主题下都更易于阅读。

  * 多项选择题现在使用与其他 CLI 提示相同的选择 UI，包括输入自定义答案。

  ### 修复

  * `apply_patch` 的文件写入现在会与 `write` 和 `edit` 工具的写入一起显示在 Agent 时间线 / worklog 中。

  * 长会话在关闭时现在能更快退出。

  * 当文本占满终端宽度时，代码块不再丢失最后一个字符。

  * Agent 主动流式传输事件时，输入响应性得到改进。

  * 在渲染后的 markdown 中，编号列表现在会显示数字标记 (`1.`、`2.`、`3.`) ，而不是项目符号。

  * OpenAI 推理模型在请求配置了 temperature 时不再失败。

  * 提示历史记录现在可在 Devin 运行时打开，包括补全内容可见时。

  * 待办事项列表不再会在 Agent 完成更新后消失。

  * `/upgrade` 现在会打开 Devin 套餐，而不是 Windsurf 定价页面。

  * 打开由较新版本 CLI 写入的会话数据库时，现在会显示清晰的 "请运行 `devin update`" 消息，而不是原始的 "filesystem 中缺少迁移" 错误。

  * `/handoff` 现在会通过会话配置选项设置 repo，并将会话标记为 "Terminal"。

  * 模型选择器搜索不再用各个单独变体替换系列分组。

  * 当后台自动更新会自行安装新版本时，不再显示 "Update vX available!" 横幅。现在仅当用户需要采取操作时才会显示 (例如外部管理的安装，或已禁用自动更新时)。

  * 文件和代码 snippet 引用现在会渲染为可读路径，而不是原始 XML 标签。
</Update>

<Update label="v2026.4.17-0" description="2026 年 4 月 17 日">
  ### 后台自动更新

  在 macOS 和 Linux 上，新版本现在会在终端版 Devin 运行时自动下载并激活，因此下次调用时将自动使用最新版本。在更新过程中退出是安全的，不会导致安装损坏。如需关闭此功能，请在 `config.json` 中设置 `"auto_update": false`。

  ### 交互式配置编辑器

  `/config` 可打开一个交互式终端内配置编辑器，支持树形导航、搜索以及类型感知的值编辑。

  ### `/handoff` 至 cloud Devin

  `/handoff` 斜杠命令现已正式发布。将任务移交给远程 Devin session，并通过实时 status 更新了解 Agent 当前正在处理的内容。

  ### 可搜索的模型选择器

  模型选择器现在提供可搜索界面：输入内容以筛选模型，使用方向键导航，并一目了然地查看定价信息。

  ### 已新增

  * 支持自适应选择和 model-router 选择，现在会在推理时自动解析为具体模型。

  * 在 `devin auth status` 中提供更详细的登录信息：登录方式、用户名和电子邮件、用户 ID、团队 ID、套餐和层级，以及缓存的团队设置。

  * 新增托盘面板，列出正在运行的后台 shell。在输入框中按向下箭头即可打开，使用上下方向键导航，并按 `x` 终止选中的 shell。

  * 支持由企业配置默认模型。Admin 现在可以通过 Windsurf 或 Devin Enterprise Admin 仪表板，为新 session 设置团队级默认模型。

  * 在云 Agent 托盘中新增键盘选择功能：使用方向键选择云 Agent，并按 Enter 在默认浏览器中打开其 session。当无法启动浏览器时，每个条目下方仍会显示 session URL 作为后备方式。

  * 现在会强制执行组织的 “Auto run terminal commands” 设置。企业管理员现在可以限制 CLI 用户可用的 permission 模式——例如，当组织策略设置为 “Auto” 或更低时，禁止选择 Bypass 模式。

  * 新增一种方式：当 Agent 正忙时，在空输入框中按 Enter 可立即将排队消息发送给 Agent，以便在当前工具调用完成后立刻处理 (且不会中断该调用) 。

  * `/handoff` 现在会将本地 git diff 附加到 Devin session 中，使其能够看到未提交的更改。

  * 当未配置 org 时，`/handoff` 现在会提供交互式组织选择器，替代此前要求手动编辑配置的报错。

  * 新增 `legacy_terminal` 配置选项，用于兼容 VT100 终端，禁用键盘增强探测、OSC 序列和主题自动检测。

  * 新增 `disable_osc` 配置选项，用于独立控制 OSC 序列发送 (终端标题和超链接) 。

  * 新增 `skip_workspace_trust` 配置选项，用于跳过 workspace trust 提示。

  * 在模型选择器中显示按模型区分的令牌定价，展示每百万令牌的输入和输出成本。

  * 对于由 server 标记的模型，在模型选择器中显示 NEW、PROMO 和 BETA 徽章。

  * 当无法获取按令牌计费的价格时，使用相对成本层级 (Free / \$ / \$\$ / \$\$\$) 作为后备说明。

  * 新增 `/rename-session` 斜杠命令，用于重命名当前 session。

  * 新增 `/revert <step>` 命令，用于将文件更改撤销回特定 conversation 步骤

  * 新增 `/steps` 命令，用于列出 conversation 步骤，以便与 `/fork` 和 `/revert` 搭配使用

  * 为 `/fork` 新增可选的 `[step]` 参数，用于从更早的 conversation 节点分支

  * Shift+Insert 现在会从剪贴板粘贴，与标准 X11/Linux 粘贴快捷键保持一致。

  ### 已变更

  * `/bug` 现在会明确说明该报告会发送给终端版 Devin 的开发者。

  * 改进了模型选择器：采用紧凑的单行高度条目、清晰可见的搜索输入框边框，以及更精简的所选模型定价显示。

  * 未知斜杠命令现在会根据相似的命令名称显示 “did you mean?” 建议。

  * 为 `/handoff` 状态行应用了标准的动画 spinner 和弱化文本样式，替代静态的半圆符号和蓝色强调色。

  * `/handoff` 现在无需参数即可使用。它会总结当前 conversation，并交接给远程 Devin session 以继续该任务。

  * 切换到不可用 permission 模式时的错误信息现在会说明：沙箱模式会限制可用模式，以及该限制是否由组织强制执行。

  * 输入框下方的模型名称现在使用默认文本颜色，而不是蓝色。

  * 登录体验已简化：spinner 现在会提示 “Press Enter to paste a token manually instead”，且手动输入令牌的流程会输出一行简洁说明，而不是多步骤的大段文本。

  * 已从登录 spinner 中移除 “Logging in with Windsurf. If the browser didn't open...” 前导说明。

  * Plan 模式的审批提示现在会显示与计划相关的选项：“Yes, implement plan and accept edits”、“Yes, implement plan and bypass permissions” 和 “No, plan needs changes”。

  * “16-color” 主题已重命名为 “Terminal colors”，以明确说明它会继承你的终端 emulator 的配色方案。

  * Session 恢复选择器 (`devin -r`, `devin list`) 现在提供可搜索的输入即筛选界面，与模型选择器体验保持一致。

  * 更新了托盘面板，始终显示云 Agent 和子 Agent 两个选项卡；当某个列表没有条目时，会显示空状态提示，介绍另一项功能。

  * 子 Agent 和云 Agent 托盘面板现在按时间倒序排序，因此最近启动的 Agent 会显示在顶部。

  * 注入到 context 中的始终生效规则文件 (例如 `AGENTS.md`) 现在每个最多限制为 32 KiB。超出大小的规则会被截断，并附带指向源路径的提示，以便 Agent 在需要时读取完整文件。

  ### 已修复

  * 来自上游服务器的错误 (配额耗尽、5xx 响应、连接中断等) 现在会在 REPL 中显示为易于理解的警告，并附带重试提示，而不再是原始的 `Error: …` 文本；同时也会以带类型的原因传递给 ACP 客户端，以便它们按正确的严重程度进行渲染。

  * 在 Windsurf 中运行的终端版 Devin 现在会遵循用户的 `deny` / `allow` / `ask` 权限规则 (包括 `Read(...)` 和 `Write(...)`) ，与独立 CLI 的行为保持一致。

  * 使用自适应模型时，不再会在每一轮都触发不必要的压缩。

  * 恢复 session 时，Logo 现在会显示在 conversation 历史记录上方，与全新 session 的布局保持一致。

  * Windows 上的 `/add-dir` 不再会错误处理包含反斜杠的路径。`D:\Source\Project` 和 `..\Project` 这两种形式现在都能正确工作。

  * 启动横幅文本在窄终端宽度下的续行对齐现已正确。

  * 询问当前日期时，星期几现在会显示正确。

  * 当复合 shell 命令中包含你在 CLI 权限中已拒绝的命令时，这些命令现在会被阻止。

  * 已修复已选中/高亮的 UI 元素 (如活动的问题选项卡、选中的图片附件和选中的子 Agent) 与未高亮文本使用相同文本颜色进行渲染的问题，避免它们难以区分。

  * 配置了 `"transport": "sse"` 的 MCP 服务器现在会明确报错，说明 legacy SSE 不受支持，而不是静默地通过错误的 transport 进行连接。

  * 在启用沙盒的 Autonomous mode 下，不再会为 shell 命令显示不必要的权限提示。

  * 现在已在文档和 `devin skills paths` 输出中澄清：在 Windows 上，全局 skills 位于 `%APPDATA%\devin\skills\`，而不是 `~/.config/devin/skills/`。

  * 光标定位现在使用兼容 VT100 的序列 (CR + CUF) ，而不是并非所有终端都支持的 CHA。

  * 提示和 spinner 符号现在会遵循 ASCII 模式设置。

  * 已修复浏览器登录页面：现在只有在实际完成登录后才会显示“身份验证成功”，如果未完成则会显示失败页面。

  * 无法识别的斜杠命令现在会显示错误，而不是被发送给模型。

  * 当 Linux 上缺少 `socat` 时，现在会显示明确的安装指示错误，而不是静默失败。

  * 同一轮中的文件编辑不再会偶尔互相覆盖。
</Update>

<Update label="v2026.4.9-0" description="2026 年 4 月 9 日">
  ### 默认允许只读工具

  只读工具调用 (文件读取、grep、glob、thinking) 现在始终允许，不再弹出权限提示。用户、项目和组织配置的拒绝规则仍具有优先级，因此你仍可限制对敏感路径的读取。

  ### `.devin/hooks.v1.json` 支持

  在独立的 `.devin/hooks.v1.json` 文件中定义命令前后的钩子，格式与 Claude Code 钩子相同。

  ### `devin mcp add` 全面改版

  `devin mcp add` 现已与 Claude Code 的语法保持一致：支持位置式 URL 参数 (例如 `devin mcp add notion https://mcp.notion.com/mcp`)，可从 `--url` (HTTP) 或尾部参数 (stdio) 推断 transport，默认作用域从 `user` 改为 `local` (写入 `.devin/config.local.json`，已加入 gitignore)，并新增短标志 (`-t`、`-s`、`-e`、`-H`)。

  ### Agent 模式与权限模式分离

  Agent Profile (normal、plan、ask) 与权限模式 (normal、accept edits、bypass、autonomous) 现已成为两个独立的 Controls。Profile 通过 `/plan`、`/ask`、`/normal` 斜杠命令切换。`/plan <prompt>` 可切换至 plan 模式并在一个步骤中立即发送提示。权限模式通过 Shift+Tab 或 `/mode` 循环切换。

  ### 工具预览实时流式传输

  工具调用现在会在参数流式传入时立即显示，呈现结构化标题和内容 (编辑操作显示 diff、写入操作显示代码块、执行操作显示命令) ，无需等待完整请求。

  ### Terminal 通知

  CLI 现在会在 Agent 完成、需要输入或请求工具审批时发送终端通知。在支持的终端模拟器中触发 dock 角标和通知横幅。可通过 `notify` 配置选项控制：`"never"`、`"smart"` (默认，仅在未聚焦时) 或 `"always"`。

  ### 已添加

  * 连接到声明支持 elicitation 能力的 ACP 客户端时，新增了结构化表单输入支持。

  * 为 ACP 工具调用事件新增了推理工具名称元数据，以便 ACP 客户端能够按工具决定展示方式 (例如，对内部工具隐藏参数面板) 。

  * 在 stable 和 next 版本中启用了 `devin acp` 子命令，因此任何已发布的终端版 Devin 构建都可由支持 ACP 的编辑器作为 Agent Client Protocol 服务器启动。

  * 为 ACP 客户端 (例如 JetBrains) 新增了 `/ask`、`/compact`、`/context` 和 `/undo-add-dir` 斜杠命令。

  * 扩展了 ACP 会话中的 `/help` 输出，以列出所有内置命令和已发现的 skills。

  * 在 Windsurf UI 中显示子 Agent 活动和生命周期事件。

  * 使页脚中的 "Mode:" 和 "Model:" 标签可点击，以打开各自的选择菜单

  * 为选择菜单新增鼠标支持：点击选择、滚轮导航、悬停高亮

  * 为 `/continue` 和 `/rm-session` 命令新增自动补全，显示最近会话的 ID 前缀、距今时间和标题。

  * 为 `devin update` 和 `/update` 新增 `--force` 标志，即使当前已是最新版本也会强制重新安装。

  * 为 MCP 服务器新增交互式 OAuth 支持——当 MCP 服务器需要身份验证时，会自动打开浏览器，并在 REPL 中显示状态消息。

  * 将 `/new` 作为 `/clear` 的别名，用于开始新的会话。

  * 在输入框顶部边框显示当前生效的权限级别。

  * 可通过 `Alt+↑`/`Alt+↓` 和 `/feedback` 对 Agent 响应提供赞/踩反馈。

  * 新增 `respect_gitignore` 配置选项，用于控制 Agent 通过工具访问文件时是否遵循 `.gitignore` (默认：关闭) 。它与 `include_gitignored_files` 分开，后者仅影响 `@` 选项卡补全。

  * 将 `/resume` 作为 `/ls` 的别名 (列出最近会话) 。

  * 当子 Agent 完成时，在展开视图 (Ctrl+O) 中显示子 Agent 提示。

  * 在等待前台子 Agent 或 `read_subagent` 调用期间，实时流式显示子 Agent 的 actions。

  * 新增 `/session-stats` 命令，用于显示累计会话统计信息 (工具调用、变更文件、运行的命令、令牌、模型、请求 ID) 。

  ### 变更

  * 将通过 ACP 更新工作区目录的方式改为使用替换语义，从而可通过配置选项移除目录。

  * 使 `/ask <question>` 成为与 REPL 行为一致的一次性命令：临时切换到 Ask 模式，提交问题，然后恢复到之前的模式。

  * 通过在输出面板中直接显示诊断日志，让在 Windsurf 中进行会话故障排查变得更容易。

  * 将相关的智能体问题集中在一个分页表单中呈现，而不是一次只显示一个。

  * 改进了退出 Plan 模式时的审批流程，提供专门的审查 UI 来显示计划摘要和带上下文的按钮标签。

  * 改进了 Windsurf 钩子脚本，使其可通过 stdin 接收更丰富的工具信息，包括编辑详情、MCP 工具结果和助手响应

  * `devin mcp add` 在常见的 stdio 场景下不再需要 `--transport` 或 `--command`——会根据 `--url` (HTTP) 或尾随参数 (stdio) 推断 transport；当省略 `--command` 时，第一个尾随参数将用作 command

  * `/mode` 现在会打开交互式下拉选择器 (类似 `/model`)，而不是打印静态列表。使用方向键导航，按 Enter 确认，按 Esc 取消。

  * `-p`/`--print` 现在接受可选的 inline 提示，因此 `devin -p "fix the bug"` 无需 `--` 分隔符即可使用。旧的 `devin -p -- fix the bug` 语法仍然可用。

  * 用于命令权限提示的 "always allow" 标签现已缩短为 "始终允许在 `<workspace>` 中运行 `<cmd>` 命令"，其中 `<workspace>` 仅为工作区目录路径的最后一段，因此当工作区路径较长时，它不再会在较窄的终端或 ACP 客户端 UI 中溢出。

  * `/mode` 现在会打开交互式下拉选择器 (类似 `/model`)，而不是打印静态列表。使用方向键导航，按 Enter 确认，按 Esc 取消。

  * 退出 Plan 模式时的审批流程现在具有专门的审查 UI，用于显示计划摘要和带上下文的按钮标签。

  * 从启动 logo 中移除了品牌颜色，因此它会使用终端的默认前景色。

  * 截断通知现在包含 "(ctrl+o to expand)" 提示。

  * 在 Windsurf 中将模式选择器和权限选择器合并为一个统一的模式选择器。现在可用的模式为 Code、Ask、Plan、Accept Edits 和 Bypass Permissions。

  * 每个 Devin CLI channel 现在都会从 `~/.codeium/` 下与其对应的 channel 专属目录中读取 Windsurf 配置 (MCP 服务器、skills)

  ### 已修复

  * 修复了 ACP 会话现在必须使用主机提供的凭据，而不是静默回退到本地 CLI 凭据的问题，从而确保用量能正确归属到相应账户。

  * 在 ACP 聊天 UI 中保留了流式 shell 命令输出，因此命令完成后输出仍然可见，并会同时显示退出码，而不是用退出码替换输出。

  * 从权限提示中选择 "switch to accept edits" 后，会话模式选择器现在会立即更新。

  * 在 Windsurf 中跳过工具调用不再会导致 Agent 停止——LLM 现在会看到该拒绝，并可尝试其他方法

  * 工具失败消息现在会在 Windsurf 中显示错误原因，而不再只是显示没有任何说明的 "Failed"。

  * 修复了 `/add-dir` 和 `/undo-add-dir` 无法处理包含空格的目录路径的问题。斜杠命令参数现在会按 shell 风格引号解析 (例如 `/add-dir "my dir"` 或 `/add-dir my\ dir`)，并且选项卡补全会自动转义目录名中的空格。

  * 修复了 ASCII 模式启动横幅中行距过大的问题。

  * 长时间运行的 shell 命令 (如开发服务器) 现在可以可靠启动，而不会阻塞后续工作。

  * 修复了由于权限作用域不正确，Bypass 模式不会自动批准 MCP `read_resource`、Computer Use、recording 和 Browser 工具的问题。

  * 修复了 Autonomous mode 会静默自动批准在 OS 沙盒之外运行的隐私敏感工具 (Computer Use、recording、Browser) 的问题。

  * 修复了当 screenshots 目录为相对路径时，Browser 截图路径授权不匹配的问题。

  * 修复了删除与宽字符 (CJK/emoji) 相邻的字符时出现的显示损坏问题。

  * 修复了命令权限的 "always allow" 在 git 代码仓库外运行时无法静默持久化的问题。

  * 改进了当终端背景与所选颜色主题不匹配时的文本可见性。

  * 修复了目录补全菜单中的字母排序问题：较短的目录名现在会排在具有相同前缀的较长目录名前面 (例如，`devin/` 现在会正确显示在 `devin-docs/` 之前)。

  * 在具有大量滚动回溯的长时间终端会话后，shell 命令输出不再丢失。

  * 修复了重新打开已保存会话时，注入的 lint 诊断信息显示为伪造用户消息的问题。

  * 修复了 Agent 在代码编辑后检测到 lint 错误时不会自动审查并修复这些错误的问题。

  * 改进了 lint 错误的展示，提供了更多详细信息，包括严重级别、来源和精确位置。

  * 为 lint 修复注入次数增加了安全上限，以防止在 lint 无法修复时出现无限循环。

  * 通过不同的说明文本区分新的和持续存在的 lint 错误，以便 Agent 理解哪些 lint 之前已经见过。

  * ANSI 颜色转义码不再写入日志文件，也不会通过管道输出到 stdout/stderr。彩色输出仅会发送到真实终端，并遵循 `NO_COLOR` environment variable。

  * 现在在恢复会话时会正确恢复模式。

  * 在经过多轮压缩后恢复会话时，不再会丢失较早的会话消息。

  * 权限模式不再会在会话中途意外重置。

  * 退出 Plan mode 时，沙盒会话不再从 Autonomous 模式切回 Normal 模式。

  * 在 replay UI 中重新加载会话后，代码 diff 和其他富工具调用内容不再从 edit/write 工具调用中消失。

  * `shell run` 退出后不再使终端处于异常状态。

  * 修复了当企业代理或防火墙在会话中途重置网络连接时发生的静默崩溃问题。

  * 即使网络连接缓慢或卡住，Ctrl+C 现在也能快速退出。

  * 权限提示中的“本次会话”和“始终允许”选项，现在可对同时写入文件的终端命令正确生效。

  * 当模型跳过 `ThinkingComplete` 事件时，thinking 输出现在始终会先于内容渲染。

  * 格式错误的工具调用报错信息现在会指出具体字段和期望的值类型。

  * Windows 在初始设置期间不再显示两次身份验证提示。

  * Windows 安装程序现在会将文件放置到正确的目录中，从而使 PATH 能正确解析。

  * 现在已清楚说明 Windows 配置文件位置为 `%APPDATA%\devin\config.json`，而不是 `~/.config/devin/config.json`。

  * Grep 现在会搜索 `.env` 和 `.github/` 等隐藏文件，与 `rg --hidden` 的行为一致。`.git/` 目录仍会被排除。

  * 大图片 (超过 5 MB) 不再发送失败。

  * 本地 shell 命令在会话中断或取消后不再继续在后台运行。

  * 恢复会话时会保留富提及渲染 (例如 `@README.md` 标签) ，而不是显示原始 markdown 文本。

  ### 已移除

  * 已移除 REPL 内的超额状态提示横幅
  * REPL 的滚动历史中不再显示 “Thought for Xs” 的用时。
</Update>

<Update label="v2026.4.1-4" description="2026年4月8日">
  ### 已移除

  * 不再显示 REPL 内的 overage 状态指示横幅。
</Update>

<Update label="v2026.4.1-3" description="2026年4月8日">
  ### 已新增

  * 当你的账户处于 overage 状态时，会显示警告，告知你请求正在从你团队的预付余额中扣费。
  * `/usage` 命令，用于显示当前会话期间消耗的 Windsurf 积分和 ACU。
</Update>

<Update label="v2026.4.1-2" description="2026年4月6日">
  ### 已修复

  * 安装程序现在接受现有的 `~/.local/bin/devin` 符号链接 (指向旧版 `~/.local/share/cognition/cli/...` 路径) ，并会在 cognition 到 devin 的迁移后正确刷新这些链接。
</Update>

<Update label="v2026.4.1-1" description="2026年4月2日">
  ### 已修复

  * 删除与宽字符 (CJK/emoji) 相邻的字符时，不再出现显示损坏问题。
</Update>

<Update label="v2026.4.1-0" description="2026年4月1日">
  ### 已新增

  * 在 Windsurf UI 中显示子 Agent 活动和生命周期事件。

  * 页脚中的“Mode:”和“Model:”标签现在可以点击，以打开各自的选择器菜单。

  * 选择器菜单现已支持鼠标操作：点击选择、滚轮导航、悬停高亮。

  * 为 `/continue` 和 `/rm-session` 命令提供自动补全，显示最近的会话及其 ID 前缀、距今时间和标题。

  * 为 `devin update` 和 `/update` 添加了 `--force` 标志，即使已经是最新版本，也可强制重新安装。

  * 新增支持从 `.devin/hooks.v1.json` 读取钩子，这是一个使用与 Claude Code hooks 相同格式的独立钩子文件

  * 当子 Agent 完成时，在展开视图 (Ctrl+O) 中显示子 Agent 提示。

  * 在等待前台子 Agent 或 `read_subagent` 调用时，在实时显示中流式展示子 Agent 操作。

  * 新增 `notify` 配置选项，用于控制 Agent 完成、需要输入或请求工具批准时的终端通知。可设置为 `"never"`、`"smart"` (默认) 或 `"always"`。在 `smart` 模式下，仅当终端窗口未聚焦时才会发送通知。在受支持的终端模拟器中会触发 dock 徽章和通知横幅。

  ### 已更改

  * `devin mcp add` 在常见的 stdio 场景下不再需要 `--transport` 或 `--command` —— `transport` 会根据 `--url` (HTTP) 或尾随参数 (stdio) 自动推断；当省略 `--command` 时，第一个尾随参数会被用作命令

  * `/mode` 现在会打开一个交互式下拉选择器 (类似 `/model`) ，而不是打印静态列表。使用方向键导航，按 Enter 确认，按 Esc 取消。

  * `-p`/`--print` 现在接受可选的内联提示，因此 `devin -p "fix the bug"` 无需 `--` 分隔符即可使用。旧的 `devin -p -- fix the bug` 语法仍然有效。

  * 在截断提示中新增了“(ctrl+o to expand)”提示，帮助用户了解如何查看完整输出。

  ### 已修复

  * 在 Windsurf 中跳过工具调用不再会导致 Agent 停止——现在 LLM 会感知到该调用被拒绝，并尝试其他方案

  * 现在，Windsurf 中的工具失败消息会显示具体错误原因，不再只是没有任何说明的“Failed”。

  * `/add-dir` 和 `/undo-add-dir` 现已支持处理包含空格的目录路径。Slash Command 参数现在按 shell 风格引号进行解析 (例如 `/add-dir "my dir"` 或 `/add-dir my\ dir`) ，选项卡补全也会自动转义目录名中的空格。

  * 即使在 git 代码仓库之外运行，命令权限中的“始终允许”现在也能正确持久化。

  * 当终端背景与所选颜色主题不匹配时，文本的可见性有所改善。

  * 目录补全菜单中的字母排序现在会正确地将具有相同前缀的较短名称排在较长名称之前 (例如 `devin/` 会排在 `devin-docs/` 前面) 。

  * 恢复会话时，现在能够正确还原模式。

  * 当企业代理或防火墙在会话中途重置网络连接时，不再会发生静默崩溃。

  * 当模型跳过 `ThinkingComplete` 事件时，思考输出现在始终会在内容之前渲染。

  * 已修复 Windows 上初始设置期间重复弹出身份验证提示的问题。

  * 已修复 Windows 安装程序将文件放到错误目录，导致 PATH 指向错误位置的问题

  * 已修复大图片 (超过 5 MB) 发送失败的问题。
</Update>

<Update label="v2026.3.20-2" description="2026 年 3 月 23 日">
  ### 新增

  * 添加 `16color` 和 `nocolor` 主题模式。`16color` 会将输出量化为 16 色 ANSI 调色板 (遵循终端配色方案) 。`nocolor` 会为 VT100 和其他单色终端禁用所有彩色输出。

  * 支持多根工作区，可在会话工作目录之外添加更多目录。

  * 添加 `/workspace` 和 `/add-dir` 斜杠命令，用于在运行时列出和添加工作区目录。

  * 添加 `workspace-dirs` 配置选项，用于以编程方式设置工作区目录。

  * 添加 Ask 模式 (`/ask`) ，用于只读问答，不会产生代码修改

  * 添加 `/bug` 斜杠命令，用于从 stdio 服务器提交 bug 报告

  * 在 Windows Conhost 中运行时持续显示警告横幅，建议使用 Windows Terminal 或 Git Bash 以获得更好的体验。

  * `Ctrl+Left` 和 `Ctrl+Right` 现在会在单词之间跳转，与标准 Linux 和 Windows 终端行为一致。`Ctrl+Backspace` 和 `Ctrl+Delete` 分别向后和向前删除单词。

  * 添加自定义子 Agent Profile：可通过项目 `agents/` 目录中的 `AGENT.md` 文件定义专用子 Agent，并为其设置各自的系统提示、工具和模型 (实验性)

  * 为技能添加 `subagent` 和 `agent` frontmatter 字段，使技能能够作为独立子 Agent 运行，而不是以内联方式运行 (实验性)

  * 添加 `include_gitignored_files` 配置选项，以在 @ 选项卡补全结果中包含被 Git 忽略的文件 (默认：关闭)

  * 添加 `/undo-add-dir` 命令，用于从工作区中移除目录。

  * 添加 `/rm-session` 命令，用于删除会话。

  * 添加了 `request_scope` 工具，用于在沙箱模式下运行时请求目录的读写访问权限

  * 添加了沙箱模式系统提示，告知 Agent 沙箱限制以及如何请求额外访问权限

  * `--sandbox` 标志和 `devin sandbox setup` 命令现已在所有构建渠道中可用 (此前仅限 insiders)

  * 添加 `unicode_mode` 配置选项 (`auto`/`unicode`/`ascii`) ，用于不支持 Unicode 字形的终端

  * 添加 `devin version` 子命令，作为 `devin --version` 的别名

  ### 变更

  * 在 bug 报告详情中包含当前活动的界面模式
  * 将所有配置、数据和缓存目录从 `~/.config/cognition/`、`~/.local/share/cognition/` 和 `~/.cache/cognition/` 迁移到 `devin/`。会在每个旧路径创建一个向后兼容的符号链接，以便旧会话继续正常工作。
  * 将项目级配置目录从 `.cognition/` 重命名为 `.devin/`。现有的 `.cognition/` 目录仍会被读取 (并显示弃用警告) ，以保持向后兼容。

  ### 修复

  * `.claude/settings.json` 中定义的钩子现已由 CLI 加载 (包括项目级和全局 `~/.claude/settings.json`)

  * Cmd+V 现在会在将其报告为按键事件的终端中触发剪贴板粘贴 (例如粘贴图像等非文本数据时)

  * 修复了将 CLI 输出通过管道传递给提前关闭的命令时发生 panic 的问题 (例如 `devin -p "..." | head`)。

  * 修复了 Agent 在流式传输期间因错误停止时，部分输出 (thinking 和 content) 被静默丢弃的问题

  * 修复了当文件扩展名与实际图像格式不匹配时图像上传失败的问题 (例如将 JPEG 保存为 `.png`)。现在会根据图像内容检测 MIME 类型，而不是信任调用方提供的值。

  * 修复了 `devin mcp login` 在仅允许 `/auth/callback` 作为 OAuth 重定向路径的服务器 (例如 Glean) 上失败的问题

  * 通过折叠超过 5,000 个字符的粘贴内容，修复了粘贴超长单行文本 (例如 JSON blob、base64 字符串) 时 CLI 卡死的问题

  * 技能现在会显示其真实源路径 (例如 `.agents/skills/`) ，而不再始终显示 `.devin/skills/`

  * 修复了将文本 (Ctrl+V / bracketed paste) 粘贴到 `/bug` 等斜杠命令提示中的问题

  * 遵循 MCP 服务器配置中的 `disabled: true` 开关，因此在 Windsurf、Claude 或 Devin 配置文件中标记为已禁用的服务器将不再被加载
</Update>

<Update label="v2026.3.17-3" description="2026 年 3 月 19 日">
  ### 修复

  * 按文档所述，除了旧版的 `~/.config/cognition/` 和 `.cognition/` 路径外，现还会从 `~/.config/devin/` 和 `.devin/` 目录加载技能和 Agent。
</Update>

<Update label="v2026.3.16-0" description="2026 年 3 月 16 日">
  ### 已新增

  * 新增自动生成描述性会话标题的功能。
  * 新增 `CHISEL_LOG_STDERR` 环境变量，用于将日志输出定向到 stderr
  * 新增 Windows 和 macOS 上的 PAC (代理自动配置) 支持。CLI 现在会遵循系统级 PAC 设置和 WPAD 自动检测，无需手动配置环境变量，即可通过正确的代理路由流量。
  * 新增 `!<command>` 语法，可直接从 REPL 运行 Shell 命令。输出会实时流式显示，并自动添加到会话上下文中，供你的下一条消息使用。输入 `!` 会进入 bash 模式，并显示专用提示符和标题指示器。使用 Ctrl+C 可取消正在运行的命令。
  * CLI 启动时，会在产品信息旁显示 Devin logo。

  ### 已更改

  * `/bug` 命令现在会自动在 bug 报告中包含终端环境信息 (`TERM_PROGRAM`、`TERM_PROGRAM_VERSION`、`TERM`) 。
  * 将权限提示的默认选项从“是，始终允许”改回“是” (仅批准一次)

  ### 已修复

  * 修复在 Windsurf 中运行时，“始终允许”权限无法在多次工具调用之间保留的问题

  * 修复在 Windsurf 中运行时，企业团队强制执行的权限规则未生效的问题

  * 修复 `Co-Authored-By` commit 尾注错误地使用了 `noreply@cognition.ai`，而不是正确的 GitHub App 机器人邮箱的问题

  * 修复权限建议将文件路径包含在命令前缀中的问题
    (例如，`allow cat foo/bar/baz.txt` 现在会正确显示为 `allow cat`) 。

  * 修复推理在流式处理中途失败并重试时，重复出现“Context compacted”通知的问题

  * 修复当编辑位置不在文件开头时，编辑工具报告的起始/结束行号存在偏移 1 的错误

  * 修复重启后无法识别“始终允许 fetches to”权限的问题

  * `mcp_list_tools` 现在会为每个工具包含 `input_schema`，这样 Agent 无需先触发工具调用错误，也能发现参数要求。

  * 修复 `devin mcp login` 在使用 RFC 8414 OAuth 自动发现机制而非 RFC 9728 的服务器上失败的问题 (例如 Atlassian)

  * 修复粘贴以 `#` 开头的文本 (例如 Markdown 标题) 时，内容被静默丢弃的问题。

  * 修复主 session 仍在运行时，子 Agent 完成后加载指示器消失的问题

  * 修复启动横幅中的布局偏移问题：账户信息加载后，文本会发生跳动

  * 修复在 `TERM=dumb` 的无头环境中，终端输出开头出现多余 `<` 字符的问题

  * 修复 thoughts 中缺少空格的问题。

  * 允许在 `ask_user_question` 中使用较长的问题标头，而不是直接拒绝；超过 16 个字符的标头现在会在显示时截断并添加省略号 (…)

  * 通过静态链接 C 运行时，修复 Windows ARM 上缺少 DLL 的错误

  ### 已移除

  * 移除了启动时的“Loading configuration from...”提示。来自 Cursor、Windsurf 和 Claude Code 的配置导入仍然有效——只是这个提示不再显示。
</Update>

<Update label="v2026.3.9-0" description="2026 年 3 月 9 日">
  ### 已新增

  * 新增 `show_path` 配置选项，用于在输入边框中显示当前工作目录
</Update>
