Verdent Docs
配置

配置优化

针对你的工作流优化 Verdent

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

优化领域

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

针对你的工作流调整设置

模型预设选择

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

预设成本成本效率最适合
Efficiency约为 Balance 的 0.3 倍(降低 70%)比 Sonnet 高 3.2 倍效率简单任务、快速修复、快速原型
Balance(默认)1 倍基准1 倍基准通用开发任务、日常编码
PerformanceBalance 的 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 日前免费)

执行模式配置

  • 完全自主,无需审批提示
  • 不会因权限而中断
  • 风险最高——仅在自动化环境中使用
  • 命令需要审批,文件操作自动执行
  • 减少权限提示
  • 风险较低,同时对危险操作保持安全保护
  • 每个操作都需要审批
  • 完全可见与可控
  • 最慢但最安全——最适合学习和生产代码
  • 执行前进行策略规划
  • 只读分析阶段
  • 在任何改动前审查并批准

Think Hard 模式

为复杂推理任务启用:

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

速度与全面性的权衡

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

配置:

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

优势:

  • 最快的响应时间
  • 最少的中断
  • 相比 Balance 预设降低 70% 成本

配置:

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

优势:

  • 最大上下文窗口(1M tokens)
  • 完全可见与可控
  • 针对复杂问题的深度推理
  • 执行前先审查

大多数用户受益于在不同配置之间切换:

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

策略: 根据任务类型调整配置,而不是采用一刀切的方式。

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


工作区级别配置

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

项目专属配置

项目规则(AGENTS.md):

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

示例:

# 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

示例:

{
  "verdent.enableCheckpoints": true
}

配置优先级

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

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

项目专属定制

大型项目的上下文管理

  • 将复杂操作委托给拥有独立上下文窗口的子智能体
  • 只有子智能体的结果会消耗主上下文,而非整个过程
  • 防止主上下文被实现细节填满
  • 使用 @filename 仅显式添加相关文件
  • 避免不必要地将整个项目加载到上下文中
  • 针对特定组件进行聚焦分析
  • 将大型任务拆分为更小、可完成的块
  • 为不同的功能或组件开启新会话
  • 自然断点可防止上下文耗尽
  • 在消耗执行上下文前审查方案
  • 减少因错误实现而浪费的上下文
  • Plan Mode 拥有独立的上下文管理

性能优化

选择性启用检查点:

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

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

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

模型选择:

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

执行模式:

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

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

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


另见