↓ Zum Hauptinhalt springen
  1. Dokumentation/

PocketHook 1.4: Server und QR-Einrichtung

Voraussetzungen und Kompatibilität
#

PocketHook 1.4 unterstützt Serverprofile unter iOS/iPadOS 26 oder neuer und auf kompatiblen Macs. Ein Server ist kostenlos, einschließlich manueller und QR-Einrichtung. Mehrere Server benötigen einen aktiven Pro-Test, den Pro-Kauf oder die Berechtigung der früheren kostenpflichtigen App. Ein Kauf gilt für alle Profile. Bestehende Pro-Funktionen behalten ihre Zugangsvoraussetzungen.

Das Anhängen oder Einfügen von Bildern im Chat war bereits kostenlos und bleibt es auch. In 1.4 kannst du auch Links zur lokalen Fotomediathek ohne Pro aktivieren. Aktiviere diese Funktion in den Einstellungen und erteile die passende iOS-Berechtigung.

Jeder kompatible HTTPS-Endpunkt bleibt nutzbar. Agent Server 0.8.0 ergänzt die optionale QR-Kopplung und ist für die manuelle Einrichtung nicht erforderlich. Das SDK bleibt bei 0.1.3, Apple Bridge bei 0.6.0. Für Anhänge und asynchrone Ergebnisse gelten weiterhin die Protokollanforderungen von 1.3.

Server hinzufügen und wechseln
#

  1. Öffne Einstellungen → Server verwalten → Server hinzufügen.
  2. Gib HTTPS-Endpunkt und Token ein, scanne eine QR-Einladung oder importiere ihr Bild.
  3. Vergib einen Namen und optional ein Emoji. Ein leeres Emoji-Feld verwendet das Standardsymbol.
  4. Teste die Verbindung und speichere sie. Wechsle über die Auswahl oben im Chat den Server.

Jeder Server behält Chat, Entwurf, Links, Sitzung und ausstehende Aufgaben. Verbindung, Zeitlimits, Statusprüfung, Aufgaben und Personal UI werden in seinen eigenen Einstellungen verwaltet. Das Bearbeiten eines anderen Servers aktiviert ihn nicht. Erneutes Antippen des ausgewählten UI-Tabs lädt die aktuelle Seite neu.

Erscheinungsbild und Navigation
#

Öffne Einstellungen → Server verwalten → dein Server → Erscheinungsbild → Stile. Wähle ein Bild aus Fotos oder Dateien, entferne es, ändere die Farben deiner Nachrichten und der Antworten oder passe die Deckkraft der Sprechblasen an. Die Vorschau zeigt das Ergebnis. Text und Bilder behalten ihre Deckkraft. Sprechblasenfarben zurücksetzen stellt die automatischen Farben wieder her.

Hintergrund auf alle Server anwenden erscheint bei mehreren Profilen und kopiert nur das Bild auf die Server, die auf diesem Gerät hinzugefügt wurden. Farben, Deckkraft und Synchronisierung bleiben je Server erhalten. Hintergrund und Farben werden nicht an den Server gesendet; iCloud überträgt sie nur für Profile mit aktivierter Synchronisierung. Diese Optionen sind kostenlos.

Mac und breite iPad-Fenster bieten eine obere Navigation oder Seitenleiste; auf dem iPhone bleiben die Tabs unten. Liquid Glass folgt den Systemeinstellungen. Transparenz reduzieren hat Vorrang vor der gewählten Deckkraft. Antwortoptionen erscheinen als Karte mit einer Zeile pro Option und der Antwortfarbe des Servers.

Eine Agent-Server-Einladung erzeugen
#

Auf dem Mac mit Agent Server 0.8.0 und installierten Xcode Command Line Tools:

bun run app:qr

Der Befehl liest die lokale Konfiguration und sucht in der vorhandenen Tailscale-Einrichtung oder gespeicherten Tunnelkonfiguration nach einer passenden HTTPS-Adresse. Er erstellt oder verändert keinen Tunnel. Ist keine eindeutige Adresse verfügbar, erklärt er, welche Angabe fehlt. Das Telefon muss die Adresse erreichen können; eine private Tailscale-Adresse setzt weiterhin den entsprechenden Tailscale-Zugang voraus.

Das Terminal zeigt den QR-Code; bun run app:qr --open öffnet zusätzlich das Bild. Einladungen gelten fünf Minuten und nur einmal. Eine neue Einladung oder ein Serverneustart macht die vorherige ungültig. Erzeuge bei Ablauf eine neue. Der QR-Code enthält einen temporären Code, den die App über HTTPS gegen die Zugangsdaten eintauscht.

Behandle die Einladung wie einen Zugang zu deinem Server. Sie verwendet die Zugangsdaten des Eigentümers und erstellt kein separates Benutzerkonto. Mehrere PocketHook-Profile schaffen keine getrennten Benutzer in Agent Server. Veröffentliche keine echten QR-Einladungen in Dokumentationen oder Repositories. Siehe die Kopplungsreferenz des Servers.

Kurzbefehle, Teilen und ausstehende Ergebnisse
#

Aktionen mit Serverzugriff bieten den Parameter Server. Wähle ein Profil, um das Ziel einer Automation festzulegen. Bestehende Aktionen ohne Auswahl behalten das ursprüngliche Profil, unabhängig vom aktiven Chat. Auch beim Teilen lässt sich das Ziel auswählen. Bei einem entfernten oder gesperrten Ziel erscheint ein Fehler; die App sendet den Inhalt nicht an einen anderen Server.

Eine laufende Anfrage behält ihren Ursprungsserver. Solange die App aktiv ist, fragt sie ausstehende Aufgaben aktivierter Profile ab, auch wenn ein anderer Chat geöffnet ist. Ein weiterer Tipp auf Chat startet eine Prüfung. Im Hintergrund bestimmt das Betriebssystem die Abfragen und garantiert keinen genauen Zustellzeitpunkt.

Update, Speicherung und Pro
#

Aktiviere Diesen Server mit iCloud synchronisieren, um Name, Emoji, Chat-Hintergrund, Farben und Deckkraft der Sprechblasen, Verbindungseinstellungen, zugestellte Nachrichten und gespeicherte Links zu teilen. Auf anderen Geräten erscheint er unter In iCloud verfügbar. Du wählst, wo du ihn hinzufügst; erst dann wird sein Verlauf geladen. Ohne Synchronisierung bleibt ein Server gerätelokal. Aktiver Server, Entwürfe und ausstehende Sendungen bleiben auf jedem Gerät unabhängig. Authentifizierungstokens werden bei aktivierter Serversynchronisierung sicher über den iCloud-Schlüsselbund synchronisiert. Aktiviere ihn auf beiden Geräten mit demselben Apple Account; Zugangsdaten können später als das Profil ankommen. Das per QR erhaltene Token muss nicht kopiert werden. Die ursprüngliche Unterhaltung behält ihre bisherige iCloud-Synchronisierung.

Server verwalten fragt iCloud beim Öffnen ab. iCloud aktualisieren startet eine erneute Abfrage und zeigt Fortschritt und letzte Prüfung. Profil, Verlauf und Zugangsdaten können zeitversetzt eintreffen. Fehlen Zugangsdaten, zeigt das Profil an, dass es auf den Schlüsselbund wartet, bevor Nachrichten gesendet werden können.

Ohne aktives Pro wählst du einen kostenlosen Server. Die übrigen bleiben gespeichert, aber gesperrt. Ein Kauf oder die Wiederherstellung von Pro schaltet sie frei. Das Entfernen eines Profils von diesem Gerät trennt die Verbindung und entfernt seine lokalen Zugangsdaten. Es löscht keine entfernten Daten und bedeutet nicht, dass historische lokale oder iCloud-Datensätze gelöscht werden. Siehe die Datenschutzerklärung.

Eigene Server brauchen für mehrere Profile kein neues Pflichtprotokoll. Jedes Profil sendet Anfragen mit eigenen Zugangsdaten und eigener Sitzung an seinen Endpunkt. QR-Kopplung ist eine optionale Ergänzung zum bestehenden Chatprotokoll.