@neurocode-ai/web 1.18.8

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

@@ -0,0 +1,223 @@
+---
+title: Модели
+description: Настройка поставщика и модели LLM.
+---
+
+opencode использует [AI SDK](https://ai-sdk.dev/) и [Models.dev](https://models.dev) для поддержки **более 75 поставщиков LLM** и поддерживает запуск локальных моделей.
+
+---
+
+## Провайдеры
+
+Большинство популярных провайдеров предварительно загружены по умолчанию. Если вы добавили учетные данные для поставщика с помощью команды `/connect`, они будут доступны при запуске opencode.
+
+Узнайте больше о [providers](/docs/providers).
+
+---
+
+## Выберите модель
+
+После того, как вы настроили своего провайдера, вы можете выбрать нужную модель, введя:
+
+```bash frame="none"
+/models
+```
+
+---
+
+## Рекомендуемые модели
+
+Моделей очень много, новые выходят каждую неделю.
+
+:::tip
+Рассмотрите возможность использования одной из моделей, которые мы рекомендуем.
+:::
+
+Однако лишь немногие из них хороши как в генерации кода, так и в вызове инструментов.
+
+Вот несколько моделей, которые хорошо работают с opencode (в произвольном порядке). (Это не исчерпывающий список и не обязательно актуальный):
+
+- GPT 5.2
+- Кодекс GPT 5.1
+- Claude Opus 4.5
+- Claude Sonnet 4.5
+- MiniMax M2.1
+- Gemini 3 Pro
+
+---
+
+## Установить значение по умолчанию
+
+Чтобы установить одну из них в качестве модели по умолчанию, вы можете установить ключ `model` в вашем
+Конфигурация opencode.
+
+```json title="opencode.json" {3}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "model": "lmstudio/google/gemma-3n-e4b"
+}
+```
+
+Здесь полный идентификатор `provider_id/model_id`. Например, если вы используете [OpenCode Zen](/docs/zen), вы должны использовать `opencode/gpt-5.1-codex` для кодекса GPT 5.1.
+
+Если вы настроили [пользовательский поставщик](/docs/providers#custom), `provider_id` — это ключ из части `provider` вашей конфигурации, а `model_id` — это ключ из `provider.models`.
+
+---
+
+## Настройка моделей
+
+Вы можете глобально настроить параметры модели через файл config.
+
+```jsonc title="opencode.jsonc" {7-12,19-24}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openai": {
+      "models": {
+        "gpt-5": {
+          "options": {
+            "reasoningEffort": "high",
+            "textVerbosity": "low",
+            "reasoningSummary": "auto",
+            "include": ["reasoning.encrypted_content"],
+          },
+        },
+      },
+    },
+    "anthropic": {
+      "models": {
+        "claude-sonnet-4-5-20250929": {
+          "options": {
+            "thinking": {
+              "type": "enabled",
+              "budgetTokens": 16000,
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+Здесь мы настраиваем глобальные параметры для двух встроенных моделей: `gpt-5` при доступе через поставщика `openai` и `claude-sonnet-4-20250514` при доступе через поставщика `anthropic`.
+Названия встроенных поставщиков и моделей можно найти на сайте [Models.dev](https://models.dev).
+
+Вы также можете настроить эти параметры для любых используемых вами агентов. Конфигурация агента переопределяет любые глобальные параметры здесь. [Подробнее](/docs/agents/#additional).
+
+Вы также можете определить собственные варианты, расширяющие встроенные. Варианты позволяют настраивать разные параметры для одной и той же модели без создания повторяющихся записей:
+
+```jsonc title="opencode.jsonc" {6-21}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "opencode": {
+      "models": {
+        "gpt-5": {
+          "variants": {
+            "high": {
+              "reasoningEffort": "high",
+              "textVerbosity": "low",
+              "reasoningSummary": "auto",
+            },
+            "low": {
+              "reasoningEffort": "low",
+              "textVerbosity": "low",
+              "reasoningSummary": "auto",
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+---
+
+## Варианты
+
+Многие модели поддерживают несколько вариантов с разными конфигурациями. opencode поставляется со встроенными вариантами по умолчанию для популярных провайдеров.
+
+### Встроенные варианты
+
+opencode поставляется с вариантами по умолчанию для многих провайдеров:
+
+**Anthropic**:
+
+- `high` — Бюджет рассуждений: высокий (по умолчанию)
+- `max` — Максимальный бюджет рассуждений
+
+**OpenAI**:
+
+Зависит от модели, но примерно:
+
+- `none` — Без рассуждений.
+- `minimal` — Минимальные усилия для рассуждений
+- `low` — Низкие усилия для рассуждений.
+- `medium` — Средние усилия для рассуждений.
+- `high` — Высокие усилия для рассуждений.
+- `xhigh` — Сверхвысокие усилия для рассуждений.
+
+**Google**:
+
+- `low` – меньший бюджет усилий/токенов.
+- `high` — более высокий бюджет усилий/токенов
+
+:::tip
+Этот список не является исчерпывающим. Многие другие провайдеры также имеют встроенные настройки по умолчанию.
+:::
+
+### Пользовательские варианты
+
+Вы можете переопределить существующие варианты или добавить свои собственные:
+
+```jsonc title="opencode.jsonc" {7-18}
+{
+  "$schema": "https://opencode.ai/config.json",
+  "provider": {
+    "openai": {
+      "models": {
+        "gpt-5": {
+          "variants": {
+            "thinking": {
+              "reasoningEffort": "high",
+              "textVerbosity": "low",
+            },
+            "fast": {
+              "disabled": true,
+            },
+          },
+        },
+      },
+    },
+  },
+}
+```
+
+### Переключение вариантов
+
+Используйте сочетание клавиш `variant_cycle` для быстрого переключения между вариантами. [Подробнее ](/docs/keybinds).
+
+---
+
+## Загрузка моделей
+
+Когда opencode запускается, он проверяет модели в следующем порядке приоритета:
+
+1. CLI-флаг `--model` или `-m`. Формат тот же, что и в файле конфигурации: `provider_id/model_id`.
+
+2. Список моделей в конфигурации opencode.
+
+   ```json title="opencode.json"
+   {
+     "$schema": "https://opencode.ai/config.json",
+     "model": "anthropic/claude-sonnet-4-20250514"
+   }
+   ```
+
+   Здесь используется формат `provider/model`.
+
+3. Последняя использованная модель.
+
+4. Первая модель, использующая внутренний приоритет.

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

@@ -0,0 +1,57 @@
+---
+title: Сеть
+description: Настройте прокси и пользовательские сертификаты.
+---
+
+opencode поддерживает стандартные переменные среды прокси-сервера и пользовательские сертификаты для сетевых сред предприятия.
+
+---
+
+## Прокси
+
+opencode учитывает стандартные переменные среды прокси.
+
+```bash
+# HTTPS proxy (recommended)
+export HTTPS_PROXY=https://proxy.example.com:8080
+
+# HTTP proxy (if HTTPS not available)
+export HTTP_PROXY=http://proxy.example.com:8080
+
+# Bypass proxy for local server (required)
+export NO_PROXY=localhost,127.0.0.1
+```
+
+:::caution
+TUI взаимодействует с локальным HTTP-сервером. Вы должны обойти прокси-сервер для этого соединения, чтобы избежать петель маршрутизации.
+:::
+
+Вы можете настроить порт и имя хоста сервера, используя [CLI flags](/docs/cli#run).
+
+---
+
+### Аутентификация
+
+Если ваш прокси-сервер требует базовой аутентификации, включите учетные данные в URL-адрес.
+
+```bash
+export HTTPS_PROXY=http://username:password@proxy.example.com:8080
+```
+
+:::caution
+Избегайте жесткого кодирования паролей. Используйте переменные среды или безопасное хранилище учетных данных.
+:::
+
+Для прокси-серверов, требующих расширенной аутентификации, например NTLM или Kerberos, рассмотрите возможность использования шлюза LLM, поддерживающего ваш метод аутентификации.
+
+---
+
+## Пользовательские сертификаты
+
+Если ваше предприятие использует собственные центры сертификации для HTTPS-соединений, настройте opencode, чтобы доверять им.
+
+```bash
+export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem
+```
+
+Это работает как для прокси-соединений, так и для прямого доступа к API.

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

@@ -0,0 +1,235 @@
+---
+title: Разрешения
+description: Контролируйте, какие действия требуют одобрения для выполнения.
+---
+
+opencode использует конфигурацию `permission`, чтобы решить, должно ли данное действие выполняться автоматически, запрашивать вас или блокироваться.
+
+Начиная с `v1.1.1`, устаревшая логическая конфигурация `tools` устарела и была объединена с `permission`. Старая конфигурация `tools` по-прежнему поддерживается для обеспечения обратной совместимости.
+
+---
+
+## Действия
+
+Каждое правило разрешения разрешается в одно из:
+
+- `"allow"` — запуск без одобрения
+- `"ask"` — запрос на одобрение
+- `"deny"` — заблокировать действие
+
+---
+
+## Конфигурация
+
+Вы можете устанавливать разрешения глобально (с помощью `*`) и переопределять определенные инструменты.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "*": "ask",
+    "bash": "allow",
+    "edit": "deny"
+  }
+}
+```
+
+Вы также можете установить все разрешения одновременно:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": "allow"
+}
+```
+
+---
+
+## Детальные правила (синтаксис объекта)
+
+Для большинства разрешений вы можете использовать объект для применения различных действий на основе входных данных инструмента.
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "npm *": "allow",
+      "rm *": "deny",
+      "grep *": "allow"
+    },
+    "edit": {
+      "*": "deny",
+      "packages/web/src/content/docs/*.mdx": "allow"
+    }
+  }
+}
+```
+
+Правила оцениваются по шаблону, при этом **выигрывает последнее совпадающее правило**. Обычно сначала ставится универсальное правило `"*"`, а после него — более конкретные правила.
+
+### Подстановочные знаки
+
+В шаблонах разрешений используется простое сопоставление с подстановочными знаками:
+
+- `*` соответствует нулю или более любого символа.
+- `?` соответствует ровно одному символу
+- Все остальные символы совпадают буквально
+
+### Расширение домашнего каталога
+
+Вы можете использовать `~` или `$HOME` в начале шаблона для ссылки на ваш домашний каталог. Это особенно полезно для правил [`external_directory`](#external-directories).
+
+- `~/projects/*` -> `/Users/username/projects/*`
+- `$HOME/projects/*` -> `/Users/username/projects/*`
+- `~` -> `/Users/username`
+
+### Внешние каталоги
+
+Используйте `external_directory`, чтобы разрешить вызовы инструментов, затрагивающие пути за пределами рабочего каталога, в котором был запущен opencode. Это применимо к любому инструменту, который принимает путь в качестве входных данных (например, `read`, `edit`, `glob`, `grep` и многие команды `bash`).
+
+Расширение дома (например, `~/...`) влияет только на запись шаблона. Он не делает внешний путь частью текущего рабочего пространства, поэтому пути за пределами рабочего каталога все равно должны быть разрешены через `external_directory`.
+
+Например, это позволяет получить доступ ко всему, что находится под `~/projects/personal/`:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    }
+  }
+}
+```
+
+Любой каталог, разрешенный здесь, наследует те же настройки по умолчанию, что и текущая рабочая область. Поскольку для [`read` по умолчанию установлено значение `allow`](#defaults), чтение также разрешено для записей под `external_directory`, если оно не переопределено. Добавьте явные правила, когда инструмент должен быть ограничен в этих путях, например, блокировать редактирование при сохранении чтения:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "external_directory": {
+      "~/projects/personal/**": "allow"
+    },
+    "edit": {
+      "~/projects/personal/**": "deny"
+    }
+  }
+}
+```
+
+Держите список сосредоточенным на доверенных путях и добавляйте дополнительные правила разрешения или запрета по мере необходимости для других инструментов (например, `bash`).
+
+---
+
+## Доступные разрешения
+
+Разрешения opencode привязаны к имени инструмента, а также к нескольким мерам безопасности:
+
+- `read` — чтение файла (соответствует пути к файлу)
+- `edit` — все модификации файлов (охватывает `edit`, `write`, `patch`)
+- `glob` — подстановка файла (соответствует шаблону подстановки)
+- `grep` — поиск по контенту (соответствует шаблону регулярного выражения)
+- `bash` — запуск shell-команд (соответствует проанализированным командам, например `git status --porcelain`)
+- `task` — запуск субагентов (соответствует типу субагента)
+- `skill` — загрузка навыка (соответствует названию навыка)
+- `lsp` — выполнение запросов LSP (в настоящее время не детализированных)
+- `webfetch` — получение URL-адреса (соответствует URL-адресу)
+- `websearch` — поиск в сети (соответствует запросу)
+- `external_directory` — срабатывает, когда инструмент касается путей за пределами рабочего каталога проекта.
+- `doom_loop` — срабатывает, когда один и тот же вызов инструмента повторяется 3 раза с одинаковым вводом.
+
+---
+
+## По умолчанию
+
+Если вы ничего не укажете, opencode запустится с разрешенных значений по умолчанию:
+
+- Большинство разрешений по умолчанию имеют значение `"allow"`.
+- `doom_loop` и `external_directory` по умолчанию равны `"ask"`.
+- `read` — это `"allow"`, но файлы `.env` по умолчанию запрещены:
+
+```json title="opencode.json"
+{
+  "permission": {
+    "read": {
+      "*": "allow",
+      "*.env": "deny",
+      "*.env.*": "deny",
+      "*.env.example": "allow"
+    }
+  }
+}
+```
+
+---
+
+## Что означает «ask»
+
+Когда opencode запрашивает одобрение, пользовательский интерфейс предлагает три результата:
+
+- `once` — утвердить только этот запрос
+- `always` — одобрять будущие запросы, соответствующие предложенным шаблонам (до конца текущего сеанса opencode).
+- `reject` — отклонить запрос
+
+Набор шаблонов, которые одобрит `always`, предоставляется инструментом (например, разрешения bash обычно включают в белый список безопасный префикс команды, такой как `git status*`).
+
+---
+
+## Агенты
+
+Вы можете переопределить разрешения для каждого агента. Разрешения агента объединяются с глобальной конфигурацией, и правила агента имеют приоритет. [Подробнее](/docs/agents#permissions) о разрешениях агента.
+
+:::note
+Более подробные примеры сопоставления с образцом см. в разделе [Детальные правила (синтаксис объекта)](#granular-rules-object-syntax) выше.
+:::
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "permission": {
+    "bash": {
+      "*": "ask",
+      "git *": "allow",
+      "git commit *": "deny",
+      "git push *": "deny",
+      "grep *": "allow"
+    }
+  },
+  "agent": {
+    "build": {
+      "permission": {
+        "bash": {
+          "*": "ask",
+          "git *": "allow",
+          "git commit *": "ask",
+          "git push *": "deny",
+          "grep *": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+Вы также можете настроить разрешения агента в Markdown:
+
+```markdown title="~/.config/opencode/agents/review.md"
+---
+description: Code review without edits
+mode: subagent
+permission:
+  edit: deny
+  bash: ask
+  webfetch: deny
+---
+
+Only analyze code and suggest changes.
+```
+
+:::tip
+Используйте сопоставление с образцом для команд с аргументами. `"grep *"` разрешает `grep pattern file.txt`, а сам `"grep"` блокирует его. Такие команды, как `git status`, работают по умолчанию, но требуют явного разрешения (например, `"git status *"`) при передаче аргументов.
+:::