LSP serveri

OpenCode se može integrisati sa Language Server Protocol (LSP) serverima kako bi koristio dijagnostiku kao feedback za agenta.

Ugrađeni

OpenCode dolazi sa nekoliko ugrađenih LSP servera za popularne jezike:

LSP je podrazumijevano isključen. Kada je omogućen, serveri se pokreću kada se otkrije jedna od gore navedenih ekstenzija datoteke i zahtjevi su ispunjeni. :::note Možete onemogućiti automatska preuzimanja LSP servera tako što ćete postaviti varijablu okruženja OPENCODE_DISABLE_LSP_DOWNLOAD na true. :::

Kako radi

Kada je LSP omogućen i opencode otvori fajl, on:

1. Provjerava ekstenziju datoteke u odnosu na sve omogućene LSP servere.
2. Pokreće odgovarajući LSP server ako već nije pokrenut.

Najbolje prakse

LSP može pomoći agentu da pronađe i popravi probleme pružanjem dijagnostike iz jezičkih servera. Ovo je korisno u nekim projektima, ali nije uvijek neto pozitivno.

Jezički serveri mogu ispasti iz sinhronizacije, koristiti mnogo memorije, razlikovati se po verziji ili projektu i usporiti agent workflow. U mnogim projektima je bolje da agent direktno pokreće lint, typecheck ili druge dijagnostičke CLI alate, tako da se greške vraćaju u agent loop bez tih kompromisa. Dokumentujte te komande u instrukcijskim fajlovima kao što su AGENTS.md ili skills, kako bi agent znao šta treba pokrenuti. Uključite LSP kada vaš projekt ima koristi od dodatnog feedbacka jezičkog servera.

Konfiguracija

Možete omogućiti i prilagoditi LSP servere kroz lsp odjeljak u vašoj opencode konfiguraciji.

Da biste omogućili sve ugrađene LSP servere, postavite lsp na true.

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

Koristite objekt da zadržite ugrađene servere omogućene dok konfigurirate izmjene ili prilagođene servere.

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

Svaki LSP server podržava sljedeće:

Pogledajmo neke primjere.

Varijable okruženja

Koristite svojstvo env za postavljanje varijabli okruženja prilikom pokretanja LSP servera:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "rust": {
      "env": {
        "RUST_LOG": "debug"
      }
    }
  }
}

Opcije inicijalizacije

Koristite svojstvo initialization da prosledite opcije inicijalizacije na LSP server. Ovo su postavke specifične za server poslane tokom LSP initialize zahtjeva:

{
  "$schema": "https://opencode.ai/config.json",
  "lsp": {
    "typescript": {
      "initialization": {
        "preferences": {
          "importModuleSpecifierPreference": "relative"
        }
      }
    }
  }
}

:::note Opcije inicijalizacije razlikuju se od LSP servera. Provjerite dokumentaciju vašeg LSP servera za dostupne opcije. :::

Onemogućavanje LSP servera

Ako je lsp izostavljen, svi LSP serveri su onemogućeni. Da biste onemogućili sve LSP servere nakon što ih je druga konfiguracija omogućila, postavite lsp na false:

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

Da onemogućite specifičan LSP server, postavite disabled na true:

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

Prilagođeni LSP serveri

Možete dodati prilagođene LSP servere navodeći ekstenzije naredbe i datoteke:

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

Dodatne informacije

PHP Intelephense

PHP Intelephense nudi vrhunske funkcije putem licencnog ključa. Možete dati licencni ključ postavljanjem (samo) ključa u tekstualnu datoteku na:

• Na macOS/Linuxu: $HOME/intelephense/license.txt
• Na Windowsima: %USERPROFILE%/intelephense/license.txt Datoteka treba da sadrži samo licencni ključ bez dodatnog sadržaja.