使用者介面概覽
了解 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