---
title: 安装
description: "Verdent 安装与配置分步指南"
---

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

---

## 系统要求

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

### 系统要求

* **操作系统**：macOS 11+ 或 Windows 10+（64 位）。完整兼容性详情请参阅[支持的操作系统](/docs/verdent-manager/getting-started/supported-operating-systems)。
* **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](https://git-scm.com/download/win) 下载官方安装程序，按默认选项安装即可。
  - 在终端中运行 `git --version` 验证安装。
* **网络连接**：需要活跃的网络连接以与 AI 服务通信

### 可选但推荐

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

---

## 下载

从官方网站下载 Verdent：

**[verdent.ai/download](https://verdent.ai/download)**

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

---

## macOS 安装

<Steps>
  <Step title="下载">
    从 [verdent.ai/download](https://verdent.ai/download) 下载 `.dmg` 文件
  </Step>
  <Step title="打开 DMG">
    双击下载的 `.dmg` 文件以挂载磁盘映像
  </Step>
  <Step title="安装">
    将 Verdent 图标拖入"应用程序"文件夹
  </Step>
  <Step title="启动">
    打开"应用程序"文件夹，双击 Verdent
  </Step>
  <Step title="安全性许可">
    如果出现提示，请打开**系统设置 → 隐私与安全性**（macOS 13+）或**系统偏好设置 → 安全性与隐私**（更早版本的 macOS），然后点击**仍要打开**
  </Step>
</Steps>

**支持的 macOS 版本：**
- macOS 11（Big Sur）及更高版本
- 支持 Intel 和 Apple Silicon

---

## Windows 安装

<Steps>
  <Step title="下载">
    从 [verdent.ai/download](https://verdent.ai/download) 下载 `.exe` 安装程序
  </Step>
  <Step title="运行安装程序">
    双击下载的 `.exe` 文件
  </Step>
  <Step title="UAC 提示">
    在用户账户控制提示中点击**是**
  </Step>
  <Step title="安装选项">
    按照安装程序提示操作（部分版本可能不提供自定义安装目录选项）
  </Step>
  <Step title="完成安装">
    点击**安装**并等待完成
  </Step>
  <Step title="启动">
    点击**完成**以启动 Verdent，或在开始菜单中找到它
  </Step>
</Steps>

**支持的 Windows 版本：**
- Windows 10
- Windows 11
- 仅限 64 位

---

## 认证与配置

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

### 初次认证

<Steps>
  <Step title="启动 Verdent">
    从"应用程序"（macOS）或开始菜单（Windows）打开 Verdent。欢迎界面将会出现。
  </Step>

  <Step title="登录">
    点击**登录**。浏览器将打开 Verdent 认证页面。
  </Step>

  <Step title="浏览器认证">
    使用你的 Verdent 账户凭据登录（邮箱/密码或 Google、GitHub 等第三方登录方式）。
  </Step>

  <Step title="返回应用">
    认证完成后返回 Verdent，你将看到主界面。
  </Step>

  <Step title="打开项目">
    选择**打开项目**以选择一个目录，或选择**最近的项目**（如果是再次使用）。
  </Step>
</Steps>

---

## 验证安装

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

### 视觉验证

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

### 功能验证

<Steps>
  <Step title="打开项目">
    在 Verdent 中打开一个目录。
  </Step>

  <Step title="发送测试提示词">
    在输入框中尝试一个简单的请求，例如"解释一下这个项目包含什么内容"。
  </Step>

  <Step title="接收响应">
    Verdent 应该会分析你的项目并很快给出响应。
  </Step>
</Steps>

**成功标志：**

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

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

---

## 安装故障排除

<Tabs>
  <Tab title="macOS 安全性">
    **问题：**"无法打开 Verdent，因为它来自身份不明的开发者"

    **解决方案：**
    1. 打开**系统设置 → 隐私与安全性**（macOS 13+）或**系统偏好设置 → 安全性与隐私**（更早版本的 macOS）
    2. 找到 Verdent 的警告信息
    3. 点击**仍要打开**
    4. 点击**打开**确认
  </Tab>
  <Tab title="Windows Defender">
    **问题：** Windows Defender 阻止安装

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

---

## 常见问题

<AccordionGroup>
<Accordion title="可以同时安装 Verdent 和 VS Code 扩展吗？">
可以。Verdent 和 VS Code 扩展是独立的应用程序。你可以同时使用两者，它们共享相同的积分池和账户。
</Accordion>

<Accordion title="如何更新 Verdent？">
Verdent 在启动时会自动检查更新。当有可用更新时：
1. 会出现通知提示
2. 点击**更新**以下载并安装
3. 重启应用程序

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

<Accordion title="如何卸载 Verdent？">
**macOS：** 将 Verdent 从"应用程序"文件夹拖到废纸篓

**Windows：** 使用**设置 → 应用 → Verdent → 卸载**或**控制面板 → 程序和功能**
</Accordion>
</AccordionGroup>

---

## 后续步骤

<CardGroup cols={2}>
  <Card title="快速入门" icon="rocket" href="/docs/verdent-manager/getting-started/quick-start">
    添加你的第一个项目并分配任务
  </Card>
  <Card title="Manager" icon="user-tie" href="/docs/verdent-manager/core-features/manager">
    了解 Manager 如何规划、调度和跟踪工作
  </Card>
</CardGroup>