# 安裝 (/zh-Hant/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 等 OAuth 提供者）。
  </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>