安裝
安裝與設定 Verdent 的逐步指南
本指南將引導你從 Visual Studio Code Marketplace 安裝 Verdent for VS Code，並完成初始驗證。
系統需求
在安裝 Verdent 之前，請確認你的系統符合下列先決條件：
系統需求
- Visual Studio Code：版本 1.90.0 或更高
- 作業系統：macOS 11+、Windows 10+ 或 Linux（Ubuntu 20.04+、Debian 10+、RHEL 8+）
- 網路連線：與 AI 服務通訊需要有效連線
選用但建議
- Git：用於版本控制整合與追蹤程式碼變更
詳細的相容性資訊請參閱 系統需求。
安裝擴充功能
Verdent for VS Code 透過 Visual Studio Code Marketplace 散布。
造訪 Marketplace
在瀏覽器中前往 Verdent 擴充功能頁面。
點擊安裝
在 marketplace 頁面點擊 Install 按鈕。
在 VS Code 中開啟
VS Code 會自動開啟並開始安裝程序。
開啟 VS Code
在你的電腦上啟動 Visual Studio Code。
存取擴充功能
點擊左側邊欄的擴充功能圖示（四個方塊圖示）或按下：
- macOS：
Cmd+Shift+X - Windows/Linux：
Ctrl+Shift+X
搜尋 Verdent
在擴充功能面板頂端的搜尋框中輸入「Verdent」。在結果中找到由 Verdent AI 提供的「Verdent」。
安裝
點擊 Verdent 擴充功能旁的 Install 按鈕。安裝通常只需幾秒鐘。
code --install-extension verdentai.verdent此方法適用於：
- 自動化設定腳本
- 透過 SSH 在遠端伺服器上安裝
- CI/CD 環境設定
- 在多台機器上快速安裝
如果你使用 VS Code Settings Sync，當你同步擴充功能清單時，Verdent 會自動安裝在新機器上。
驗證與設定
安裝完成後，你需要使用 Verdent 帳號進行驗證，才能開始使用此擴充功能。
初始驗證
開啟 Verdent
安裝完成後，點擊 VS Code 側邊欄中的 Verdent 圖示。你會看到「登入／註冊」選項。
登入
點擊 Sign In。VS Code 會顯示一個彈出視窗詢問「Do you want Code to open the external website?」——點擊 Open。
瀏覽器驗證
你的瀏覽器會開啟 Verdent 驗證頁面。使用你的 Verdent 帳號憑證（電子郵件／密碼，或 Google、GitHub 等 OAuth 提供者）登入。
授權 VS Code
在提示時，授予 VS Code 存取你的 Verdent 帳號的權限。
返回 VS Code
驗證完成後返回 VS Code。Verdent 面板現在會顯示輸入介面。
總計時間： 完整安裝與設定約需 2-3 分鐘。
初始設定（選用）
Verdent for VS Code 設計為驗證後即可立即使用，所需設定極少。
預設設定：
- 權限模式：Auto-Run Mode（自動核准安全操作）
- 模型預設：Balance（最佳的效能／成本搭配）
- 上下文管理：自動
選用的自訂設定：
你之後可以透過 Verdent 面板調整這些設定：
- 權限模式 - 選擇 Manual Accept、Auto-Run、Plan Mode 或 Skip Permissions
- 模型選擇 - 選擇 Performance、Balance、Efficiency 預設或特定模型
- 工作區設定 - 設定專案專屬的偏好
大多數使用者在登入後即可立即開始使用 Verdent，無需任何額外設定。進階設定可視需要調整。
驗證安裝
透過下列簡單檢查，確認你的安裝正常運作：
視覺驗證
- 側邊欄圖示 - 在 VS Code 側邊欄（左側）尋找 Verdent 圖示
- 擴充功能清單 - 開啟擴充功能面板（
Cmd+Shift+X/Ctrl+Shift+X）並確認「Verdent」顯示為已安裝並帶有勾選標記
功能驗證
開啟 Verdent 面板
點擊側邊欄中的 Verdent 圖示，或按下 Cmd+L（macOS）／ Ctrl+L（Windows/Linux）。
傳送測試提示詞
在輸入框中嘗試一個簡單的請求，例如「Explain what this workspace contains」。
接收回應
Verdent 應會分析你的工作區並在幾秒內提供回應。
成功指標：
- 側邊欄中可見 Verdent 圖示
- 成功驗證帳號
- 可以傳送提示詞並接收回應
疑難排解
如果驗證失敗，請嘗試下列解決方法：
| 問題 | 解決方法 |
|---|---|
| 缺少側邊欄圖示 | 重新啟動 VS Code 或檢查擴充功能更新 |
| 提示詞沒有回應 | 檢查網路連線與防火牆設定 |
| 找不到擴充功能 | 確認 VS Code 版本為 1.90.0 或更高 |
Verdent 需要有效的網路連線。如果提示詞沒有回應，請確認你的網路連線狀況，以及防火牆設定允許對外連往 Verdent API 端點的 HTTPS 流量。