快速入門指南
幾分鐘內開始使用 Verdent
本快速入門指南將讓你在 15 分鐘內開始使用 Verdent 的 Plan-Verify-Code 工作流程。你將安裝擴充套件、完成第一個任務，並在使用 Verdent for VS Code 時理解核心工作流程。
你將學到什麼
- 從市集安裝 Verdent for VS Code
- 完成驗證並確認設定
- 完成你的第一個 AI 輔助任務
- 理解執行模式（手動接受、自動執行、Plan Mode）
- 使用日常編碼的必備功能
先決條件
開始之前，請確認你已具備：
- 系統已安裝 Visual Studio Code
- 可用的網路連線
- 有效的 Verdent 訂閱帳號（或從 7 天免費試用開始）
步驟 1：安裝 Verdent
造訪 Verdent 擴充套件頁面 並點擊 Install。
- 開啟 Visual Studio Code
- 按下
Ctrl+Shift+X（macOS 上為Cmd+Shift+X） - 搜尋「Verdent」
- 點擊 Install
code --install-extension verdentai.verdent步驟 2：開始使用 Verdent
開啟 Visual Studio Code
在你的專案資料夾中開啟 Visual Studio Code。
存取 Verdent
點擊側邊欄中的 Verdent 圖示，或按下 Ctrl+L（Windows/Linux）/ Cmd+L（macOS）。
登入
出現提示時登入，以驗證你的 Verdent 帳號。
步驟 3：你的第一個任務
讓我們從一個簡單、非破壞性的任務開始，展示 Verdent 對你工作區的理解。
在 VS Code 中開啟一個專案，然後在 Verdent 輸入框中嘗試以下其中一個提示詞：
What kind of project is this?Verdent 會分析你的工作區結構、讀取關鍵檔案，並說明你正在開發的是哪種類型的應用程式。這展示了上下文感知能力，且不會做出任何變更。
你應該會看到：
- Verdent 正在分析你工作區中的檔案
- 一份關於你專案類型、技術與結構的摘要
- 沒有任何檔案修改（唯讀分析）
試試這些後續提示詞：
Explain what this project doesWhat dependencies does this project have?Show me the main entry point of this application每個提示詞都能幫助你確認 Verdent 可以存取你的工作區並理解你的程式碼庫。
這些探索性提示詞非常適合用於理解陌生的程式碼庫。Verdent 會在需要時讀取檔案，無需你手動加入上下文。
步驟 4：進行你的第一次程式碼變更
現在讓 Verdent 建立一些東西。試試這個簡單的任務：
Create a hello_world.txt file with a greeting message會發生什麼：
- Verdent 提出變更你會看到一個預覽，顯示即將建立的檔案及其內容
- 權限請求 在自動執行模式（預設）下，Verdent 在建立檔案時會自動核准
- 你核准 點擊「Accept」或核准變更
- 檔案已建立Verdent 建立檔案並確認完成
理解權限：
手動接受模式確保未經你核准不會發生任何不必要的修改。你會在以下情況看到權限提示：
- 檔案編輯與建立
- 命令執行
- 工具使用（每種工具類型的首次使用）
這讓你擁有完整的控制權，並幫助你了解 Verdent 在不同任務中執行哪些操作。
手動接受模式是新使用者建議的起點。熟悉之後，你可以切換到自動執行模式或 Plan Mode 以應對不同的工作流程。
步驟 5：使用 Plan Mode 處理複雜任務
Plan Mode 是 Verdent 的唯讀規劃模式，你可以在執行前審查方法。讓我們來試試：
切換到 Plan Mode：
點擊輸入框中的 Switch Mode 按鈕並選擇 Plan Mode
試試一個規劃任務：
Suggest ways to build a website for my project會發生什麼：
- Verdent 分析你的專案它會讀取檔案並理解你的專案結構與需求
- 建立詳細計畫顯示要使用哪些技術、要建立哪些頁面，以及如何構建網站
- 不做修改Plan Mode 是唯讀的。在你明確核准之前，Verdent 無法修改檔案
- 互動式澄清Verdent 可能會在最終確定計畫前，詢問有關設計偏好、目標受眾或功能的問題
為什麼使用 Plan Mode：
- 安全探索 - 在不意外變更的情況下理解陌生的程式碼庫
- 程式碼審查 - 在進行修改前分析品質與架構
- 策略規劃 - 將複雜任務分解為可審查的步驟
- 減少不確定性 - Verdent 會提出澄清問題以消除模糊之處
對於任何你想在執行前審查方法的任務，都可使用 Plan Mode。當你想了解 Verdent 如何思考你的程式碼庫時，它尤其有價值。
執行計畫：
審查計畫後，Verdent 會提供兩個選項：
- 選擇 Edit 來請求修改或提出澄清問題
- 選擇 Start Building 切換到 Agent Mode 並開始執行
步驟 6：理解執行模式
Verdent 提供多種執行模式，以配合不同的工作流程：
權限模式：
| 模式 | 說明 | 何時使用 |
|---|---|---|
| 手動接受 | 在每種工具首次使用時請求權限 | 學習階段，以及需要最大控制權的一般開發 |
| 自動執行（預設） | 自動接受安全操作（檔案讀取、網路搜尋）；檔案編輯與命令仍需核准 | 受信任的專案與快速原型開發 |
| Plan Mode | 用於分析與規劃的唯讀模式，不修改檔案 | 複雜任務與程式碼審查 |
| 略過權限 | 完全自主運作，略過所有提示 | 隔離、安全的環境，如自動化測試或沙箱 |
額外模式：
- Think Hard Mode - 為複雜推理與架構決策提供最大思考預算
略過權限模式會移除所有安全檢查。請僅在隔離、可拋棄的環境中使用，在這些環境中錯誤不會造成任何後果。
必備操作
以下是你在 Verdent for VS Code 中每天會用到的關鍵操作：
| 操作 | 如何存取 | 說明 |
|---|---|---|
| 開啟 Verdent | Cmd+L / Ctrl+L 或點擊側邊欄圖示 | 開啟 Verdent 面板 |
| 新工作階段 | 點擊頂部列的「New Session」 | 以乾淨的上下文開始全新的對話 |
| 加入上下文 | 點擊「Add Context」按鈕 | 透過 @-mention 引用檔案 |
| 加入圖片 | 點擊「Add Images or Files」按鈕 | 上傳截圖、設計稿或圖表 |
| 切換模式 | 點擊「Switch Mode」按鈕 | 切換 Agent/Plan/Chat 模式 |
| 變更模型 | 點擊模型選擇器 | 選擇 Performance/Balance/Efficiency 預設 |
| Think Hard | 點擊「Think Hard Mode」按鈕 | 為複雜任務啟用延伸推理 |
| 切換權限 | 點擊「Switch Permission」按鈕 | 變更權限模式 |
| 檢視歷史 | 點擊頂部列的「Project History」 | 瀏覽過去的工作階段 |
| 使用者中心 | 點擊頂部列的「User Center」 | 查看點數餘額與帳戶資訊 |
| 設定 | 點擊頂部列的「Settings」 | 設定 MCP 伺服器、子代理、規則 |
給初學者的專業技巧
從探索性提示詞開始
在進行變更之前，讓 Verdent 理解你的程式碼庫：
Analyze the database schemaExplain the authentication flow這能建立 Verdent 對你專案的上下文，並幫助它提供更好的建議。
請求要具體明確
不要說：「修復這個 bug」
試試：「修復 LoginForm.tsx 中的登入 bug，使用者輸入錯誤憑證後會看到空白畫面」
具體的提示詞能帶來更精準的解決方案與更少的反覆修改。
對陌生程式碼使用 Plan Mode
在處理你不完全理解的程式碼時，先使用 Plan Mode：
Refactor the authentication module to use async/await instead of callbacks審查計畫，選擇 Edit 來提出澄清問題並改進，待有信心後再選擇 Start Building。
將複雜任務分解為多個步驟
對於多步驟的功能，採用漸進式的方式進行：
1. Create a new database table for user profiles然後在完成後：
2. Create an API endpoint to get and update profiles這能保持清晰度，並讓你能驗證每一個步驟。
善用 @-mention 提供上下文
在需要時明確引用檔案：
@components/UserProfile.tsx refactor this component to use hooks這能確保 Verdent 專注於你任務的正確上下文。
使用子代理處理特定任務
Verdent 內建三個子代理：
@Explorer- 快速探索程式碼庫與檔案發現@Verifier- 快速程式碼驗證與檢查@Code-reviewer- 全面的安全性與品質審查
範例：
@Explorer find all API endpoints in this project常見問題
解決方案： 重新啟動 VS Code。如果仍然找不到，請在擴充套件面板（Cmd+Shift+X / Ctrl+Shift+X）中確認安裝狀態，並確認「Verdent」出現在清單中。
解決方案：
- 確認網路連線正常
- 檢查防火牆/代理設定是否允許 HTTPS 連線到 Verdent 服務
- 確認你在使用者中心中仍有剩餘點數
- 嘗試使用更簡單的提示詞以測試連線
解決方案： 使用「Switch Permission」按鈕切換到自動執行模式。這會自動核准安全的讀取操作，同時仍會在檔案編輯與命令時請求核准。
取得協助
- Discord 社群：https://discord.com/invite/NGjXEZcbJq - 提供即時支援的活躍社群
- 文件：瀏覽本文件中的其他指南
- 意見回饋：使用 Verdent 頂部列的「Feedback」按鈕回報問題或提出改進建議
常見問答
我如何知道自己目前處於哪個執行模式？
查看 Verdent 面板底部的輸入框。「Switch Permission」按鈕會顯示你目前的模式（例如「Manual」、「Auto」、「Plan」）。你可以點擊它來切換模式。
如果我的點數用完了會怎樣？
當你的餘額歸零時，標準的點數計費請求會停止。請等待下一個帳務週期的重置，或購買一次性加值以繼續使用。
我可以同時在多個專案中使用 Verdent 嗎？
可以，每個 VS Code 視窗都獨立運作。你可以在多個專案中同時開啟 Verdent，每個都會維護自己獨立的對話上下文。
我如何以乾淨的上下文開始新的對話？
點擊頂部列的「New Session」按鈕。這會清除目前的對話歷史，並為你的下一個任務提供 Verdent 全新的上下文視窗。
後續步驟
你已經安裝了 Verdent、完成了第一個任務，並學會了核心工作流程。以下是接下來可以前往的方向：