# 快速入門指南 (/zh-Hant/docs/verdent-for-vscode/getting-started/quick-start)

> 幾分鐘內開始使用 Verdent



本快速入門指南將讓你在 15 分鐘內開始使用 Verdent 的 Plan-Verify-Code 工作流程。你將安裝擴充套件、完成第一個任務，並在使用 Verdent for VS Code 時理解核心工作流程。

### 你將學到什麼 [#你將學到什麼]

* 從市集安裝 Verdent for VS Code
* 完成驗證並確認設定
* 完成你的第一個 AI 輔助任務
* 理解執行模式（手動接受、自動執行、Plan Mode）
* 使用日常編碼的必備功能

### 先決條件 [#先決條件]

開始之前，請確認你已具備：

* 系統已安裝 Visual Studio Code
* 可用的網路連線
* 有效的 Verdent 訂閱帳號（或從 7 天免費試用開始）

***

## 步驟 1：安裝 Verdent [#步驟-1安裝-verdent]

<Tabs>
  <Tab title="Visual Studio Code 市集">
    造訪 [Verdent 擴充套件頁面](https://marketplace.visualstudio.com/items?itemName=verdentai.verdent) 並點擊 **Install**。
  </Tab>

  <Tab title="擴充套件面板">
    1. 開啟 Visual Studio Code
    2. 按下 `Ctrl+Shift+X`（macOS 上為 `Cmd+Shift+X`）
    3. 搜尋「Verdent」
    4. 點擊 **Install**
  </Tab>

  <Tab title="命令列">
    ```bash
    code --install-extension verdentai.verdent
    ```
  </Tab>
</Tabs>

***

## 步驟 2：開始使用 Verdent [#步驟-2開始使用-verdent]

<Steps>
  <Step title="開啟 Visual Studio Code">
    在你的專案資料夾中開啟 Visual Studio Code。
  </Step>

  <Step title="存取 Verdent">
    點擊側邊欄中的 Verdent 圖示，或按下 `Ctrl+L`（Windows/Linux）/ `Cmd+L`（macOS）。
  </Step>

  <Step title="登入">
    出現提示時登入，以驗證你的 Verdent 帳號。
  </Step>
</Steps>

***

## 步驟 3：你的第一個任務 [#步驟-3你的第一個任務]

讓我們從一個簡單、非破壞性的任務開始，展示 Verdent 對你工作區的理解。

**在 VS Code 中開啟一個專案**，然後在 Verdent 輸入框中嘗試以下其中一個提示詞：

```
What kind of project is this?
```

Verdent 會分析你的工作區結構、讀取關鍵檔案，並說明你正在開發的是哪種類型的應用程式。這展示了上下文感知能力，且不會做出任何變更。

**你應該會看到：**

* Verdent 正在分析你工作區中的檔案
* 一份關於你專案類型、技術與結構的摘要
* 沒有任何檔案修改（唯讀分析）

**試試這些後續提示詞：**

```
Explain what this project does
```

```
What dependencies does this project have?
```

```
Show me the main entry point of this application
```

每個提示詞都能幫助你確認 Verdent 可以存取你的工作區並理解你的程式碼庫。

<Tip>
  這些探索性提示詞非常適合用於理解陌生的程式碼庫。Verdent 會在需要時讀取檔案，無需你手動加入上下文。
</Tip>

***

## 步驟 4：進行你的第一次程式碼變更 [#步驟-4進行你的第一次程式碼變更]

現在讓 Verdent 建立一些東西。試試這個簡單的任務：

```
Create a hello_world.txt file with a greeting message
```

**會發生什麼：**

1. **Verdent 提出變更**你會看到一個預覽，顯示即將建立的檔案及其內容
2. **權限請求** 在自動執行模式（預設）下，Verdent 在建立檔案時會自動核准
3. **你核准** 點擊「Accept」或核准變更
4. **檔案已建立**Verdent 建立檔案並確認完成

**理解權限：**

手動接受模式確保未經你核准不會發生任何不必要的修改。你會在以下情況看到權限提示：

* 檔案編輯與建立
* 命令執行
* 工具使用（每種工具類型的首次使用）

這讓你擁有完整的控制權，並幫助你了解 Verdent 在不同任務中執行哪些操作。

<Note>
  手動接受模式是新使用者建議的起點。熟悉之後，你可以切換到自動執行模式或 Plan Mode 以應對不同的工作流程。
</Note>

***

## 步驟 5：使用 Plan Mode 處理複雜任務 [#步驟-5使用-plan-mode-處理複雜任務]

Plan Mode 是 Verdent 的唯讀規劃模式，你可以在執行前審查方法。讓我們來試試：

**切換到 Plan Mode：**

點擊輸入框中的 **Switch Mode** 按鈕並選擇 **Plan Mode**

**試試一個規劃任務：**

```
Suggest ways to build a website for my project
```

**會發生什麼：**

1. **Verdent 分析你的專案**它會讀取檔案並理解你的專案結構與需求
2. **建立詳細計畫**顯示要使用哪些技術、要建立哪些頁面，以及如何構建網站
3. **不做修改**Plan Mode 是唯讀的。在你明確核准之前，Verdent 無法修改檔案
4. **互動式澄清**Verdent 可能會在最終確定計畫前，詢問有關設計偏好、目標受眾或功能的問題

**為什麼使用 Plan Mode：**

* **安全探索** - 在不意外變更的情況下理解陌生的程式碼庫
* **程式碼審查** - 在進行修改前分析品質與架構
* **策略規劃** - 將複雜任務分解為可審查的步驟
* **減少不確定性** - Verdent 會提出澄清問題以消除模糊之處

<Tip>
  對於任何你想在執行前審查方法的任務，都可使用 Plan Mode。當你想了解 Verdent 如何思考你的程式碼庫時，它尤其有價值。
</Tip>

**執行計畫：**

審查計畫後，Verdent 會提供兩個選項：

* 選擇 **Edit** 來請求修改或提出澄清問題
* 選擇 **Start Building** 切換到 Agent Mode 並開始執行

***

## 步驟 6：理解執行模式 [#步驟-6理解執行模式]

Verdent 提供多種執行模式，以配合不同的工作流程：

**權限模式：**

| 模式            | 說明                              | 何時使用                |
| ------------- | ------------------------------- | ------------------- |
| **手動接受**      | 在每種工具首次使用時請求權限                  | 學習階段，以及需要最大控制權的一般開發 |
| **自動執行**（預設）  | 自動接受安全操作（檔案讀取、網路搜尋）；檔案編輯與命令仍需核准 | 受信任的專案與快速原型開發       |
| **Plan Mode** | 用於分析與規劃的唯讀模式，不修改檔案              | 複雜任務與程式碼審查          |
| **略過權限**      | 完全自主運作，略過所有提示                   | 隔離、安全的環境，如自動化測試或沙箱  |

**額外模式：**

* **Think Hard Mode** - 為複雜推理與架構決策提供最大思考預算

<Warning>
  略過權限模式會移除所有安全檢查。請僅在隔離、可拋棄的環境中使用，在這些環境中錯誤不會造成任何後果。
</Warning>

***

## 必備操作 [#必備操作]

以下是你在 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 伺服器、子代理、規則                    |

***

## 給初學者的專業技巧 [#給初學者的專業技巧]

<Accordion title="從探索性提示詞開始">
  在進行變更之前，讓 Verdent 理解你的程式碼庫：

  ```
  Analyze the database schema
  ```

  ```
  Explain the authentication flow
  ```

  這能建立 Verdent 對你專案的上下文，並幫助它提供更好的建議。
</Accordion>

<Accordion title="請求要具體明確">
  不要說：「修復這個 bug」

  試試：「修復 `LoginForm.tsx` 中的登入 bug，使用者輸入錯誤憑證後會看到空白畫面」

  具體的提示詞能帶來更精準的解決方案與更少的反覆修改。
</Accordion>

<Accordion title="對陌生程式碼使用 Plan Mode">
  在處理你不完全理解的程式碼時，先使用 Plan Mode：

  ```
  Refactor the authentication module to use async/await instead of callbacks
  ```

  審查計畫，選擇 **Edit** 來提出澄清問題並改進，待有信心後再選擇 **Start Building**。
</Accordion>

<Accordion title="將複雜任務分解為多個步驟">
  對於多步驟的功能，採用漸進式的方式進行：

  ```
  1. Create a new database table for user profiles
  ```

  然後在完成後：

  ```
  2. Create an API endpoint to get and update profiles
  ```

  這能保持清晰度，並讓你能驗證每一個步驟。
</Accordion>

<Accordion title="善用 @-mention 提供上下文">
  在需要時明確引用檔案：

  ```
  @components/UserProfile.tsx refactor this component to use hooks
  ```

  這能確保 Verdent 專注於你任務的正確上下文。
</Accordion>

<Accordion title="使用子代理處理特定任務">
  Verdent 內建三個子代理：

  * `@Explorer` - 快速探索程式碼庫與檔案發現
  * `@Verifier` - 快速程式碼驗證與檢查
  * `@Code-reviewer` - 全面的安全性與品質審查

  範例：

  ```
  @Explorer find all API endpoints in this project
  ```
</Accordion>

***

## 常見問題 [#常見問題]

<Tabs>
  <Tab title="側邊欄中看不到擴充套件">
    **解決方案：** 重新啟動 VS Code。如果仍然找不到，請在擴充套件面板（`Cmd+Shift+X` / `Ctrl+Shift+X`）中確認安裝狀態，並確認「Verdent」出現在清單中。
  </Tab>

  <Tab title="提示詞沒有得到回應">
    **解決方案：**

    1. 確認網路連線正常
    2. 檢查防火牆/代理設定是否允許 HTTPS 連線到 Verdent 服務
    3. 確認你在使用者中心中仍有剩餘點數
    4. 嘗試使用更簡單的提示詞以測試連線
  </Tab>

  <Tab title="權限提示過於頻繁">
    **解決方案：** 使用「Switch Permission」按鈕切換到自動執行模式。這會自動核准安全的讀取操作，同時仍會在檔案編輯與命令時請求核准。
  </Tab>
</Tabs>

***

## 取得協助 [#取得協助]

* **Discord 社群**：[https://discord.com/invite/NGjXEZcbJq](https://discord.com/invite/NGjXEZcbJq) - 提供即時支援的活躍社群
* **文件**：瀏覽本文件中的其他指南
* **意見回饋**：使用 Verdent 頂部列的「Feedback」按鈕回報問題或提出改進建議

***

## 常見問答 [#常見問答]

<Accordion title="我如何知道自己目前處於哪個執行模式？">
  查看 Verdent 面板底部的輸入框。「Switch Permission」按鈕會顯示你目前的模式（例如「Manual」、「Auto」、「Plan」）。你可以點擊它來切換模式。
</Accordion>

<Accordion title="如果我的點數用完了會怎樣？">
  當你的餘額歸零時，標準的點數計費請求會停止。請等待下一個帳務週期的重置，或購買一次性加值以繼續使用。
</Accordion>

<Accordion title="我可以同時在多個專案中使用 Verdent 嗎？">
  可以，每個 VS Code 視窗都獨立運作。你可以在多個專案中同時開啟 Verdent，每個都會維護自己獨立的對話上下文。
</Accordion>

<Accordion title="我如何以乾淨的上下文開始新的對話？">
  點擊頂部列的「New Session」按鈕。這會清除目前的對話歷史，並為你的下一個任務提供 Verdent 全新的上下文視窗。
</Accordion>

***

## 後續步驟 [#後續步驟]

你已經安裝了 Verdent、完成了第一個任務，並學會了核心工作流程。以下是接下來可以前往的方向：

<CardGroup cols="2">
  <Card title="核心概念" icon="lightbulb" href="/docs/verdent-for-vscode/getting-started/core-concepts">
    理解子代理、多代理架構與上下文管理
  </Card>

  <Card title="常見工作流程" icon="code" href="/docs/verdent-for-vscode/common-workflows/multi-step-tasks">
    多步驟任務、大型程式碼庫與版本控制的逐步指南
  </Card>
</CardGroup>