Verdent Docs
入门

安装

Verdent 安装与配置分步指南

本指南将引导你完成 Verdent 的下载、平台专属安装步骤以及 Verdent 账户认证。

系统要求

安装 Verdent 前，请确保你的系统满足以下前提条件：

系统要求

  • 操作系统：macOS 11+ 或 Windows 10+（64 位）。完整兼容性详情请参阅支持的操作系统。
  • Git：2.20 或更高版本。Verdent 使用 Git worktree 来实现工作区隔离。你的项目文件夹不必是 Git 仓库，但部分功能需要 Git，Verdent 会在需要时引导你初始化仓库。
    • macOS： Git 随 Xcode Command Line Tools 一起提供。可通过 xcode-select --install 安装，或使用 Homebrew：brew install git。
    • Windows： 从 git-scm.com/download/win 下载官方安装程序，按默认选项安装即可。
    • 在终端中运行 git --version 验证安装。
  • 网络连接：需要活跃的网络连接以与 AI 服务通信

可选但推荐

  • 磁盘空间：至少 2 GB 可用空间（大型仓库、worktree 和缓存需要更多空间）

下载

从官方网站下载 Verdent：

verdent.ai/download

选择你的操作系统以下载对应的安装程序。

macOS 安装

下载

从 verdent.ai/download 下载 .dmg 文件

打开 DMG

双击下载的 .dmg 文件以挂载磁盘映像

安装

将 Verdent 图标拖入"应用程序"文件夹

启动

打开"应用程序"文件夹，双击 Verdent

安全性许可

如果出现提示，请打开系统设置 → 隐私与安全性（macOS 13+）或系统偏好设置 → 安全性与隐私（更早版本的 macOS），然后点击仍要打开

支持的 macOS 版本：

  • macOS 11（Big Sur）及更高版本
  • 支持 Intel 和 Apple Silicon

Windows 安装

下载

从 verdent.ai/download 下载 .exe 安装程序

运行安装程序

双击下载的 .exe 文件

UAC 提示

在用户账户控制提示中点击是

安装选项

按照安装程序提示操作（部分版本可能不提供自定义安装目录选项）

完成安装

点击安装并等待完成

启动

点击完成以启动 Verdent，或在开始菜单中找到它

支持的 Windows 版本：

  • Windows 10
  • Windows 11
  • 仅限 64 位

认证与配置

安装完成后，你需要使用 Verdent 账户进行认证才能开始使用。

初次认证

启动 Verdent

从"应用程序"（macOS）或开始菜单（Windows）打开 Verdent。欢迎界面将会出现。

登录

点击登录。浏览器将打开 Verdent 认证页面。

浏览器认证

使用你的 Verdent 账户凭据登录（邮箱/密码或 Google、GitHub 等第三方登录方式）。

返回应用

认证完成后返回 Verdent，你将看到主界面。

打开项目

选择打开项目以选择一个目录，或选择最近的项目（如果是再次使用）。

验证安装

通过以下简单检查确认安装是否正常：

视觉验证

  1. 应用程序图标 - Verdent 出现在"应用程序"（macOS）或开始菜单（Windows）中
  2. 已登录 - 认证后可以在应用中看到你的账户状态（如头像/邮箱）

功能验证

打开项目

在 Verdent 中打开一个目录。

发送测试提示词

在输入框中尝试一个简单的请求，例如"解释一下这个项目包含什么内容"。

接收响应

Verdent 应该会分析你的项目并很快给出响应。

成功标志：

  • Verdent 启动无错误
  • 账户认证成功
  • 可以发送提示词并收到响应

Verdent 的 AI 功能需要活跃的网络连接。如果提示词没有响应，请检查你的网络连接，并确保防火墙允许到 Verdent API 端点的出站 HTTPS 请求。

安装故障排除

问题："无法打开 Verdent，因为它来自身份不明的开发者"

解决方案：

  1. 打开系统设置 → 隐私与安全性（macOS 13+）或系统偏好设置 → 安全性与隐私（更早版本的 macOS）
  2. 找到 Verdent 的警告信息
  3. 点击仍要打开
  4. 点击打开确认

问题： Windows Defender 阻止安装

解决方案：

  1. 在 SmartScreen 弹窗中点击更多信息
  2. 如果你是从官方网站下载的 Verdent 并信任该来源，点击仍要运行
  3. 继续安装

常见问题

可以同时安装 Verdent 和 VS Code 扩展吗？

可以。Verdent 和 VS Code 扩展是独立的应用程序。你可以同时使用两者，它们共享相同的积分池和账户。

如何更新 Verdent？

Verdent 在启动时会自动检查更新。当有可用更新时：

  1. 会出现通知提示
  2. 点击更新以下载并安装
  3. 重启应用程序

你也可以从应用菜单手动检查（例如：帮助 → 检查更新）。

如何卸载 Verdent？

macOS： 将 Verdent 从"应用程序"文件夹拖到废纸篓

Windows： 使用设置 → 应用 → Verdent → 卸载或控制面板 → 程序和功能

后续步骤

快速入门

添加你的第一个项目并分配任务

Manager

了解 Manager 如何规划、调度和跟踪工作

View source

概览

Verdent — 你的 AI 技术合伙人

快速开始

添加你的第一个项目并为 Manager 分配任务

On this page

系统要求系统要求可选但推荐下载macOS 安装Windows 安装认证与配置初次认证验证安装视觉验证功能验证安装故障排除常见问题后续步骤