docs(web): update LSP docs wording (#29435)

Co-authored-by: starptech <starptech@starptechs-MBP.fritz.box>
This commit is contained in:
Dustin Deus
2026-05-26 19:59:51 +02:00
committed by GitHub
parent afdae3950a
commit 5f31d2ca88
18 changed files with 418 additions and 87 deletions

View File

@@ -3,7 +3,7 @@ title: خوادم LSP
description: يتكامل OpenCode مع خوادم LSP لديك.
---
يتكامل OpenCode مع بروتوكول خادم اللغة (LSP) لمساعدة LLM على التفاعل مع قاعدة الشيفرة لديك. ويستخدم التشخيصات لتزويد LLM بتغذية راجعة.
يمكن أن يتكامل OpenCode مع خوادم Language Server Protocol (LSP) لاستخدام التشخيصات كملاحظات للوكيل.
---
@@ -46,7 +46,7 @@ description: يتكامل OpenCode مع خوادم LSP لديك.
| yaml-ls | .yaml, .yml | يثبت `yaml-language-server` من Red Hat تلقائيا |
| zls | .zig, .zon | توفر أمر `zig` |
تُفعَّل خوادم LSP تلقائيا عند اكتشاف أحد امتدادات الملفات المذكورة أعلاه واستيفاء المتطلبات.
تكون ميزة LSP معطلة افتراضيا. عند تفعيلها، تبدأ الخوادم عند اكتشاف أحد امتدادات الملفات المذكورة أعلاه واستيفاء المتطلبات.
:::note
يمكنك تعطيل تنزيلات خوادم LSP التلقائية عبر ضبط متغير البيئة `OPENCODE_DISABLE_LSP_DOWNLOAD` على `true`.
@@ -56,16 +56,35 @@ description: يتكامل OpenCode مع خوادم LSP لديك.
## كيف يعمل
عندما يفتح opencode ملفا، فإنه:
عند تفعيل LSP وفتح opencode لملف، فإنه:
1. يفحص امتداد الملف مقابل جميع خوادم LSP المفعّلة.
2. يشغّل خادم LSP المناسب إذا لم يكن قيد التشغيل بالفعل.
---
## أفضل الممارسات
يمكن أن تساعد LSP الوكيل على العثور على المشاكل وإصلاحها عبر توفير التشخيصات من خوادم اللغة. هذا مفيد في بعض المشاريع، لكنه ليس دائما مكسبا صافيا.
قد تخرج خوادم اللغة عن المزامنة، وتستهلك ذاكرة كبيرة، وتختلف حسب الإصدار أو المشروع، وتبطئ سير عمل الوكيل. في كثير من المشاريع، يكون من الأفضل أن يشغّل الوكيل lint أو typecheck أو أدوات CLI التشخيصية الأخرى مباشرة، بحيث تعود الأخطاء إلى حلقة الوكيل دون هذه المفاضلات. فعّل LSP عندما يستفيد مشروعك من ملاحظات إضافية من خادم اللغة.
---
## الإعداد
يمكنك تخصيص خوادم LSP عبر قسم `lsp` في إعدادات opencode.
يمكنك تفعيل خوادم LSP وتخصيصها عبر قسم `lsp` في إعدادات opencode.
لتفعيل جميع خوادم LSP المدمجة، اضبط `lsp` على `true`.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
استخدم كائنا لإبقاء الخوادم المدمجة مفعلة أثناء إعداد التجاوزات أو الخوادم المخصصة.
```json title="opencode.json"
{
@@ -134,7 +153,7 @@ description: يتكامل OpenCode مع خوادم LSP لديك.
### تعطيل خوادم LSP
لتعطيل **جميع** خوادم LSP على مستوى التطبيق، اضبط `lsp` على `false`:
إذا تم حذف `lsp`، فستكون جميع خوادم LSP معطلة. لتعطيل جميع خوادم LSP بعد أن فعّلها إعداد آخر، اضبط `lsp` على `false`:
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: LSP serveri
description: OpenCode se integriše sa vašim LSP serverima.
---
OpenCode se integriše sa vašim Language Server Protocol (LSP) serverima kako bi pomogao LLM-u u interakciji s kodnom bazom. Koristi dijagnostiku za slanje povratnih informacija modelu.
OpenCode se može integrisati sa Language Server Protocol (LSP) serverima kako bi koristio dijagnostiku kao feedback za agenta.
## Ugrađeni
@@ -45,7 +45,7 @@ OpenCode dolazi sa nekoliko ugrađenih LSP servera za popularne jezike:
| yaml-ls | .yaml, .yml | Automatski instalira Red Hat yaml-language-server |
| zls | .zig, .zon | `zig` komanda dostupna |
LSP serveri su automatski omogućeni kada se otkrije jedna od gore navedenih ekstenzija datoteke i zahtjevi su ispunjeni.
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`.
:::
@@ -54,16 +54,35 @@ Možete onemogućiti automatska preuzimanja LSP servera tako što ćete postavit
## Kako radi
Kada opencode otvori fajl, on:
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. Uključite LSP kada vaš projekt ima koristi od dodatnog feedbacka jezičkog servera.
---
## Konfiguracija
Možete prilagoditi LSP servere kroz `lsp` odjeljak u vašoj opencode konfiguraciji.
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`.
```json title="opencode.json"
{
"$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.
```json title="opencode.json"
{
@@ -132,7 +151,7 @@ Opcije inicijalizacije razlikuju se od LSP servera. Provjerite dokumentaciju va
### Onemogućavanje LSP servera
Da biste onemogućili **sve** LSP servere globalno, postavite `lsp` na `false`:
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`:
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: LSP-servere
description: OpenCode integreres med dine LSP-servere.
---
OpenCode integreres med Language Server Protocol (LSP) for at hjælpe LLM med at interagere med din kodebase. Den bruger diagnostik til at give feedback til LLM.
OpenCode kan integreres med Language Server Protocol (LSP)-servere for at bruge diagnostik som feedback til agenten.
---
@@ -47,7 +47,7 @@ OpenCode leveres med flere indbyggede LSP-servere til populære sprog:
| yaml-ls | .yaml,.yml | Autoinstallerer Red Hat yaml-language-server |
| zls | .zig,.zon | `zig` kommando tilgængelig |
LSP-servere aktiveres automatisk, når en af ovenstående filtypenavne opdages, og kravene er opfyldt.
LSP er deaktiveret som standard. Når det er aktiveret, starter servere, når en af ovenstående filtypenavne opdages, og kravene er opfyldt.
:::note
Du kan deaktivere automatisk LSP-serverdownloads ved at indstille miljøvariablen `OPENCODE_DISABLE_LSP_DOWNLOAD` til `true`.
@@ -57,16 +57,35 @@ Du kan deaktivere automatisk LSP-serverdownloads ved at indstille miljøvariable
## Sådan fungerer det
Når opencode åbner en fil, vil den:
Når LSP er aktiveret, og opencode åbner en fil, vil den:
1. Kontrollerer filtypenavnet mod alle aktiverede LSP-servere.
2. Starter den relevante LSP-server, hvis den ikke allerede kører.
---
## Bedste praksis
LSP kan hjælpe agenten med at finde og rette problemer ved at levere diagnostik fra sprogservere. Det er nyttigt i nogle projekter, men er ikke altid en klar fordel.
Sprogservere kan komme ud af sync, bruge meget hukommelse, variere efter version eller projekt og gøre agentarbejdsgange langsommere. I mange projekter er det bedre, at agenten kører lint, typecheck eller andre diagnostiske CLI-værktøjer direkte, så fejl føres tilbage i agentens loop uden disse afvejninger. Aktivér LSP, når dit projekt har gavn af ekstra sprogserverfeedback.
---
## Konfiguration
Du kan tilpasse LSP-servere gennem sektionen `lsp` i din opencode-konfiguration.
Du kan aktivere og tilpasse LSP-servere gennem sektionen `lsp` i din opencode-konfiguration.
For at aktivere alle indbyggede LSP-servere skal du indstille `lsp` til `true`.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
Brug et objekt til at holde indbyggede servere aktiveret, mens du konfigurerer tilsidesættelser eller brugerdefinerede servere.
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ Initialiseringsmuligheder forskellige afhængige af LSP-serveren. Se din LSP-ser
### Deaktivering af LSP-servere
For at deaktivere **alle** LSP-servere globalt, skal du indstille `lsp` til `false`:
Hvis `lsp` udelades, er alle LSP-servere deaktiveret. For at deaktivere alle LSP-servere efter at en anden konfiguration har aktiveret dem, skal du indstille `lsp` til `false`:
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: LSP Server
description: OpenCode lässt sich in Ihren LSP-Server integrieren.
---
OpenCode lässt sich in Ihr Language Server Protocol (LSP) integrieren, um die Interaktion von LLM mit Ihrer Codebasis zu unterstützen. Es verwendet Diagnosefunktionen, um dem LLM Feedback zu geben.
OpenCode kann sich in Language Server Protocol (LSP)-Server integrieren, um Diagnosen als Feedback für den Agenten zu verwenden.
---
@@ -46,7 +46,7 @@ OpenCode verfügt über mehrere integrierte LSP-Server für gängige Sprachen:
| yaml-ls | .yaml, .yml | Installiert den Red Hat yaml-language-server automatisch |
| zls | .zig, .zon | `zig`-Befehl verfügbar |
LSP-Server werden automatisch aktiviert, wenn eine der oben genannten Dateierweiterungen erkannt wird und die Anforderungen erfüllt sind.
LSP ist standardmäßig deaktiviert. Wenn es aktiviert ist, starten Server, sobald eine der oben genannten Dateierweiterungen erkannt wird und die Anforderungen erfüllt sind.
:::note
Sie können LSP-Server-Downloads automatisch deaktivieren, indem Sie die Umgebungsvariable `OPENCODE_DISABLE_LSP_DOWNLOAD` auf `true` setzen.
@@ -56,16 +56,35 @@ Sie können LSP-Server-Downloads automatisch deaktivieren, indem Sie die Umgebun
## Funktionsweise
Wenn OpenCode eine Datei öffnet, geschieht Folgendes:
Wenn LSP aktiviert ist und OpenCode eine Datei öffnet, geschieht Folgendes:
1. Überprüft die Dateierweiterung anhand aller aktivierten LSP-Server.
2. Startet den entsprechenden LSP-Server, falls er noch nicht ausgeführt wird.
---
## Bewährte Praktiken
LSP kann dem Agenten helfen, Probleme zu finden und zu beheben, indem es Diagnosen von Sprachservern bereitstellt. Das ist in einigen Projekten nützlich, aber nicht immer ein klarer Vorteil.
Sprachserver können aus dem Sync geraten, viel Speicher verwenden, je nach Version oder Projekt unterschiedlich arbeiten und Agent-Workflows verlangsamen. In vielen Projekten ist es besser, wenn der Agent lint, typecheck oder andere diagnostische CLI-Tools direkt ausführt, damit Fehler in die Agent-Schleife zurückfließen, ohne diese Kompromisse einzugehen. Aktivieren Sie LSP, wenn Ihr Projekt von zusätzlichem Sprachserver-Feedback profitiert.
---
## Konfiguration
Sie können LSP-Server über den Abschnitt `lsp` in Ihrer OpenCode-Konfiguration anpassen.
Sie können LSP-Server über den Abschnitt `lsp` in Ihrer OpenCode-Konfiguration aktivieren und anpassen.
Um alle integrierten LSP-Server zu aktivieren, setzen Sie `lsp` auf `true`.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
Verwenden Sie ein Objekt, um integrierte Server aktiviert zu lassen und gleichzeitig Überschreibungen oder benutzerdefinierte Server zu konfigurieren.
```json title="opencode.json"
{
@@ -134,7 +153,7 @@ Die Initialisierungsoptionen variieren je nach LSP-Server. Überprüfen Sie die
### Deaktivieren von LSP-Servern
Um **alle** LSP-Server global zu deaktivieren, setzen Sie `lsp` auf `false`:
Wenn `lsp` ausgelassen wird, sind alle LSP-Server deaktiviert. Um alle LSP-Server zu deaktivieren, nachdem sie durch eine andere Konfiguration aktiviert wurden, setzen Sie `lsp` auf `false`:
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: Servidores LSP
description: OpenCode se integra con sus servidores LSP.
---
OpenCode se integra con su protocolo de servidor de idiomas (LSP) para ayudar a LLM a interactuar con su código base. Utiliza diagnósticos para proporcionar retroalimentación al LLM.
OpenCode puede integrarse con servidores Language Server Protocol (LSP) para usar diagnósticos como feedback para el agente.
---
@@ -47,7 +47,7 @@ OpenCode viene con varios servidores LSP integrados para idiomas populares:
| yaml-ls | .yaml, .yml | Autoinstala Red Hat yaml-language-server |
| zls | .zig, .zon | Comando `zig` disponible |
Los servidores LSP se habilitan automáticamente cuando se detecta una de las extensiones de archivo anteriores y se cumplen los requisitos.
LSP está deshabilitado por defecto. Cuando está habilitado, los servidores se inician cuando se detecta una de las extensiones de archivo anteriores y se cumplen los requisitos.
:::note
Puede deshabilitar las descargas automáticas del servidor LSP configurando la variable de entorno `OPENCODE_DISABLE_LSP_DOWNLOAD` en `true`.
@@ -57,16 +57,35 @@ Puede deshabilitar las descargas automáticas del servidor LSP configurando la v
## Cómo funciona
Cuando opencode abre un archivo:
Cuando LSP está habilitado y opencode abre un archivo:
1. Comprueba la extensión del archivo con todos los servidores LSP habilitados.
2. Inicia el servidor LSP apropiado si aún no se está ejecutando.
---
## Buenas prácticas
LSP puede ayudar al agente a encontrar y corregir problemas proporcionando diagnósticos de los servidores de lenguaje. Esto es útil en algunos proyectos, pero no siempre es una mejora neta.
Los servidores de lenguaje pueden desincronizarse, usar bastante memoria, variar según la versión o el proyecto y ralentizar los flujos de trabajo del agente. En muchos proyectos es mejor hacer que el agente ejecute lint, typecheck u otras herramientas CLI de diagnóstico directamente, para que los errores vuelvan al ciclo del agente sin esas compensaciones. Habilita LSP cuando tu proyecto se beneficie de feedback adicional del servidor de lenguaje.
---
## Configuración
Puede personalizar los servidores LSP a través de la sección `lsp` en su configuración opencode.
Puede habilitar y personalizar los servidores LSP a través de la sección `lsp` en su configuración opencode.
Para habilitar todos los servidores LSP integrados, configure `lsp` como `true`.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
Use un objeto para mantener habilitados los servidores integrados mientras configura anulaciones o servidores personalizados.
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ Las opciones de inicialización varían según el servidor LSP. Consulte la docu
### Deshabilitar servidores LSP
Para deshabilitar **todos** los servidores LSP globalmente, configure `lsp` en `false`:
Si se omite `lsp`, todos los servidores LSP están deshabilitados. Para deshabilitar todos los servidores LSP después de que otra configuración los haya habilitado, configure `lsp` en `false`:
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: Serveurs LSP
description: OpenCode s'intègre à vos serveurs LSP.
---
OpenCode s'intègre via le protocole LSP (Language Server Protocol) pour aider le LLM à interagir avec votre base de code. Il utilise des diagnostics pour fournir des commentaires au LLM.
OpenCode peut s'intégrer aux serveurs Language Server Protocol (LSP) pour utiliser les diagnostics comme retour pour l'agent.
---
@@ -47,7 +47,7 @@ OpenCode est livré avec plusieurs serveurs LSP intégrés pour les langages pop
| yaml-ls | .yaml, .yml | Installe automatiquement le serveur yaml-language-server de Red Hat |
| zls | .zig, .zon | Commande `zig` disponible |
Les serveurs LSP sont automatiquement activés lorsque l'une des extensions de fichier ci-dessus est détectée et que les exigences sont remplies.
LSP est désactivé par défaut. Lorsqu'il est activé, les serveurs démarrent lorsqu'une des extensions de fichier ci-dessus est détectée et que les exigences sont remplies.
:::note
Vous pouvez désactiver les téléchargements automatiques du serveur LSP en définissant la variable d'environnement `OPENCODE_DISABLE_LSP_DOWNLOAD` sur `true`.
@@ -57,16 +57,35 @@ Vous pouvez désactiver les téléchargements automatiques du serveur LSP en dé
## Comment ça marche
Lorsque opencode ouvre un fichier, il :
Lorsque LSP est activé et qu'opencode ouvre un fichier, il :
1. Vérifie l'extension du fichier par rapport à tous les serveurs LSP activés.
2. Démarre le serveur LSP approprié s'il n'est pas déjà en cours d'exécution.
---
## Bonnes pratiques
LSP peut aider l'agent à trouver et corriger des problèmes en fournissant les diagnostics des serveurs de langage. C'est utile dans certains projets, mais ce n'est pas toujours un gain net.
Les serveurs de langage peuvent se désynchroniser, consommer beaucoup de mémoire, varier selon la version ou le projet, et ralentir les flux de travail de l'agent. Dans de nombreux projets, il est préférable de faire exécuter directement par l'agent le lint, le typecheck ou d'autres outils CLI de diagnostic, afin que les erreurs reviennent dans la boucle de l'agent sans ces compromis. Activez LSP lorsque votre projet bénéficie d'un retour supplémentaire des serveurs de langage.
---
## Configuration
Vous pouvez personnaliser les serveurs LSP via la section `lsp` de votre configuration opencode.
Vous pouvez activer et personnaliser les serveurs LSP via la section `lsp` de votre configuration opencode.
Pour activer tous les serveurs LSP intégrés, définissez `lsp` sur `true`.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
Utilisez un objet pour conserver les serveurs intégrés activés tout en configurant des remplacements ou des serveurs personnalisés.
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ Les options d'initialisation varient selon le serveur LSP. Consultez la document
### Désactivation des serveurs LSP
Pour désactiver **tous** les serveurs LSP globalement, définissez `lsp` sur `false` :
Si `lsp` est omis, tous les serveurs LSP sont désactivés. Pour désactiver tous les serveurs LSP après qu'une autre configuration les a activés, définissez `lsp` sur `false` :
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: Server LSP
description: OpenCode si integra con i tuoi server LSP.
---
OpenCode si integra con il tuo Language Server Protocol (LSP) per aiutare l'LLM a interagire con la tua codebase. Usa le diagnostiche per fornire feedback all'LLM.
OpenCode può integrarsi con server Language Server Protocol (LSP) per usare la diagnostica come feedback per l'agente.
---
@@ -47,7 +47,7 @@ OpenCode include diversi server LSP integrati per linguaggi popolari:
| yaml-ls | .yaml, .yml | Installazione automatica di Red Hat yaml-language-server |
| zls | .zig, .zon | comando `zig` disponibile |
I server LSP vengono abilitati automaticamente quando viene rilevata una delle estensioni qui sopra e i requisiti sono soddisfatti.
LSP è disabilitato per impostazione predefinita. Quando è abilitato, i server si avviano quando viene rilevata una delle estensioni qui sopra e i requisiti sono soddisfatti.
:::note
Puoi disabilitare il download automatico dei server LSP impostando la variabile d'ambiente `OPENCODE_DISABLE_LSP_DOWNLOAD` a `true`.
@@ -57,16 +57,35 @@ Puoi disabilitare il download automatico dei server LSP impostando la variabile
## Come funziona
Quando opencode apre un file:
Quando LSP è abilitato e opencode apre un file:
1. Controlla l'estensione del file rispetto a tutti i server LSP abilitati.
2. Avvia il server LSP appropriato se non e gia in esecuzione.
---
## Buone pratiche
LSP può aiutare l'agente a trovare e correggere problemi fornendo diagnostica dai server di linguaggio. Questo è utile in alcuni progetti, ma non è sempre un vantaggio netto.
I server di linguaggio possono andare fuori sincronizzazione, usare molta memoria, variare in base alla versione o al progetto e rallentare i workflow dell'agente. In molti progetti è meglio far eseguire direttamente all'agente lint, typecheck o altri strumenti CLI diagnostici, così gli errori rientrano nel ciclo dell'agente senza questi compromessi. Abilita LSP quando il tuo progetto trae beneficio da feedback aggiuntivo del server di linguaggio.
---
## Configura
Puoi personalizzare i server LSP tramite la sezione `lsp` nella configurazione di opencode.
Puoi abilitare e personalizzare i server LSP tramite la sezione `lsp` nella configurazione di opencode.
Per abilitare tutti i server LSP integrati, imposta `lsp` a `true`.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
Usa un oggetto per mantenere abilitati i server integrati mentre configuri override o server personalizzati.
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ Le opzioni di inizializzazione variano da server a server. Consulta la documenta
### Disabilitare i server LSP
Per disabilitare **tutti** i server LSP globalmente, imposta `lsp` a `false`:
Se `lsp` è omesso, tutti i server LSP sono disabilitati. Per disabilitare tutti i server LSP dopo che un'altra configurazione li ha abilitati, imposta `lsp` a `false`:
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: LSPサーバー
description: OpenCode は LSP サーバーと統合します。
---
OpenCode は言語サーバープロトコル (LSP) と統合して、LLM がコードベースと対話できるようにします。診断を使用して LLM にフィードバックを提供します。
OpenCode は Language Server Protocol (LSP) サーバーと統合し、診断を agent へのフィードバックとして使用できます。
---
@@ -47,7 +47,7 @@ OpenCode には、一般的な言語用のいくつかの組み込み LSP サー
| yaml-ls | .yaml, .yml | Auto-installs Red Hat yaml-language-server |
| zls | .zig, .zon | `zig` command available |
上記のファイル拡張子のいずれかが検出され、要件が満たされると、LSP サーバーは自動的に有効になります。
LSP はデフォルトで無効です。有効にすると、上記のファイル拡張子のいずれかが検出され、要件が満たされた場合にサーバーが起動します。
:::note
`OPENCODE_DISABLE_LSP_DOWNLOAD` 環境変数を `true` に設定すると、LSP サーバーの自動ダウンロードを無効にできます。
@@ -57,16 +57,35 @@ OpenCode には、一般的な言語用のいくつかの組み込み LSP サー
## 仕組み
OpenCode がファイルを開くと、次のようになります。
LSP が有効で OpenCode がファイルを開くと、次のようになります。
1. 有効なすべての LSP サーバーに対してファイル拡張子をチェックします。
2. 適切な LSP サーバーがまだ実行されていない場合は開始します。
---
## ベストプラクティス
LSP は、言語サーバーの診断を提供することで、agent が問題を見つけて修正する助けになります。これは一部のプロジェクトで有用ですが、常に明確な利点になるとは限りません。
言語サーバーは同期が外れたり、多くのメモリを使用したり、バージョンやプロジェクトによって挙動が変わったり、agent のワークフローを遅くすることがあります。多くのプロジェクトでは、agent に lint、typecheck、その他の診断用 CLI ツールを直接実行させる方が適しています。これにより、これらのトレードオフを避けながら、エラーを agent のループに戻せます。追加の言語サーバーフィードバックが有効な場合に LSP を有効にしてください。
---
## 設定
OpenCode 設定の `lsp` セクションを通じて LSP サーバーをカスタマイズできます。
OpenCode 設定の `lsp` セクションを通じて LSP サーバーを有効化し、カスタマイズできます。
すべての組み込み LSP サーバーを有効にするには、`lsp` を `true` に設定します。
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
オブジェクトを使用すると、組み込みサーバーを有効にしたまま、上書き設定やカスタムサーバーを設定できます。
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ LSP サーバーの起動時に `env` プロパティを使用して環境変数
### LSPサーバーの無効化
**すべて** LSP サーバーをグローバルに無効にするには、`lsp` を `false` に設定します。
`lsp` を省略すると、すべて LSP サーバーは無効になります。別の設定で有効化されたすべての LSP サーバーを無効にするには、`lsp` を `false` に設定します。
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: LSP 서버
description: OpenCode는 LSP 서버와 통합됩니다.
---
OpenCode는 Language Server Protocol(LSP)과 통합되어 LLM이 코드베이스와 상호작용하도록 돕습니다. 진단 정보를 활용해 LLM에 피드백을 제공합니다.
OpenCode는 Language Server Protocol(LSP) 서버와 통합해 진단 정보를 agent의 피드백으로 사용할 수 있습니다.
---
@@ -47,7 +47,7 @@ OpenCode는 널리 사용되는 언어를 위해 여러 built-in LSP 서버를
| yaml-ls | .yaml, .yml | Red Hat `yaml-language-server` 자동 설치 |
| zls | .zig, .zon | `zig` 명령 사용 가능 |
위 확장자 중 하나가 감지되고 요구 사항이 충족되면 LSP 서버가 자동으로 활성화됩니다.
LSP는 기본적으로 비활성화되어 있습니다. 활성화하면 위 확장자 중 하나가 감지되고 요구 사항이 충족될 때 서버가 시작됩니다.
:::note
`OPENCODE_DISABLE_LSP_DOWNLOAD` 환경 변수를 `true`로 설정하면 LSP 서버 자동 다운로드를 비활성화할 수 있습니다.
@@ -57,16 +57,35 @@ OpenCode는 널리 사용되는 언어를 위해 여러 built-in LSP 서버를
## 작동 방식
OpenCode가 파일을 열면 다음과 같이 동작합니다.
LSP가 활성화되어 있고 OpenCode가 파일을 열면 다음과 같이 동작합니다.
1. 활성화된 모든 LSP 서버에 대해 파일 확장자를 확인합니다.
2. 적절한 LSP 서버가 아직 실행 중이지 않다면 시작합니다.
---
## 모범 사례
LSP는 언어 서버의 진단을 제공해 agent가 문제를 찾고 수정하는 데 도움을 줄 수 있습니다. 일부 프로젝트에서는 유용하지만 항상 순이익이 되는 것은 아닙니다.
언어 서버는 동기화가 어긋나거나 많은 메모리를 사용하거나 버전 또는 프로젝트에 따라 다르게 동작하고 agent 워크플로를 느리게 만들 수 있습니다. 많은 프로젝트에서는 agent가 lint, typecheck 또는 다른 진단용 CLI 도구를 직접 실행하게 하는 편이 더 좋습니다. 이렇게 하면 이러한 트레이드오프 없이 오류가 agent 루프로 다시 전달됩니다. 프로젝트가 추가 언어 서버 피드백의 이점을 얻을 때 LSP를 활성화하세요.
---
## 구성
OpenCode config의 `lsp` 섹션에서 LSP 서버를 사용자 정의할 수 있습니다.
OpenCode config의 `lsp` 섹션에서 LSP 서버를 활성화하고 사용자 정의할 수 있습니다.
모든 내장 LSP 서버를 활성화하려면 `lsp`를 `true`로 설정하세요.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
객체를 사용하면 내장 서버를 활성화한 상태로 유지하면서 오버라이드나 사용자 정의 서버를 구성할 수 있습니다.
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ OpenCode config의 `lsp` 섹션에서 LSP 서버를 사용자 정의할 수 있
### LSP 서버 비활성화
전역에서 **모든** LSP 서버를 비활성화하려면 `lsp`를 `false`로 설정하세요.
`lsp`를 생략하면 모든 LSP 서버가 비활성화됩니다. 다른 config에서 활성화한 모든 LSP 서버를 비활성화하려면 `lsp`를 `false`로 설정하세요.
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: LSP Servers
description: OpenCode integrates with your LSP servers.
---
OpenCode can integrate with your Language Server Protocol (LSP) to help the LLM interact with your codebase. It uses diagnostics to provide feedback to the LLM.
OpenCode can integrate with Language Server Protocol (LSP) servers to use diagnostics as feedback for the agent.
---
@@ -48,7 +48,7 @@ OpenCode comes with several built-in LSP servers for popular languages:
| yaml-ls | .yaml, .yml | Auto-installs Red Hat yaml-language-server |
| zls | .zig, .zon | `zig` command available |
When LSP is enabled, servers start when one of the above file extensions is detected and the requirements are met.
LSP is disabled by default. When enabled, servers start when one of the above file extensions is detected and the requirements are met.
:::note
You can disable automatic LSP server downloads by setting the `OPENCODE_DISABLE_LSP_DOWNLOAD` environment variable to `true`.
@@ -65,6 +65,14 @@ When LSP is enabled and opencode opens a file, it:
---
## Best Practices
LSP can help the agent find and fix issues by providing diagnostics from language servers. This is useful in some projects, but it is not always a net positive.
Language servers can get out of sync, use significant memory, vary by version or project, and slow down agent workflows. In many projects it is better to have the agent run lint, typecheck, or other diagnostic CLI tools directly, so errors are fed back into the agent loop without those tradeoffs. Enable LSP when your project benefits from additional language-server feedback.
---
## Configure
You can enable and customize LSP servers through the `lsp` section in your opencode config.

View File

@@ -3,7 +3,7 @@ title: LSP-servere
description: opencode integreres med LSP-serverne dine.
---
OpenCode integreres med din Language Server Protocol (LSP) for å hjelpe LLM med å samhandle med kodebasen din. Den bruker diagnostikk for å gi tilbakemelding til LLM.
OpenCode kan integreres med Language Server Protocol (LSP)-servere for å bruke diagnostikk som tilbakemelding til agenten.
---
@@ -47,7 +47,7 @@ OpenCode kommer med flere innebygde LSP-servere for populære språk:
| yaml-ls | .yaml, .yml | Installerer Red Hat yaml-language-server automatisk |
| zls | .zig, .zon | `zig` kommando tilgjengelig |
LSP-servere aktiveres automatisk når en av filtypene ovenfor oppdages og kravene oppfylles.
LSP er deaktivert som standard. Når det er aktivert, starter servere når en av filtypene ovenfor oppdages og kravene oppfylles.
:::note
Du kan deaktivere automatiske LSP-servernedlastinger ved å sette miljøvariabelen `OPENCODE_DISABLE_LSP_DOWNLOAD` til `true`.
@@ -57,16 +57,35 @@ Du kan deaktivere automatiske LSP-servernedlastinger ved å sette miljøvariabel
## Slik fungerer det
Når opencode åpner en fil, gjør den:
Når LSP er aktivert og opencode åpner en fil, gjør den:
1. Kontrollerer filtypen mot alle aktiverte LSP-servere.
2. Starter den riktige LSP-serveren hvis den ikke allerede kjører.
---
## Beste praksis
LSP kan hjelpe agenten med å finne og fikse problemer ved å gi diagnostikk fra språkservere. Dette er nyttig i noen prosjekter, men er ikke alltid en klar gevinst.
Språkservere kan komme ut av synk, bruke mye minne, variere etter versjon eller prosjekt og redusere agentarbeidsflyter. I mange prosjekter er det bedre at agenten kjører lint, typecheck eller andre diagnostiske CLI-verktøy direkte, slik at feil mates tilbake i agentløkken uten disse avveiningene. Aktiver LSP når prosjektet ditt har nytte av ekstra språkservertilbakemelding.
---
## Konfigurasjon
Du kan tilpasse LSP-servere gjennom `lsp`-delen i OpenCode-konfigurasjonen.
Du kan aktivere og tilpasse LSP-servere gjennom `lsp`-delen i OpenCode-konfigurasjonen.
For å aktivere alle innebygde LSP-servere, sett `lsp` til `true`.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
Bruk et objekt for å beholde innebygde servere aktivert mens du konfigurerer overstyringer eller egendefinerte servere.
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ Initialiseringsalternativer varierer etter LSP-server. Sjekk dokumentasjonen til
### Deaktivering av LSP-servere
For å deaktivere **alle** LSP-servere globalt, sett `lsp` til `false`:
Hvis `lsp` utelates, er alle LSP-servere deaktivert. For å deaktivere alle LSP-servere etter at en annen konfigurasjon har aktivert dem, sett `lsp` til `false`:
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: Serwery LSP
description: OpenCode integruje się z serwerami LSP.
---
OpenCode integruje się z protokołem Language Server Protocol (LSP), aby zapewnić modelom LLM kontekst bazy kodu. Wykorzystuje diagnostykę, aby przekazywać informacje zwrotne do LLM.
OpenCode może integrować się z serwerami Language Server Protocol (LSP), aby używać diagnostyki jako informacji zwrotnej dla agenta.
---
@@ -47,7 +47,7 @@ OpenCode posiada kilka wbudowanych serwerów LSP dla następujących języków:
| yaml-ls | .yaml, .yml | Automatycznie instaluje serwer języka yaml Red Hat |
| zls | .zig, .zon | Dostępne polecenie `zig` |
Serwery LSP są automatycznie włączane po wykryciu jednego z obsługiwanych plików i spełnieniu wymagań.
LSP jest domyślnie wyłączone. Gdy jest włączone, serwery uruchamiają się po wykryciu jednego z obsługiwanych rozszerzeń plików i spełnieniu wymagań.
:::note
Możesz wyłączyć automatyczne pobieranie serwerów LSP, ustawiając zmienną środowiskową `OPENCODE_DISABLE_LSP_DOWNLOAD` na `true`.
@@ -57,16 +57,35 @@ Możesz wyłączyć automatyczne pobieranie serwerów LSP, ustawiając zmienną
## Jak to działa
Gdy OpenCode otwiera plik:
Gdy LSP jest włączony i OpenCode otwiera plik:
1. Sprawdza plik pod kątem wszystkich dostępnych serwerów LSP.
2. Uruchamia odpowiedni serwer LSP, jeśli jeszcze nie działa.
---
## Dobre praktyki
LSP może pomóc agentowi znajdować i naprawiać problemy, dostarczając diagnostykę z serwerów językowych. Jest to przydatne w niektórych projektach, ale nie zawsze jest jednoznaczną korzyścią.
Serwery językowe mogą wypaść z synchronizacji, zużywać dużo pamięci, różnić się między wersjami lub projektami i spowalniać workflow agenta. W wielu projektach lepiej, aby agent uruchamiał lint, typecheck lub inne diagnostyczne narzędzia CLI bezpośrednio; wtedy błędy wracają do pętli agenta bez tych kompromisów. Włącz LSP, gdy Twój projekt korzysta z dodatkowej informacji zwrotnej z serwera językowego.
---
## Konfiguracja
Możesz dostosować serwery LSP poprzez sekcję `lsp` w konfiguracji OpenCode.
Możesz włączać i dostosowywać serwery LSP poprzez sekcję `lsp` w konfiguracji OpenCode.
Aby włączyć wszystkie wbudowane serwery LSP, ustaw `lsp` na `true`.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
Użyj obiektu, aby pozostawić wbudowane serwery włączone i jednocześnie skonfigurować nadpisania lub serwery niestandardowe.
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ Opcje inicjalizacji różnią się w zależności od serwera LSP. Sprawdź dokum
### Wyłączanie serwerów LSP
Aby wyłączyć **wszystkie** serwery LSP globalnie, ustaw `lsp` na `false`:
Jeśli `lsp` zostanie pominięte, wszystkie serwery LSP są wyłączone. Aby wyłączyć wszystkie serwery LSP po tym, jak inna konfiguracja je włączyła, ustaw `lsp` na `false`:
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: Servidores LSP
description: O opencode integra-se aos seus servidores LSP.
---
O opencode integra-se ao seu Protocolo de Servidor de Linguagem (LSP) para ajudar o LLM a interagir com sua base de código. Ele usa diagnósticos para fornecer feedback ao LLM.
O opencode pode se integrar a servidores Language Server Protocol (LSP) para usar diagnósticos como feedback para o agente.
---
@@ -47,7 +47,7 @@ O opencode vem com vários servidores LSP integrados para linguagens populares:
| yaml-ls | .yaml, .yml | Instala automaticamente o servidor yaml-language-server da Red Hat |
| zls | .zig, .zon | Comando `zig` disponível |
Os servidores LSP são habilitados automaticamente quando uma das extensões de arquivo acima é detectada e os requisitos são atendidos.
O LSP fica desabilitado por padrão. Quando habilitado, os servidores iniciam quando uma das extensões de arquivo acima é detectada e os requisitos são atendidos.
:::note
Você pode desabilitar os downloads automáticos do servidor LSP definindo a variável de ambiente `OPENCODE_DISABLE_LSP_DOWNLOAD` como `true`.
@@ -57,16 +57,35 @@ Você pode desabilitar os downloads automáticos do servidor LSP definindo a var
## Como Funciona
Quando o opencode abre um arquivo, ele:
Quando o LSP está habilitado e o opencode abre um arquivo, ele:
1. Verifica a extensão do arquivo em relação a todos os servidores LSP habilitados.
2. Inicia o servidor LSP apropriado se não estiver em execução.
---
## Boas práticas
O LSP pode ajudar o agente a encontrar e corrigir problemas fornecendo diagnósticos dos servidores de linguagem. Isso é útil em alguns projetos, mas nem sempre é um ganho líquido.
Servidores de linguagem podem ficar fora de sincronia, usar bastante memória, variar por versão ou projeto e desacelerar fluxos de trabalho do agente. Em muitos projetos, é melhor fazer o agente executar lint, typecheck ou outras ferramentas CLI de diagnóstico diretamente, para que os erros voltem ao ciclo do agente sem essas compensações. Habilite o LSP quando seu projeto se beneficiar de feedback adicional do servidor de linguagem.
---
## Configuração
Você pode personalizar os servidores LSP através da seção `lsp` na sua configuração do opencode.
Você pode habilitar e personalizar os servidores LSP através da seção `lsp` na sua configuração do opencode.
Para habilitar todos os servidores LSP integrados, defina `lsp` como `true`.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
Use um objeto para manter os servidores integrados habilitados enquanto configura substituições ou servidores personalizados.
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ As opções de inicialização variam de acordo com o servidor LSP. Verifique a
### Desabilitando servidores LSP
Para desabilitar **todos** os servidores LSP globalmente, defina `lsp` como `false`:
Se `lsp` for omitido, todos os servidores LSP ficam desabilitados. Para desabilitar todos os servidores LSP depois que outra configuração os habilitou, defina `lsp` como `false`:
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: LSP-серверы
description: opencode интегрируется с вашими серверами LSP.
---
opencode интегрируется с вашим протоколом языкового сервера (LSP), чтобы помочь LLM взаимодействовать с вашей кодовой базой. Он использует диагностику для предоставления обратной связи LLM.
opencode может интегрироваться с серверами Language Server Protocol (LSP), чтобы использовать диагностику как обратную связь для агента.
---
@@ -46,7 +46,7 @@ opencode поставляется с несколькими встроенным
| yaml-ls | .yaml, .yml | Автоматически устанавливает Red Hat yaml-language-server |
| zls | .zig, .zon | `zig` команда доступна |
Серверы LSP автоматически включаются при обнаружении одного из указанных выше расширений файлов и выполнении требований.
LSP отключен по умолчанию. Когда он включен, серверы запускаются при обнаружении одного из указанных выше расширений файлов и выполнении требований.
:::note
Вы можете отключить автоматическую загрузку LSP-сервера, установив для переменной среды `OPENCODE_DISABLE_LSP_DOWNLOAD` значение `true`.
@@ -56,16 +56,35 @@ opencode поставляется с несколькими встроенным
## Как это работает
Когда opencode открывает файл, он:
Когда LSP включен и opencode открывает файл, он:
1. Проверяет расширение файла на всех включенных серверах LSP.
2. Запускает соответствующий сервер LSP, если он еще не запущен.
---
## Рекомендации
LSP может помочь агенту находить и исправлять проблемы, предоставляя диагностику от языковых серверов. Это полезно в некоторых проектах, но не всегда является однозначным преимуществом.
Языковые серверы могут рассинхронизироваться, потреблять много памяти, отличаться по поведению между версиями или проектами и замедлять рабочие процессы агента. Во многих проектах лучше, чтобы агент напрямую запускал lint, typecheck или другие диагностические CLI-инструменты; так ошибки возвращаются в цикл агента без этих компромиссов. Включайте LSP, когда проект получает пользу от дополнительной обратной связи языкового сервера.
---
## Настройка
Вы можете настроить серверы LSP через раздел `lsp` в конфигурации opencode.
Вы можете включить и настроить серверы LSP через раздел `lsp` в конфигурации opencode.
Чтобы включить все встроенные LSP-серверы, установите `lsp` в `true`.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
Используйте объект, чтобы оставить встроенные серверы включенными и при этом настроить переопределения или пользовательские серверы.
```json title="opencode.json"
{
@@ -134,7 +153,7 @@ opencode поставляется с несколькими встроенным
### Отключение LSP-серверов
Чтобы отключить **все** LSP-серверы глобально, установите для `lsp` значение `false`:
Если `lsp` не указан, все LSP-серверы отключены. Чтобы отключить все LSP-серверы после того, как другая конфигурация их включила, установите для `lsp` значение `false`:
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: LSP เซิร์ฟเวอร์
description: OpenCode ทำงานร่วมกับเซิร์ฟเวอร์ LSP ของคุณ
---
OpenCode ทำงานร่วมกับ Language Server Protocol (LSP) เพื่อช่วยให้ LLM โต้ตอบกับโค้ดเบสของคุณ ใช้การวินิจฉัยเพื่อให้ข้อเสนอแนะไปยัง LLM
OpenCode สามารถทำงานร่วมกับเซิร์ฟเวอร์ Language Server Protocol (LSP) เพื่อใช้ diagnostics เป็น feedback สำหรับ agent
---
@@ -47,7 +47,7 @@ OpenCode มาพร้อมกับเซิร์ฟเวอร์ LSP ใ
| yaml-ls | .yaml, .yml | ติดตั้งเซิร์ฟเวอร์ภาษา Red Hat yaml โดยอัตโนมัติ |
| zls | .zig, .zon | `zig` คำสั่งใช้ได้ |
เซิร์ฟเวอร์ LSP จะถูกเปิดใช้งานโดยอัตโนมัติเมื่อตรวจพบนามสกุลไฟล์ใดนามสกุลหนึ่งข้างต้นและเป็นไปตามข้อกำหนด
LSP ปิดใช้งานเป็นค่าเริ่มต้น เมื่อเปิดใช้งาน เซิร์ฟเวอร์จะเริ่มทำงานเมื่อตรวจพบนามสกุลไฟล์ข้างต้นและเป็นไปตามข้อกำหนด
:::note
คุณสามารถปิดใช้งานการดาวน์โหลดเซิร์ฟเวอร์ LSP อัตโนมัติได้โดยตั้งค่าตัวแปรสภาพแวดล้อม `OPENCODE_DISABLE_LSP_DOWNLOAD` เป็น `true`
@@ -57,16 +57,35 @@ OpenCode มาพร้อมกับเซิร์ฟเวอร์ LSP ใ
## มันทำงานอย่างไร
เมื่อ opencode เปิดไฟล์ มันจะ:
เมื่อเปิดใช้งาน LSP และ opencode เปิดไฟล์ มันจะ:
1. ตรวจสอบนามสกุลไฟล์กับเซิร์ฟเวอร์ LSP ที่เปิดใช้งานทั้งหมด
2. เริ่มเซิร์ฟเวอร์ LSP ที่เหมาะสมหากยังไม่ได้ทำงาน
---
## แนวทางปฏิบัติที่แนะนำ
LSP สามารถช่วยให้ agent ค้นหาและแก้ไขปัญหาโดยให้ diagnostics จากเซิร์ฟเวอร์ภาษา สิ่งนี้มีประโยชน์ในบางโปรเจ็กต์ แต่ไม่ได้เป็นผลบวกเสมอไป
เซิร์ฟเวอร์ภาษาอาจไม่ตรงกับสถานะโปรเจ็กต์ ใช้หน่วยความจำมาก แตกต่างกันตามเวอร์ชันหรือโปรเจ็กต์ และทำให้เวิร์กโฟลว์ของ agent ช้าลง ในหลายโปรเจ็กต์ การให้ agent รัน lint, typecheck หรือเครื่องมือ CLI สำหรับ diagnostics อื่นโดยตรงจะดีกว่า เพราะข้อผิดพลาดจะถูกส่งกลับเข้า loop ของ agent โดยไม่มีข้อแลกเปลี่ยนเหล่านี้ เปิดใช้งาน LSP เมื่อโปรเจ็กต์ของคุณได้ประโยชน์จาก feedback เพิ่มเติมของเซิร์ฟเวอร์ภาษา
---
## กำหนดค่า
You can customize LSP servers through the `lsp` section in your opencode config.
คุณสามารถเปิดใช้งานและปรับแต่งเซิร์ฟเวอร์ LSP ผ่านส่วน `lsp` ในการกำหนดค่า opencode
หากต้องการเปิดใช้งานเซิร์ฟเวอร์ LSP ในตัวทั้งหมด ให้ตั้งค่า `lsp` เป็น `true`
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
ใช้อ็อบเจ็กต์เพื่อให้เซิร์ฟเวอร์ในตัวยังคงเปิดใช้งานอยู่ พร้อมกำหนดค่าการแทนที่หรือเซิร์ฟเวอร์แบบกำหนดเอง
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ You can customize LSP servers through the `lsp` section in your opencode config.
### ปิดการใช้งานเซิร์ฟเวอร์ LSP
หากต้องการปิดการใช้งานเซิร์ฟเวอร์ **ทั้งหมด** LSP ทั่วโลก ให้ตั้งค่า `lsp` เป็น `false`:
หากละเว้น `lsp` เซิร์ฟเวอร์ LSP ทั้งหมดจะถูกปิดใช้งาน หากการกำหนดค่าอื่นเปิดใช้งาน LSP ไว้ ให้ตั้งค่า `lsp` เป็น `false` เพื่อปิดใช้งานเซิร์ฟเวอร์ LSP ทั้งหมด:
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: LSP Sunucuları
description: OpenCode, LSP sunucularınızla bütünleşir.
---
OpenCode, LLM'in kod tabanınızla etkileşime girmesine yardımcı olmak için Dil Sunucusu Protokolünüzle (LSP) bütünleşir. LLM'ye geri bildirim sağlamak için tanılamayı kullanır.
OpenCode, tanılamayı agent için geri bildirim olarak kullanmak üzere Language Server Protocol (LSP) sunucularıyla bütünleşebilir.
---
@@ -47,7 +47,7 @@ OpenCode, popüler diller için çeşitli yerleşik LSP sunucularıyla birlikte
| yaml-ls | .yaml, .yml | Red Hat yaml-language-server'ı otomatik olarak yükler |
| zls | .zig, .zon | `zig` komutu mevcut |
Yukarıdaki dosya uzantılarından biri tespit edildiğinde ve gereksinimler karşılandığında LSP sunucuları otomatik olarak etkinleştirilir.
LSP varsayılan olarak devre dışıdır. Etkinleştirildiğinde, yukarıdaki dosya uzantılarından biri tespit edilir ve gereksinimler karşılanırsa sunucular başlatılır.
:::note
`OPENCODE_DISABLE_LSP_DOWNLOAD` ortam değişkenini `true` olarak ayarlayarak otomatik LSP sunucu indirmelerini devre dışı bırakabilirsiniz.
@@ -57,16 +57,35 @@ Yukarıdaki dosya uzantılarından biri tespit edildiğinde ve gereksinimler kar
## Nasıl Çalışır?
opencode bir dosyayı açtığında:
LSP etkinleştirildiğinde ve opencode bir dosyayı açtığında:
1. Dosya uzantısını tüm etkin LSP sunucularına göre kontrol eder.
2. Henüz çalışmıyorsa uygun LSP sunucusunu başlatır.
---
## En İyi Uygulamalar
LSP, dil sunucularından tanılama sağlayarak agent'ın sorunları bulup düzeltmesine yardımcı olabilir. Bu bazı projelerde yararlıdır, ancak her zaman net bir kazanç değildir.
Dil sunucuları senkronizasyonu kaybedebilir, önemli miktarda bellek kullanabilir, sürüme veya projeye göre değişebilir ve agent iş akışlarını yavaşlatabilir. Birçok projede agent'ın lint, typecheck veya diğer tanılama CLI araçlarını doğrudan çalıştırması daha iyidir; böylece hatalar bu ödünleşimler olmadan agent döngüsüne geri beslenir. Projeniz ek dil sunucusu geri bildiriminden yararlanıyorsa LSP'yi etkinleştirin.
---
## Yapılandırma
LSP sunucularını, opencode yapılandırmanızdaki `lsp` bölümü aracılığıyla özelleştirebilirsiniz.
LSP sunucularını, opencode yapılandırmanızdaki `lsp` bölümü aracılığıyla etkinleştirebilir ve özelleştirebilirsiniz.
Tüm yerleşik LSP sunucularını etkinleştirmek için `lsp` değerini `true` olarak ayarlayın.
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
Yerleşik sunucuları etkin tutarken geçersiz kılmaları veya özel sunucuları yapılandırmak için bir nesne kullanın.
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ Başlatma seçenekleri LSP sunucusuna göre değişir. Mevcut seçenekler için
### LSP sunucularını devre dışı bırakma
**tüm** LSP sunucularını genel olarak devre dışı bırakmak için `lsp`'yi `false` olarak ayarlayın:
`lsp` atlanırsa tüm LSP sunucuları devre dışı kalır. Başka bir yapılandırma etkinleştirdikten sonra tüm LSP sunucularını devre dışı bırakmak için `lsp` değerini `false` olarak ayarlayın:
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: LSP 服务器
description: OpenCode 与你的 LSP 服务器集成。
---
OpenCode 与你的语言服务器协议LSP集成,帮助 LLM 与你的代码库进行交互。它利用诊断信息向 LLM 提供反馈。
OpenCode 可以与语言服务器协议LSP服务器集成,将诊断信息作为 agent 的反馈。
---
@@ -47,7 +47,7 @@ OpenCode 内置了多种适用于主流语言的 LSP 服务器:
| yaml-ls | .yaml, .yml | 自动安装 Red Hat yaml-language-server |
| zls | .zig, .zon | 需要 `zig` 命令可用 |
当检测到上述文件扩展名且满足相应要求时,LSP 服务器会自动启用
LSP 默认关闭。启用后,当检测到上述文件扩展名且满足相应要求时,服务器会启动
:::note
你可以将 `OPENCODE_DISABLE_LSP_DOWNLOAD` 环境变量设置为 `true` 来禁用 LSP 服务器的自动下载。
@@ -57,16 +57,35 @@ OpenCode 内置了多种适用于主流语言的 LSP 服务器:
## 工作原理
opencode 打开一个文件时,它会:
启用 LSP 且 opencode 打开文件时,它会:
1. 将文件扩展名与所有已启用的 LSP 服务器进行匹配。
2. 如果对应的 LSP 服务器尚未运行,则自动启动它。
---
## 最佳实践
LSP 可以通过语言服务器诊断帮助 agent 发现并修复问题。这对某些项目很有用,但并不总是带来净收益。
语言服务器可能与项目不同步、占用较多内存、随版本或项目表现不同,并拖慢 agent 工作流。在许多项目中,更好的做法是让 agent 直接运行 lint、typecheck 或其他诊断类 CLI 工具,这样错误会进入 agent 循环,同时避免这些权衡。当你的项目能从额外的语言服务器反馈中受益时再启用 LSP。
---
## 配置
你可以通过 opencode 配置文件中的 `lsp` 部分来自定义 LSP 服务器。
你可以通过 opencode 配置文件中的 `lsp` 部分来启用并自定义 LSP 服务器。
要启用所有内置 LSP 服务器,请将 `lsp` 设置为 `true`。
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
使用对象可以在保持内置服务器启用的同时配置覆盖项或自定义服务器。
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ OpenCode 内置了多种适用于主流语言的 LSP 服务器:
### 禁用 LSP 服务器
要全局禁用**所有** LSP 服务器,将 `lsp` 设置为 `false`
如果省略 `lsp`,所有 LSP 服务器都会被禁用。如果另一个配置启用了 LSP将 `lsp` 设置为 `false` 来禁用所有 LSP 服务器
```json title="opencode.json" {3}
{

View File

@@ -3,7 +3,7 @@ title: LSP 伺服器
description: OpenCode 與您的 LSP 伺服器整合。
---
OpenCode 與您的語言伺服器協定LSP整合,協助 LLM 與您的程式碼庫進行互動。它利用診斷資訊向 LLM 提供回饋。
OpenCode 可以與語言伺服器協定LSP伺服器整合,將診斷資訊作為 agent 的回饋。
---
@@ -47,7 +47,7 @@ OpenCode 內建了多種適用於主流語言的 LSP 伺服器:
| yaml-ls | .yaml, .yml | 自動安裝 Red Hat yaml-language-server |
| zls | .zig, .zon | 需要 `zig` 指令可用 |
當偵測到上述檔案副檔名且滿足相應要求時,LSP 伺服器會自動啟用
LSP 預設關閉。啟用後,當偵測到上述檔案副檔名且滿足相應要求時,伺服器會啟動
:::note
您可以將 `OPENCODE_DISABLE_LSP_DOWNLOAD` 環境變數設定為 `true` 來停用 LSP 伺服器的自動下載。
@@ -57,16 +57,35 @@ OpenCode 內建了多種適用於主流語言的 LSP 伺服器:
## 工作原理
OpenCode 開啟一個檔案時,它會:
啟用 LSP 且 OpenCode 開啟檔案時,它會:
1. 將檔案副檔名與所有已啟用的 LSP 伺服器進行比對。
2. 如果對應的 LSP 伺服器尚未執行,則自動啟動它。
---
## 最佳實踐
LSP 可以透過語言伺服器診斷幫助 agent 發現並修復問題。這對某些專案很有用,但不一定總是帶來淨收益。
語言伺服器可能與專案不同步、佔用較多記憶體、隨版本或專案表現不同,並拖慢 agent 工作流程。在許多專案中,更好的做法是讓 agent 直接執行 lint、typecheck 或其他診斷類 CLI 工具,這樣錯誤會回到 agent 循環,同時避免這些取捨。當您的專案能從額外的語言伺服器回饋中受益時再啟用 LSP。
---
## 設定
您可以透過 OpenCode 設定檔中的 `lsp` 部分來自訂 LSP 伺服器。
您可以透過 OpenCode 設定檔中的 `lsp` 部分來啟用並自訂 LSP 伺服器。
要啟用所有內建 LSP 伺服器,請將 `lsp` 設定為 `true`。
```json title="opencode.json"
{
"$schema": "https://opencode.ai/config.json",
"lsp": true
}
```
使用物件可以在保持內建伺服器啟用的同時設定覆寫項或自訂伺服器。
```json title="opencode.json"
{
@@ -135,7 +154,7 @@ OpenCode 內建了多種適用於主流語言的 LSP 伺服器:
### 停用 LSP 伺服器
要全域停用**所有** LSP 伺服器,將 `lsp` 設定為 `false`
如果省略 `lsp`,所有 LSP 伺服器都會被停用。如果另一個設定啟用了 LSP將 `lsp` 設定為 `false` 來停用所有 LSP 伺服器
```json title="opencode.json" {3}
{