Skip to main content
O plugin Windsurf JetBrains está em modo de manutenção e o Cascade está sendo descontinuado. Versões mais recentes das IDEs JetBrains podem quebrar o plugin legado. Se o Cascade ou o plugin parou de funcionar, mude para o Devin via ACP — consulte o guia de configuração do ACP no JetBrains.

​
Versões compatíveis

Versão 2022.3 ou posterior.
  • JetBrains Fleet ou ReSharper não têm suporte
  • Remote SSH não tem suporte.

​
Coletando logs da extensão

A partir da versão 1.10.0 da extensão, o Chat Panel passou a ter um botão Extension Diagnostics na página de Configurações. Esse botão coleta automaticamente os logs e parâmetros relevantes em um arquivo de texto que pode ser baixado. Para versões mais antigas da extensão:
  1. Os logs são gravados no arquivo idea.log. Para localizar esse arquivo, acesse a opção de menu Help > Show Log in Finder/Explorer
  2. Exporte ou copie os logs

​
Problemas conhecidos do IDE e soluções

​
Cascade não é exibido

Normalmente, você verá o seguinte erro nos logs:
ou
JCEF é um navegador necessário para exibir o Cascade. Para resolver isso, vá até Help > Find Actions > Choose Java Boot Runtime e selecione um runtime com JCEF incluído. Se o JCEF já estiver incluído no seu runtime, ele pode estar desativado no seu registro/properties. Edite suas propriedades: Help > Edit Custom Properties, adicione a flag a seguir e reinicie a IDE:

​
Problemas com certificados

Se você encontrar os seguintes erros:
Isso sugere que a extensão Codeium não consegue confiar na conexão TLS com o portal Enterprise / servidor de API porque não confia no certificado apresentado. Isso significa que ou o certificado apresentado pela implantação do Codeium não é confiável, ou o certificado apresentado por um proxy corporativo que intercepta a requisição não é confiável. Em qualquer um dos casos, a solução mais recomendada é garantir que o certificado raiz que assinou esse certificado esteja devidamente instalado nas máquinas dos usuários finais, no local apropriado. Os IDEs da JetBrains e a maioria dos outros IDEs carregam certificados do local padrão do sistema operacional. Seu certificado é emitido e gerenciado pela equipe local de TI ou de Admin. Entre em contato com ela para obter ajuda para instalar os certificados necessários no seu sistema. É importante que a cadeia completa de certificados seja apresentada onde quer que o TLS esteja sendo encerrado. Muitas vezes, se apenas o certificado final é apresentado, os IDEs da JetBrains e outros IDEs não conseguem verificar sua autenticidade porque não conhecem o certificado intermediário, que valida o certificado final e é validado pelo certificado raiz. Os navegadores geralmente conseguem contornar esse problema, pois os usuários provavelmente já terão acessado outro site que apresenta a cadeia completa de certificados, então o certificado intermediário é identificado e armazenado em cache, mas aplicativos como os IDEs da JetBrains não têm essa vantagem. Observação: Nos produtos da família JetBrains 2024.3, foi introduzido um bug em que o IDE não consegue aceitar os certificados do sistema operacional (relatório de problema da JetBrains). Para resolver isso, os usuários podem fazer qualquer uma das opções a seguir:
  • Fazer downgrade dos produtos JB para versões anteriores
  • Usar a versão preview 2024.3.1 (versão beta)
  • Adicionar -Djavax.net.ssl.trustStoreType=Windows-ROOT como uma opção personalizada da JVM

​
Workspaces personalizados

Se aparecer o seguinte erro ao usar o Cascade:
Isso indica que o Cascade precisa de acesso a um workspace personalizado para funcionar corretamente. Para resolver isso:
  1. Abra as Configurações da sua IDE JetBrains acessando File > Settings (ou IntelliJ IDEA > Preferences no macOS)
  2. Vá para Tools > Windsurf Settings
  3. No painel Windsurf Settings, localize a seção “Custom Workspaces” na parte inferior
  4. Clique no botão “Add Workspace” para adicionar o workspace do seu projeto
  5. Selecione o diretório de workspace adequado para o seu projeto
  6. Clique em “OK” para aplicar as configurações
  7. Reinicie a IDE para que as alterações entrem em vigor

​
Comportamento no Enterprise vs. fora do Enterprise

O comportamento de workspaces personalizados varia de acordo com o tipo de usuário:

​
Usuários Enterprise

Usuários Enterprise têm controle seletivo sobre a indexação de workspaces:
  • Ao adicionar workspaces, você verá uma caixa de seleção para ativar a indexação de cada workspace
  • Somente os workspaces com a caixa de seleção ativada serão indexados e ficarão disponíveis no Cascade
  • Isso permite controlar quais workspaces consomem recursos de indexação
  • Por segurança, as chamadas de ferramentas ficam restritas ao workspace ativo

​
Usuários não Enterprise

Usuários não Enterprise têm indexação automática do workspace:
  • Qualquer workspace que você adicionar será indexado automaticamente, sem exigir uma caixa de seleção
  • Todos os workspaces adicionados ficam imediatamente disponíveis para o Cascade
  • As chamadas de ferramentas nunca são bloqueadas fora do workspace ativo
  • O recurso de indexação seletiva não é relevante nesse modelo
Após concluir as etapas de configuração acima, o Cascade deverá conseguir acessar seu workspace e funcionar normalmente.

​
Atalho de teclado não funciona no Rider no Windows

Se você estiver usando o JetBrains Rider no Windows e encontrar um problema em que Shift+Enter não cria uma nova linha no Cascade ou a tecla Delete não funciona, isso é causado por um conflito de atalhos de teclado com a janela Unit Test Tool Window do Rider. Este é um problema conhecido que afeta plugins de IA no Rider. Para resolver isso:
  1. Abra as Configurações da IDE JetBrains em File > Settings
  2. Vá até Keymap
  3. Pesquise por “Unit Test Tool Window Action”
  4. Desative ou reatribua os atalhos de teclado em conflito (Shift+Enter e Delete)
  5. Reinicie a IDE para que as alterações entrem em vigor