配置与自定义

Verdent for VS Code 提供丰富的配置选项，以适配你的开发工作流、编码偏好和团队规范。你可以通过 VS Code 原生设置界面配置选项、自定义键盘快捷键，并创建规则和子智能体以实现专门化的行为。

你将学到

• 为 Verdent 配置 VS Code 扩展设置
• 自定义键盘快捷键以提升工作流效率
• 创建并管理规则以个性化智能体行为
• 构建自定义子智能体处理专门任务

前置条件

• 已安装并通过认证的 Verdent for VS Code
• VS Code 设置访问权限（Cmd+, 或 Ctrl+,）
• 对规则文件 JSON 的基本理解（可选）

VS Code 扩展设置

Verdent for VS Code 的设置可通过多个位置访问，具体取决于配置类型和作用范围。

访问设置

扩展设置（VS Code 原生）：

1. 打开 VS Code 设置：Cmd+,（macOS）或 Ctrl+,（Windows/Linux）
2. 在设置搜索栏中搜索 "Verdent"
3. 修改扩展设置（例如 verdent.enableCheckpoints）

Verdent 专属设置：

点击 Verdent 顶部栏中的 Settings 按钮以访问：

• Rules - 用户规则、项目规则、计划规则
• MCP Servers - Model Context Protocol 配置
• Subagents - 自定义子智能体管理

对话内控制：

许多设置可以直接从 Verdent 面板底部的输入框切换：

• Switch Permission - 手动接受、自动运行、计划、跳过权限
• Switch Mode - Agent、Plan、Chat 模式
• Switch/Customize AI Model - 性能、平衡、效率预设
• Think Hard Mode - 为复杂推理提供最大思考预算
• Add Context - 使用 @ 提及附加文件
• Add Images or Files - 包含截图或文档
• Add Subagent - 委派给专门的子智能体

设置更改会立即生效，无需重启 VS Code。

可用的扩展设置

Verdent for VS Code 提供 2 项核心扩展设置，可通过 VS Code 的设置界面进行配置：

输入框控件参考

Verdent 面板底部的输入框提供对配置控件的快速访问：

权限模式

模型预设

键盘快捷键自定义

默认快捷键

主要快捷键：

• macOS： Cmd+L - 打开/聚焦 Verdent 面板
• Windows/Linux： Ctrl+L - 打开/聚焦 Verdent 面板
  • 命令：verdent.addToChat
  • 可从命令面板和编辑器上下文使用

这是从 VS Code 任何位置快速访问 Verdent 而不打断编码流程的关键快捷键。

其他命令：

可通过命令面板使用（默认快捷键可自定义）：

• verdent.addFeedBack - 提供反馈
• verdent.addTerminalOutputToChat - 将终端输出添加到 Verdent
• verdent.addToChatBySearch - 通过搜索添加到 Verdent
• verdent.centerButtonClicked - 用户中心
• verdent.historyButtonClicked - 项目历史
• verdent.mcpButtonClicked - 添加 MCP 服务器
• verdent.openInNewTabByParams - 在新标签页中打开
• verdent.plusButtonClicked - 新会话
• verdent.rulesButtonClicked - 规则设置
• verdent.SettingClicked - 设置菜单
• verdent.subagentButtonClicked - 添加子智能体

自定义快捷键

所有 Verdent 键盘快捷键都可以使用 VS Code 的标准键绑定系统进行自定义。

{
  "key": "cmd+shift+v",
  "command": "verdent.addToChat"
}

{
  "key": "ctrl+shift+v",
  "command": "verdent.addToChat"
}

自定义范围：

• 所有 Verdent 命令都可以重新映射
• 可以为同一命令分配多个快捷键
• 可以移除默认快捷键
• 更改通过 VS Code 设置同步在各设备间同步

平台专属快捷键

Verdent 遵循 VS Code 的平台专属键盘约定：

常见模式：

• 设置：Cmd+,（macOS）对比 Ctrl+,（Windows/Linux）
• 命令面板：Cmd+Shift+P（macOS）对比 Ctrl+Shift+P（Windows/Linux）
• 键盘快捷键：Cmd+K Cmd+S（macOS）对比 Ctrl+K Ctrl+S（Windows/Linux）

自定义指令与人格

Verdent for VS Code 支持两种自定义 AI 行为的系统：用于偏好和指导原则的规则，以及用于专门任务人格的子智能体。

规则系统

规则定义 Verdent 在编码会话期间的行为和响应方式。规则存储在 Markdown 文件中，并在整个对话过程中持续应用。

三种类型的规则

1. 用户规则（VERDENT.md）：

• 位置： ~/.verdent/（全局配置目录）
• 范围： 应用于所有项目的所有对话
• 用途： 个人编码偏好、沟通风格、文档规范

2. 项目规则（AGENTS.md）：

• 位置： 项目根目录或工作区
• 范围： 仅应用于当前项目
• 版本控制： 可提交到 git 以实现团队级规范
• 用途： 项目专属编码规范、架构模式、测试要求

3. 计划规则（plan_rules.md）：

• 位置： ~/.verdent/（全局配置目录）
• 范围： 在所有项目中使用 Plan Mode 时应用
• 用途： 自定义计划内容、格式和详细程度

创建和编辑规则

用户规则示例：

# Code Style Preferences
- Always use functional React components with hooks
- Prefer TypeScript over JavaScript
- Add JSDoc comments for all exported functions
- Provide explanations before showing code

项目规则示例：

## Testing instructions
- Run `pnpm turbo run test --filter <project_name>` to run all checks
- Fix test and type errors until suite is green
- Add or update tests for code changes

## PR instructions
- Title format: [<project_name>] <Title>
- Always run `pnpm lint` and `pnpm test` before committing

规则存储与应用

配置优先级：

当规则冲突时，Verdent 应用以下优先级顺序：

1. 项目规则（AGENTS.md） - 最高优先级（项目专属）
2. 用户规则（VERDENT.md） - 全局用户偏好
3. 默认行为 - Verdent 的内置默认值

子智能体

子智能体是具有自定义系统提示词和独立上下文窗口的专门 AI 智能体，用于处理特定任务。

内置子智能体

Verdent 包含三个默认子智能体，无需配置即可立即使用：

创建自定义子智能体

子智能体文件格式：

---
name: security-reviewer
description: Security-focused code review specialist
---
# System Prompt

You are a security-focused code reviewer. When analyzing code:
- Prioritize security vulnerabilities (SQL injection, XSS, auth flaws)
- Use skeptical, critical tone - assume code is vulnerable until proven otherwise
- Provide specific remediation steps with code examples
- Reference OWASP Top 10 and security best practices
- Never approve code with unresolved security issues

Invocation policy (strict): Only run security-reviewer if user explicitly requests it.

When to use the security-reviewer agent:
- User requests security review of authentication/authorization logic
- User asks to audit code for vulnerabilities
- User needs security assessment before deployment

When NOT to use:
- General code review without security focus
- Opening or reading files without analysis

管理子智能体

通过 Settings → Subagents 访问以：

• 编辑： 修改系统提示词、工具权限、配置
• 复制： 复制子智能体以创建变体或模板
• 删除： 移除未使用的子智能体
• 启用/禁用： 在不删除的情况下切换可用性

使用子智能体

内置子智能体：

• 用 @ 提及引用：@Verifier、@Explorer、@Code-reviewer
• 在检测到合适的任务类型时自动调用

自定义子智能体：

• 点击输入框中的 Add Subagent 按钮
• 从下拉菜单中选择
• 主智能体自动委派合适的任务

子智能体 vs 规则

示例工作流：

1. 用户规则： "为所有新函数生成单元测试"
2. 主智能体： 检测到生成测试的需求
3. 委派给测试生成器子智能体： 专门的全面测试方法
4. 子智能体： 以独立上下文生成完整测试套件
5. 主智能体： 接收结果并继续，不污染上下文

常见问题（FAQ）

参见