@neurocode-ai/web 1.18.8

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

@@ -0,0 +1,341 @@
+---
+title: Инструменты
+description: Управляйте инструментами, которые может использовать LLM.
+---
+
+Инструменты позволяют LLM выполнять действия в вашей кодовой базе. opencode поставляется с набором встроенных инструментов, но вы можете расширить его с помощью [пользовательских инструментов](/docs/custom-tools) или [MCP-серверов](/docs/mcp-servers).
+
+По умолчанию все инструменты **включены** и не требуют разрешения для запуска. Вы можете контролировать поведение инструмента через [permissions](/docs/permissions).
+
+---
+
+## Настройка
+
+Используйте поле `permission` для управления поведением инструмента. Вы можете разрешить, запретить или потребовать одобрения для каждого инструмента.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "deny",
+    "bash": "ask",
+    "webfetch": "allow"
+  }
+}
+```
+
+Вы также можете использовать подстановочные знаки для одновременного управления несколькими инструментами. Например, чтобы потребовать одобрения всех инструментов с сервера MCP:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "mymcp_*": "ask"
+  }
+}
+```
+
+[Подробнее](/docs/permissions) о настройке разрешений.
+
+---
+
+## Встроенный
+
+Вот все встроенные инструменты, доступные в opencode.
+
+---
+
+### bash
+
+Выполняйте shell-команды в среде вашего проекта.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": "allow"
+  }
+}
+```
+
+Этот инструмент позволяет LLM запускать команды терминала, такие как `npm install`, `git status` или любую другую shell-команду.
+
+---
+
+### edit
+
+Измените существующие файлы, используя точную замену строк.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "allow"
+  }
+}
+```
+
+Этот инструмент выполняет точное редактирование файлов, заменяя точные совпадения текста. Это основной способ изменения кода в LLM.
+
+---
+
+### write
+
+Создавайте новые файлы или перезаписывайте существующие.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "allow"
+  }
+}
+```
+
+Используйте это, чтобы позволить LLM создавать новые файлы. Он перезапишет существующие файлы, если они уже существуют.
+
+:::note
+Инструмент `write` контролируется разрешением `edit`, которое распространяется на все модификации файлов (`edit`, `write`, `patch`).
+:::
+
+---
+
+### read
+
+Прочитайте содержимое файла из вашей кодовой базы.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "read": "allow"
+  }
+}
+```
+
+Этот инструмент читает файлы и возвращает их содержимое. Он поддерживает чтение определенных диапазонов строк для больших файлов.
+
+---
+
+### grep
+
+Поиск содержимого файла с помощью регулярных выражений.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "grep": "allow"
+  }
+}
+```
+
+Быстрый поиск контента по вашей кодовой базе. Поддерживает полный синтаксис регулярных выражений и фильтрацию шаблонов файлов.
+
+---
+
+### glob
+
+Найдите файлы по шаблону.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "glob": "allow"
+  }
+}
+```
+
+Ищите файлы, используя шаблоны glob, например `**/*.js` или `src/**/*.ts`. Возвращает соответствующие пути к файлам, отсортированные по времени изменения.
+
+---
+
+### lsp (экспериментальный)
+
+Взаимодействуйте с настроенными серверами LSP, чтобы получить функции анализа кода, такие как определения, ссылки, информация о наведении и иерархия вызовов.
+
+:::note
+Этот инструмент доступен только при `OPENCODE_EXPERIMENTAL_LSP_TOOL=true` (или `OPENCODE_EXPERIMENTAL=true`).
+:::
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "lsp": "allow"
+  }
+}
+```
+
+Поддерживаемые операции включают `goToDefinition`, `findReferences`, `hover`, `documentSymbol`, `workspaceSymbol`, `goToImplementation`, `prepareCallHierarchy`, `incomingCalls` и `outgoingCalls`.
+
+Чтобы настроить серверы LSP, доступные для вашего проекта, см. [LSP Servers](/docs/lsp).
+
+---
+
+### patch
+
+Применяйте патчи к файлам.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "edit": "allow"
+  }
+}
+```
+
+Этот инструмент применяет файлы исправлений к вашей кодовой базе. Полезно для применения различий и патчей из различных источников.
+
+:::note
+Инструмент `patch` контролируется разрешением `edit`, которое распространяется на все модификации файлов (`edit`, `write`, `patch`).
+:::
+
+---
+
+### skill
+
+Загрузите [skill](/docs/skills) (файл `SKILL.md`) и верните его содержимое в диалог.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "skill": "allow"
+  }
+}
+```
+
+---
+
+### todowrite
+
+Управляйте списками дел во время сеансов кодирования.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "todowrite": "allow"
+  }
+}
+```
+
+Создает и обновляет списки задач для отслеживания прогресса во время сложных операций. LLM использует это для организации многоэтапных задач.
+
+:::note
+По умолчанию этот инструмент отключен для субагентов, но вы можете включить его вручную. [Подробнее](/docs/agents/#permissions)
+:::
+
+---
+
+### webfetch
+
+Получить веб-контент.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "webfetch": "allow"
+  }
+}
+```
+
+Позволяет LLM получать и читать веб-страницы. Полезно для поиска документации или исследования онлайн-ресурсов.
+
+---
+
+### websearch
+
+Найдите информацию в Интернете.
+
+:::note
+Этот инструмент доступен только при использовании поставщика opencode или когда для переменной среды `OPENCODE_ENABLE_EXA` установлено любое истинное значение (например, `true` или `1`).
+
+Чтобы включить при запуске opencode:
+
+```bash
+OPENCODE_ENABLE_EXA=1 opencode
+```
+
+:::
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "websearch": "allow"
+  }
+}
+```
+
+Выполняет поиск в Интернете с помощью Exa AI для поиска соответствующей информации в Интернете. Полезно для исследования тем, поиска текущих событий или сбора информации, выходящей за рамки данных обучения.
+
+Ключ API не требуется — инструмент подключается напрямую к сервису MCP, размещенному на Exa AI, без аутентификации.
+
+:::tip
+Используйте `websearch`, когда вам нужно найти информацию (обнаружение), и `webfetch`, когда вам нужно получить контент с определенного URL-адреса (извлечение).
+:::
+
+---
+
+### question
+
+Задавайте вопросы пользователю во время выполнения.
+
+```json title="opencode.json" {4}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "question": "allow"
+  }
+}
+```
+
+Этот инструмент позволяет LLM задавать вопросы пользователю во время выполнения задачи. Это полезно для:
+
+- Сбор предпочтений или требований пользователей
+- Уточнение двусмысленных инструкций
+- Получение решений по вариантам реализации
+- Предлагая выбор, в каком направлении двигаться
+
+Каждый вопрос включает заголовок, текст вопроса и список вариантов. Пользователи могут выбрать один из предложенных вариантов или ввести собственный ответ. Если вопросов несколько, пользователи могут перемещаться между ними, прежде чем отправлять все ответы.
+
+---
+
+## Пользовательские инструменты
+
+Пользовательские инструменты позволяют вам определять собственные функции, которые может вызывать LLM. Они определены в вашем файле конфигурации и могут выполнять произвольный код.
+
+[Подробнее](/docs/custom-tools) о создании собственных инструментов.
+
+---
+
+## MCP-серверы
+
+Серверы MCP (Model Context Protocol) позволяют интегрировать внешние инструменты и сервисы. Сюда входит доступ к базе данных, интеграция API и сторонние сервисы.
+
+[Подробнее](/docs/mcp-servers) о настройке серверов MCP.
+
+---
+
+## Внутреннее устройство
+
+Внутренне такие инструменты, как `grep` и `glob`, используют [ripgrep](https://github.com/BurntSushi/ripgrep). По умолчанию ripgrep учитывает шаблоны `.gitignore`, что означает, что файлы и каталоги, перечисленные в вашем `.gitignore`, будут исключены из поиска и списков.
+
+---
+
+### Игнорировать шаблоны
+
+Чтобы включить файлы, которые обычно игнорируются, создайте файл `.ignore` в корне вашего проекта. Этот файл может явно разрешать определенные пути.
+
+```text title=".ignore"
+!node_modules/
+!dist/
+!build/
+```
+
+Например, этот файл `.ignore` позволяет ripgrep выполнять поиск в каталогах `node_modules/`, `dist/` и `build/`, даже если они указаны в `.gitignore`.

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

@@ -0,0 +1,300 @@
+---
+title: Поиск неисправностей
+description: Распространенные проблемы и способы их решения.
+---
+
+Чтобы устранить проблемы с opencode, начните с проверки журналов и локальных данных, которые он хранит на диске.
+
+---
+
+## Журналы
+
+Лог-файлы записываются в:
+
+- **macOS/Linux**: `~/.local/share/opencode/log/`
+- **Windows**: нажмите `WIN+R` и вставьте `%USERPROFILE%\.local\share\opencode\log`.
+
+Файлам журналов присваиваются имена с метками времени (например, `2025-01-09T123456.log`), и сохраняются 10 последних файлов журналов.
+
+Вы можете установить уровень журнала с помощью CLI-параметра `--log-level`, чтобы получить более подробную информацию об отладке. Например, `opencode --log-level DEBUG`.
+
+---
+
+## Хранилище
+
+opencode хранит данные сеанса и другие данные приложения на диске по адресу:
+
+- **macOS/Linux**: `~/.local/share/opencode/`
+- **Windows**: нажмите `WIN+R` и вставьте `%USERPROFILE%\.local\share\opencode`.
+
+Этот каталог содержит:
+
+- `auth.json` – данные аутентификации, такие как ключи API и токены OAuth.
+- `log/` – журналы приложений.
+- `project/` — данные, специфичные для проекта, такие как данные сеанса и сообщения.
+  - Если проект находится в репозитории Git, он хранится в `./<project-slug>/storage/`.
+  - Если это не репозиторий Git, он хранится в `./global/storage/`.
+
+---
+
+## Настольное приложение
+
+opencode Desktop запускает локальный сервер opencode (спутник `opencode-cli`) в фоновом режиме. Большинство проблем вызвано неправильно работающим плагином, поврежденным кешем или неверными настройками сервера.
+
+### Быстрые проверки
+
+- Полностью закройте и перезапустите приложение.
+- Если приложение отображает экран с ошибкой, нажмите **Перезапустить** и скопируйте сведения об ошибке.
+- Только для macOS: меню `OpenCode` -> **Обновить веб-просмотр** (помогает, если пользовательский интерфейс пуст или завис).
+
+---
+
+### Отключить плагины
+
+Если настольное приложение дает сбой при запуске, зависает или ведет себя странно, начните с отключения плагинов.
+
+#### Проверьте глобальную конфигурацию
+
+Откройте файл глобальной конфигурации и найдите ключ `plugin`.
+
+- **macOS/Linux**: `~/.config/opencode/opencode.jsonc` (или `~/.config/opencode/opencode.json`)
+- **macOS/Linux** (более ранние версии): `~/.local/share/opencode/opencode.jsonc`
+- **Windows**: нажмите `WIN+R` и вставьте `%USERPROFILE%\.config\opencode\opencode.jsonc`.
+
+Если у вас настроены плагины, временно отключите их, удалив ключ или установив для него пустой массив:
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [],
+}
+```
+
+#### Проверьте каталоги плагинов
+
+opencode также может загружать локальные плагины с диска. Временно переместите их в сторону (или переименуйте папку) и перезапустите настольное приложение:
+
+- **Глобальные плагины**
+  - **macOS/Linux**: `~/.config/opencode/plugins/`
+  - **Windows**: нажмите `WIN+R` и вставьте `%USERPROFILE%\.config\opencode\plugins`.
+- **Плагины проекта** (только если вы используете конфигурацию для каждого проекта)
+  - `<your-project>/.opencode/plugins/`
+
+Если приложение снова начнет работать, повторно включите плагины по одному, чтобы определить, какой из них вызывает проблему.
+
+---
+
+### Очистить кеш
+
+Если отключение плагинов не помогает (или установка плагина зависла), очистите кеш, чтобы opencode мог его пересобрать.
+
+1. Полностью закройте opencode Desktop.
+2. Удалите каталог кэша:
+
+- **macOS**: Finder -> `Cmd+Shift+G` -> вставить `~/.cache/opencode`.
+- **Linux**: удалите `~/.cache/opencode` (или запустите `rm -rf ~/.cache/opencode`).
+- **Windows**: нажмите `WIN+R` и вставьте `%USERPROFILE%\.cache\opencode`.
+
+3. Перезапустите рабочий стол opencode.
+
+---
+
+### Исправить проблемы с подключением к серверу
+
+opencode Desktop может либо запустить собственный локальный сервер (по умолчанию), либо подключиться к настроенному вами URL-адресу сервера.
+
+Если вы видите диалоговое окно **Ошибка подключения** (или приложение никогда не выходит за пределы заставки), проверьте URL-адрес пользовательского сервера.
+
+#### Очистите URL-адрес сервера по умолчанию для рабочего стола.
+
+На главном экране щелкните имя сервера (с точкой состояния), чтобы открыть окно выбора сервера. В разделе **Сервер по умолчанию** нажмите **Очистить**.
+
+#### Удалите `server.port`/`server.hostname` из вашей конфигурации.
+
+Если ваш `opencode.json(c)` содержит раздел `server`, временно удалите его и перезапустите настольное приложение.
+
+#### Проверьте переменные среды
+
+Если в вашей среде установлен `OPENCODE_PORT`, настольное приложение попытается использовать этот порт для локального сервера.
+
+- Отмените настройку `OPENCODE_PORT` (или выберите свободный порт) и перезапустите.
+
+---
+
+### Linux: проблемы с Wayland/X11
+
+В Linux некоторые настройки Wayland могут вызывать пустые окна или ошибки компоновщика.
+
+- Если вы используете Wayland, а приложение не работает или вылетает, попробуйте запустить с помощью `OC_ALLOW_WAYLAND=1`.
+- Если это усугубляет ситуацию, удалите его и попробуйте вместо этого запустить сеанс X11.
+
+---
+
+### Windows: среда выполнения WebView2.
+
+В Windows для opencode Desktop требуется Microsoft Edge **WebView2 Runtime**. Если приложение открывается в пустом окне или не запускается, установите/обновите WebView2 и повторите попытку.
+
+---
+
+### Windows: общие проблемы с производительностью
+
+Если вы испытываете низкую производительность, проблемы с доступом к файлам или проблемы с terminal в Windows, попробуйте использовать [WSL (подсистема Windows для Linux)](/docs/windows-wsl). WSL предоставляет среду Linux, которая более эффективно работает с функциями opencode.
+
+---
+
+### Уведомления не отображаются
+
+opencode Desktop отображает системные уведомления только в следующих случаях:
+
+- уведомления для opencode включены в настройках вашей ОС, и
+- окно приложения не в фокусе.
+
+---
+
+### Сбросить хранилище настольных приложений (последнее средство)
+
+Если приложение не запускается и вы не можете очистить настройки из пользовательского интерфейса, сбросьте сохраненное состояние настольного приложения.
+
+1. Закройте рабочий стол opencode.
+2. Найдите и удалите эти файлы (они находятся в каталоге данных приложения opencode Desktop):
+
+- `opencode.settings.dat` (URL-адрес сервера по умолчанию для рабочего стола)
+- `opencode.global.dat` и `opencode.workspace.*.dat` (состояние пользовательского интерфейса, например, недавние серверы/проекты)
+
+Чтобы быстро найти каталог:
+
+- **macOS**: Finder -> `Cmd+Shift+G` -> `~/Library/Application Support` (затем найдите имена файлов, указанные выше)
+- **Linux**: найдите в `~/.local/share` имена файлов, указанные выше.
+- **Windows**: нажмите `WIN+R` -> `%APPDATA%` (затем найдите имена файлов, указанные выше).
+
+---
+
+## Получение помощи
+
+Если у вас возникли проблемы с opencode:
+
+1. **Сообщайте о проблемах на GitHub**
+
+   Лучший способ сообщить об ошибках или запросить новые функции — через наш репозиторий GitHub:
+
+   [**github.com/anomalyco/opencode/issues**](https://github.com/anomalyco/opencode/issues)
+
+   Прежде чем создавать новую проблему, выполните поиск по существующим проблемам, чтобы узнать, не сообщалось ли уже о вашей проблеме.
+
+2. **Присоединяйтесь к нашему Discord**
+
+   Для получения помощи в режиме реального времени и обсуждения в сообществе присоединяйтесь к нашему серверу Discord:
+
+   [**opencode.ai/discord**](https://opencode.ai/discord)
+
+---
+
+## Общие проблемы
+
+Вот некоторые распространенные проблемы и способы их решения.
+
+---
+
+### opencode не запускается
+
+1. Проверьте журналы на наличие сообщений об ошибках
+2. Попробуйте запустить `--print-logs`, чтобы увидеть вывод в terminal.
+3. Убедитесь, что у вас установлена ​​последняя версия `opencode upgrade`.
+
+---
+
+### Проблемы аутентификации
+
+1. Попробуйте выполнить повторную аутентификацию с помощью команды `/connect` в TUI.
+2. Убедитесь, что ваши ключи API действительны
+3. Убедитесь, что ваша сеть разрешает подключения к API провайдера.
+
+---
+
+### Модель недоступна
+
+1. Убедитесь, что вы прошли аутентификацию у провайдера
+2. Проверьте правильность названия модели в вашей конфигурации.
+3. Для некоторых моделей может потребоваться специальный доступ или подписка.
+
+Если вы столкнулись с `ProviderModelNotFoundError`, вы, скорее всего, ошибаетесь.
+ссылка на модель где-то.
+На модели следует ссылаться следующим образом: `<providerId>/<modelId>`.
+
+Примеры:
+
+- `openai/gpt-4.1`
+- `openrouter/google/gemini-2.5-flash`
+- `opencode/kimi-k2`
+
+Чтобы выяснить, к каким моделям у вас есть доступ, запустите `opencode models`.
+
+---
+
+### ProviderInitError
+
+Если вы столкнулись с ошибкой ProviderInitError, скорее всего, у вас неверная или поврежденная конфигурация.
+
+Чтобы решить эту проблему:
+
+1. Сначала убедитесь, что ваш провайдер настроен правильно, следуя [руководству провайдеров](/docs/providers)
+2. Если проблема не устранена, попробуйте очистить сохраненную конфигурацию:
+
+   ```bash
+   rm -rf ~/.local/share/opencode
+   ```
+
+   В Windows нажмите `WIN+R` и удалите: `%USERPROFILE%\.local\share\opencode`.
+
+3. Повторно выполните аутентификацию у своего провайдера, используя команду `/connect` в TUI.
+
+---
+
+### AI_APICallError и проблемы с пакетом провайдера
+
+Если вы столкнулись с ошибками вызова API, это может быть связано с устаревшими пакетами провайдера. opencode динамически устанавливает пакеты провайдеров (OpenAI, Anthropic, Google и т. д.) по мере необходимости и кэширует их локально.
+
+Чтобы решить проблемы с пакетом поставщика:
+
+1. Очистите кеш пакетов провайдера:
+
+   ```bash
+   rm -rf ~/.cache/opencode
+   ```
+
+   В Windows нажмите `WIN+R` и удалите: `%USERPROFILE%\.cache\opencode`.
+
+2. Перезапустите opencode, чтобы переустановить последние пакеты поставщиков.
+
+Это заставит opencode загружать самые последние версии пакетов провайдеров, что часто решает проблемы совместимости с параметрами модели и изменениями API.
+
+---
+
+### Копирование/вставка не работает в Linux
+
+Для работы функций копирования/вставки пользователям Linux необходимо установить одну из следующих утилит буфера обмена:
+
+**Для систем X11:**
+
+```bash
+apt install -y xclip
+# or
+apt install -y xsel
+```
+
+**Для систем Wayland:**
+
+```bash
+apt install -y wl-clipboard
+```
+
+**Для headless-сред:**
+
+```bash
+apt install -y xvfb
+# and run:
+Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
+export DISPLAY=:99.0
+```
+
+opencode определит, используете ли вы Wayland и предпочитаете `wl-clipboard`, в противном случае он попытается найти инструменты буфера обмена в порядке: `xclip` и `xsel`.