---
title: 配置优化
description: 针对你的工作流优化 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 模式

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

---

## 速度与全面性的权衡

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

<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 工作区设置

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

**位置：** 工作区根目录中的 `.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>
