Verdent Docs
Getting Started

使用者介面概覽

了解 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


另請參閱