---
title: 設定優化
description: 為你的工作流程優化 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 日前免費）

### 執行模式設定

<Tabs>
  <Tab title="Skip Permissions (Speed)">
    - 完全自主，無需核准提示
    - 不會因權限而中斷
    - 風險最高 — 僅在自動化環境中使用
  </Tab>
  <Tab title="Auto-Run (Balanced)">
    - 命令需要核准，檔案操作自動進行
    - 減少權限提示
    - 風險較低，同時對危險操作維持安全防護
  </Tab>
  <Tab title="Manual Accept (Thoroughness)">
    - 每項操作都需要核准
    - 完整的可見性與掌控度
    - 最慢但最安全 — 最適合學習與正式環境程式碼
  </Tab>
  <Tab title="Plan (Review)">
    - 執行前進行策略規劃
    - 唯讀分析階段
    - 在任何變更前審查並核准
  </Tab>
</Tabs>

### Think Hard 模式

為複雜的推理任務啟用：
- **徹底性：** 針對複雜問題提供最大推理深度
- **速度：** 因延長思考預算而較慢
- **最適合：** 架構決策、複雜除錯、繁複分析

---

## 速度與徹底性的取捨

根據任務需求，在執行速度與分析深度之間取得平衡。

<Tabs>
  <Tab title="Speed-Critical">
    **設定：**
    - **模型：** Efficiency 預設（Claude-4.5-haiku）
    - **權限模式：** Auto-Run Mode
    - **執行模式：** Agent Mode 直接執行
    - **使用情境：** 快速修正、例行操作、簡單任務

    **優點：**
    - 最快的回應時間
    - 最少的中斷
    - 相較 Balance 預設降低 70% 成本
  </Tab>
  <Tab title="Thoroughness-Critical">
    **設定：**
    - **模型：** Performance 預設（Claude-4.5-sonnet-1m）
    - **權限模式：** Manual Accept Mode
    - **執行模式：** Plan Mode 進行策略審查
    - **Think Hard：** 啟用以進行複雜推理
    - **使用情境：** 複雜功能、正式環境程式碼、架構決策

    **優點：**
    - 最大上下文視窗（1M token）
    - 完整的可見性與掌控度
    - 針對複雜問題進行深度推理
    - 執行前先審查
  </Tab>
  <Tab title="Hybrid Approach">
    多數使用者能從在不同設定間切換上下文中受益：

    - **快速修正：** Efficiency + Agent Mode
    - **複雜功能：** Balance/Performance + Plan Mode
    - **探索：** 先用 Plan Mode 制定策略，再用 Agent Mode 執行

    **策略：** 依任務類型調整設定，而非採用一體適用的方式。
  </Tab>
</Tabs>

<Tip>
對於受信任的專案，使用 Auto-Run Mode 可減少權限提示，同時對危險操作維持安全防護。這能在不犧牲關鍵保護的前提下簡化工作流程。
</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="Subagents">
    - 將複雜操作委派給擁有獨立上下文視窗的子代理
    - 只有子代理的結果會消耗主上下文，而非整個處理過程
    - 避免主上下文被實作細節填滿
  </Tab>
  <Tab title="File Selection">
    - 使用 `@filename` 僅明確加入相關檔案
    - 避免不必要地將整個專案載入上下文
    - 針對特定元件進行聚焦分析
  </Tab>
  <Tab title="Task Chunking">
    - 將大型任務拆分為較小、可完成的區塊
    - 為不同功能或元件開啟新工作階段
    - 自然的中斷點可避免上下文耗盡
  </Tab>
  <Tab title="Plan Mode">
    - 在消耗執行上下文前先審查方法
    - 減少因錯誤實作而浪費的上下文
    - Plan Mode 有獨立的上下文管理
  </Tab>
</Tabs>

### 效能優化

**選擇性啟用 Checkpoints：**

`verdent.enableCheckpoints` 設定使用 git 進行版本控制：
- 在非常大的儲存庫上可能影響效能
- 僅在需要 checkpoint 功能時啟用
- 在大型程式碼庫上停用以獲得最大效能

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

**模型選擇：**
- 對簡單、獨立的任務使用 Efficiency 預設（Haiku）
- 將 Performance 預設（Sonnet-1M）保留給上下文繁重的操作
- 一般工作使用 Balance 預設

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

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

<Tip>
多工作區設定讓你能依專案類型優化設定，例如開發與正式環境、monorepo 與微服務。
</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>