​
支持的版本

2022.3 及以上版本。
  • 不支持 JetBrains Fleet 或 ReSharper
  • 不支持远程 SSH。

​
收集扩展日志

从扩展版本 1.10.0 开始，Chat 面板的设置页面新增了 Extension Diagnostics 按钮。点击该按钮会自动收集相关日志和参数，并打包为可下载的文本文件。 对于较旧版本的扩展：
  1. 日志会写入 idea.log 文件。要定位该文件，请通过菜单 Help > Show Log in Finder/Explorer 打开日志目录
  2. 导出或复制日志

​
如何重置或更改 Enterprise URL

  1. 依次点击 Tools → Codeium Enterprise → Reset Codeium Enterprise Updater。
  2. 输入新的 URL，确保前后没有空格。
  3. 重启 IDE。
  4. 重启后，系统会提示你登录。

​
已知 IDE 问题及解决方案

​
Cascade 无法使用（或 Windsurf 插件完全不可用）

如果 Windsurf 的 JetBrains 插件无法使用，建议首先尝试重置插件：前往 Help > Find Action > Reset Windsurf Enterprise Updater。 如果问题仅发生在少数用户身上，很可能是因为 Enterprise Domain URL 的证书尚未加载到你的 IDE。你们团队的管理员应当知道如何处理。

​
未显示 Cascade

通常，你会在日志中看到如下错误： 
此环境不支持 JCEF 或 JCEF 初始化失败
或 
不支持内部 JCEF，正在尝试外部 JCEF
JCEF 是用于显示 Cascade 的浏览器组件。要解决此问题，请前往 Help > Find Actions > Choose Java Boot Runtime，选择包含 JCEF 的运行时。 如果你的运行时已包含 JCEF，可能是 JCEF 在你的注册表/属性中被禁用了。 编辑你的属性：Help > Edit Custom Properties，添加以下标志并重启 IDE： 
ide.browser.jcef.enabled=true

​
证书相关问题

如果你遇到以下错误： 
无法从 <YourDomainURL> 获取扩展基础 URL

PKIX 路径构建失败：sun.security.provider.certpath.SunCertPathBuilderException：
无法找到到请求目标的有效证书路径
这表明 Codeium 扩展无法信任与您的企业门户/API 服务器的 TLS 连接，因为它不信任所提供的证书。这要么意味着由 Codeium 部署所提供的证书不受信任，要么是拦截请求的企业代理所提供的证书不受信任。 无论哪种情况，最理想的解决方案是确保为该证书签名的根证书已正确安装在终端用户设备的合适位置。JetBrains IDE 以及大多数其他 IDE 会从操作系统的默认位置加载证书。 您的证书由本地 IT 或管理员团队签发并管理。请联系他们，协助在您的系统上安装所需证书。 务必确保在 TLS 终止的位置完整提供证书链。很多时候，如果只提供叶子证书，JetBrains IDE 和其他 IDE 将无法验证其真实性，因为它们并不知道用于验证叶子证书、且由根证书再进行验证的中间证书。浏览器通常可以绕过此问题，因为用户很可能访问过其他确实提供完整证书链的网站，从而见到并缓存了中间证书，但像 JetBrains IDE 这样的应用并无此优势。 注意：在 JetBrains 家族产品 2024.3 中引入了一个 bug，导致 IDE 无法接受操作系统证书（参见 JetBrains 问题报告：https://youtrack.jetbrains.com/issue/IJPL-171446/Unable-to-find-valid-certification-path-to-requested-target-exception-in-Settings-Sync-when-proxy-is-used）。为解决此问题，用户可以采取以下任一操作：
  • 将 JB 产品降级到更早版本
  • 使用 2024.3.1 预览版（测试版）
  • 添加 -Djavax.net.ssl.trustStoreType=Windows-ROOT 作为自定义 JVM 选项

​
自定义工作区

如果你在使用 Cascade 时遇到以下错误： 
Cascade 无法在没有活动工作区时访问路径
这表示 Cascade 需要访问自定义工作区才能正常运行。要解决此问题：
  1. 通过转到 File > Settings（在 macOS 上为 IntelliJ IDEA > Preferences）打开你的 JetBrains IDE 设置
  2. 前往 Tools > Windsurf Settings
  3. 在 Windsurf 设置面板中，找到底部的 “Custom Workspaces” 部分
  4. 点击 “Add Workspace” 按钮以添加你的项目工作区
  5. 选择适合你项目的工作区目录
  6. 点击 “OK” 以应用设置
  7. 重启 IDE 使更改生效

​
Enterprise 与非 Enterprise 行为

自定义工作区的行为会因您的用户类型而有所不同：

​
Enterprise 用户

Enterprise 用户可对工作区索引进行选择性控制：
  • 添加工作区时，你会看到一个复选框，可为每个工作区启用索引
  • 只有勾选该复选框的工作区才会被索引，并供 Cascade 使用
  • 这样你可以控制哪些工作区消耗索引资源
  • 出于安全考虑，工具调用将被限制在活动工作区内

​
非 Enterprise 用户

非 Enterprise 用户将享有自动工作区索引：
  • 你添加的任何工作区都会自动建立索引，无需勾选复选框
  • 所有已添加的工作区会立即可供 Cascade 使用
  • 工具调用在活动工作区之外也不会被阻止
  • 在此模式下，选择性索引功能不适用
完成上述设置后，Cascade 应可访问你的工作区并正常运行。