1 files changed, 300 insertions, 0 deletions
diff --git a/packages/web/src/content/docs/pl/troubleshooting.mdx b/packages/web/src/content/docs/pl/troubleshooting.mdx
new file mode 100644
index 000000000..844d5b91f
--- /dev/null
+++ b/packages/web/src/content/docs/pl/troubleshooting.mdx
@@ -0,0 +1,300 @@
+---
+title: Troubleshooting
+description: Typowe problemy i sposoby ich rozwiązywania.
+---
+
+Aby debugować problemy z OpenCode, zacznij od sprawdzenia dzienników i danych lokalnych przechowywanych na dysku.
+
+---
+
+## Logs
+
+Log files are written to:
+
+- **macOS/Linux**: `~/.local/share/opencode/log/`
+- **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.local\share\opencode\log`
+
+Nazwy plików dziennika zawierają znaczniki czasu (np. `2025-01-09T123456.log`) i przechowywanych jest 10 ostatnich plików dziennika.
+
+Możesz ustawić poziom dziennika za pomocą opcji wiersza poleceń `--log-level`, aby uzyskać bardziej szczegółowe informacje debugowania. Na przykład `opencode --log-level DEBUG`.
+
+---
+
+## Storage
+
+opencode przechowuje dane sesji i inne dane aplikacji na dysku pod adresem:
+
+- **macOS/Linux**: `~/.local/share/opencode/`
+- **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.local\share\opencode`
+
+Ten katalog zawiera:
+
+- `auth.json` - Authentication data like API keys, OAuth tokens
+- `log/` - Application logs
+- `project/` — Dane specyficzne dla projektu, takie jak dane sesji i komunikatów
+  - Jeśli projekt znajduje się w repozytorium Git, jest on przechowywany w `./<project-slug>/storage/`
+  - If it is not a Git repo, it is stored in `./global/storage/`
+
+---
+
+## Desktop app
+
+OpenCode Desktop uruchamia w tle lokalny serwer OpenCode (wózek boczny `opencode-cli`). Większość problemów jest spowodowana nieprawidłowo działającą wtyczką, uszkodzoną pamięcią podręczną lub złymi ustawieniami serwera.
+
+### Quick checks
+
+- Całkowicie zakończ i uruchom ponownie aplikację.
+- Jeśli aplikacja wyświetli ekran błędu, kliknij **Uruchom ponownie** i skopiuj szczegóły błędu.
+- Tylko macOS: menu `OpenCode` -> **Załaduj ponownie przeglądarkę internetową** (pomaga, jeśli interfejs użytkownika jest pusty/zawieszony).
+
+---
+
+### Disable plugins
+
+Jeśli aplikacja komputerowa ulega awarii podczas uruchamiania, zawiesza się lub zachowuje się dziwnie, zacznij od wyłączenia wtyczek.
+
+#### Sprawdź konfigurację globalną
+
+Otwórz globalny plik konfiguracyjny i poszukaj klucza `plugin`.
+
+- **macOS/Linux**: `~/.config/opencode/opencode.jsonc` (or `~/.config/opencode/opencode.json`)
+- **macOS/Linux** (older installs): `~/.local/share/opencode/opencode.jsonc`
+- **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.config\opencode\opencode.jsonc`
+
+Jeśli masz skonfigurowane wtyczki, tymczasowo je wyłącz, usuwając klucz lub ustawiając go na pustą tablicę:
+
+```jsonc
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": [],
+}
+```
+
+#### Check plugin directories
+
+OpenCode może także ładować lokalne wtyczki z dysku. Tymczasowo usuń je (lub zmień nazwę folderu) i uruchom ponownie aplikację komputerową:
+
+- **Global plugins**
+  - **macOS/Linux**: `~/.config/opencode/plugins/`
+  - **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.config\opencode\plugins`
+- **Wtyczki projektowe** (tylko jeśli używasz konfiguracji dla poszczególnych projektów)
+  - `<your-project>/.opencode/plugins/`
+
+Jeśli aplikacja ponownie zacznie działać, włączaj ponownie wtyczki pojedynczo, aby dowiedzieć się, która powoduje problem.
+
+---
+
+### Wyczyść pamięć podręczną
+
+Jeśli wyłączenie wtyczek nie pomoże (lub instalacja wtyczki utknęła), wyczyść pamięć podręczną, aby OpenCode mógł ją odbudować.
+
+1. Quit OpenCode Desktop completely.
+2. Usuń katalog pamięci podręcznej:
+
+- **macOS**: Finder -> `Cmd+Shift+G` -> paste `~/.cache/opencode`
+- **Linux**: usuń `~/.cache/opencode` (lub uruchom `rm -rf ~/.cache/opencode`)
+- **Windows**: Naciśnij `WIN+R` i wklej `%USERPROFILE%\.cache\opencode`
+
+3. Restart OpenCode Desktop.
+
+---
+
+### Napraw problemy z połączeniem z serwerem
+
+OpenCode Desktop może uruchomić własny serwer lokalny (domyślnie) lub połączyć się ze skonfigurowanym adresem URL serwera.
+
+Jeśli zobaczysz okno dialogowe **„Połączenie nie powiodło się”** (lub aplikacja nigdy nie wychodzi poza ekran powitalny), sprawdź, czy jest niestandardowy adres URL serwera.
+
+#### Wyczyść domyślny adres URL serwera na komputerze
+
+Na ekranie głównym kliknij nazwę serwera (z kropką stanu), aby otworzyć selektor serwerów. W sekcji **Serwer domyślny** kliknij **Wyczyść**.
+
+#### Usuń `server.port` / `server.hostname` ze swojej konfiguracji
+
+Jeśli Twój `opencode.json(c)` zawiera sekcję `server`, tymczasowo usuń ją i uruchom ponownie aplikację komputerową.
+
+#### Check environment variables
+
+Jeśli w swoim środowisku masz ustawiony `OPENCODE_PORT`, aplikacja komputerowa spróbuje użyć tego portu dla serwera lokalnego.
+
+- Rozbierz `OPENCODE_PORT` (lub wybierz wolny port) i uruchom ponownie.
+
+---
+
+### Linux: Wayland / X11 issues
+
+On Linux, some Wayland setups can cause blank windows or compositor errors.
+
+- Jeśli korzystasz z Wayland, a aplikacja jest pusta/ ulega awarii, spróbuj uruchomić ją za pomocą `OC_ALLOW_WAYLAND=1`.
+- Jeśli to pogorszy sprawę, usuń go i zamiast tego spróbuj uruchomić w sesji X11.
+
+---
+
+### Windows: WebView2 runtime
+
+W systemie Windows OpenCode Desktop wymaga Microsoft Edge **WebView2 Runtime**. Jeśli aplikacja otwiera się w pustym oknie lub nie uruchamia się, zainstaluj/zaktualizuj WebView2 i spróbuj ponownie.
+
+---
+
+### Windows: General performance issues
+
+Jeśli doświadczasz niskiej wydajności, problemów z dostępem do plików lub problemów z terminalem w systemie Windows, spróbuj użyć [WSL (podsystem Windows dla systemu Linux) (./windows-wsl). WSL zapewnia środowisko Linux, które płynniej współpracuje z funkcjami OpenCode.
+
+---
+
+### Notifications not showing
+
+OpenCode Desktop only shows system notifications when:
+
+- powiadomienia są włączone dla OpenCode w ustawieniach systemu operacyjnego, oraz
+- okno aplikacji nie jest aktywne.
+
+---
+
+### Reset desktop app storage (last resort)
+
+Jeśli aplikacja nie uruchamia się i nie możesz wyczyścić ustawień w interfejsie użytkownika, zresetuj zapisany stan aplikacji komputerowej.
+
+1. Quit OpenCode Desktop.
+2. Znajdź i usuń te pliki (znajdują się w katalogu danych aplikacji OpenCode Desktop):
+
+- `opencode.settings.dat` (domyślny adres URL serwera na komputerze stacjonarnym)
+- `opencode.global.dat` i `opencode.workspace.*.dat` (stan interfejsu użytkownika, taki jak najnowsze serwery/projekty)
+
+Aby szybko znaleźć katalog:
+
+- **macOS**: Finder -> `Cmd+Shift+G` -> `~/Library/Application Support` (następnie wyszukaj nazwy plików powyżej)
+- **Linux**: wyszukaj powyższe nazwy plików pod `~/.local/share`
+- **Windows**: Naciśnij `WIN+R` -> `%APPDATA%` (następnie wyszukaj nazwy plików powyżej)
+
+---
+
+## Getting help
+
+Jeśli masz problemy z OpenCode:
+
+1. **Report issues on GitHub**
+
+   Najlepszym sposobem zgłaszania błędów lub zgłaszania żądań funkcji jest skorzystanie z naszego repozytorium GitHub:
+
+   [**github.com/anomalyco/opencode/issues**](https://github.com/anomalyco/opencode/issues)
+
+   Przed utworzeniem nowego problemu przeszukaj istniejące i sprawdź, czy Twój problem nie został już zgłoszony.
+
+2. **Join our Discord**
+
+   Aby uzyskać pomoc w czasie rzeczywistym i dyskusję społeczności, dołącz do naszego serwera Discord:
+
+   [**opencode.ai/discord**](https://opencode.ai/discord)
+
+---
+
+## Common issues
+
+Oto kilka typowych problemów i sposobów ich rozwiązania.
+
+---
+
+### OpenCode nie uruchamia się
+
+1. Sprawdź dzienniki pod kątem komunikatów o błędach
+2. Spróbuj uruchomić z `--print-logs`, aby zobaczyć dane wyjściowe w terminalu
+3. Upewnij się, że masz najnowszą wersję z `opencode upgrade`
+
+---
+
+### Authentication issues
+
+1. Spróbuj ponownie uwierzytelnić się za pomocą polecenia `/connect` w TUI
+2. Sprawdź, czy klucze API są ważne
+3. Upewnij się, że Twoja sieć umożliwia połączenia z interfejsem API dostawcy
+
+---
+
+### Model niedostępny
+
+1. Sprawdź, czy dokonałeś uwierzytelnienia u dostawcy
+2. Sprawdź, czy nazwa modelu w konfiguracji jest poprawna
+3. Some models may require specific access or subscriptions
+
+Jeśli napotkasz `ProviderModelNotFoundError`, najprawdopodobniej się mylisz
+odwołując się gdzieś do modelu.
+Models should be referenced like so: `<providerId>/<modelId>`
+
+Examples:
+
+- `openai/gpt-4.1`
+- `openrouter/google/gemini-2.5-flash`
+- `opencode/kimi-k2`
+
+Aby dowiedzieć się, do jakich modeli masz dostęp, uruchom `opencode models`
+
+---
+
+### ProviderInitError
+
+Jeśli napotkasz błąd ProviderInitError, prawdopodobnie masz nieprawidłową lub uszkodzoną konfigurację.
+
+Aby rozwiązać ten problem:
+
+1. Najpierw sprawdź, czy Twój dostawca jest prawidłowo skonfigurowany, postępując zgodnie z [przewodnikiem dostawców](/docs/providers)
+2. Jeśli problem będzie się powtarzał, spróbuj wyczyścić zapisaną konfigurację:
+
+   ```bash
+   rm -rf ~/.local/share/opencode
+   ```
+
+   W systemie Windows naciśnij `WIN+R` i usuń: `%USERPROFILE%\.local\share\opencode`
+
+3. Ponownie uwierzytelnij się u swojego dostawcy za pomocą polecenia `/connect` w TUI.
+
+---
+
+### Problemy z AI_APICallError i pakietem dostawcy
+
+Jeśli napotkasz błędy wywołań API, może to wynikać z nieaktualnych pakietów dostawców. opencode dynamicznie instaluje pakiety dostawców (OpenAI, Anthropic, Google itp.) w razie potrzeby i przechowuje je lokalnie w pamięci podręcznej.
+
+Aby rozwiązać problemy z pakietem dostawcy:
+
+1. Wyczyść pamięć podręczną pakietu dostawcy:
+
+   ```bash
+   rm -rf ~/.cache/opencode
+   ```
+
+   W systemie Windows naciśnij `WIN+R` i usuń: `%USERPROFILE%\.cache\opencode`
+
+2. Uruchom ponownie kod opencode, aby ponownie zainstalować najnowsze pakiety dostawców
+
+Zmusi to opencode do pobrania najnowszych wersji pakietów dostawców, co często rozwiązuje problemy ze zgodnością z parametrami modelu i zmianami API.
+
+---
+
+### Copy/paste not working on Linux
+
+Aby funkcja kopiowania/wklejania działała, użytkownicy systemu Linux muszą mieć zainstalowane jedno z następujących narzędzi schowka:
+
+**Dla systemów X11:**
+
+```bash
+apt install -y xclip
+# or
+apt install -y xsel
+```
+
+**Dla systemów Wayland:**
+
+```bash
+apt install -y wl-clipboard
+```
+
+**Dla środowisk bezgłowych:**
+
+```bash
+apt install -y xvfb
+# and run:
+Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
+export DISPLAY=:99.0
+```
+
+opencode wykryje, czy używasz Waylanda i wolisz `wl-clipboard`, w przeciwnym razie spróbuje znaleźć narzędzia schowka w kolejności: `xclip` i `xsel`.