Verdent Docs
Configuration

設定優化

為你的工作流程優化 Verdent

優化 Verdent for VS Code,根據你的工作流程需求在速度、成本與徹底性之間取得平衡。設定模型預設、執行模式與上下文管理策略,以達到最佳效能。

優化領域

  • 選擇模型預設,平衡成本與效能
  • 設定執行模式,提升工作流程效率
  • 為大型程式碼庫進行上下文管理
  • 按專案與工作區層級進行自訂

為你的工作流程調整設定

模型預設選擇

根據任務複雜度與預算選擇合適的模型預設:

預設成本成本效率最適合
Efficiency約 0.3x Balance(降低 70%)比 Sonnet 效率高 3.2 倍簡單任務、快速修正、快速原型開發
Balance(預設)1x 基準1x 基準一般開發任務、日常程式設計
Performance1-2x Balance0.5x 效率(2x 成本,1M 上下文)複雜的架構決策、繁複的重構

其他模型:

  • Claude-4.5-sonnet: 平衡的通用模型(1x 基準)
  • Claude-4.5-sonnet-1m: 為複雜任務提供延伸上下文(0.5x 效率,輸入超過 200k token 時成本為 2x)
  • 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)
  • 權限模式: Auto-Run Mode
  • 執行模式: Agent Mode 直接執行
  • 使用情境: 快速修正、例行操作、簡單任務

優點:

  • 最快的回應時間
  • 最少的中斷
  • 相較 Balance 預設降低 70% 成本

設定:

  • 模型: Performance 預設(Claude-4.5-sonnet-1m)
  • 權限模式: Manual Accept Mode
  • 執行模式: Plan Mode 進行策略審查
  • Think Hard: 啟用以進行複雜推理
  • 使用情境: 複雜功能、正式環境程式碼、架構決策

優點:

  • 最大上下文視窗(1M token)
  • 完整的可見性與掌控度
  • 針對複雜問題進行深度推理
  • 執行前先審查

多數使用者能從在不同設定間切換上下文中受益:

  • 快速修正: Efficiency + Agent Mode
  • 複雜功能: Balance/Performance + Plan Mode
  • 探索: 先用 Plan Mode 制定策略,再用 Agent Mode 執行

策略: 依任務類型調整設定,而非採用一體適用的方式。

對於受信任的專案,使用 Auto-Run 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 有獨立的上下文管理

效能優化

選擇性啟用 Checkpoints:

verdent.enableCheckpoints 設定使用 git 進行版本控制:

  • 在非常大的儲存庫上可能影響效能
  • 僅在需要 checkpoint 功能時啟用
  • 在大型程式碼庫上停用以獲得最大效能

僅針對關鍵任務選擇性啟用 Checkpoints,過度建立 checkpoint 會拖慢工作流程,卻無實際助益。

模型選擇:

  • 對簡單、獨立的任務使用 Efficiency 預設(Haiku)
  • 將 Performance 預設(Sonnet-1M)保留給上下文繁重的操作
  • 一般工作使用 Balance 預設

執行模式:

  • Auto-Run Mode 可減少權限提示所消耗的上下文
  • Skip Permissions Mode 為自動化環境發揮最大效率

多工作區情境會在切換工作區時自動套用對應的專案規則,無需手動切換設定。

多工作區設定讓你能依專案類型優化設定,例如開發與正式環境、monorepo 與微服務。


另請參閱