docs(web): update LSP docs wording (#29435)
Co-authored-by: starptech <starptech@starptechs-MBP.fritz.box>
This commit is contained in:
parent
afdae3950a
commit
5f31d2ca88
18 changed files with 418 additions and 87 deletions
|
|
@ -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}
|
||||
{
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue