Configuration
設定優化
為你的工作流程優化 Verdent
優化 Verdent for VS Code,根據你的工作流程需求在速度、成本與徹底性之間取得平衡。設定模型預設、執行模式與上下文管理策略,以達到最佳效能。
優化領域
- 選擇模型預設,平衡成本與效能
- 設定執行模式,提升工作流程效率
- 為大型程式碼庫進行上下文管理
- 按專案與工作區層級進行自訂
為你的工作流程調整設定
模型預設選擇
根據任務複雜度與預算選擇合適的模型預設:
| 預設 | 成本 | 成本效率 | 最適合 |
|---|---|---|---|
| Efficiency | 約 0.3x Balance(降低 70%) | 比 Sonnet 效率高 3.2 倍 | 簡單任務、快速修正、快速原型開發 |
| Balance(預設) | 1x 基準 | 1x 基準 | 一般開發任務、日常程式設計 |
| Performance | 1-2x Balance | 0.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 committingVS Code 工作區設定
在工作區層級設定擴充功能:
位置: 工作區根目錄中的 .vscode/settings.json
範例:
{
"verdent.enableCheckpoints": true
}設定優先順序
當設定發生衝突時,Verdent 會套用以下優先順序:
- 專案規則(AGENTS.md) - 最高優先(專案專屬)
- 工作區設定 - VS Code 工作區層級設定
- 使用者規則(VERDENT.md) - 全域使用者偏好
- 預設設定 - Verdent 的內建預設值
專案專屬自訂
大型專案的上下文管理
- 將複雜操作委派給擁有獨立上下文視窗的子代理
- 只有子代理的結果會消耗主上下文,而非整個處理過程
- 避免主上下文被實作細節填滿
- 使用
@filename僅明確加入相關檔案 - 避免不必要地將整個專案載入上下文
- 針對特定元件進行聚焦分析
- 將大型任務拆分為較小、可完成的區塊
- 為不同功能或元件開啟新工作階段
- 自然的中斷點可避免上下文耗盡
- 在消耗執行上下文前先審查方法
- 減少因錯誤實作而浪費的上下文
- Plan Mode 有獨立的上下文管理
效能優化
選擇性啟用 Checkpoints:
verdent.enableCheckpoints 設定使用 git 進行版本控制:
- 在非常大的儲存庫上可能影響效能
- 僅在需要 checkpoint 功能時啟用
- 在大型程式碼庫上停用以獲得最大效能
僅針對關鍵任務選擇性啟用 Checkpoints,過度建立 checkpoint 會拖慢工作流程,卻無實際助益。
模型選擇:
- 對簡單、獨立的任務使用 Efficiency 預設(Haiku)
- 將 Performance 預設(Sonnet-1M)保留給上下文繁重的操作
- 一般工作使用 Balance 預設
執行模式:
- Auto-Run Mode 可減少權限提示所消耗的上下文
- Skip Permissions Mode 為自動化環境發揮最大效率
多工作區情境會在切換工作區時自動套用對應的專案規則,無需手動切換設定。
多工作區設定讓你能依專案類型優化設定,例如開發與正式環境、monorepo 與微服務。