---
title: "使用者介面概覽"
description: "了解 Verdent 的介面元件與導覽"
---
Verdent for VS Code 採用簡潔的三段式介面，盡量減少干擾。所有互動都在 Visual Studio Code 側邊欄中進行，讓你緊貼著程式碼工作。
---
## 開啟 Verdent
你可以透過以下任一方式開啟 Verdent：
- **側邊欄圖示** - 點擊 Visual Studio Code 活動列（左側邊欄）中的 Verdent 圖示
- **鍵盤快捷鍵** - 按下 `Cmd+L`（macOS）或 `Ctrl+L`（Windows/Linux）
- **命令面板** - 按下 `Cmd+Shift+P` / `Ctrl+Shift+P`，然後搜尋「Verdent」
面板會在 Visual Studio Code 側邊欄中開啟，並可依需要調整大小、移動或停靠。
拖曳 Verdent 面板邊緣即可調整大小，以檢視更多對話記錄或為編輯器騰出更多空間。
---
## 介面元件
快速存取核心功能：
| 按鈕 | 功能 |
| --------------- | ---------------------------------------------------------- |
| 新增工作階段 | 以乾淨的上下文開始全新對話 |
| 專案歷史 | 瀏覽並還原先前的工作階段 |
| 使用者中心 | 檢視帳戶資訊與點數餘額 |
| 意見回饋 | 提交意見回饋並回報問題 |
| 設定 | 設定 MCP 伺服器、子代理、規則與模型預設組 |
主要對話區域會顯示：
- **AI 回應** - 帶有語法高亮程式碼區塊的格式化文字
- **程式碼差異** - 互動式的檔案變更前後對照
- **計畫** - 使用 Plan Mode 時的結構化任務拆解
- **驗證結果** - 測試執行輸出與除錯資訊
- **檔案操作** - 檔案建立、編輯或刪除的確認
- **子代理輸出** - 委派任務的執行結果
對話檢視會保留完整的對話記錄，讓你可以向上捲動回顧先前的互動。
底部的輸入區域，包含用於撰寫請求的各項控制項：
**文字輸入區：** 用於輸入自然語言提示詞的主要文字欄位
**動作按鈕：**
| 按鈕 | 功能 |
| ------------------------- | ------------------------------------------------------------------------ |
| 新增上下文 | 以 @ 提及方式參考檔案，或叫用子代理 |
| 新增圖片或檔案 | 加入截圖、圖表或文件以供分析 |
| 新增子代理 | 將任務委派給專門的子代理 |
| 切換模式 | 在 Agent、Plan 與 Chat 模式之間切換 |
| 切換／自訂 AI 模型 | 選擇 Performance、Balance、Efficiency 預設組或特定模型 |
| Think Hard 模式 | 啟用最大思考預算以處理複雜推理 |
| 切換權限 | 變更權限模式（Manual Accept、Auto-Run、Plan、Skip Permissions） |
| 傳送 | 將你的提示詞送出給 AI 模型 |
---
## 狀態指示器
Verdent 透過視覺指示器傳達系統狀態：
對話檢視透過視覺提示而非明確標籤來傳達狀態：
- **處理中指示器** - 當 Verdent 正在主動工作時會出現視覺指示器。這表示 AI 正在讀取檔案、分析程式碼或準備回應。
- **正在產生文字** - 你會看到 Verdent 的回應即時出現，AI 正在撰寫說明、程式碼建議或計畫。串流文字代表模型正在主動產生輸出。
- **沒有任何動靜** - 當對話檢視保持靜止且無任何活動時，表示 Verdent 正在等待。這意味著你需要核准檔案變更、回答釐清問題或提供下一個請求。
輸入框中的文字游標會指示 Verdent 是否準備好接受新的請求：
- **閃爍的游標** - 輸入框處於作用中狀態，可接受文字輸入。你可以輸入請求並按下傳送。這會在 Verdent 完成處理並等待你下一個提示詞時出現。
- **無游標／已停用** - 當 Verdent 正在處理請求時，輸入框會被停用。這可避免中斷目前的任務，並確保每個請求在開始下一個之前完成。
**工作流程模式：** 當你送出請求時，游標會消失（輸入框變為停用）。一旦 Verdent 完成任務，游標會重新出現，表示你可以輸入下一個請求。
輸入框會顯示指示器以呈現你目前的設定：
- **切換權限按鈕** - 在按鈕本身上以標籤顯示你目前的權限模式。你會看到「Manual」、「Auto」、「Plan」或「Skip」。這讓你在送出請求前確認目前生效的執行模式。點擊按鈕即可在各可用模式之間循環切換。
- **切換／自訂 AI 模型按鈕** - 顯示目前選取的模型或預設組。對於預設組你會看到「Performance」、「Balance」或「Efficiency」，若你選取了個別模型則會看到特定模型名稱，例如「Claude 4.5 Sonnet」。這可確認哪個 AI 模型將處理你的下一個請求。
這些指示器能讓你一眼確認目前的設定，協助你在送出提示詞前確保配置正確。
狀態指示器會即時更新，精確呈現 Verdent 正在進行的工作，協助你了解代理的活動。
---
## 導覽模式
頂部列會依功能使用不同的導覽模式：
**按鈕：**
- **新增工作階段** - 點擊此按鈕會立即清除你目前的對話，並回到具有乾淨上下文的全新對話檢視。沒有獨立的頁面或彈出視窗；它會在同一檢視中即時發生。
**頁面：**
- **專案歷史** - 開啟一個專屬的整頁檢視，你可以在其中瀏覽所有先前的工作階段與對話。這會離開對話檢視以顯示你的工作階段歷史。點擊 **X** 按鈕即可回到對話檢視。
**彈出視窗（覆蓋對話框）：**
- **使用者中心** - 開啟一個覆蓋式彈出視窗，顯示你的帳戶資訊、點數餘額與用量明細。對話檢視仍會顯示在彈出視窗後方。
- **意見回饋** - 開啟一個覆蓋式彈出視窗，內含提交意見回饋與回報問題的表單。對話檢視會留在背景中。
若要關閉彈出視窗，可點擊彈出視窗區域外側，或使用彈出視窗角落的 **X** 按鈕。
**下拉式選單：**
- **設定** - 開啟一個內嵌的下拉式選單，提供 MCP 伺服器、子代理、規則與模型預設組等選項。當你從選單中選取某個選項（例如「MCP 伺服器」）時，會開啟該設定的專屬整頁檢視。點擊 **X** 按鈕即可回到對話檢視。
所有輸入框按鈕都會開啟下拉式選單，以便快速、內嵌地進行設定：
**下拉式選單模式：** 輸入框中的每個按鈕（新增上下文、新增圖片或檔案、新增子代理、切換模式、切換／自訂 AI 模型、Think Hard 模式、切換權限）都會在按鈕正下方開啟下拉式選單。這些選單讓你無須離開對話檢視即可設定請求。
**為何使用下拉式選單：** 此設計讓你在所有常見操作中都能停留在對話檢視。你可以調整設定、選取模型、變更模式並新增上下文，而不會看不到對話或中斷工作流程。
**關閉下拉式選單：** 當你做出選擇或點擊選單外任何位置時，下拉式選單會自動關閉。這讓你能快速完成設定並回到撰寫請求。
不同的導覽元素會以不同方式回到主要的對話檢視：
**從頁面（專案歷史、設定）：**
- 點擊頁面頂部角落的 **X** 按鈕
- 這會讓你回到先前離開的對話檢視
**從彈出視窗（使用者中心、意見回饋）：**
- 點擊彈出視窗角落的 **X** 按鈕，或
- 點擊彈出視窗覆蓋層外的任何位置
- 對話檢視一直顯示在彈出視窗後方，因此關閉彈出視窗會立即將焦點回復
**從下拉式選單：**
- 當你做出選擇時選單會自動關閉
- 點擊選單外任何位置即可不做選擇而關閉
- 你從未離開對話檢視，因此沒有需要「回去」的地方
**導覽理念：** 大多數互動都透過下拉式選單進行，讓你停留在對話檢視中。**專案歷史**與**設定選項**會導覽到獨立頁面，而**使用者中心**與**意見回饋**則使用不會隱藏對話的覆蓋式彈出視窗。
使用 @ 提及與斜線命令來引導導覽。這能協助 Verdent 理解你的意圖並選擇正確的工具。
---
## 透過規則自訂
前往 **設定** → **規則**，使用 Markdown 檔案自訂 Verdent 的行為：
**檔案：** `VERDENT.md`
**範圍：** 套用於所有專案的全域偏好設定
**用途：** 設定你個人的使用偏好，Verdent 會在所有工作區的對話中套用這些設定。這些是全域設定，無論你目前在處理哪個專案，都會在所有工作階段中持續生效。
**常見使用情境：**
- 預設輸出語言（例如「一律以西班牙文回應」）
- 程式碼註解偏好（例如「在產生的程式碼中加入詳細註解」）
- 回應格式（例如「所有 JavaScript 範例都使用 TypeScript」）
- 個人程式碼風格偏好
**如何編輯：**
點擊頂部列中的 **設定**
從下拉式選單中選擇 **規則**
選擇 **使用者規則** 以 Markdown 格式建立或編輯 `VERDENT.md`
**檔案：** `AGENTS.md`
**範圍：** 僅套用於目前工作區的專案專屬規則
**用途：** 定義專門套用於目前專案的程式碼標準、架構模式與開發工作流程。在此工作區中工作時，這些規則會覆寫使用者規則，並協助 Verdent 理解你專案的獨特需求。
**常見使用情境：**
- 專案專屬的程式碼標準（例如「所有檔案名稱使用 kebab-case」）
- 架構模式（例如「資料存取遵循 repository 模式」）
- 技術堆疊需求（例如「使用 React Hooks，而非 class 元件」）
- 團隊慣例（例如「所有 API 回應都必須包含錯誤碼」）
**如何編輯：**
點擊頂部列中的 **設定**
從下拉式選單中選擇 **規則**
選擇 **專案規則** 以在工作區根目錄建立或編輯 `AGENTS.md`
此檔案為專案專屬，通常會提交至版本控制。
**檔案：** `Plan.md`
**範圍：** 控制 Plan Mode 的輸出格式與內容
**用途：** 自訂計畫中顯示哪些資訊、詳盡程度，以及使用 Plan Mode 時所遵循的格式。這些規則會決定 Verdent 在執行複雜任務前所產生計畫的結構與內容。
**常見使用情境：**
- 計畫詳盡程度（例如「為每個步驟加入時間估計」）
- 計畫結構（例如「一律包含『風險』章節」）
- 內容需求（例如「列出所有將被修改的檔案」）
- 輸出格式（例如「對連續步驟使用編號清單」）
**如何編輯：**
點擊頂部列中的 **設定**
從下拉式選單中選擇 **規則**
選擇 **計畫規則** 以 Markdown 格式建立或編輯 `plan_rules.md`
---
## 另請參閱
從你的第一個任務開始使用介面
自訂介面行為與偏好設定