执行模式与权限
了解不同的执行模式及其适用场景
Verdent for VS Code 提供多种执行模式，用于控制 AI 如何与你的文件交互以及执行命令。每种模式在控制力、速度和安全性之间提供不同的权衡。
你将学到
- 每种执行模式的工作方式及适用场景
- 权限模型与安全考量
- 模式对比与切换策略
- 用于复杂推理任务的 Think Hard Mode
可用的关键模式
Manual Accept Mode
默认模式，对每个受保护操作都发出权限请求。提供最大的控制力与监督。
Auto-Run Mode
自动执行文件操作，命令则需要权限。在速度与安全之间取得平衡。
Skip Permission Mode
为隔离环境提供完全自主。对任何操作都不弹出权限提示。
Plan Mode
只读规划模式。在执行开始前审查完整计划。
执行模式
Manual Accept Mode 是默认的执行模式，为文件修改和命令执行提供控制。
自动操作：
- 文件读取与代码分析
- 目录浏览
需要权限：
- 文件编辑（创建、修改、删除）
- 命令执行（终端命令、测试、构建）
当 Verdent 需要执行受保护操作时，它会显示想要采取的操作以及涉及的文件/命令。你可以对每个操作选择 Accept 或 Reject。
重要： 每次权限仅针对该特定操作。Manual Accept Mode 在整个会话中对每个受保护操作都需要批准。
何时使用
- 学习 Verdent 的能力与工作流模式
- 在不熟悉的代码库中工作，需要谨慎监督
- 对生产代码或安全敏感区域进行关键更改
- 需要明确批准记录的合规要求
激活
Manual Accept Mode 默认处于激活状态。要切换回来：
打开权限菜单
点击输入框中的 "Switch Permission" 按钮
选择 Manual Accept Mode
从下拉菜单中选择 "Manual Accept Mode"
确认激活
按钮显示 "Manual" 以确认该模式已激活
安全考量
优点：
- 每种工具类型（文件编辑、命令、工具）首次使用时需批准
- 在授权前拥有完整可见性
- 最大的控制力与透明度
限制：
- 某类工具首次批准后，后续使用将不再提示
- 批准是按工具类型而非按操作进行
- 处理关键代码时，开启新会话以重置工具批准
Auto-Run Mode 自动批准文件操作，但命令仍需权限。这减少了常规文件工作的权限提示，同时为风险操作保留安全保障。
自动：
- 工作区内的文件读取、编辑、创建、删除
- 工作区内文件的移动、重命名、整理
- 文件搜索与导航操作
需要权限：
- 任何涉及当前工作区之外路径的命令
- 危险的 bash 命令：
rm -rf、git commit、git push等 - 命令执行（终端、脚本、构建）
- 软件包安装与系统修改
何时使用
| 适合 Auto-Run | 不适合 |
|---|---|
| 有版本控制的受信任代码库 | 不熟悉的代码库 |
| 快速原型设计与实验 | 关键生产代码 |
| 多文件重构（15+ 文件 = 节省 15 次提示） | 没有版本控制的安全网 |
| 减少打断的专注开发 | 合规要求 |
激活
打开权限菜单
点击显示当前模式的 "Switch Permission" 按钮
选择 Auto-Run Mode
从下拉菜单中选择 "Auto-Run Mode"
确认激活
按钮显示 "Auto" 以确认该模式已激活
跨会话与 VS Code 重启持久保留。全局应用于所有工作区。
示例工作流
构建 POST /api/tasks 端点：
- 激活 Auto-Run Mode
- 提交："创建 POST /api/tasks 端点，验证分类存在并保存到数据库"
- Verdent 读取 5+ 个文件，自动修改 3 个文件（无提示）
- 在 Source Control 面板中审查更改
- 请求测试："运行 tasks API 的测试"
npm test命令的权限提示 - 选择 Accept- 添加验证："为空标题添加验证"
- Verdent 自动编辑（无提示）
- 再次请求测试 - 权限提示 - 选择 Accept
- 审查差异，提交更改
结果： 3 次命令提示，0 次文件提示。Manual Accept 则会额外需要 4 次文件提示。
安全考量
优点：
- 更改立即在 VS Code 中可见
- 限定在工作区范围内（无法影响系统文件）
- Git 提供回滚保障
风险：
- 缺乏对文件操作的监督
- 意外的范围扩大（"将 User 重命名为 Account" 可能修改数十个文件）
- 清理过程中可能删除文件
- 如被提示可能会修改敏感文件
缓解措施：
- 使用清晰、具体的提示词
- 完成后审查 Source Control 面板
- 频繁提交以建立干净的检查点
- 对复杂操作先使用 Plan Mode
- 配置 .gitignore 以保护敏感文件
Skip Permission Mode 绕过所有权限提示，允许完全自主。仅在隔离的、可丢弃的环境中使用。
所有操作自动执行：
- 文件操作
- 命令执行
- 软件包安装
- 系统级操作
此模式移除所有安全护栏。仅在完全隔离、可丢弃且错误不会造成任何后果的环境中使用。切勿在生产环境或任何你在意的代码库中使用。
何时使用
| 适合 Skip Permission | 切勿用于 |
|---|---|
| 隔离容器中的自动化 CI/CD 流水线 | 生产环境 |
| 一次性开发容器（实验后删除） | 含有重要代码的开发环境 |
| 无生产连接的沙盒环境 | 任何你在意的代码库 |
| 人工批准会失去意义的脚本化工作流 | 共享仓库 |
| 含有敏感数据的环境 |
激活
打开权限菜单
点击 "Switch Permission" 按钮
选择 Skip Permission Mode
从下拉菜单中选择 "Skip Permission Mode"
确认激活
按钮显示 "Skip" 以确认该模式已激活
激活前的安全检查：
- 这是一次性容器或虚拟机吗？
- 此环境是否可以被删除而无后果？
- 这里是否存在任何生产或重要代码？
如果前两项为"否"或第三项为"是"，请勿激活。
安全警告
所有安全护栏被移除：
- 命令以系统权限立即执行
- 文件可能被修改或删除而无警告
- 数据库操作、Git 操作（包括强制推送）无需批准即可执行
- 可能安装恶意软件包或暴露凭据
仅在以下情况下安全：
- 环境完全可丢弃
- 不存在重要代码或数据
- 与生产系统没有连接
- 你接受任何东西都可能被销毁
Plan Mode
Plan Mode 是一种只读交互模式，Verdent 在其中分析代码、创建详细计划并提出澄清问题，但在你批准之前无法修改文件或执行命令。
工作方式
- 分析 - 自动读取文件
- 规划 - 创建带待办列表的结构化计划
- 澄清 - 提出问题以消除不确定性
- 批准 - 你审查并决定是否继续
- 执行 - 切换到你的权限模式以执行
计划会显示要修改的文件、实现步骤、依赖关系和验证策略。
何时使用
- 复杂的多文件更改（在投入前理解范围）
- 不熟悉的代码库（安全探索而无风险）
- 架构决策（在实现前审查方案）
- 避免 Manual Accept 疲劳（一次审查 vs 50 次单独提示）
- 高风险的生产更改（执行前拥有完整可见性）
激活
打开模式菜单
点击输入框中的 "Switch Mode" 按钮
选择 Plan Mode
从下拉菜单中选择 "Plan Mode"
确认激活
模式指示器变为 "Plan" 以确认该模式已激活
激活后，Verdent 会分析并创建计划，但在你批准之前不会修改文件或执行命令。批准后，切换到你的默认权限模式（Manual Accept 或 Auto-Run）。
安全考量
优点：
- 规划期间零执行风险
- 投入前拥有完整可见性
- 交互式澄清消除不确定性
- 对生产环境分析安全
限制：
- 批准并不保证正确性（计划可能存在逻辑错误）
- 执行安全取决于批准后选择的权限模式
- 计划质量取决于提示词的清晰度
最佳实践：
- 审查计划中的逻辑错误或误解
- 如有不清楚之处提出追问
- 在批准执行前优化提示词
- 考虑将由哪种权限模式执行（Manual Accept 用于监督，Auto-Run 用于速度）
Think Hard Mode
Think Hard Mode 为复杂推理任务分配最大计算资源。模型会探索多种方案并提供更彻底的解决方案。
特点：
- 延长的推理时间
- 对多种解决方案更深入的分析
- 更好地处理复杂逻辑、边界情况和架构决策
- 每次请求消耗更高的积分
何时使用
| 适合 Think Hard Mode | 不适合 |
|---|---|
| 涉及多种权衡的复杂架构决策 | 简单直接的任务 |
| 有多种潜在原因的复杂调试 | 时间敏感的请求 |
| 需要优化分析的算法设计 | 积分预算有限 |
| 正确性至关重要的关键业务逻辑 | 标准模式已足够时 |
| 复杂瓶颈的性能优化 |
激活
使用 UI 按钮进行单次请求激活：
启用 Think Hard
点击输入框中的 "Think Hard" 按钮/开关
提交你的提示词
输入并提交你的请求
仅限单次请求
仅应用于该特定请求 - 不持久保留
适用于所有 AI 提供商。不持久保留 - 需要深度推理的请求每次都必须激活。
在你的提示词中包含思考关键词：
Think: Design the optimal database schema for this multi-tenant SaaS application或用于最大化推理：
Ultrathink: Analyze the trade-offs between different authentication approaches"Think" 和 "ultrathink" 是 Claude 模型特有的能力。这些关键词会在 Claude 模型（Sonnet、Opus）中激活更深入的推理，但可能不适用于其他 AI 提供商（GPT-5、MiniMax）。
仅限单次请求激活 - 不像 Manual Accept 或 Auto-Run 那样持久保留。
模式对比
| 模式 | 控制力 | 速度 | 最适合 | 避免使用场景 |
|---|---|---|---|---|
| Manual Accept | 最大 | 最慢 | 学习、不熟悉的代码、关键更改 | 受信任的项目、快速迭代 |
| Auto-Run | 适中 | 快 | 受信任的代码库、原型设计、多文件工作 | 不熟悉的代码、无版本控制 |
| Skip Permission | 无 | 最快 | CI/CD、一次性容器、沙盒 | 生产、重要代码 |
| Plan Mode | 先审查 | 不适用 | 复杂更改、架构决策 | 简单任务 |
| Think Hard | 按请求 | 较慢 | 复杂推理、算法、关键逻辑 | 简单任务、时间敏感 |
各模式的使用场景
| 场景 | Manual Accept | Auto-Run | Skip Permission | Plan Mode |
|---|---|---|---|---|
| 学习 Verdent | ✓ | |||
| 不熟悉的代码库 | ✓ | ✓ | ||
| 有 Git 的受信任代码库 | ✓ | |||
| 关键/生产代码 | ✓ | ✓ | ||
| 快速原型设计 | ✓ | |||
| 多文件重构 | ✓ | |||
| 复杂架构规划 | ✓ | |||
| CI/CD 流水线（隔离） | ✓ | |||
| 一次性容器 | ✓ | |||
| 合规要求 | ✓ |
安全最佳实践
安全层级（从最安全到最不安全）
理解每种模式的安全排名有助于你为不同风险级别做出适当选择。
- Plan Mode - 在批准前为只读。规划期间零执行风险。
- Manual Accept Mode - 按操作控制，每种工具类型首次使用需批准。
- Auto-Run Mode - 文件自主，命令需批准。需要 Git 安全网。
- Skip Permission Mode - 完全自主。仅限隔离环境。
根据风险级别匹配你的模式：关键代码使用最安全的模式（Plan、Manual Accept），受信任的代码使用更快的模式（Auto-Run），一次性环境使用最快的模式（Skip Permission）。
通用最佳实践
无论你使用哪种执行模式，都适用的基本实践。
适用于所有模式：
- 使用版本控制 - 在使用宽松模式前初始化 Git，频繁提交，提交前审查差异
- 编写清晰的提示词 - 明确范围，显式指定文件边界，使用 @-提及提供上下文
- 提交前审查 - 完成后检查 Source Control 面板，仔细审查所有差异，测试更改
- 开启全新会话 - 在重大任务之间清除上下文，为敏感工作重置工具批准，避免上下文污染
- 将模式匹配风险 - 关键代码 → Manual Accept 或 Plan Mode，受信任代码 → Auto-Run，实验 → 带 Git 的 Auto-Run，一次性环境 → 仅 Skip Permission
安全提醒：
- 切勿提交敏感文件（.env、凭据）
- 在使用 Auto-Run 前配置 .gitignore
- 仔细审查命令权限
- 对影响安全的更改使用 Plan Mode
- 全新会话会重置 Manual Accept 中的工具批准
渐进式权限模型
理解 Verdent 权限系统的工作方式有助于你高效使用它。
工作方式：
- 首次使用 - 当你首次使用每种工具类型（文件编辑、命令执行、工具使用）时，系统会请求权限
- 后续使用 - 初次批准后，该工具类型在本次会话剩余时间内将不再提示
- 新会话 - 开启新会话会重置所有批准，让你重新开始
关键原则： 此模型在安全与生产力之间取得平衡。你只需审查并批准工具类型一次，然后在该批准上下文中高效工作。对于敏感工作，开启新会话以重置批准。
重置批准的方法： 开启新会话