wip(docs): i18n (#12681)

2026-04-18 06:34:50 +00:00 · 2026-02-09 11:34:35 -06:00
parent f74c0339cc
commit dc53086c1e
642 changed files with 192745 additions and 509 deletions
--- a/packages/web/src/content/docs/ru/windows-wsl.mdx
+++ b/packages/web/src/content/docs/ru/windows-wsl.mdx
@@ -0,0 +1,113 @@
+---
+title: Windows (WSL)
+description: Запускайте OpenCode в Windows через WSL.
+---
+
+import { Steps } from "@astrojs/starlight/components"
+
+OpenCode можно запускать напрямую в Windows, но для лучшего опыта мы рекомендуем [Windows Subsystem for Linux (WSL)](https://learn.microsoft.com/en-us/windows/wsl/install). WSL дает Linux-среду, которая отлично работает с возможностями OpenCode.
+
+:::tip[Почему WSL?]
+WSL дает более высокую производительность файловой системы, полноценную поддержку терминала и совместимость с инструментами разработки, на которые опирается OpenCode.
+:::
+
+---
+
+## Настройка
+
+<Steps>
+
+1. **Установите WSL**
+
+   Если вы еще не сделали этого, установите WSL по [официальному руководству Microsoft](https://learn.microsoft.com/en-us/windows/wsl/install).
+
+2. **Установите OpenCode в WSL**
+
+   После настройки WSL откройте терминал WSL и установите OpenCode одним из [способов установки](/docs/).
+
+   ```bash
+   curl -fsSL https://opencode.ai/install | bash
+   ```
+
+3. **Запускайте OpenCode из WSL**
+
+   Перейдите в каталог проекта (к файлам Windows можно обращаться через `/mnt/c/`, `/mnt/d/` и т.д.) и запустите OpenCode.
+
+   ```bash
+   cd /mnt/c/Users/YourName/project
+   opencode
+   ```
+
+</Steps>
+
+---
+
+## Десктопное приложение + сервер в WSL
+
+Если вы предпочитаете OpenCode Desktop, но хотите запускать сервер в WSL:
+
+1. **Запустите сервер в WSL** с параметром `--hostname 0.0.0.0`, чтобы разрешить внешние подключения:
+
+   ```bash
+   opencode serve --hostname 0.0.0.0 --port 4096
+   ```
+
+2. **Подключите десктопное приложение** к `http://localhost:4096`
+
+:::note
+Если в вашей конфигурации `localhost` не работает, используйте IP-адрес WSL (выполните в WSL: `hostname -I`) и подключайтесь по `http://<wsl-ip>:4096`.
+:::
+
+:::caution
+При использовании `--hostname 0.0.0.0` задайте `OPENCODE_SERVER_PASSWORD`, чтобы защитить сервер.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve --hostname 0.0.0.0
+```
+
+:::
+
+---
+
+## Веб-клиент + WSL
+
+Для лучшего веб-опыта в Windows:
+
+1. **Запускайте `opencode web` в терминале WSL**, а не в PowerShell:
+
+   ```bash
+   opencode web --hostname 0.0.0.0
+   ```
+
+2. **Открывайте в браузере Windows** адрес `http://localhost:<port>` (OpenCode выведет URL)
+
+Запуск `opencode web` из WSL обеспечивает корректный доступ к файловой системе и интеграцию с терминалом, при этом интерфейс остается доступным из браузера Windows.
+
+---
+
+## Доступ к файлам Windows
+
+WSL может получать доступ ко всем вашим файлам Windows через каталог `/mnt/`:
+
+- `C:` drive → `/mnt/c/`
+- `D:` drive → `/mnt/d/`
+- И так далее
+
+Пример:
+
+```bash
+cd /mnt/c/Users/YourName/Documents/project
+opencode
+```
+
+:::tip
+Для максимально плавной работы стоит клонировать или скопировать репозиторий в файловую систему WSL (например, в `~/code/`) и запускать OpenCode оттуда.
+:::
+
+---
+
+## Советы
+
+- Даже для проектов на дисках Windows запускайте OpenCode в WSL, чтобы получить более плавный доступ к файлам
+- Используйте OpenCode вместе с [расширением WSL для VS Code](https://code.visualstudio.com/docs/remote/wsl) для единого рабочего процесса
+- Конфигурация и сессии OpenCode хранятся в среде WSL по пути `~/.local/share/opencode/`