Dokumentacja ustawień

Synchronizacja

#

PocketHook synchronizuje Twoje rozmowy i ustawienia aplikacji między Twoimi urządzeniami przy użyciu Twojego prywatnego konta iCloud — bez konta PocketHook, bez żadnego serwera zewnętrznego.

Zaloguj się na to samo konto iCloud na swoim iPhonie, iPadzie i Macu, a wszystko pojawi się automatycznie — bez żadnej konfiguracji. Twoje dane pozostają w Twojej własnej, prywatnej bazie danych iCloud; serwery PocketHook nigdy ich nie widzą.

Konfiguracja Serwera

#

Podstawowe ustawienia połączenia z Twoim serwerem PocketHook.

URL Serwera

#

Endpoint HTTPS, na który PocketHook wysyła Twoje wiadomości z czatu. Akceptowane są wyłącznie adresy HTTPS — HTTP jest odrzucane ze względów bezpieczeństwa. To główny endpoint, na którym nasłuchuje Twój serwer.

Token Uwierzytelniania

#

Token Bearer wysyłany w nagłówku Authorization z każdym żądaniem. Twój serwer może go użyć do weryfikacji, że żądania pochodzą z Twojego urządzenia. Przechowywany bezpiecznie w iOS Keychain — nigdy w postaci jawnego tekstu.

Zgodność z OpenClaw

#

Włącz, jeśli Twój serwer korzysta z platformy OpenClaw lub dowolnego API zgodnego z OpenAI Chat Completions. Po włączeniu PocketHook wysyła wiadomości w formacie czatu OpenAI i parsuje z odpowiedzi znaczniki skrótów w tekście ([SHORTCUT:name], [DATA:{...}], [URL:...]). Do żądań dołączany jest nagłówek x-openclaw-agent-id.

Testuj Połączenie

#

Przycisk wysyłający żądanie testowe do skonfigurowanego serwera. Wyświetla:

• Czas odpowiedzi w milisekundach
• Wynik health checku (jeśli włączony)
• Szczegóły błędu, jeśli połączenie się nie powiedzie

Użyj po zmianie URL Serwera lub Tokenu Uwierzytelniania, aby sprawdzić, czy wszystko działa.

Sieć

#

Dostosuj zachowanie limitów czasu dla różnych typów operacji.

Limit Czasu Żądania

#

Jak długo PocketHook czeka, aż serwer zacznie odpowiadać na żądanie. Jeśli Twój serwer wykonuje ciężkie przetwarzanie (np. wywołuje model AI), zwiększ tę wartość. Dla prostych serwerów webhook domyślne 5 sekund zwykle wystarcza.

Limit Czasu Zasobu

#

Maksymalny czas na ukończenie całej odpowiedzi, łącznie z transferem danych. Powinien być wyższy niż Limit Czasu Żądania. Zwiększ, jeśli Twój serwer zwraca duże payloady lub ma wolną prędkość wysyłania.

Health Check

#

Włącza monitorowanie stanu serwera. Gdy aktywne, PocketHook wysyła żądanie GET na URL Health Checku podczas testów połączenia i wyświetla, czy serwer zgłasza poprawny stan.

URL Health Checku

#

Osobny endpoint HTTPS zwracający zwykły tekst true lub false. Ten URL jest odpytywany podczas testów połączenia, aby zweryfikować, że serwer działa. Przydatne, gdy główny endpoint API jest za uwierzytelnianiem, a chcesz prostego sprawdzenia stanu.

Automatyzacja

#

Kontroluj, jak PocketHook wykonuje Skróty iOS wyzwalane odpowiedziami serwera.

Skróty iOS

#

Główny przełącznik wykonywania Skrótów. Gdy jest OFF, PocketHook nadal wyświetla wiadomości z serwera, ale ignoruje wszelkie pola shortcut w odpowiedziach. Przydatne do debugowania lub tymczasowego wyłączenia automatyzacji.

Opóźnienie Między Skrótami

#

Czas oczekiwania między wykonaniem kolejnych skrótów, gdy serwer zwraca wiele automatyzacji w jednej odpowiedzi. Zwiększ, jeśli Twoje skróty zależą od siebie (np. pierwszy skrót tworzy plik, który czyta drugi).

Limit Czasu Skrótu

#

Maksymalny czas oczekiwania na zakończenie każdego pojedynczego skrótu, zanim PocketHook uzna go za przekroczony. Długo działające skróty (np. przetwarzające multimedia lub wykonujące wiele wywołań API) mogą potrzebować pełnych 5 minut.

Osobisty Interfejs

#

Osadź własny interfejs webowy bezpośrednio w PocketHook.

Osobisty Interfejs

#

Pokazuje dedykowaną kartę z osadzonym widokiem webowym. Po włączeniu w głównej nawigacji pojawia się nowa karta, na której wyświetlana jest Twoja własna strona internetowa. Strona jest wstępnie ładowana dla natychmiastowego wyświetlenia i obsługuje pull-to-refresh.

URL Osobistego Interfejsu

#

URL wyświetlany na karcie Osobistego Interfejsu. Akceptowane są zarówno HTTP, jak i HTTPS (zalecane HTTPS). Może to być dashboard, panel administracyjny lub dowolna strona, do której chcesz mieć szybki dostęp obok czatu.

Linki

#

Skonfiguruj, jak PocketHook obsługuje adresy URL z odpowiedzi serwera.

Karta Linki

#

Pokazuje lub ukrywa kartę Linki w głównej nawigacji. Po włączeniu wszystkie adresy URL otrzymane z odpowiedzi serwera są zapisywane i wyświetlane na dedykowanej karcie z bogatymi podglądami linków, wyszukiwaniem i możliwością usuwania.

Automatyczne Otwieranie URL

#

Gdy włączone, PocketHook automatycznie otwiera adresy URL z odpowiedzi serwera w domyślnej przeglądarce. Gdy wyłączone, adresy URL są nadal zapisywane na karcie Linki (jeśli włączona), ale nie otwierają się automatycznie.

To ustawienie jest celowo skonfigurowane osobno na każdym urządzeniu: możesz chcieć, aby linki otwierały się automatycznie na Twoim iPhonie, ale nie na Macu. Dotknięcie pigułki z linkiem pod wiadomością zawsze ją otwiera, niezależnie od tego ustawienia.

Język

#

Dostosuj język aplikacji i dyktowania.

Język Aplikacji

#

Zmienia język wyświetlania aplikacji niezależnie od języka urządzenia. Przy ustawieniu „Domyślny systemu" PocketHook podąża za ustawieniem języka iOS.

Język Dyktowania

#

Język używany do dyktowania głosowego (zamiany mowy na tekst) w polu czatu. Dostępne języki:

Zadania w Tle

#

Okresowo sprawdzaj oczekujące zadania, nawet gdy aplikacja jest w tle.

Zadania w Tle

#

Włącza polling w tle. Gdy aktywne, PocketHook okresowo wysyła żądanie GET na URL Pollingu. Jeśli odpowiedź to true, po otwarciu aplikacji wysyła Wiadomość Pobierania do Twojego głównego serwera. Wymaga uprawnienia do powiadomień, aby ostrzegać o oczekujących zadaniach.

Częstotliwość Sprawdzania

#

Jak często PocketHook sprawdza URL Pollingu w tle. Krótsze interwały oznaczają szybsze wykrywanie oczekujących zadań, ale większe zużycie baterii. iOS może dostosować rzeczywistą częstotliwość na podstawie wzorców użycia urządzenia.

URL Pollingu

#

Endpoint HTTPS odpytywany przez PocketHook w skonfigurowanym interwale. Musi zwracać zwykły tekst true (zadania oczekują) lub false (brak zadań). To lekkie sprawdzenie — Twój serwer powinien odpowiadać szybko, bez ciężkiego przetwarzania.

Agent Server: Użyj https://your-host/jobs (dostosuj host i port do swojej konfiguracji).

Wiadomość Pobierania

#

Wiadomość wysyłana do głównego serwera, gdy sprawdzenie w tle znajdzie oczekujące zadania i aplikacja zostanie otwarta. Odpowiedź serwera pojawia się na czacie jak każda inna wiadomość. Dostosuj ją, aby wyzwolić określone zachowanie po stronie serwera.

Zarządzanie Danymi

#

Monitoruj i zarządzaj przechowywanymi wiadomościami.

Przechowywane Wiadomości

#

Pokazuje, ile wiadomości jest obecnie przechowywanych. Wskaźnik jest oznaczony kolorami:

• Zielony — Poniżej 70% pojemności
• Pomarańczowy — 70–90% pojemności
• Czerwony — Powyżej 90% pojemności

Po osiągnięciu limitu 500 wiadomości najstarsze wiadomości są automatycznie usuwane, aby zrobić miejsce na nowe.

Eksportuj Rozmowę

#

Przycisk eksportujący wszystkie przechowywane wiadomości jako plik JSON przez arkusz udostępniania iOS. Możesz zapisać plik, wysłać go przez AirDrop lub udostępnić dowolnej aplikacji. Przydatne do tworzenia kopii zapasowych rozmów lub analizy historii wiadomości.

Usuń Wszystkie Wiadomości

#

Destrukcyjny przycisk trwale usuwający wszystkie przechowywane wiadomości. Wymaga potwierdzenia przed wykonaniem. Tej akcji nie można cofnąć.

O Aplikacji

#

Informacje o Twojej instalacji PocketHook (tylko do odczytu).