Servidores LSP

O OpenCode se integra aos seus servidores LSP.

O OpenCode pode se integrar ao seu Language Server Protocol (LSP) para ajudar o LLM a interagir com sua base de código. Ele usa diagnósticos para fornecer feedback ao LLM.

Integrados

O OpenCode vem com vários servidores LSP integrados para linguagens populares:

Quando o LSP está habilitado, os servidores iniciam quando uma das extensões de arquivo acima é detectada e os requisitos são atendidos.

Nota: Você pode desabilitar os downloads automáticos de servidores LSP definindo a variável de ambiente OPENCODE_DISABLE_LSP_DOWNLOAD como true.

Como Funciona

Quando o LSP está habilitado e o opencode abre um arquivo, ele:

1. Verifica a extensão do arquivo contra todos os servidores LSP habilitados.
2. Inicia o servidor LSP apropriado se ainda não estiver em execução.

Configurar

Você pode habilitar e personalizar servidores LSP através da seção lsp na sua config do opencode.

Para habilitar todos os servidores LSP integrados, defina lsp como true.

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": true
}

Use um objeto para manter os integrados habilitados enquanto configura substituições ou servidores personalizados.

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {}
}

Cada entrada de servidor LSP configurada oferece suporte ao seguinte:

As entradas de servidor precisam de command, a menos que apenas desabilitem um servidor.

Vamos ver alguns exemplos.

Variáveis de ambiente

Use a propriedade env para definir variáveis de ambiente ao iniciar o servidor LSP:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "rust": {
      "command": ["rust-analyzer"],
      "env": {
        "RUST_LOG": "debug"
      }
    }
  }
}

Opções de inicialização

Use a propriedade initialization para passar opções de inicialização ao servidor LSP. Estas são configurações específicas do servidor enviadas durante a requisição initialize do LSP:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "custom-lsp": {
      "command": ["custom-lsp-server", "--stdio"],
      "extensions": [".custom"],
      "initialization": {
        "preferences": {
          "importModuleSpecifierPreference": "relative"
        }
      }
    }
  }
}

Nota: As opções de inicialização variam conforme o servidor LSP. Verifique a documentação do seu servidor LSP para as opções disponíveis.

Desabilitando servidores LSP

Se lsp for omitido, todos os servidores LSP ficam desabilitados. Para desabilitar todos os servidores LSP depois que outra config os habilitou, defina lsp como false:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": false
}

Para desabilitar um servidor LSP específico, defina disabled como true:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "disabled": true
    }
  }
}

Servidores LSP personalizados

Você pode adicionar servidores LSP personalizados especificando o comando e as extensões de arquivo:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "custom-lsp": {
      "command": ["custom-lsp-server", "--stdio"],
      "extensions": [".custom"]
    }
  }
}

Informações Adicionais

PHP Intelephense

O PHP Intelephense oferece recursos premium através de uma chave de licença. Você pode fornecer uma chave de licença colocando (apenas) a chave em um arquivo de texto em:

• No macOS/Linux: $HOME/intelephense/license.txt
• No Windows: %USERPROFILE%/intelephense/license.txt

O arquivo deve conter apenas a chave de licença, sem nenhum conteúdo adicional.