---
title: "核心概念"
description: "了解 Verdent 的架構與關鍵術語"
---

Verdent for VS Code 為 AI 驅動的開發帶來精準與掌控。傳統的 AI 程式設計工具只能猜測你的意圖，而 Verdent 讓你在執行前就能準確看到 AI 將要做什麼、驗證其是否正確運作，並每次都交付可靠的程式碼。

**先規劃，早驗證，交付可靠程式碼**

Verdent 的工作流程圍繞三個核心階段建構：

- **規劃** - 在執行任何動作之前，先與 AI 進行澄清循環。你可以透過規劃規則自訂其行為，並運用互動式架構規劃、視覺化圖表與任務拆解，讓你的需求清晰明確
- **撰寫程式碼** - 透過 Code Diff 的企業級分析審查變更，並充滿信心地交付可投入生產的成果
- **驗證** - 透過 Verify 子代理與瀏覽器動作進行品質保證。反覆執行多輪修復循環，直到程式碼通過全面驗證

了解這些核心概念與 Verdent 的架構，將幫助你更有效地使用本擴充功能。

**深入了解：Plan-Code-Verify 工作流程**

---

## 架構概覽

複雜的任務會被拆解並委派給針對特定目的最佳化的專業 AI 代理。每個子代理都以自己的自訂系統提示詞與獨立的上下文視窗運作，與呼叫它的主代理相互隔離。

這種隔離能維持顛峰效能並避免上下文污染，讓每個子代理專注於其專業任務，而不會讓主代理背負每一項實作細節。

**內建預設子代理：**

Verdent 包含三個可立即使用的預設子代理：

| 子代理              | 用途                          | 何時使用                                                           |
| ------------------ | -------------------------------- | ------------------------------------------------------------------------ |
| **@Verifier**      | 快速程式碼檢查與驗證 | 在程式設計任務期間確保程式碼品質與正確性               |
| **@Explorer**      | 快速探索程式碼庫        | 尋找檔案並回答關於程式碼庫結構的問題      |
| **@Code-reviewer** | 即時程式碼品質評估  | 主動掃描安全性、可維護性與效能問題 |

**自訂子代理：**

你可以建立符合特定需求的自訂子代理。每個自訂子代理都以自己的系統提示詞運作，讓你為特定任務或工作流程定義專屬行為。

自訂子代理可根據任務模式自動觸發，或透過 @ 提及手動呼叫。常見的使用情境包括：

- **技術堆疊專家** - React 效能最佳化器、SQL 查詢最佳化器、Docker 設定審查器
- **品質保證** - 測試覆蓋率分析器、錯誤處理審查器、日誌標準執行器
- **團隊專屬工作流程** - 程式碼風格執行器、文件一致性檢查器、相依套件稽核器
- **專案專屬需求** - 舊版程式碼現代化器、遷移助手、效能預算執行器

**深入了解：** [子代理管理](/docs/verdent-for-vscode/agents-rules/subagent-management)

---

## 執行模式

Verdent 支援多種執行模式，用於控制 AI 如何處理權限與互動：

**權限模式：**

- **手動接受模式** - 每個工具首次使用時請求權限。最適合在學習與一般開發時保有最大掌控權。
- **自動執行模式**（預設）- 自動接受安全操作（檔案讀取、網路搜尋）的權限。檔案編輯與命令執行仍需核准。最適合信任的專案與快速原型開發。
- **略過權限模式** - 完全自主運作，略過所有提示。僅適用於隔離且安全的環境，例如自動化測試或沙箱。

<Tip>
  若要切換權限模式，請點擊輸入框中的 **Switch Permission** 按鈕（顯示目前模式，例如「Manual」或「Auto」），並從下拉選單中選擇你想要的模式。
</Tip>

**切換模式**（控制互動風格）：

- **Agent Mode** - 完整的代理式行為，具備自主任務執行與檔案操作能力
- **Plan Mode** - 以規劃為核心的互動，在執行前審查方法
- **Chat Mode** - 對話式互動，不含自主檔案操作

<Tip>
  若要切換互動風格，請點擊輸入框中的 **Switch Mode** 按鈕（顯示目前模式，例如「Agent」或「Plan」），並從下拉選單中選擇你想要的模式。
</Tip>

**其他模式：**

- **Think Hard Mode** - 分配最大運算資源以深入分析問題、探索多種方法並提供更周延的解決方案。最適合架構決策、複雜除錯，以及需要精密推理的任務。

<Tip>
  若要啟用 Think Hard Mode，請在送出請求前點擊輸入框中的 **Think Hard** 按鈕。
</Tip>

**深入了解：** [執行模式概覽](/docs/verdent-for-vscode/execution-modes/overview)

---

## 上下文管理

上下文管理控制 Verdent 在你的工作階段期間能存取哪些資訊。**上下文視窗**是代理的記憶上限，以 token 為單位計量，並由數個元件共享：系統指令、檔案內容、對話訊息與代理回應。

**上下文如何運作：**

- **@ 提及** - 使用 `@filename.js` 明確將檔案加入上下文，以實現精確掌控
- **自動載入** - Verdent 會根據任務自動納入相關檔案
- **獨立的子代理上下文** - 每個子代理以隔離的上下文視窗運作，避免污染主代理的記憶
- **上下文視窗限制** - 以 token 計量的有限上下文。隨著對話增長，可用空間減少，模型效能也會下降

**最佳實踐：**

- 將大型任務以自然的斷點拆解成較小的區塊
- 對複雜任務使用 Plan Mode，在執行前審查方法
- 在整合前完成個別元件，以避免上下文耗盡
- 開始新任務時開啟新對話，以清除上下文並維持最佳效能

**深入了解：** [上下文管理最佳實踐](/docs/verdent-for-vscode/best-practices/context)

---

## 模型選擇

Verdent 在單一工作流程中協調來自多家 AI 供應商（Claude、GPT-5、Gemini、MiniMax）的模型。每個專業代理都能為其特定任務運用最佳模型。

**預設模型組合：**

- **Performance** - 最大上下文、前沿模型（1-2 倍點數用量）
- **Balance** - 效能與成本的最佳平衡（1 倍點數用量）
- **Efficiency** - 快速、靈敏、具成本效益的任務（約 0.3 倍點數用量）

**可用的個別模型：**

| 供應商  | 模型                | 最適用於                                         | 成本效益                 |
| --------- | -------------------- | ------------------------------------------------ | ------------------------------- |
| Anthropic | Claude 4.5 Opus      | 非常適合深度程式設計任務與問題解決。 | 1.5 倍成本                       |
| Anthropic | Claude 4.5 Sonnet    | 平衡的複雜任務                           | 1 倍基準                     |
| Anthropic | Claude 4.5 Sonnet 1M | 長篇或複雜任務（\>200k 輸入）             | 0.5 倍效率（2 倍成本）       |
| Anthropic | Claude 4.5 Haiku     | 快速、簡單的任務                               | 比 Sonnet 高 3.2 倍效率 |
| OpenAI    | GPT-5 (Beta)         | 推理與創意                         | 比 Sonnet 高 1.3 倍效率 |
| OpenAI    | GPT-5 Codex (Beta)   | 程式設計與除錯                              | 比 Sonnet 高 1.3 倍效率 |
| Google    | Gemini 3 Pro         | 進階推理與多模態                | 變動                        |
| Kimi      | Kimi 2 Turbo (Beta)  | 程式設計的極速模型                   | 比 Sonnet 高 3.1 倍效率 |

**深入了解：** [設定選項](/docs/verdent-for-vscode/configuration/settings)

---

## 常見問題

<Accordion title="什麼是上下文污染？">
  當上下文中先前的動作與資訊產生非預期的行為模式，進而影響未來的任務。例如，如果你反覆更新程式碼然後部署，代理可能會開始將所有程式碼更新都與立即部署連結，即使你只是在實驗。子代理透過以隔離的上下文視窗運作來避免上下文污染，讓每項專業任務都能以乾淨的上下文開始，並避免不同類型工作之間的交叉污染。
</Accordion>

<Accordion title="什麼是安全操作？">
  僅讀取資料而不進行變更的操作：檔案讀取與網路搜尋。這些操作在自動執行模式中會被自動核准，而檔案編輯與命令執行為了安全考量仍需核准。
</Accordion>

<Accordion title="什麼是命令執行？">
  透過 Verdent 執行終端機命令或 shell 指令稿，包括執行測試、安裝套件或執行建置命令等操作。命令執行在大多數權限模式中需要核准，以避免非預期的系統變更。
</Accordion>

<Accordion title="什麼是 token？">
  上下文視窗的計量單位。Token 代表 AI 模型處理的文字片段（單字、單字的一部分或字元）。上下文限制以 token 而非字元或單字計量，一般對話通常會消耗數千個 token。
</Accordion>

<Accordion title="什麼是點數？">
  Verdent 的使用量計價單位。不同模型有不同的成本效益（例如 Haiku 比 Sonnet 基準高 3.2 倍效率，Sonnet 為 1 倍基準）。你的訂閱方案包含每月點數額度（例如 Starter 為 640 點數、Pro 為 2,000 點數、Max 為 6,000 點數）。
</Accordion>

<Accordion title="什麼是多輪生成-測試-修復循環？">
  一種迭代式驗證流程，程式碼會被生成、測試並修復，直到通過全面測試。Verdent 會自動執行測試、分析失敗、修正問題並重新測試，經過多輪反覆直到程式碼正確運作。這能交付可投入生產的程式碼，而不僅是建議。每個結果都包含詳細的摘要與程式碼差異，準確顯示變更了什麼。
</Accordion>

---

## 另請參閱

<CardGroup cols={2}>
  <Card title="執行模式" icon="sliders" href="/docs/verdent-for-vscode/execution-modes/overview">
    深入了解手動接受、自動執行、Plan Mode 與權限
  </Card>
  <Card title="子代理管理" icon="robot" href="/docs/verdent-for-vscode/agents-rules/subagent-management">
    建立並自訂用於專業任務的子代理
  </Card>
</CardGroup>