安装
安装并设置 Verdent 的分步指南
本指南将引导你从 Visual Studio Code Marketplace 安装 Verdent for VS Code，并完成初始身份验证。
系统要求
在安装 Verdent 之前，请确保你的系统满足以下前提条件：
系统要求
- Visual Studio Code：版本 1.90.0 或更高
- 操作系统：macOS 11+、Windows 10+ 或 Linux（Ubuntu 20.04+、Debian 10+、RHEL 8+）
- 网络连接：与 AI 服务通信需要有效的网络连接
可选但推荐
- Git：用于版本控制集成并追踪代码变更
详细的兼容性信息请参阅系统要求。
安装扩展
Verdent for VS Code 通过 Visual Studio Code Marketplace 分发。
访问 Marketplace
在浏览器中打开 Verdent 扩展页面。
点击 Install
在 Marketplace 页面点击 Install 按钮。
在 VS Code 中打开
VS Code 将自动打开并开始安装流程。
打开 VS Code
在你的电脑上启动 Visual Studio Code。
进入扩展面板
点击左侧边栏中的扩展图标（四个方块的图标），或按：
- macOS：
Cmd+Shift+X - Windows/Linux：
Ctrl+Shift+X
搜索 Verdent
在扩展面板顶部的搜索框中输入 “Verdent”。在结果中查找由 Verdent AI 发布的 “Verdent”。
安装
点击 Verdent 扩展旁边的 Install 按钮。安装通常只需几秒钟。
code --install-extension verdentai.verdent此方法适用于：
- 自动化安装脚本
- 通过 SSH 在远程服务器上安装
- CI/CD 环境配置
- 快速在多台机器上安装
如果你使用 VS Code 设置同步（Settings Sync），当你同步扩展列表时，Verdent 会自动安装到新机器上。
身份验证与设置
安装完成后，你需要使用 Verdent 账户进行身份验证，才能开始使用扩展。
初始身份验证
打开 Verdent
安装完成后，点击 VS Code 边栏中的 Verdent 图标。你将看到登录 / 注册选项。
登录
点击 Sign In。VS Code 会弹出提示 “Do you want Code to open the external website?” —— 点击 Open。
浏览器身份验证
你的浏览器将打开 Verdent 身份验证页面。使用你的 Verdent 账户凭据登录（邮箱/密码，或 Google、GitHub 等 OAuth 提供商）。
授权 VS Code
在提示时，授予 VS Code 访问你的 Verdent 账户的权限。
返回 VS Code
身份验证完成后返回 VS Code。Verdent 面板此时将显示输入界面。
总耗时： 完整的安装和设置约需 2-3 分钟。
初始配置（可选）
Verdent for VS Code 设计为在身份验证后即可立即使用，所需配置极少。
默认设置：
- 权限模式：Auto-Run 模式（自动批准安全操作）
- 模型预设：Balance（性能/成本的最佳平衡）
- 上下文管理：自动
可选自定义：
你可以稍后通过 Verdent 面板调整这些设置：
- 权限模式 —— 选择 Manual Accept、Auto-Run、Plan Mode 或 Skip Permissions
- 模型选择 —— 选择 Performance、Balance、Efficiency 预设或特定模型
- 工作区设置 —— 配置项目专属偏好
大多数用户在登录后无需任何额外配置即可立即开始使用 Verdent。高级设置可按需调整。
验证安装
通过以下简单检查确认你的安装是否正常工作：
可视化验证
- 边栏图标 —— 在 VS Code 边栏（左侧）中查找 Verdent 图标
- 扩展列表 —— 打开扩展面板（
Cmd+Shift+X/Ctrl+Shift+X），确认 “Verdent” 显示为已安装并带有勾选标记
功能验证
打开 Verdent 面板
点击边栏中的 Verdent 图标，或按 Cmd+L（macOS）/ Ctrl+L（Windows/Linux）。
发送测试提示词
在输入框中尝试一个简单请求，例如 “Explain what this workspace contains”。
接收响应
Verdent 应在几秒内分析你的工作区并给出响应。
成功标志：
- 边栏中可见 Verdent 图标
- 账户身份验证成功
- 能够发送提示词并接收响应
故障排查
如果验证失败，请尝试以下解决方案：
| 问题 | 解决方案 |
|---|---|
| 边栏图标缺失 | 重启 VS Code 或检查扩展更新 |
| 提示词无响应 | 检查网络连接和防火墙设置 |
| 找不到扩展 | 确保 VS Code 版本为 1.90.0 或更高 |
Verdent 需要有效的网络连接。如果提示词没有响应，请确认你的网络连通性和防火墙配置允许出站 HTTPS 访问 Verdent 的 API 端点。