快速入门指南
几分钟内开始使用 Verdent
本快速入门指南将帮助你在 15 分钟内用上 Verdent 的"规划-验证-编码"工作流。你将安装扩展、完成第一个任务，并了解使用 Verdent for VS Code 时的核心工作流。
你将学到
- 从应用市场安装 Verdent for VS Code
- 完成身份验证并确认配置无误
- 完成第一个 AI 辅助任务
- 了解执行模式（手动接受、自动运行、Plan Mode）
- 使用日常编码的核心功能
前置条件
开始之前，请确保你已具备：
- 系统中已安装 Visual Studio Code
- 可用的互联网连接
- 一个有效的 Verdent 订阅账户（或先开始 7 天免费试用）
第 1 步：安装 Verdent
访问 Verdent 扩展页面 并点击 Install。
- 打开 Visual Studio Code
- 按下
Ctrl+Shift+X（macOS 上按Cmd+Shift+X） - 搜索 "Verdent"
- 点击 Install
code --install-extension verdentai.verdent第 2 步：开始使用 Verdent
打开 Visual Studio Code
在你的项目文件夹中打开 Visual Studio Code。
访问 Verdent
点击侧边栏中的 Verdent 图标，或按下 Ctrl+L（Windows/Linux）/ Cmd+L（macOS）。
登录
在提示时登录，完成 Verdent 账户的身份验证。
第 3 步：你的第一个任务
让我们从一个简单的、非破坏性的任务开始，展示 Verdent 对你工作区的理解能力。
在 VS Code 中打开一个项目，然后在 Verdent 输入框中尝试以下提示词之一：
What kind of project is this?Verdent 会分析你的工作区结构、读取关键文件，并说明你正在开发的是哪种类型的应用。这展示了它的上下文感知能力，而不会做出任何改动。
你应该会看到：
- Verdent 正在分析你工作区中的文件
- 关于你的项目类型、所用技术和结构的摘要
- 没有任何文件修改（只读分析）
尝试以下后续提示词：
Explain what this project doesWhat dependencies does this project have?Show me the main entry point of this application每个提示词都能帮助你确认 Verdent 可以访问你的工作区并理解你的代码库。
这些探索性的提示词非常适合理解陌生的代码库。Verdent 会按需读取文件，无需你手动添加上下文。
第 4 步：进行你的第一次代码改动
现在让 Verdent 创建一些内容。尝试这个简单的任务：
Create a hello_world.txt file with a greeting message会发生什么：
- Verdent 提出改动你会看到一个预览，显示将要创建的文件及其内容
- 权限请求 在自动运行模式（默认）下，Verdent 会在创建文件时自动批准
- 你批准点击 "Accept" 或批准该改动
- 文件已创建Verdent 创建文件并确认完成
理解权限：
手动接受模式可确保未经你批准不会发生任何不希望的修改。你会在以下情况看到权限提示：
- 文件编辑和创建
- 命令执行
- 工具使用（每种工具类型首次使用时）
这让你拥有完全控制权，并帮助你了解 Verdent 在不同任务中执行了哪些操作。
手动接受模式是推荐给新用户的起点。熟悉之后，你可以切换到自动运行模式或 Plan Mode 以适应不同的工作流。
第 5 步：使用 Plan Mode 处理复杂任务
Plan Mode 是 Verdent 的只读规划模式，你可以在执行前审查方案。让我们来试试：
切换到 Plan Mode：
点击输入框中的 Switch Mode 按钮，并选择 Plan Mode
尝试一个规划任务：
Suggest ways to build a website for my project会发生什么：
- Verdent 分析你的项目它会读取文件，理解你的项目结构和需求
- 创建详细的计划展示要使用哪些技术、要创建哪些页面，以及如何组织网站结构
- 不做任何修改Plan Mode 是只读的。在你明确批准之前，Verdent 无法修改文件
- 交互式澄清在最终确定计划之前，Verdent 可能会询问有关设计偏好、目标受众或功能的问题
为什么使用 Plan Mode：
- 安全探索 - 在不意外改动的情况下理解陌生的代码库
- 代码审查 - 在进行修改之前分析质量和架构
- 战略规划 - 将复杂任务拆解为可审查的步骤
- 减少不确定性 - Verdent 会提出澄清问题以消除歧义
对于任何你想在执行前审查方案的任务，都可以使用 Plan Mode。在学习 Verdent 如何理解你的代码库时，它尤其有价值。
执行计划：
审查完计划后，Verdent 会提供两个选项：
- 选择 Edit 来请求修改或提出澄清问题
- 选择 Start Building 切换到 Agent Mode 并开始执行
第 6 步：了解执行模式
Verdent 提供多种执行模式以匹配不同的工作流：
权限模式：
| 模式 | 说明 | 适用场景 |
|---|---|---|
| 手动接受 | 每种工具首次使用时请求权限 | 以最大控制度进行学习和常规开发 |
| 自动运行（默认） | 自动接受安全操作（文件读取、网页搜索）；文件编辑和命令仍需批准 | 受信任的项目和快速原型开发 |
| Plan Mode | 用于分析和规划的只读模式，不修改文件 | 复杂任务和代码审查 |
| 跳过权限 | 完全自主运行，绕过所有提示 | 隔离、安全的环境，如自动化测试或沙盒 |
额外模式：
- Think Hard Mode - 为复杂推理和架构决策提供最大的思考预算
跳过权限模式会移除所有安全检查。仅在隔离、可丢弃的环境中使用，其中的错误不会造成任何后果。
核心操作
以下是你在 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 服务器、子智能体、规则 |
给初学者的专业提示
从探索性提示词开始
在进行改动之前，先让 Verdent 理解你的代码库：
Analyze the database schemaExplain the authentication flow这能建立 Verdent 对你项目的上下文理解，并帮助它给出更好的建议。
让你的请求更具体
与其说："修复这个 bug"
不如试试："修复 LoginForm.tsx 中的登录 bug，用户输入错误凭据后会看到空白屏幕"
具体的提示词能带来更准确的解决方案和更少的迭代。
对陌生代码使用 Plan Mode
在处理你尚未完全理解的代码时，先使用 Plan Mode：
Refactor the authentication module to use async/await instead of callbacks审查计划，选择 Edit 提出澄清问题并完善方案，确信无误后再选择 Start Building。
把复杂任务拆解为多个步骤
对于多步骤功能，逐步推进：
1. Create a new database table for user profiles完成后再继续：
2. Create an API endpoint to get and update profiles这能保持清晰度，并让你能够验证每一步。
善用 @-mention 提供上下文
在需要时明确引用文件：
@components/UserProfile.tsx refactor this component to use hooks这能确保 Verdent 聚焦于你任务所需的正确上下文。
对专门任务使用子智能体
Verdent 内置了三个子智能体：
@Explorer- 快速探索代码库并发现文件@Verifier- 快速代码验证和检查@Code-reviewer- 全面的安全和质量审查
示例：
@Explorer find all API endpoints in this project常见问题
解决方法： 重启 VS Code。如果仍然缺失，请在扩展面板（Cmd+Shift+X / Ctrl+Shift+X）中确认安装情况，并确认列表中出现 "Verdent"。
解决方法：
- 确认互联网连接正常
- 检查防火墙/代理设置允许访问 Verdent 服务的 HTTPS
- 确认你在用户中心中仍有剩余积分
- 尝试一个更简单的提示词来测试连通性
解决方法： 使用 "Switch Permission" 按钮切换到自动运行模式。这会自动批准安全的读取操作，同时仍会在文件编辑和命令上请求批准。
获取帮助
- Discord 社区：https://discord.com/invite/NGjXEZcbJq - 活跃的社区，提供实时支持
- 文档：浏览本文档中的其他指南
- 反馈：使用 Verdent 顶栏中的 Feedback 按钮来报告问题或提出改进建议
常见问答
如何知道我当前处于哪种执行模式？
查看 Verdent 面板底部的输入框。"Switch Permission" 按钮会显示你当前的模式（例如 "Manual"、"Auto"、"Plan"）。你可以点击它来切换模式。
如果积分用完了会怎样？
当余额降到零时，基于积分的标准请求会停止。等待你下个计费周期的刷新，或购买一次性充值包以继续使用。
我能同时在多个项目中使用 Verdent 吗？
可以，每个 VS Code 窗口都独立运行。你可以在多个项目中打开 Verdent，每个都维护自己独立的对话上下文。
如何以干净的上下文开始一次新对话？
点击顶栏中的 "New Session" 按钮。这会清除当前对话历史，为你的下一个任务提供一个全新的 Verdent 上下文窗口。
后续步骤
你已经安装了 Verdent，完成了第一个任务，并了解了核心工作流。接下来可以继续：