Cherry Studio 移除 Soul Mode自主模式开关所有 Agent 默认启用自主能力的破坏性变更解析【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studio本篇技术指南以 Cherry Studio v2 重构分支中的 breaking change 记录 2026-07-03-remove-soul-mode-toggle.md 为核心完整讲解 Soul Mode / Autonomous Mode 开关被移除的前因后果自主工具cron/notify/config、Agent 记忆工具、工作区 personaSOUL.md如何对所有 Agent 无条件开放permission_mode如何与自主能力彻底解耦以及旧的soul_enabled配置、mcp__claw__*/mcp__cherry__*禁用项如何处理。读完你可以准确评估该变更对现有 Agent 配置、定时任务、通道channels与工具权限的实际影响并为用户与发布流程做好应对。变更背景从「可选开关」到「无条件启用」的演进Soul Mode在部分界面中称为 Autonomous Mode / 自主模式是 Cherry Studio v2 Agent 体系中的一项能力门控开关。它控制着一组「自主任务管理与记忆」能力是否对某个 Agent 开放。在本次变更之前Soul Mode 的演进经历了两个阶段早期阶段soul_enabled默认不设置由后端默认值决定仅在用户主动开启时生效。2026-06-18 中间态由 PR #16187 引入的变更见 2026-06-18-agent-create-defaults-bypass-soul.md将「从 v2 库创建 Agent」的流程默认改为permission_mode bypassPermissions且soul_enabled true即新创建的 Agent 默认开启自主模式并绕过工具审批这是一次更宽松的默认安全姿态。2026-07-03 最终态PR #16726 直接删除了开关本身使自主能力对所有 Agent 无条件生效。本次文档severity:noticecategory:removed宣告的就是第三阶段开关不再存在任何 Agent 都始终运行在开启自主能力的模式下。核心变更开关移除后哪些能力变成了「人人可用」根据文档被 Soul Mode 开关门控的能力共有三组移除后对所有 Agent 无条件开放1. 自主工具mcp__cherry-tools__cron/notify/config这三个工具由进程内 MCP 服务器cherry-tools托管实现在 cherryAutonomyTools.ts 中文件头部注释明确写道这些是 Agent autonomy tools (cron / notify / config) hosted by the in-process cherry-tools MCP server。与无状态的 builtin 查询工具不同它们代表特定 Agent 行动——为其调度定时任务、通过其通道发送通知、管理其自身配置因此构造时携带按会话隔离的CherryAgentContextagentId、workspaceSource、workspacePath、trustedNotifyChannels等。从源码可以看到三个工具的实际能力边界cron管理定时任务。action支持add/list/removeadd时通过cron如0 9 * * 1-5、every如30m、2h、1h30m由parseDurationToMinutes解析为分钟或atRFC3339 一次性时间戳如2024-01-15T14:30:0008:00指定调度方式三者互斥可通过channel_ids指定投递通道。notify通过 Agent 配置的通知通道发送消息或文件。测试用例cherryAutonomyTools.test.ts验证了它支持message与file_path可二选一或同时提供、消息脱敏将sk-ant-api03-*之类的密钥替换为[REDACTED]、部分失败报告、无通知接收方时的信息性结果Message sent to 0 chat(s)且不视为错误等行为。config管理 Agent 自身的配置例如重命名、标记 bootstrap 完成。2. Agent 记忆工具mcp__agent-memory__*Agent 记忆能力agent-memory服务器此前同样受 Soul Mode 门控现在对所有 Agent 开放。它与自主工具共同构成 Agent 的「长期记忆 自主行动」闭环。3. 工作区 persona 提示SOUL.md 与相关工作区文件Soul Mode 此前还会决定 Agent 是否读取工作区中的 persona 提示SOUL.md及相关工作区文件。现在该提示对所有 Agent 生效。这一机制与 Agent 的 bootstrap 流程深度绑定在 bootstrap.ts 中SOUL.md被定义为记录 Agent「名称、个性、语气、沟通风格」的文件而USER.md记录用户画像bootstrap 完成前还会调用mcp__cherry-tools__configcomplete_bootstrap与mcp__agent-memory__memoryappendtags:[bootstrap]记录引导完成事件。该文件还定义了SOUL_CONTENT_THRESHOLD 50用于判断SOUL.md是否已从模板状态变为已配置状态。用户可见的变化编辑对话框与页面表现文档明确列出了用户及开发者在界面上能观察到的差异Agent 编辑对话框中的 Autonomous Mode 开关不再出现设置项被整体移除此前关闭了该开关的 Agent现在会自动暴露自主任务管理、记忆工具并读取工作区 persona 提示——这是一个行为上的自动扩展定时任务页面scheduled-tasks现在列出所有 Agent而非仅列出 Soul-Mode / bypass 权限的 Agent通道channels与定时任务不再要求 Soul Mode 或bypassPermissions权限模式任何 Agent 都可以用于它们。permission_mode的独立性与自主能力彻底解耦本次变更最重要的语义调整之一是permission_mode权限模式变得完全独立选择bypassPermissions不再意味着也不再被任何自主设置所隐含或隐含它反之自主能力也不再要求bypassPermissions。也就是说Soul Mode 移除后「Agent 能否自主调度任务 / 发送通知 / 使用记忆」与「Agent 使用工具时是否需要用户审批」是两条正交的轴。一个采用严格审批模式非 bypass的 Agent同样可以使用 cron/notify/config 等自主工具一个 bypass 权限的 Agent其自主工具的暴露也不再由开关控制。工具覆盖层移除交互式工具恢复禁用分类保留PR #16726 同时移除了一刀切的 disallowed-tools 覆盖层blanket overlay。在 settingsBuilder.test.ts 中留有直接注释佐证Interactive tools are no longer blanket-disabled now that the soul-mode overlay is gone.。具体来说恢复可用此前被覆盖层统一禁用AskUserQuestion询问用户plan-mode 工具EnterPlanMode/ExitPlanMode等worktree 工具EnterWorktree等但注意当会话工作目录无.git时仍会被按条件阻止。测试用例leaves interactive tools available for plain agents (only registry-disabled tools blocked)验证了AskUserQuestion、EnterPlanMode不再进入disallowedTools。仍然保持禁用由声明式注册表的exposure: disabled分类决定CronCreate/CronDelete/CronList、TodoWrite、NotebookEdit仍被阻止。在 toolRegistry.ts 中工具分类ClaudeToolExposure user | internal | disabled明确注释disabled分类的工具始终被阻止加入 SDKdisallowedTools硬阻止列表。Cron*系列CronCreate、CronDelete、CronList与TodoWrite、NotebookEdit均属于此类——也就是说Cherry Studio 的调度能力统一收敛到mcp__cherry-tools__cron而 Claude Code 原生 Cron/Todo 工具仍被屏蔽避免能力重复与冲突。保留的特殊限制按场景assistant-only 的AskUserQuestion禁用被保留内置助手Assistant角色仍不能使用该工具headless 运行通道触发与定时任务派发仍禁用AskUserQuestion这类运行没有响应者responder若允许询问会导致运行卡死。测试用例denies interactive no-responder tools at tool fire time for the current headless turn验证了这一点——它通过AgentSessionRuntimeService.getInteractionState判断当前 turn 是否为headless若是则在工具触发时刻而非设置构建时拒绝AskUserQuestion、EnterPlanMode、ExitPlanMode、EnterWorktree及需要审批的运行期工具提示 This channel or scheduled turn has no interactive responder...。用户仍可自行收窄最终保留的自主工具cron、notify、config可以通过 Agent 的工具设置tool settings逐项禁用——这是文档建议的、替代「依赖 Soul Mode 关闭来隐藏自主工具」的做法。旧配置兼容性soul_enabled被忽略旧禁用项静默失效文档明确了迁移行为用户无需任何操作任何 Agent 配置中存储的soul_enabled值都会被直接忽略配置字段已从 schema 中移除曾依赖 Soul Mode 关闭来隐藏自主工具的用户应改为通过 Agent 的工具设置限制单个工具持久化的disabledTools条目中使用旧名称mcp__claw__*/mcp__cherry__*的覆盖项将失去其覆盖效果——该破坏性变更被接受pre-release break不提供 remap 兼容垫片。如果用户此前通过这些旧名称禁用了某个工具升级后该禁用将不再生效需要重新以新名称mcp__cherry-tools__*配置。从服务器构建测试buildMcpServers.test.ts可以印证服务器命名的最终形态测试断言 injects cherry-tools for every session; the standalone cherry server and exa are gone且cherry-tools与agent-memory、skills、mcp-manager一样作为每个会话都会挂载的宿主工具集出现自动批准清单中直接包含mcp__cherry-tools__cron、mcp__cherry-tools__notify、mcp__cherry-tools__config。品牌与服务器重命名CherryClaw 退出历史舞台同一 PR 中完成的三项重命名需要一并知晓CherryClaw 品牌移除UI 字符串与 i18n key 中不再出现该品牌名相关文案统一改为 channels / tasks独立clawMCP 服务器更名为cherry随后与cherry-tools合并独立服务器不再存在自主工具的最终命名统一为mcp__cherry-tools__cron/mcp__cherry-tools__notify/mcp__cherry-tools__config。发布管理者须知Release Notes 要点汇总文档「Notes for release manager」一节为本变更的聚合发布提供了清单涵盖 PR #16726 的多个提交面无条件 Soul-Mode 行为main 进程侧renderer / schema 侧标志位移除CherryClaw 品牌移除UI 与 i18n 清理交互式工具覆盖层移除claw→cherry-tools服务器重命名与合并上一期相关条目2026-06-18 的默认值变更中关于soul_enabled的描述已被本次变更取代该字段已不存在聚合时需合并处理。结论与升级建议Soul Mode 开关的移除本质上是 Cherry Studio v2 Agent 体系的一次「能力扁平化」自主任务管理、记忆与 persona 提示从「可选特权」变为「基础能力」而权限审批permission_mode与工具级禁用成为唯一的收窄手段。对使用者而言无需任何手动迁移——旧的soul_enabled自动失效审视既有安全预期——此前通过关闭 Soul Mode 隐藏自主工具的 Agent现在会暴露这些能力应改用 Agent 工具设置逐项禁用cron/notify/config检查disabledTools旧名称——mcp__claw__*/mcp__cherry__*条目不再生效需按新命名重新配置理解 headless 限制不变——通道与定时任务派发的运行仍禁止需要响应者的交互式工具这是刻意设计而非回归定时任务与通道的选择范围扩大——所有 Agent 均可用于调度与通道不再受模式约束。如需深入底层实现可继续阅读 cherryAutonomyTools.ts自主工具实现、cherryAutonomyTools.test.ts行为契约测试、toolRegistry.ts工具 exposure 分类以及 settingsBuilder.test.ts会话设置与 disallowedTools 组装逻辑。【免费下载链接】cherry-studio Cherry Studio 是一款支持多个 LLM 提供商的桌面客户端项目地址: https://gitcode.com/CherryHQ/cherry-studio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考