esengine--deepseek-reasonix/docs/TOOL_APPROVAL_MODES.zh-CN.md

工具权限：询问、自动与 Yolo 模式

Reasonix 桌面端输入框下方的“询问 / 自动 / Yolo”控制的是工具权限审批方式。它决定写文件、运行命令、调用带权限的工具时，是否需要先停下来让你批准。

工具权限和“协作方式”是两条独立轴：

• 协作方式与运行模式决定 Reasonix 怎么推进任务，以及采用轻量、均衡还是交付优先倾向。
• 工具权限决定 Reasonix 调用受控工具时，是否需要你审批。

快速对比

模式	行为	适合场景	不适合场景
询问	默认在写文件、跑命令等受控工具前请求批准。	不熟悉的仓库、高风险改动、生产相关操作、需要逐步确认的任务。	大量低风险重复操作，或你已经明确允许 Reasonix 连续执行。
自动	自动批准普通工具权限；显式 ask 规则、deny 规则、计划确认和记忆写入/删除等强制审批仍生效。	日常读代码、改小问题、跑测试、可信工作区里的常规实现任务。	你希望每个写入或命令都人工确认的任务。
Yolo	跳过普通工具权限审批，让写文件和命令尽量连续执行；deny 规则、计划确认、ask 问题和强制审批仍不会被自动回答。	临时分支、可回滚工作区、已确认计划后的批量机械改动。	生产环境、敏感文件、删除/发布/推送等高风险操作，或需求边界不清时。

询问模式

询问模式是最保守的工具权限模式。Reasonix 遇到需要审批的工具调用时，会弹出审批卡片，你可以选择允许一次、本会话允许、总是允许或拒绝。

审批卡片快捷键

• ← / → 循环切换高亮动作。
• Enter 确认当前高亮动作。工具审批默认高亮“允许一次”；计划确认默认高亮“开始执行”。
• 1 / 2 / 3 / 4 可以直接选择对应编号的工具审批动作；计划确认只有 1 / 2 / 3。
• Esc 拒绝当前工具审批；在计划确认里表示退出或继续规划。
• 如果你用 Tab 聚焦到某个按钮，再按 Enter 会触发当前聚焦按钮本身，不会被高亮动作覆盖。

建议使用场景

• 第一次让 Reasonix 处理某个仓库或目录。
• 任务可能涉及删除文件、改配置、提交、发布、安装依赖或访问外部服务。
• 你想观察 Reasonix 准备调用什么工具，再决定是否继续。
• 你正在处理生产数据、密钥、隐私文件或不可轻易回滚的环境。

注意事项

• 询问模式更安全，但会增加交互次数。
• 审批卡片里的“本会话允许”和“总是允许”是权限规则，不是切换到自动模式。
• 如果你已经确认任务范围很清楚，且操作都在可信工作区内，自动模式通常更顺手。

自动模式

自动模式适合日常开发。它会把普通工具权限自动放行，减少反复点击审批；但它不是无限制执行。

自动模式仍会遵守这些边界：

• 显式 deny 规则仍然阻止对应工具或命令。
• 显式 ask 规则仍然会弹出审批。
• 计划模式的“开始执行”确认仍然需要你选择。
• remember / forget 等记忆写入或删除操作仍需要新鲜人工审批，Guardian/安全审查不能代替用户批准。
• ask 问题仍然等待你回答，不会由自动模式代选。

建议使用场景

• 普通代码阅读、搜索、编辑和测试。
• 你信任当前工作区，且改动可以通过 Git 或测试回滚。
• 目标模式下希望 Reasonix 连续推进，但仍保留显式规则和关键确认。
• 计划模式已经确认方案，后续只是常规实现和验证。

注意事项

• 自动模式不等于 Yolo。它不会跳过显式 ask 规则，也不会自动回答产品决策问题。
• 自动模式会减少审批噪音，但仍建议在高风险命令上保留 deny 或 ask 规则。
• 如果你发现 Reasonix 反复准备做你不想要的操作，切回询问模式更容易干预。

Yolo 模式

Yolo 模式用于最大化连续执行。开启后，普通工具审批会被跳过，写文件、运行命令等操作可以更少中断地执行。

怎么开启

• 点击工具权限区域里的“Yolo”。
• 也可以使用 Ctrl+Y 或 Cmd+Y 快捷键切换。
• 通过快捷键进入 Yolo 时，Reasonix 会记住原来的“询问”或“自动”基线；再次按快捷键退出 Yolo，会恢复之前的基线模式。

建议使用场景

• 当前在临时分支或干净工作树，改坏了也能快速回滚。
• 任务已经在计划模式里确认过，后续只是按计划执行。
• 批量机械改动、格式化、补测试、跑一组本地验证命令。
• 你明确希望减少所有普通工具审批中断。

注意事项

• Yolo 只跳过工具权限审批，不会跳过计划确认和 ask 问题。
• Yolo 不会绕过后端的 deny 规则、系统权限、工作区限制或沙箱限制。
• 记忆写入/删除、计划确认等强制新鲜审批仍然会等待你处理；非交互运行和子代理会拒绝这类工具，而不是自动批准。
• 不建议在生产环境、敏感目录、密钥文件、发布流程或需求不清楚的任务里开启。

与协作方式的组合

组合	行为
计划 + 询问	最保守。先只读出计划，确认执行后每个受控工具仍可能请求审批。
计划 + 自动	计划确认仍需要你批准；开始执行后，普通工具权限自动放行。
计划 + Yolo	计划确认仍需要你批准；开始执行后，普通工具审批尽量不再打断。
目标 + 询问	目标会持续推进，但遇到工具审批会停下来等你。
目标 + 自动	适合大多数日常目标任务，连续推进且保留显式规则边界。
目标 + Yolo	适合边界非常清楚、可回滚的目标任务；风险最高。
任一运行模式 + 任一工具权限	支持。运行模式影响工具面和执行合约，不改变工具审批语义。

推荐选择

• 不确定怎么选：用“询问”。
• 日常开发：用“自动”。
• 已确认计划、可回滚、想减少中断：短时间使用“Yolo”。
• 高风险命令或敏感环境：用“询问”，并通过 deny / ask 规则保护关键操作。