# 安装 (/zh-CN/docs/verdent-manager/getting-started/installation)

> Verdent 安装与配置分步指南



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

***

## 系统要求 [#系统要求]

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

### 系统要求 [#系统要求-1]

* **操作系统**：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 安装 [#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 安装 [#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>