# 配置优化 (/zh-CN/docs/verdent-for-vscode/configuration/tuning)

> 针对你的工作流优化 Verdent



针对你的工作流需求优化 Verdent for VS Code，平衡速度、成本与全面性。配置模型预设、执行模式和上下文管理策略以获得最佳性能。

### 优化领域 [#优化领域]

* 选择模型预设以平衡成本与性能
* 配置执行模式以提升工作流效率
* 针对大型代码库进行上下文管理
* 按项目和工作区级别进行定制

***

## 针对你的工作流调整设置 [#针对你的工作流调整设置]

### 模型预设选择 [#模型预设选择]

根据任务复杂度和预算选择合适的模型预设：

| 预设              | 成本                         | 成本效率                  | 最适合            |
| --------------- | -------------------------- | --------------------- | -------------- |
| **Efficiency**  | 约为 Balance 的 0.3 倍（降低 70%） | 比 Sonnet 高 3.2 倍效率    | 简单任务、快速修复、快速原型 |
| **Balance**（默认） | 1 倍基准                      | 1 倍基准                 | 通用开发任务、日常编码    |
| **Performance** | Balance 的 1-2 倍            | 0.5 倍效率（2 倍成本，1M 上下文） | 复杂架构决策、复杂重构    |

**其他模型：**

* **Claude-4.5-sonnet：** 均衡的通用模型（1 倍基准）
* **Claude-4.5-sonnet-1m：** 适用于复杂任务的扩展上下文（输入超过 200k tokens 时为 0.5 倍效率、2 倍成本）
* **Claude-4.5-haiku：** 最快、最经济（比 Sonnet 高 3.2 倍效率）
* **GPT-5 / GPT-5-codex：** 侧重推理与创造力（Beta，比 Sonnet 高 1.3 倍效率）
* **Minimax-m2：** 快速且经济（Beta，11 月 10 日前免费）

### 执行模式配置 [#执行模式配置]

<Tabs>
  <Tab title="跳过权限（速度优先）">
    * 完全自主，无需审批提示
    * 不会因权限而中断
    * 风险最高——仅在自动化环境中使用
  </Tab>

  <Tab title="自动运行（均衡）">
    * 命令需要审批，文件操作自动执行
    * 减少权限提示
    * 风险较低，同时对危险操作保持安全保护
  </Tab>

  <Tab title="手动接受（全面优先）">
    * 每个操作都需要审批
    * 完全可见与可控
    * 最慢但最安全——最适合学习和生产代码
  </Tab>

  <Tab title="规划（审查）">
    * 执行前进行策略规划
    * 只读分析阶段
    * 在任何改动前审查并批准
  </Tab>
</Tabs>

### Think Hard 模式 [#think-hard-模式]

为复杂推理任务启用：

* **全面性：** 针对复杂问题提供最大推理深度
* **速度：** 因延长思考预算而变慢
* **最适合：** 架构决策、复杂调试、复杂分析

***

## 速度与全面性的权衡 [#速度与全面性的权衡]

根据任务需求在执行速度与分析深度之间取得平衡。

<Tabs>
  <Tab title="速度优先">
    **配置：**

    * **模型：** Efficiency 预设（Claude-4.5-haiku）
    * **权限模式：** 自动运行模式
    * **执行模式：** Agent Mode 直接执行
    * **使用场景：** 快速修复、常规操作、简单任务

    **优势：**

    * 最快的响应时间
    * 最少的中断
    * 相比 Balance 预设降低 70% 成本
  </Tab>

  <Tab title="全面性优先">
    **配置：**

    * **模型：** Performance 预设（Claude-4.5-sonnet-1m）
    * **权限模式：** 手动接受模式
    * **执行模式：** Plan Mode 进行策略审查
    * **Think Hard：** 启用以进行复杂推理
    * **使用场景：** 复杂功能、生产代码、架构决策

    **优势：**

    * 最大上下文窗口（1M tokens）
    * 完全可见与可控
    * 针对复杂问题的深度推理
    * 执行前先审查
  </Tab>

  <Tab title="混合方式">
    大多数用户受益于在不同配置之间切换：

    * **快速修复：** Efficiency + Agent Mode
    * **复杂功能：** Balance/Performance + Plan Mode
    * **探索：** 用 Plan Mode 制定策略，再用 Agent Mode 执行

    **策略：** 根据任务类型调整配置，而不是采用一刀切的方式。
  </Tab>
</Tabs>

<Tip>
  对于受信任的项目使用自动运行模式，可减少权限提示，同时对危险操作保持安全保护。这能在不牺牲关键防护的情况下简化工作流。
</Tip>

***

## 工作区级别配置 [#工作区级别配置]

Verdent 支持按项目和按工作区配置，以实现团队范围的一致性。

### 项目专属配置 [#项目专属配置]

**项目规则（AGENTS.md）：**

* **位置：** 项目根目录或工作区文件夹
* **范围：** 仅应用于当前项目
* **版本控制：** 提交到 git 以建立团队范围的标准
* **内容：** 编码规范、测试要求、架构模式

**示例：**

```markdown filename="AGENTS.md"
# Project Rules

## Code Standards
- Use TypeScript strict mode
- Generate unit tests for all new functions
- Follow MVC pattern

## Testing
- All endpoints require input validation
- Run tests before committing
```

### VS Code 工作区设置 [#vs-code-工作区设置]

在工作区级别配置扩展设置：

**位置：** 工作区根目录中的 `.vscode/settings.json`

**示例：**

```json filename=".vscode/settings.json"
{
  "verdent.enableCheckpoints": true
}
```

### 配置优先级 [#配置优先级]

当配置冲突时，Verdent 按以下优先级顺序应用：

1. **项目规则（AGENTS.md）** - 最高优先级（项目专属）
2. **工作区设置** - VS Code 工作区级别设置
3. **用户规则（VERDENT.md）** - 全局用户偏好
4. **默认设置** - Verdent 内置默认值

***

## 项目专属定制 [#项目专属定制]

### 大型项目的上下文管理 [#大型项目的上下文管理]

<Tabs>
  <Tab title="子智能体">
    * 将复杂操作委托给拥有独立上下文窗口的子智能体
    * 只有子智能体的结果会消耗主上下文，而非整个过程
    * 防止主上下文被实现细节填满
  </Tab>

  <Tab title="文件选择">
    * 使用 `@filename` 仅显式添加相关文件
    * 避免不必要地将整个项目加载到上下文中
    * 针对特定组件进行聚焦分析
  </Tab>

  <Tab title="任务分块">
    * 将大型任务拆分为更小、可完成的块
    * 为不同的功能或组件开启新会话
    * 自然断点可防止上下文耗尽
  </Tab>

  <Tab title="Plan Mode">
    * 在消耗执行上下文前审查方案
    * 减少因错误实现而浪费的上下文
    * Plan Mode 拥有独立的上下文管理
  </Tab>
</Tabs>

### 性能优化 [#性能优化]

**选择性启用检查点：**

`verdent.enableCheckpoints` 设置使用 git 进行版本控制：

* 在超大型仓库上可能影响性能
* 仅在需要检查点功能时启用
* 在大型代码库上为获得最大性能可禁用

<Tip>
  仅为关键任务选择性启用检查点，过度使用检查点会拖慢工作流而不带来价值。
</Tip>

**模型选择：**

* 对简单、独立的任务使用 Efficiency 预设（Haiku）
* 将 Performance 预设（Sonnet-1M）保留给上下文密集的操作
* 通用工作使用 Balance 预设

**执行模式：**

* 自动运行模式可减少权限提示所消耗的上下文
* 跳过权限模式可为自动化环境最大化效率

<Note>
  在多工作区场景中，切换工作区时会自动应用相应的项目规则，无需手动切换配置。
</Note>

<Tip>
  多工作区配置让你能针对不同项目类型优化设置，例如开发 vs 生产、monorepo vs 微服务。
</Tip>

***

## 另见 [#另见]

<CardGroup cols="2">
  <Card title="配置设置" icon="gear" href="/docs/verdent-for-vscode/configuration/settings">
    完整的配置选项与模型选择
  </Card>

  <Card title="资源监控" icon="chart-line" href="/docs/verdent-for-vscode/resource-management/monitoring">
    监控性能并优化 token 使用
  </Card>
</CardGroup>