@neurocode-ai/web 1.18.8

package/src/content/docs/ru/keybinds.mdx

@@ -0,0 +1,194 @@
+---
+title: Сочетания клавиш
+description: Настройте свои сочетания клавиш.
+---
+
+opencode имеет список сочетаний клавиш, которые вы можете настроить через `tui.json`.
+
+```json title="tui.json"
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "keybinds": {
+    "leader": "ctrl+x",
+    "app_exit": "ctrl+c,ctrl+d,<leader>q",
+    "editor_open": "<leader>e",
+    "theme_list": "<leader>t",
+    "sidebar_toggle": "<leader>b",
+    "scrollbar_toggle": "none",
+    "username_toggle": "none",
+    "status_view": "<leader>s",
+    "tool_details": "none",
+    "session_export": "<leader>x",
+    "session_new": "<leader>n",
+    "session_list": "<leader>l",
+    "session_timeline": "<leader>g",
+    "session_fork": "none",
+    "session_rename": "none",
+    "session_share": "none",
+    "session_unshare": "none",
+    "session_interrupt": "escape",
+    "session_compact": "<leader>c",
+    "session_child_first": "<leader>down",
+    "session_child_cycle": "<leader>right",
+    "session_child_cycle_reverse": "<leader>left",
+    "session_parent": "<leader>up",
+    "messages_page_up": "pageup,ctrl+alt+b",
+    "messages_page_down": "pagedown,ctrl+alt+f",
+    "messages_line_up": "ctrl+alt+y",
+    "messages_line_down": "ctrl+alt+e",
+    "messages_half_page_up": "ctrl+alt+u",
+    "messages_half_page_down": "ctrl+alt+d",
+    "messages_first": "ctrl+g,home",
+    "messages_last": "ctrl+alt+g,end",
+    "messages_next": "none",
+    "messages_previous": "none",
+    "messages_copy": "<leader>y",
+    "messages_undo": "<leader>u",
+    "messages_redo": "<leader>r",
+    "messages_last_user": "none",
+    "messages_toggle_conceal": "<leader>h",
+    "model_list": "<leader>m",
+    "model_cycle_recent": "f2",
+    "model_cycle_recent_reverse": "shift+f2",
+    "model_cycle_favorite": "none",
+    "model_cycle_favorite_reverse": "none",
+    "variant_cycle": "ctrl+t",
+    "variant_list": "none",
+    "command_list": "ctrl+p",
+    "agent_list": "<leader>a",
+    "agent_cycle": "tab",
+    "agent_cycle_reverse": "shift+tab",
+    "input_clear": "ctrl+c",
+    "input_paste": "ctrl+v",
+    "input_submit": "return",
+    "input_newline": "shift+return,ctrl+return,alt+return,ctrl+j",
+    "input_move_left": "left,ctrl+b",
+    "input_move_right": "right,ctrl+f",
+    "input_move_up": "up",
+    "input_move_down": "down",
+    "input_select_left": "shift+left",
+    "input_select_right": "shift+right",
+    "input_select_up": "shift+up",
+    "input_select_down": "shift+down",
+    "input_line_home": "ctrl+a",
+    "input_line_end": "ctrl+e",
+    "input_select_line_home": "ctrl+shift+a",
+    "input_select_line_end": "ctrl+shift+e",
+    "input_visual_line_home": "alt+a",
+    "input_visual_line_end": "alt+e",
+    "input_select_visual_line_home": "alt+shift+a",
+    "input_select_visual_line_end": "alt+shift+e",
+    "input_buffer_home": "home",
+    "input_buffer_end": "end",
+    "input_select_buffer_home": "shift+home",
+    "input_select_buffer_end": "shift+end",
+    "input_delete_line": "ctrl+shift+d",
+    "input_delete_to_line_end": "ctrl+k",
+    "input_delete_to_line_start": "ctrl+u",
+    "input_backspace": "backspace,shift+backspace",
+    "input_delete": "ctrl+d,delete,shift+delete",
+    "input_undo": "ctrl+-,super+z",
+    "input_redo": "ctrl+.,super+shift+z",
+    "input_word_forward": "alt+f,alt+right,ctrl+right",
+    "input_word_backward": "alt+b,alt+left,ctrl+left",
+    "input_select_word_forward": "alt+shift+f,alt+shift+right",
+    "input_select_word_backward": "alt+shift+b,alt+shift+left",
+    "input_delete_word_forward": "alt+d,alt+delete,ctrl+delete",
+    "input_delete_word_backward": "ctrl+w,ctrl+backspace,alt+backspace",
+    "history_previous": "up",
+    "history_next": "down",
+    "terminal_suspend": "ctrl+z",
+    "terminal_title_toggle": "none",
+    "tips_toggle": "<leader>h",
+    "display_thinking": "none"
+  }
+}
+```
+
+---
+
+## Клавиша Leader
+
+opencode использует клавишу `leader` для большинства сочетаний клавиш. Это позволяет избежать конфликтов в вашем терминале.
+
+По умолчанию `ctrl+x` является клавишей leader, и для большинства действий требуется сначала нажать клавишу leader, а затем сочетание клавиш. Например, чтобы начать новый сеанс, сначала нажмите `ctrl+x`, а затем нажмите `n`.
+
+Вам не обязательно использовать клавишу leader для привязок клавиш, но мы рекомендуем это сделать.
+
+---
+
+## Отключение привязки клавиш
+
+Вы можете отключить привязку клавиш, добавив ключ в `tui.json` со значением «none».
+
+```json title="tui.json"
+{
+  "$schema": "https://opencode.ai/tui.json",
+  "keybinds": {
+    "session_compact": "none"
+  }
+}
+```
+
+---
+
+## Шорткаты в Desktop-приложении
+
+Ввод приглашения настольного приложения opencode поддерживает распространенные сочетания клавиш в стиле Readline/Emacs для редактирования текста. Они встроены и в настоящее время не настраиваются через `opencode.json`.
+
+| Ярлык    | Действие                                             |
+| -------- | ---------------------------------------------------- |
+| `ctrl+a` | Перейти к началу текущей строки                      |
+| `ctrl+e` | Перейти к концу текущей строки                       |
+| `ctrl+b` | Переместить курсор на один символ назад              |
+| `ctrl+f` | Переместить курсор на один символ вперед             |
+| `alt+b`  | Переместить курсор на одно слово назад               |
+| `alt+f`  | Переместить курсор вперед на одно слово              |
+| `ctrl+d` | Удалить символ под курсором                          |
+| `ctrl+k` | Удалить до конца строки                              |
+| `ctrl+u` | Удалить до начала строки                             |
+| `ctrl+w` | Удалить предыдущее слово                             |
+| `alt+d`  | Удалить следующее слово                              |
+| `ctrl+t` | Поменять местами символы                             |
+| `ctrl+g` | Отменить всплывающие окна/прервать выполнение ответа |
+
+---
+
+## Shift+Enter
+
+Некоторые терминалы по умолчанию не отправляют клавиши-модификаторы с Enter. Возможно, вам придется настроить терминал на отправку `Shift+Enter` в качестве escape-последовательности.
+
+### Windows Terminal
+
+Откройте свой `settings.json` по адресу:
+
+```
+%LOCALAPPDATA%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json
+```
+
+Добавьте это в массив `actions` корневого уровня:
+
+```json
+"actions": [
+  {
+    "command": {
+      "action": "sendInput",
+      "input": "\u001b[13;2u"
+    },
+    "id": "User.sendInput.ShiftEnterCustom"
+  }
+]
+```
+
+Добавьте это в массив `keybindings` корневого уровня:
+
+```json
+"keybindings": [
+  {
+    "keys": "shift+enter",
+    "id": "User.sendInput.ShiftEnterCustom"
+  }
+]
+```
+
+Сохраните файл и перезапустите Windows Terminal или откройте новую вкладку.

package/src/content/docs/ru/lsp.mdx

@@ -0,0 +1,207 @@
+---
+title: LSP-серверы
+description: opencode интегрируется с вашими серверами LSP.
+---
+
+opencode может интегрироваться с серверами Language Server Protocol (LSP), чтобы использовать диагностику как обратную связь для агента.
+
+---
+
+## Встроенные
+
+opencode поставляется с несколькими встроенными LSP-серверами для популярных языков:
+
+| LSP Server         | Extensions                                                          | Requirements                                                              |
+| ------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| astro              | .astro                                                              | Автоматически устанавливается для проектов Astro                          |
+| bash               | .sh, .bash, .zsh, .ksh                                              | Автоматически устанавливает bash-language-server                          |
+| clangd             | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++                | Автоматически устанавливается для проектов C/C++                          |
+| csharp             | .cs                                                                 | `.NET SDK` установлен                                                     |
+| clojure-lsp        | .clj, .cljs, .cljc, .edn                                            | `clojure-lsp` команда доступна                                            |
+| dart               | .dart                                                               | `dart` команда доступна                                                   |
+| deno               | .ts, .tsx, .js, .jsx, .mjs                                          | `deno` команда доступна (автоматически обнаруживает deno.json/deno.jsonc) |
+| elixir-ls          | .ex, .exs                                                           | `elixir` команда доступна                                                 |
+| eslint             | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue                  | `eslint` зависимость в проекте                                            |
+| fsharp             | .fs, .fsi, .fsx, .fsscript                                          | `.NET SDK` установлен                                                     |
+| gleam              | .gleam                                                              | `gleam` команда доступна                                                  |
+| gopls              | .go                                                                 | `go` команда доступна                                                     |
+| hls                | .hs, .lhs                                                           | `haskell-language-server-wrapper` команда доступна                        |
+| jdtls              | .java                                                               | `Java SDK (version 21+)` установлен                                       |
+| kotlin-ls          | .kt, .kts                                                           | Автоматически устанавливается для проектов Kotlin                         |
+| lua-ls             | .lua                                                                | Автоматически устанавливается для проектов Lua                            |
+| nixd               | .nix                                                                | `nixd` команда доступна                                                   |
+| ocaml-lsp          | .ml, .mli                                                           | `ocamllsp` команда доступна                                               |
+| oxlint             | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | `oxlint` зависимость в проекте                                            |
+| php intelephense   | .php                                                                | Автоматически устанавливается для проектов PHP                            |
+| prisma             | .prisma                                                             | `prisma` команда доступна                                                 |
+| pyright            | .py, .pyi                                                           | `pyright` зависимость установлена                                         |
+| ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru                                           | `ruby` и `gem` команды доступны                                           |
+| rust               | .rs                                                                 | `rust-analyzer` команда доступна                                          |
+| sourcekit-lsp      | .swift, .objc, .objcpp                                              | `swift` установлен (`xcode` на macOS)                                     |
+| svelte             | .svelte                                                             | Автоматически устанавливается для проектов Svelte                         |
+| terraform          | .tf, .tfvars                                                        | Автоматически устанавливается из релизов GitHub                           |
+| tinymist           | .typ, .typc                                                         | Автоматически устанавливается из релизов GitHub                           |
+| typescript         | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts                        | `typescript` зависимость в проекте                                        |
+| vue                | .vue                                                                | Автоматически устанавливается для проектов Vue                            |
+| yaml-ls            | .yaml, .yml                                                         | Автоматически устанавливает Red Hat yaml-language-server                  |
+| zls                | .zig, .zon                                                          | `zig` команда доступна                                                    |
+
+LSP отключен по умолчанию. Когда он включен, серверы запускаются при обнаружении одного из указанных выше расширений файлов и выполнении требований.
+
+:::note
+Вы можете отключить автоматическую загрузку LSP-сервера, установив для переменной среды `OPENCODE_DISABLE_LSP_DOWNLOAD` значение `true`.
+:::
+
+---
+
+## Как это работает
+
+Когда LSP включен и opencode открывает файл, он:
+
+1. Проверяет расширение файла на всех включенных серверах LSP.
+2. Запускает соответствующий сервер LSP, если он еще не запущен.
+
+---
+
+## Рекомендации
+
+LSP может помочь агенту находить и исправлять проблемы, предоставляя диагностику от языковых серверов. Это полезно в некоторых проектах, но не всегда является однозначным преимуществом.
+
+Языковые серверы могут рассинхронизироваться, потреблять много памяти, отличаться по поведению между версиями или проектами и замедлять рабочие процессы агента. Во многих проектах лучше, чтобы агент напрямую запускал lint, typecheck или другие диагностические CLI-инструменты; так ошибки возвращаются в цикл агента без этих компромиссов. Задокументируйте эти команды в файлах инструкций, например `AGENTS.md` или skills, чтобы агент знал, что запускать. Включайте LSP, когда проект получает пользу от дополнительной обратной связи языкового сервера.
+
+---
+
+## Настройка
+
+Вы можете включить и настроить серверы LSP через раздел `lsp` в конфигурации opencode.
+
+Чтобы включить все встроенные LSP-серверы, установите `lsp` в `true`.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": true
+}
+```
+
+Используйте объект, чтобы оставить встроенные серверы включенными и при этом настроить переопределения или пользовательские серверы.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": {}
+}
+```
+
+Каждый LSP-сервер поддерживает следующее:
+
+| Свойство         | Тип      | Описание                                                                    |
+| ---------------- | -------- | --------------------------------------------------------------------------- |
+| `disabled`       | boolean  | Установите для этого параметра значение `true`, чтобы отключить сервер LSP. |
+| `command`        | string[] | Команда запуска LSP-сервера                                                 |
+| `extensions`     | string[] | Расширения файлов, которые должен обрабатывать этот сервер LSP              |
+| `env`            | object   | Переменные среды, которые нужно установить при запуске сервера              |
+| `initialization` | object   | Параметры инициализации для отправки на сервер LSP                          |
+
+Давайте посмотрим на несколько примеров.
+
+---
+
+### Переменные среды
+
+Используйте свойство `env` для установки переменных среды при запуске сервера LSP:
+
+```json title="opencode.json" {5-7}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": {
+    "rust": {
+      "env": {
+        "RUST_LOG": "debug"
+      }
+    }
+  }
+}
+```
+
+---
+
+### Параметры инициализации
+
+Используйте свойство `initialization` для передачи параметров инициализации на LSP-сервер. Это настройки, специфичные для сервера, отправляемые во время запроса LSP `initialize`:
+
+```json title="opencode.json" {5-9}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": {
+    "typescript": {
+      "initialization": {
+        "preferences": {
+          "importModuleSpecifierPreference": "relative"
+        }
+      }
+    }
+  }
+}
+```
+
+:::note
+Параметры инициализации зависят от сервера LSP. Проверьте документацию вашего LSP-сервера на наличие доступных опций.
+:::
+
+---
+
+### Отключение LSP-серверов
+
+Если `lsp` не указан, все LSP-серверы отключены. Чтобы отключить все LSP-серверы после того, как другая конфигурация их включила, установите для `lsp` значение `false`:
+
+```json title="opencode.json" {3}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": false
+}
+```
+
+Чтобы отключить **конкретный** LSP-сервер, установите для `disabled` значение `true`:
+
+```json title="opencode.json" {5}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": {
+    "typescript": {
+      "disabled": true
+    }
+  }
+}
+```
+
+---
+
+### Пользовательские LSP-серверы
+
+Вы можете добавить собственные LSP-серверы, указав команду и расширения файлов:
+
+```json title="opencode.json" {4-7}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "lsp": {
+    "custom-lsp": {
+      "command": ["custom-lsp-server", "--stdio"],
+      "extensions": [".custom"]
+    }
+  }
+}
+```
+
+---
+
+## Дополнительная информация
+
+### PHP Intelephense
+
+PHP Intelephense предлагает дополнительные функции через лицензионный ключ. Вы можете предоставить лицензионный ключ, поместив (только) ключ в текстовый файл по адресу:
+
+- В macOS/Linux: `$HOME/intelephense/license.txt`
+- В Windows: `%USERPROFILE%/intelephense/license.txt`
+
+Файл должен содержать только лицензионный ключ без какого-либо дополнительного содержимого.