Communitygithub.com

LiveHotspot

Ein Agenten-Skill, um Laptop-Hotspots (Smartphone) unter macOS, Windows und Linux am Leben zu halten.

Was ist LiveHotspot?

LiveHotspot ist ein technischer Agenten-Skill, der Verbindungsabbrüche zwischen einem Laptop und einem Smartphone-Hotspot zuverlässig verhindert. Dazu analysiert er das aktuelle Betriebssystem, den Verbindungsstatus und die Energieeinstellungen, bevor er eine minimale, transparente Gegenmaßnahme installiert. Der Skill unterstützt sowohl den Client-Modus (Laptop verbindet sich mit Telefon-Hotspot) als auch den Host-Modus (Laptop erstellt eigenen Hotspot) und wählt automatisch die passende native Lösung: LaunchAgent unter macOS, Task Scheduler unter Windows oder systemd-Service unter Linux. Alle Skripte sind benutzersichtbar, protokollieren in normale Verzeichnisse und vermeiden verschleierte oder administrative Operationen. Durch klare Rollback-Befehle und eine optionale Anleitung für schwächere lokale Agenten (assets/agent-prompt.zh.md) ist der Skill sowohl für direkte als auch delegierte Ausführung geeignet.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add LongChangPost/livehotspot

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht LiveHotspot?

Betriebsmodell

Behandle Hotspot-Instabilität als zwei zusammenhängende Probleme:

  1. Der Laptop schläft ein, legt Festplatten in den Ruhezustand oder verliert die WLAN-Verbindung während langer Arbeit.
  2. Der Smartphone-Hotspot oder der WLAN-Stack des Betriebssystems entscheidet, dass der Client inaktiv ist, und trennt die Verbindung.

Verwende die kleinstmögliche transparente Lösung, die den Live-Rechner handhabt. Bevorzuge native Befehle, benutzerebene Scheduler, lesbare Skripte, Protokolle und einfache Rollback-Befehle. Vermeide kompilierte Binärdateien, Verschleierung, Abfangen von Anmeldedaten, Browser- / Sitzungszugriff, versteckte Persistenz, globale Energieänderungen oder Administrator-Ausweitung, es sei denn, der Benutzer stimmt explizit zu.

Dieser Skill muss in zwei Modi funktionieren:

  • Direkter Ausführungsmodus: Der aktuelle Agent diagnostiziert und installiert die Lösung auf dem Live-Rechner.
  • Delegationsmodus: Der aktuelle Agent gibt dem Benutzer einen einzigen Kopier-Einfügen-Text aus assets/agent-prompt.zh.md, sodass ein schwächerer lokaler Agent den Workflow ausführen kann.

Workflow

  1. Bestätige das Betriebssystem und die Hotspot-Rolle.

    • Client-Modus: Der Laptop verbindet sich mit einem Smartphone-Hotspot. Dies ist die Standardeinstellung für diesen Skill.
    • Host-Modus: Der Laptop erstellt einen Hotspot für andere Geräte. Verwende die OS-spezifischen Hinweise in references/windows.md oder references/linux.md; wende keine Client-Annahmen blind an.
  2. Überprüfe den aktuellen Zustand, bevor du Änderungen vornimmst.

    • macOS: route -n get default, ipconfig getifaddr en0, networksetup -getairportnetwork en0, pmset -g assertions.
    • Windows: netsh wlan show interfaces, ipconfig, powercfg /requests.
    • Linux: nmcli -t -f DEVICE,TYPE,STATE,CONNECTION dev, ip route, systemd-inhibit --list.
  3. Wähle den OS-Pfad.

    • macOS: Verwende scripts/macos-livehotspot.sh plus einen Benutzer-LaunchAgent. Lies references/macos.md.
    • Windows: Verwende eine Benutzer-Aufgabenplaner-Aktion (Task Scheduler), die ein transparentes PowerShell-Skript ausführt. Lies references/windows.md.
    • Linux: Verwende NetworkManager plus einen Benutzer-systemd-Dienst/Timer, sofern verfügbar. Lies references/linux.md.
  4. Halte AV- und Sicherheitsprozess unauffällig.

    • Speichere Skripte in einem normalen Benutzerverzeichnis mit ASCII-Pfaden.
    • Protokolliere in einen normalen Benutzer-Protokollpfad.
    • Verwende kein curl | sh, keine Base64-Payloads, keine codierten PowerShell-Befehle, Registry-Run-Keys, LaunchDaemons, Root-Dienste, Browserautomatisierung oder Anmelde-API.
    • Bevorzuge für den Benutzer sichtbare Befehlszeilen und dokumentierte OS-APIs.
    • Füge Deinstallationsbefehle in die endgültige Antwort ein.
  5. Überprüfe mit Nachweisen.

    • Zeige dem Benutzer den Dienststatus, Prozess-/Assertionsnachweise, die letzten Protokollzeilen und eine kurze Stabilitätsprüfung über einen Zeitraum.
    • Wenn der Test auf dem aktuellen Betriebssystem nicht ausgeführt werden kann, teile dies mit und biete stattdessen einen Trockentest/Syntax-Check an.

Kopier-Einfügen-Agenten-Prompt

Wenn der Benutzer möchte, dass ein anderer Agent diese Fähigkeit verwendet, gib den Text aus assets/agent-prompt.zh.md zurück. Fasse seine Sicherheitsregeln nicht zusammen; der Punkt ist, einem schwächeren Agenten ein vollständiges, explizites Handbuch zu geben.

Entscheidungspunkte

  • Wenn der Hotspot ein iPhone auf macOS ist, erkenne ihn über die Route/Gateway und das Adressmuster 172.20.10.x anstelle der SSID; Instant Hotspot meldet oft keine AirPort-Assoziation, während das Routing dennoch funktioniert.
  • Wenn die Verbindung nach dem Keepalive immer noch abbricht, füge erneute Verbindungsversuche zu bekannten SSIDs hinzu, dann erwäge USB-Tethering als nächstzuverlässigeren Transport.
  • Wenn der Benutzer mit Akku arbeitet und eine lange Laufzeit wünscht, frage vor dem Erzwingen von aggressivem Nicht-Schlaf-Verhalten.
  • Wenn eine unternehmenseigene Antiviren-/EDR-Software vorhanden ist, halte die Skripte besonders einfach: keine codierten Befehle, keine heruntergeladenen Abhängigkeiten, keine versteckten geplanten Aufgaben, keine Privilegienausweitung.

Mitgelieferte Ressourcen

  • scripts/macos-livehotspot.sh: generischer macOS-Clientseitiger Keepalive-/Wiederverbindungs-Loop, adaptiert von einer Live-iPhone-Hotspot-Lösung.
  • references/macos.md: LaunchAgent-Installations-/Überprüfungs-/Deinstallationsmuster.
  • references/windows.md: PowerShell- und Aufgabenplaner-Muster für Windows-Laptops.
  • references/linux.md: NetworkManager- und Benutzer-systemd-Muster für Linux-Laptops.
  • references/research.md: Notizen aus öffentlicher GitHub-/Web-Recherche und was nicht blind wiederverwendet werden sollte.
  • assets/agent-prompt.zh.md: Chinesischer Kopier-Einfügen-Prompt für generische lokale Agenten, einschließlich Sicherheitsregeln, OS-Routing, Überprüfung und Rollback-Anforderungen.

Verwandte Skills