核心概念
了解 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 設定審查器
- 品質保證 - 測試覆蓋率分析器、錯誤處理審查器、日誌標準執行器
- 團隊專屬工作流程 - 程式碼風格執行器、文件一致性檢查器、相依套件稽核器
- 專案專屬需求 - 舊版程式碼現代化器、遷移助手、效能預算執行器
深入了解： 子代理管理
執行模式
Verdent 支援多種執行模式，用於控制 AI 如何處理權限與互動：
權限模式：
- 手動接受模式 - 每個工具首次使用時請求權限。最適合在學習與一般開發時保有最大掌控權。
- 自動執行模式（預設）- 自動接受安全操作（檔案讀取、網路搜尋）的權限。檔案編輯與命令執行仍需核准。最適合信任的專案與快速原型開發。
- 略過權限模式 - 完全自主運作，略過所有提示。僅適用於隔離且安全的環境，例如自動化測試或沙箱。
若要切換權限模式，請點擊輸入框中的 Switch Permission 按鈕（顯示目前模式，例如「Manual」或「Auto」），並從下拉選單中選擇你想要的模式。
切換模式（控制互動風格）：
- Agent Mode - 完整的代理式行為，具備自主任務執行與檔案操作能力
- Plan Mode - 以規劃為核心的互動，在執行前審查方法
- Chat Mode - 對話式互動，不含自主檔案操作
若要切換互動風格，請點擊輸入框中的 Switch Mode 按鈕（顯示目前模式，例如「Agent」或「Plan」），並從下拉選單中選擇你想要的模式。
其他模式：
- Think Hard Mode - 分配最大運算資源以深入分析問題、探索多種方法並提供更周延的解決方案。最適合架構決策、複雜除錯，以及需要精密推理的任務。
若要啟用 Think Hard Mode，請在送出請求前點擊輸入框中的 Think Hard 按鈕。
深入了解： 執行模式概覽
上下文管理
上下文管理控制 Verdent 在你的工作階段期間能存取哪些資訊。上下文視窗是代理的記憶上限，以 token 為單位計量，並由數個元件共享：系統指令、檔案內容、對話訊息與代理回應。
上下文如何運作：
- @ 提及 - 使用
@filename.js明確將檔案加入上下文，以實現精確掌控 - 自動載入 - Verdent 會根據任務自動納入相關檔案
- 獨立的子代理上下文 - 每個子代理以隔離的上下文視窗運作，避免污染主代理的記憶
- 上下文視窗限制 - 以 token 計量的有限上下文。隨著對話增長，可用空間減少，模型效能也會下降
最佳實踐：
- 將大型任務以自然的斷點拆解成較小的區塊
- 對複雜任務使用 Plan Mode，在執行前審查方法
- 在整合前完成個別元件，以避免上下文耗盡
- 開始新任務時開啟新對話，以清除上下文並維持最佳效能
深入了解： 上下文管理最佳實踐
模型選擇
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 倍效率 |
| Gemini 3 Pro | 進階推理與多模態 | 變動 | |
| Kimi | Kimi 2 Turbo (Beta) | 程式設計的極速模型 | 比 Sonnet 高 3.1 倍效率 |
深入了解： 設定選項
常見問題
什麼是上下文污染？
當上下文中先前的動作與資訊產生非預期的行為模式，進而影響未來的任務。例如，如果你反覆更新程式碼然後部署，代理可能會開始將所有程式碼更新都與立即部署連結，即使你只是在實驗。子代理透過以隔離的上下文視窗運作來避免上下文污染，讓每項專業任務都能以乾淨的上下文開始，並避免不同類型工作之間的交叉污染。
什麼是安全操作？
僅讀取資料而不進行變更的操作：檔案讀取與網路搜尋。這些操作在自動執行模式中會被自動核准，而檔案編輯與命令執行為了安全考量仍需核准。
什麼是命令執行？
透過 Verdent 執行終端機命令或 shell 指令稿，包括執行測試、安裝套件或執行建置命令等操作。命令執行在大多數權限模式中需要核准，以避免非預期的系統變更。
什麼是 token？
上下文視窗的計量單位。Token 代表 AI 模型處理的文字片段（單字、單字的一部分或字元）。上下文限制以 token 而非字元或單字計量，一般對話通常會消耗數千個 token。
什麼是點數？
Verdent 的使用量計價單位。不同模型有不同的成本效益（例如 Haiku 比 Sonnet 基準高 3.2 倍效率，Sonnet 為 1 倍基準）。你的訂閱方案包含每月點數額度（例如 Starter 為 640 點數、Pro 為 2,000 點數、Max 為 6,000 點數）。
什麼是多輪生成-測試-修復循環？
一種迭代式驗證流程，程式碼會被生成、測試並修復，直到通過全面測試。Verdent 會自動執行測試、分析失敗、修正問題並重新測試，經過多輪反覆直到程式碼正確運作。這能交付可投入生產的程式碼，而不僅是建議。每個結果都包含詳細的摘要與程式碼差異，準確顯示變更了什麼。