---
title: "用户界面概览"
description: "了解 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 侧边栏中打开，并可根据需要调整大小、移动或停靠。

<Tip>
  拖动 Verdent 面板的边缘即可调整大小，以查看更多对话历史或为编辑器留出更多空间。
</Tip>

---

## 界面组件

<Tabs>
  <Tab title="顶部栏">
    快速访问关键功能：

    | 按钮          | 功能                                                   |
    | --------------- | ---------------------------------------------------------- |
    | 新建会话     | 以干净的上下文开启全新对话              |
    | 项目历史 | 浏览并恢复以往会话                       |
    | 用户中心     | 查看账户信息和积分余额                |
    | 反馈        | 提交反馈并报告问题                          |
    | 设置        | 配置 MCP 服务器、子智能体、规则和模型预设 |
  </Tab>
  <Tab title="对话视图">
    主对话区显示：

    - **AI 回复** - 带语法高亮代码块的格式化文本
    - **代码差异** - 文件变更前后的交互式对比
    - **计划** - 使用 Plan Mode 时的结构化任务分解
    - **验证结果** - 测试执行输出和调试信息
    - **文件操作** - 文件创建、编辑或删除的确认
    - **子智能体输出** - 委派任务的执行结果

    对话视图保留完整的对话历史，让你可以向上滚动回顾以往的交互。
  </Tab>
  <Tab title="输入框">
    底部的输入区域，配有用于撰写请求的控件：

    **文本输入区：** 用于键入自然语言提示词的主文本字段

    **操作按钮：**

    | 按钮                    | 功能                                                                 |
    | ------------------------- | ------------------------------------------------------------------------ |
    | 添加上下文               | 通过 @ 提及引用文件或调用子智能体                      |
    | 添加图片或文件       | 加入截图、图表或文档以供分析                 |
    | 添加子智能体              | 将任务委派给专门的子智能体                                  |
    | 切换模式               | 在 Agent、Plan 和 Chat 模式之间切换                               |
    | 切换/自定义 AI 模型 | 选择 Performance、Balance、Efficiency 预设或特定模型       |
    | Think Hard 模式           | 为复杂推理启用最大思考预算                     |
    | 切换权限               | 更改权限模式（手动接受、自动运行、计划、跳过权限） |
    | 发送                      | 将你的提示词提交给 AI 模型                                       |
  </Tab>
</Tabs>

---

## 状态指示

Verdent 通过可视化指示传达系统状态：

<Tabs>
  <Tab title="对话视图状态">
    对话视图通过视觉提示而非明确标签来传达状态：

    - **处理中指示** - 当 Verdent 正在工作时会出现一个可视化指示。它会在 AI 读取文件、分析代码或准备回复时显示。
    - **正在生成文本** - 当 AI 撰写说明、代码建议或计划时，你会看到 Verdent 的回复实时出现。流式文本表明模型正在主动生成输出。
    - **没有任何动作** - 当对话视图静止无活动时，Verdent 正在等待。这意味着你需要批准文件变更、回答澄清性问题，或提供下一个请求。
  </Tab>
  <Tab title="文本光标">
    输入框中的文本光标表明 Verdent 是否准备好接受新请求：

    - **闪烁光标** - 输入框处于活动状态并可接受文本输入。你可以键入请求并点击发送。当 Verdent 完成处理并等待你的下一个提示词时会出现此状态。
    - **无光标/已禁用** - 当 Verdent 正在处理请求时输入框被禁用。这可防止当前任务被打断，并确保每个请求完成后才开始下一个。

    **工作流模式：** 当你提交请求时，光标消失（输入被禁用）。一旦 Verdent 完成任务，光标重新出现，表示你可以键入下一个请求。
  </Tab>
  <Tab title="模式指示">
    输入框显示指示，展示你当前的配置：

    - **切换权限按钮** - 在按钮本身上以标签形式显示你当前的权限模式。你会看到 "Manual"、"Auto"、"Plan" 或 "Skip"。这让你在提交请求前确认当前激活的执行模式。点击按钮可在可用模式之间循环切换。
    - **切换/自定义 AI 模型按钮** - 显示当前选定的模型或预设。你会看到预设的 "Performance"、"Balance" 或 "Efficiency"，或者如果你选择了单个模型，则显示具体的模型名称如 "Claude 4.5 Sonnet"。这可确认哪个 AI 模型将处理你的下一个请求。

    这些指示一目了然地确认你当前的设置，帮助你在发送提示词前确保配置正确。
  </Tab>
</Tabs>

<Note>
  状态指示实时更新，准确显示 Verdent 正在做什么，帮助你了解智能体的活动。
</Note>

---

## 导航模式

<Tabs>
  <Tab title="顶部栏导航">
    顶部栏根据功能使用不同的导航模式：

    **按钮：**

    - **新建会话** - 点击此按钮会立即清除你当前的对话，并以干净的上下文返回全新的对话视图。没有单独的页面或弹窗；它在同一视图中即时发生。

    **页面：**

    - **项目历史** - 打开专门的全页视图，你可以在其中浏览所有以往的会话和对话。这会从对话视图跳转，以显示你的会话历史。点击 **X** 按钮返回对话视图。

    **弹窗（覆盖对话框）：**

    - **用户中心** - 打开一个覆盖弹窗，显示你的账户信息、积分余额和使用详情。对话视图仍在弹窗后方可见。
    - **反馈** - 打开一个覆盖弹窗，包含用于提交反馈和报告问题的表单。对话视图保留在后台。

    要关闭弹窗，可以点击弹窗区域外部，或使用弹窗角落的 **X** 按钮。

    **下拉菜单：**

    - **设置** - 打开一个内嵌下拉菜单，提供 MCP 服务器、子智能体、规则和模型预设的选项。当你从菜单中选择一项（如 "MCP 服务器"）时，它会为该配置打开一个专门的全页视图。点击 **X** 按钮返回对话视图。
  </Tab>
  <Tab title="输入框导航">
    所有输入框按钮都打开下拉菜单，便于快速、内嵌地配置：

    **下拉菜单模式：** 输入框中的每个按钮（添加上下文、添加图片或文件、添加子智能体、切换模式、切换/自定义 AI 模型、Think Hard 模式、切换权限）都会在按钮正下方打开一个下拉菜单。这些菜单让你无需离开对话视图即可配置请求。

    **为何使用下拉菜单：** 这种设计让你在所有常见操作中都锚定在对话视图。你可以调整设置、选择模型、更改模式和添加上下文，而不会丢失对话视野或打断工作流。

    **关闭下拉菜单：** 当你做出选择或点击菜单外部任意位置时，下拉菜单会自动关闭。这让你可以快速配置设置并返回撰写请求。
  </Tab>
  <Tab title="返回对话视图">
    不同的导航元素使用不同的方法返回主对话视图：

    **从页面返回（项目历史、设置）：**

    - 点击页面顶部角落的 **X** 按钮
    - 这会将你带回离开时的对话视图

    **从弹窗返回（用户中心、反馈）：**

    - 点击弹窗角落的 **X** 按钮，或
    - 点击弹窗覆盖层外部任意位置
    - 对话视图始终在弹窗后方可见，因此关闭弹窗会立即恢复焦点

    **从下拉菜单返回：**

    - 当你做出选择时菜单会自动关闭
    - 点击菜单外部任意位置可不做选择即关闭
    - 你从未离开对话视图，所以无需"返回"

    **导航理念：** 大多数交互都通过下拉菜单进行，让你保持在对话视图中。**项目历史**和**设置选项**会跳转到独立页面，而**用户中心**和**反馈**使用不会隐藏对话的覆盖弹窗。
  </Tab>
</Tabs>

<Tip>
  使用 @ 提及和斜杠命令来引导导航。这有助于 Verdent 理解你的意图并选择正确的工具。
</Tip>

---

## 使用规则进行自定义

进入**设置** → **规则**，使用 Markdown 文件自定义 Verdent 的行为：

<Tabs>
  <Tab title="用户规则">
    **文件：** `VERDENT.md`

    **作用范围：** 适用于所有项目的全局偏好

    **用途：** 设置你的个人使用偏好，Verdent 会在所有工作区的对话中应用这些偏好。这些是全局设置，无论你在哪个项目中工作都会在所有会话中持续生效。

    **常见用例：**

    - 默认输出语言（如 "始终用西班牙语回复"）
    - 代码注释偏好（如 "在生成的代码中包含详细注释"）
    - 回复格式（如 "所有 JavaScript 示例使用 TypeScript"）
    - 个人代码风格偏好

    **如何编辑：**

    <Steps>
      <Step title="打开设置">
        点击顶部栏中的**设置**
      </Step>
      <Step title="选择规则">
        从下拉菜单中选择**规则**
      </Step>
      <Step title="编辑用户规则">
        选择**用户规则**以 Markdown 格式创建或编辑 `VERDENT.md`
      </Step>
    </Steps>
  </Tab>
  <Tab title="项目规则">
    **文件：** `AGENTS.md`

    **作用范围：** 仅适用于当前工作区的项目专属规则

    **用途：** 定义专门适用于当前项目的代码标准、架构模式和开发工作流。这些规则在此工作区中工作时会覆盖用户规则，并帮助 Verdent 理解项目的独特需求。

    **常见用例：**

    - 项目专属代码标准（如 "所有文件名使用 kebab-case"）
    - 架构模式（如 "数据访问遵循 repository 模式"）
    - 技术栈要求（如 "使用 React Hooks，而非类组件"）
    - 团队约定（如 "所有 API 响应必须包含错误码"）

    **如何编辑：**

    <Steps>
      <Step title="打开设置">
        点击顶部栏中的**设置**
      </Step>
      <Step title="选择规则">
        从下拉菜单中选择**规则**
      </Step>
      <Step title="编辑项目规则">
        选择**项目规则**以在工作区根目录创建或编辑 `AGENTS.md`
      </Step>
    </Steps>
    此文件是项目专属的，通常会提交到版本控制。
  </Tab>
  <Tab title="计划规则">
    **文件：** `Plan.md`

    **作用范围：** 控制 Plan Mode 的输出格式和内容

    **用途：** 自定义使用 Plan Mode 时计划中显示的信息、详细程度以及遵循的格式。这些规则决定了 Verdent 在执行复杂任务前生成的计划的结构和内容。

    **常见用例：**

    - 计划详细程度（如 "为每个步骤包含时间估算"）
    - 计划结构（如 "始终包含'风险'部分"）
    - 内容要求（如 "列出所有将被修改的文件"）
    - 输出格式（如 "对顺序步骤使用编号列表"）

    **如何编辑：**

    <Steps>
      <Step title="打开设置">
        点击顶部栏中的**设置**
      </Step>
      <Step title="选择规则">
        从下拉菜单中选择**规则**
      </Step>
      <Step title="编辑计划规则">
        选择**计划规则**以 Markdown 格式创建或编辑 `plan_rules.md`
      </Step>
    </Steps>
  </Tab>
</Tabs>

---

## 另请参阅

<CardGroup cols={2}>
  <Card title="快速开始" icon="rocket" href="/docs/verdent-for-vscode/getting-started/quick-start">
    通过你的第一个任务开始使用界面
  </Card>
  <Card title="配置设置" icon="gear" href="/docs/verdent-for-vscode/configuration/settings">
    自定义界面行为和偏好
  </Card>
</CardGroup>
