系统要求与兼容性
支持的平台、IDE 版本及网络要求
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 版本 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 等编辑器。
硬件要求
最低要求
| 组件 | 规格 |
|---|---|
| 内存 | 1 GB（较大项目推荐 4 GB 以上） |
| 磁盘空间 | Visual Studio Code + Verdent 扩展小于 500 MB |
| CPU | 任何能够运行 Visual Studio Code 的处理器 |
推荐配置
为获得最佳性能，尤其是在处理大型代码库或多智能体工作流时：
- 内存：8 GB 或更多
- CPU：多核处理器，用于并发执行子智能体
- 磁盘空间：1 GB 以上，用于缓存和索引（如果启用）
性能随硬件能力提升而提升。多智能体工作流和大规模重构会从更多的内存和处理能力中受益。
推荐配置为一般性指导。针对 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 支持获取需要加入白名单的具体端点详情。