---
title: "快速入门指南"
description: "几分钟内开始使用 Verdent"
---

本快速入门指南将帮助你在 15 分钟内用上 Verdent 的"规划-验证-编码"工作流。你将安装扩展、完成第一个任务，并了解使用 Verdent for VS Code 时的核心工作流。

###  你将学到

- 从应用市场安装 Verdent for VS Code
- 完成身份验证并确认配置无误
- 完成第一个 AI 辅助任务
- 了解执行模式（手动接受、自动运行、Plan Mode）
- 使用日常编码的核心功能

### 前置条件

开始之前，请确保你已具备：

- 系统中已安装 Visual Studio Code
- 可用的互联网连接
- 一个有效的 Verdent 订阅账户（或先开始 7 天免费试用）

---

## 第 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

<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 步：你的第一个任务

让我们从一个简单的、非破坏性的任务开始，展示 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 步：进行你的第一次代码改动

现在让 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 处理复杂任务

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 步：了解执行模式

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 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. 检查防火墙/代理设置允许访问 Verdent 服务的 HTTPS
    3. 确认你在用户中心中仍有剩余积分
    4. 尝试一个更简单的提示词来测试连通性
  </Tab>
  <Tab title="权限提示过于频繁">
    **解决方法：** 使用 "Switch Permission" 按钮切换到自动运行模式。这会自动批准安全的读取操作，同时仍会在文件编辑和命令上请求批准。
  </Tab>
</Tabs>

---

## 获取帮助

- **Discord 社区**：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>