Rozwiązywanie problemów
Ten przewodnik omawia typowe problemy, które możesz napotkać podczas korzystania z Neotask, i sposoby ich rozwiązania.
Licencja i aktywacja
„Nieprawidłowy klucz licencyjny"
- Sprawdź format klucza:
SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX - Sprawdź, czy nie ma dodatkowych spacji lub brakujących znaków
- Upewnij się, że masz aktywne połączenie z internetem
- Spróbuj ponownie wprowadzić klucz ostrożnie
„Licencja odwołana"
- Twoja licencja została odwołana przez serwer
- Sprawdź status rozliczenia na neotask.ai
- Skontaktuj się z pomocą techniczną, jeśli uważasz, że to błąd
„Licencja wygasła"
- Twoja subskrypcja wygasła
- Odnów plan przez portal rozliczeniowy
- Aplikacja przechodzi w tryb tylko do odczytu po wygaśnięciu
„Upłynął okres prolongaty offline"
- Byłeś offline przez ponad 72 godziny
- Połącz się z internetem, aby przeprowadzić automatyczną rewalidację
- Aplikacja wznowi normalne działanie po połączeniu
„Wersja zablokowana"
- Twoja wersja aplikacji została zablokowana ze względów bezpieczeństwa
- Natychmiast zaktualizuj do najnowszej wersji
- Automatyczna aktualizacja powinna Cię o tym poinformować; jeśli nie, pobierz ze strony internetowej
Problemy z bramą
„Nie udało się uruchomić bramy"
- Sprawdź, czy port 18789 jest dostępny (nieużywany przez inną aplikację)
- Spróbuj ponownie uruchomić aplikację
- Sprawdź stan bramy z panelu sterowania
- Na macOS upewnij się, że aplikacja ma niezbędne uprawnienia w Preferencjach systemowych → Prywatność i bezpieczeństwo
„Blokada po 3 próbach"
- Po 3 kolejnych błędach bramy operacje są blokowane
- Uruchom ponownie aplikację, aby zresetować licznik blokady
- Jeśli problem nadal występuje, sprawdź logi pod kątem podstawowego błędu
„Brama rozłączona"
- Lokalne środowisko wykonawcze utraciło połączenie
- Kliknij „Połącz ponownie" w panelu bramy
- Jeśli ciągle się rozłącza, uruchom ponownie aplikację
- Sprawdź, czy żadna zapora nie blokuje połączeń localhost
Problemy głosowe
„Nie wykryto wejścia audio"
- Nadaj uprawnienie do mikrofonu:
- macOS: Preferencje systemowe → Prywatność i bezpieczeństwo → Mikrofon → Włącz dla Neotask
- Windows: Ustawienia → Prywatność → Mikrofon → Zezwól aplikacjom na dostęp
- Sprawdź, czy mikrofon nie jest wyciszony
- Sprawdź, czy w ustawieniach systemowych wybrano prawidłowe urządzenie wejściowe
„Słowo aktywacyjne nie wyzwala"
- Upewnij się, że aktywacja głosowa jest włączona w Ustawieniach
- Sprawdź, czy tryb budzenia jest ustawiony na „Porcupine" (nie „Skrót" lub „Wył.")
- Wyraźnie wypowiedz frazę aktywacyjną: „Hey Neotask"
- Spróbuj zamiast tego skrótu klawiszowego (Cmd+Shift+Space / Ctrl+Shift+Space)
- Sprawdź, czy inna aplikacja nie używa mikrofonu
„Dźwięk TTS urywany lub opóźniony"
- Sprawdź połączenie internetowe (TTS wymaga API ElevenLabs)
- ElevenLabs może doświadczać ograniczenia szybkości
- Spróbuj innego głosu w Ustawieniach
- Zmniejsz aktywność sieci w tle
„Skrót głosowy nie działa"
- Inna aplikacja mogła przejąć ten sam skrót
- Zmień skrót w Ustawienia → Aktywacja → Skrót klawiszowy
- Na macOS sprawdź Preferencje systemowe → Klawiatura → Skróty pod kątem konfliktów
Połączenie i sieć
„Nie można połączyć się z serwerem"
- Sprawdź połączenie internetowe
- Sprawdź, czy neotask.ai jest dostępny w przeglądarce
- Jeśli jesteś za firmową zaporą, upewnij się, że ruch HTTPS jest dozwolony
- Spróbuj tymczasowo wyłączyć VPN
„Żądanie API nie powiodło się"
- Sprawdź połączenie internetowe
- Sprawdź, czy Twoja licencja jest aktywna
- Jeśli używasz BYOK, sprawdź, czy klucz API jest prawidłowy i ma kredyty
- Spróbuj odświeżyć panel sterowania
Agenci i sesje
„Nie można utworzyć agenta: osiągnięto limit"
- Liczba agentów nie jest ograniczona przez plan; tworzenie własnych agentów wymaga płatnego planu
- Jeśli widzisz to w planie Free, przejdź na płatny plan, aby tworzyć własnych agentów
- Usuń nieużywanych agentów, aby utrzymać porządek w przestrzeni roboczej
„Agent nie odpowiada"
- Sprawdź stan bramy (musi być uruchomiona)
- Sprawdź, czy model agenta jest dostępny (klucz API prawidłowy, dostawca dostępny)
- Sprawdź dzienny budżet -- jeśli przekroczony, agenci są wstrzymywani do północy czasu UTC
- Spróbuj zresetować sesję
„Wiadomości sesji nie ładują się"
- Odśwież stronę/aplikację
- Sprawdź status połączenia bramy
- Jeśli sesja jest bardzo długa, spróbuj utworzyć nową sesję
Rozliczenia i płatności
„Płatność nie powiodła się"
- Sprawdź, czy dane karty są prawidłowe
- Sprawdź z bankiem, czy nie ma blokad transakcji międzynarodowych
- Spróbuj innej metody płatności
- Skontaktuj się z pomocą techniczną, jeśli problem nadal występuje
„Przekroczono alokację użytkowania"
- Zużycie tokenów przez Twojego agenta przekroczyło alokację zawartą w subskrypcji
- Dodatkowe użytkowanie jest rozliczane według stawek za użytkowanie. Sprawdź stronę Użytkowanie w panelu sterowania, aby uzyskać szczegóły.
- Przełącz na tryb BYOK (używaj własnych kluczy API), aby kierować koszty tokenów bezpośrednio do dostawcy
- Ustaw dzienne limity budżetu, aby zapobiec nieoczekiwanym przekroczeniom
„Plan nie zaktualizował się po płatności"
- Webhooki Stripe mogą mieć niewielkie opóźnienie (zazwyczaj poniżej 1 minuty)
- Odśwież panel sterowania
- Jeśli nadal nie zaktualizował się po 5 minutach, skontaktuj się z pomocą techniczną z potwierdzeniem płatności
Wydajność
„Aplikacja wolno uruchamia się"
- Walidacja licencji i uruchamianie bramy odbywają się podczas uruchamiania -- to normalne
- Upewnij się, że Twój system spełnia minimalne wymagania
- Zamknij zbędne aplikacje działające w tle
„Wysokie użycie procesora"
- Jeśli używasz zawsze aktywnego słowa aktywacyjnego (Porcupine), używa minimalnego procesora, ale można je wyłączyć
- Wstrzymuj sesje głosowe, gdy nie są używane
- Sprawdź zablokowane procesy bramy w Monitorze aktywności / Menedżerze zadań
„Wysokie użycie pamięci"
- Długie sesje czatu gromadzą pamięć
- Twórz nowe sesje okresowo
- Uruchom ponownie aplikację, aby wyczyścić zgromadzony stan
Uzyskiwanie pomocy
- Dokumentacja: Jesteś tutaj -- przeglądaj bazę wiedzy
- Pomoc techniczna: Odwiedź stronę wsparcia na neotask.ai/support
- Kontakt: Użyj formularza kontaktowego na stronie internetowej
- Status: Sprawdź status usługi na neotask.ai