安裝
逐步引導你完成 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進行驗證。
- macOS： Git 隨 Xcode Command Line Tools 一同提供。使用
- 網際網路連線：與 AI 服務通訊需要有效的連線
選用但建議
- 磁碟空間：至少 2 GB 可用空間（針對大型儲存庫、worktree 與快取建議預留更多）
下載
從官方網站下載 Verdent：
選擇你的作業系統以下載對應的安裝程式。
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 等 OAuth 提供者）。
返回應用程式
驗證完成後返回 Verdent。你將看到主介面。
開啟專案
選擇 開啟專案 以選取目錄，或若是回訪則選 最近的專案。
驗證安裝
透過以下簡單檢查，確認你的安裝正常運作：
視覺驗證
- 應用程式圖示 - Verdent 出現在「應用程式」（macOS）或「開始」功能表（Windows）中
- 已登入 - 驗證後你可以在應用程式中看到帳號狀態（例如頭像／電子郵件）
功能驗證
開啟專案
在 Verdent 中開啟一個目錄。
傳送測試提示詞
在輸入框中嘗試簡單的請求，例如「說明這個專案包含哪些內容」。
接收回應
Verdent 應會分析你的專案並很快提供回應。
成功的指標：
- Verdent 啟動時沒有錯誤
- 成功驗證帳號
- 可以傳送提示詞並接收回應
Verdent 的 AI 功能需要有效的網際網路連線。若提示詞沒有回應，請確認你的網路連線，並確保防火牆允許對外連往 Verdent API 端點的 HTTPS 連線。
安裝疑難排解
問題： 「Verdent 無法開啟，因為它來自未識別的開發者」
解決方法：
- 開啟 系統設定 → 隱私權與安全性（macOS 13+）或 系統偏好設定 → 安全性與隱私權（較舊的 macOS）
- 找到 Verdent 的警告訊息
- 點選 強制開啟
- 再點選 開啟 確認
問題： Windows Defender 封鎖安裝
解決方法：
- 在 SmartScreen 彈出視窗上點選 其他資訊
- 若你是從官方網站下載 Verdent 且信任來源，請點選 仍要執行
- 繼續安裝
常見問題
我可以同時安裝 Verdent 與 VS Code 擴充功能嗎？
可以。Verdent 與 VS Code 擴充功能是各自獨立的應用程式。你可以同時使用兩者，且它們共用相同的點數池與帳號。
我該如何更新 Verdent？
Verdent 會在啟動時自動檢查更新。當有可用更新時：
- 會出現通知
- 點選 更新 以下載並安裝
- 重新啟動應用程式
你也可以從應用程式選單手動檢查（例如：說明 → 檢查更新）。
我該如何解除安裝 Verdent？
macOS： 將 Verdent 從「應用程式」拖曳到「垃圾桶」
Windows： 使用 設定 → 應用程式 → Verdent → 解除安裝 或 控制台 → 程式集與功能