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
commit 5f31d2ca88
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
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 @@ 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}
{