用户界面概览
了解 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