系統需求與相容性

Verdent for VS Code 是原生的 Visual Studio Code 擴充功能，繼承了 Visual Studio Code 的跨平台相容性，無需針對不同作業系統進行額外安裝或設定。

支援的作業系統

Verdent for VS Code 支援所有可使用 Visual Studio Code 的作業系統：

作業系統	支援版本	架構
macOS	macOS 11 (Big Sur) 及更新版本	Intel 與 Apple Silicon
Windows	Windows 10 (version 1607+)、Windows 11、Windows Server 2016+	僅限 64 位元
Linux	Ubuntu 20.04+、Debian 10+、Red Hat Enterprise Linux 8+、Fedora、CentOS 8+、openSUSE Leap 15.2+	x64 與 ARM64

已淘汰的平台：macOS 10.15 (Catalina) 的支援已於 Visual Studio Code 1.98（2025 年 2 月）終止。Windows 7 與 8/8.1 自 Visual Studio Code 1.70（2022 年 7 月）起不再支援。Windows 32 位元系統自 Visual Studio Code 1.83（2023 年 9 月）起不再支援。

Linux 需求

針對 Linux 系統，請確保你的發行版符合以下需求：

glibc 2.28 或更新版本（自 Visual Studio Code 1.86.1，2024 年 1 月起）
GLIBCXX version 3.4.25 或更新版本

所需的 IDE/編輯器版本

Visual Studio Code：

需要 1.90.0 或更高版本
建議使用最新穩定版以獲得最佳相容性

Verdent for VS Code 可搭配 Visual Studio Code 及基於 Visual Studio Code 的編輯器（Cursor、VSCodium）使用。它不支援 JetBrains IDE、Sublime Text 或 Vim 等編輯器。

硬體需求

最低需求

元件	規格
RAM	1 GB（較大型專案建議 4 GB 以上）
磁碟空間	Visual Studio Code + Verdent 擴充功能需 < 500 MB
CPU	任何能執行 Visual Studio Code 的處理器

建議規格

為獲得最佳效能，尤其是在處理大型程式碼庫或多代理工作流程時：

RAM：8 GB 或以上
CPU：多核心處理器以支援並行的子代理執行
磁碟空間：1 GB 以上用於快取與索引（如有啟用）

效能會隨硬體能力提升而擴展。多代理工作流程與大規模重構可受益於更多 RAM 與處理能力。

建議規格僅為一般性指引。針對 Verdent 特定功能（多代理工作流程、快取、索引）的官方硬體建議，仍待 Verdent 團隊提供。

網路需求

Verdent for VS Code 需要隨時保持有效的網路連線才能運作。

連線需求

連線類型：穩定的寬頻網路連線
協定：對外連向 Verdent API 端點的 HTTPS 連線
頻寬：足以傳輸程式碼上下文與串流 AI 回應

防火牆與代理考量

針對企業環境或位於防火牆後方的使用者：

所需存取權限：

對外連向 Verdent API 網域的 HTTPS 流量
Verdent 會處理至多個模型供應商（Claude、GPT-5、Gemini、MiniMax 等）的路由
無需設定任何對內防火牆規則或連接埠轉發

企業設定：

企業防火牆必須允許對外連向 Verdent 服務端點的 HTTPS 流量
代理伺服器應放行 API 請求
SSL/TLS 檢查可能需要為 Verdent 端點設定例外

若沒有網路連線，Verdent for VS Code 將無法處理請求或提供任何 AI 輔助功能。此擴充功能無法離線運作。

常見問題

如何查看我的 Visual Studio Code 版本？

開啟 Visual Studio Code，前往 Help → About（在 macOS 上為 Code → About Visual Studio Code）。版本號會顯示於對話框中。Verdent 需要 Visual Studio Code 1.90.0 或更高版本。

你也可以透過命令列查看：

code --version

如何確認我的 Linux 系統符合需求？

使用以下指令檢查你的 glibc 與 GLIBCXX 版本：

# Check glibc version (need 2.28 or later)
ldd --version

# Check GLIBCXX version (need 3.4.25 or later)
strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXX

若你的發行版不符合這些需求，你可能需要升級至較新版本的 Linux 發行版。

如何排解防火牆或連線問題？

若 Verdent 無法連線至 AI 服務，請檢查以下常見問題：

測試基本連線：

確認你有有效的網路連線
嘗試存取其他 HTTPS 服務，以確認對外連線正常運作

企業環境：

聯絡你的網路管理員，將 Verdent 的 API 端點加入白名單
確保防火牆允許對外的 HTTPS 流量
檢查代理伺服器是否已正確設定以放行 API 請求
SSL/TLS 檢查可能需要為 Verdent 端點設定例外

常見徵狀：

擴充功能似乎卡住或逾時
即使憑證正確仍驗證失敗

若在設定防火牆後問題仍持續，請聯絡 Verdent 支援團隊，以取得需加入白名單的具體端點資訊。