Verdent Docs
入门

用户界面概览

了解 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 模式为复杂推理启用最大思考预算
切换权限更改权限模式(手动接受、自动运行、计划、跳过权限)
发送将你的提示词提交给 AI 模型

状态指示

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

对话视图通过视觉提示而非明确标签来传达状态:

  • 处理中指示 - 当 Verdent 正在工作时会出现一个可视化指示。它会在 AI 读取文件、分析代码或准备回复时显示。
  • 正在生成文本 - 当 AI 撰写说明、代码建议或计划时,你会看到 Verdent 的回复实时出现。流式文本表明模型正在主动生成输出。
  • 没有任何动作 - 当对话视图静止无活动时,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,而非类组件")
  • 团队约定(如 "所有 API 响应必须包含错误码")

如何编辑:

打开设置

点击顶部栏中的设置

选择规则

从下拉菜单中选择规则

编辑项目规则

选择项目规则以在工作区根目录创建或编辑 AGENTS.md

此文件是项目专属的,通常会提交到版本控制。

文件: Plan.md

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

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

常见用例:

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

如何编辑:

打开设置

点击顶部栏中的设置

选择规则

从下拉菜单中选择规则

编辑计划规则

选择计划规则以 Markdown 格式创建或编辑 plan_rules.md


另请参阅