Troubleshooting
Start aplikacji
Dział zatytułowany „Start aplikacji”| Problem | Rozwiązanie |
|---|---|
| Tauri nie startuje / brak CLI | cargo install tauri-cli; uruchom pnpm tauri:dev:diag |
| Zła wersja Node/pnpm | pnpm env:verify, pnpm run preflight:node, sprawdź engines (Node >=20, pnpm >=10.14) |
| Brak .env | cp src-tauri/.env.example src-tauri/.env, uzupełnij klucze, pnpm env:verify |
Zależności systemowe
Dział zatytułowany „Zależności systemowe”| Platform | Problem | Rozwiązanie |
|---|---|---|
| Linux | Brak Playwright | pnpm exec playwright install --with-deps |
| Windows | Brak WebView2 | Zainstaluj WebView2 Runtime + Visual Studio Build Tools |
| macOS | Brak Xcode CLT | xcode-select --install |
Baza danych (DEV)
Dział zatytułowany „Baza danych (DEV)”| Operacja | Komenda |
|---|---|
| Reset | node scripts/reset-vista-db.mjs reset |
| Backup | node scripts/reset-vista-db.mjs backup |
| Restore | node scripts/reset-vista-db.mjs restore |
| Info | node scripts/reset-vista-db.mjs info |
Lokalizacja DB
Dział zatytułowany „Lokalizacja DB”| Platform | Ścieżka |
|---|---|
| macOS | ~/Library/Application Support/Vista/vista.db |
| Windows | %APPDATA%/Vista/vista.db |
| Linux | ~/.local/share/Vista/vista.db |
Testy i porty
Dział zatytułowany „Testy i porty”| Problem | Rozwiązanie |
|---|---|
| Vitest/E2E nie startują przez porty | node scripts/ensure-test-ports.mjs |
| Brak AI config | pnpm sync:ai-config przed testami |
| Brak przeglądarek Playwright | patrz sekcja zależności systemowych |
Manifesty i hooki
Dział zatytułowany „Manifesty i hooki”| Problem | Rozwiązanie |
|---|---|
| Manifest diff po rebazie | pnpm manifest:ensure (plus warianty :tauri, :docs, :config, :scripts) |
| File >1000 linii | Refaktor lub tymczasowy komentarz vista:file-length-ignore |
| Pre-push uruchamia testy | Domyślnie pominięte; włącz VISTA_PREPUSH_TESTS=1 jeśli potrzebne |
Build/Release
Dział zatytułowany „Build/Release”| Problem | Rozwiązanie |
|---|---|
| macOS signing/notary | pnpm mac:keys:setup, pnpm mac:notarize; ad-hoc: pnpm build:desktop:mac:adhoc |
| Windows build | Upewnij się, że VS Build Tools i WebView2 są zainstalowane; użyj pnpm build:desktop:win |
| Brakujące deps Tauri (Linux) | Doinstaluj libgtk-3-dev libssl-dev webkit2gtk-4.0 |
Diagnostyka
Dział zatytułowany „Diagnostyka”| Komenda | Opis |
|---|---|
pnpm node:diagnose | Wypisuje wersje i ścieżki |
pnpm tauri:dev:diag | Uruchamia appkę z logami diagnostycznymi |
Kiedy pingować zespół
Dział zatytułowany „Kiedy pingować zespół”Szybkie fixy
Dział zatytułowany „Szybkie fixy”Tauri CLI not found
Dział zatytułowany „Tauri CLI not found”cargo install tauri-cliProblemy z SQLite na macOS
Dział zatytułowany „Problemy z SQLite na macOS”brew install sqliteBłędy WebView2 na Windows
Dział zatytułowany „Błędy WebView2 na Windows”Pobierz i zainstaluj WebView2 Runtime.
Port zajęty
Dział zatytułowany „Port zajęty”# Znajdź proces na porcielsof -i :1420# Zabij proceskill -9 <PID>