Communitygithub.com

LiveHotspot

LiveHotspot : une compétence d'agent pour maintenir le hotspot du téléphone actif sur macOS, Windows et Linux.

Qu'est-ce que LiveHotspot ?

LiveHotspot est une compétence d'agent conçue pour résoudre le problème persistant de déconnexion des hotspots téléphoniques sur les ordinateurs portables exécutant macOS, Windows ou Linux. Elle traite l'instabilité du hotspot comme deux problèmes liés : la mise en veille de l'ordinateur et la déconnexion par le hotspot du téléphone ou la pile Wi-Fi de l'OS. La compétence fonctionne en deux modes : en mode d'exécution directe, où l'agent actuel diagnostique et installe la solution sur la machine ; et en mode de délégation, où l'agent fournit une invite copier-coller pour qu'un agent local plus limité puisse exécuter le flux de travail. LiveHotspot privilégie les commandes natives, les planificateurs au niveau utilisateur, les scripts lisibles, les journaux, et des commandes de restauration simples, tout en évitant les binaires compilés, l'obfuscation, l'élévation de privilèges non autorisée, et les modifications de configuration globales sans consentement explicite. La solution s'adapte à chaque système d'exploitation : macOS utilise un LaunchAgent avec un script shell ; Windows utilise un Planificateur de tâches avec PowerShell ; Linux utilise NetworkManager avec un service/temporisateur systemd utilisateur. Des instructions détaillées pour vérifier l'état actuel, choisir la méthode appropriée, et fournir des preuves de stabilité sont incluses, avec des ressources de référence et un prompt copier-coller pour les agents locaux.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add LongChangPost/livehotspot

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Que fait LiveHotspot ?

Modèle de fonctionnement

Traiter l'instabilité du hotspot comme deux problèmes liés :

  1. L'ordinateur portable se met en veille, met les disques en sommeil ou perd le Wi-Fi lors d'un travail de longue durée.
  2. Le hotspot du téléphone ou la pile Wi-Fi de l'OS décide que le client est inactif et se déconnecte.

Utiliser la correction transparente la plus petite qui gère la machine en activité. Privilégier les commandes natives, les planificateurs au niveau utilisateur, les scripts lisibles, les journaux et les commandes de restauration simples. Éviter les binaires compilés, l'obfuscation, la récupération d'identifiants, l'accès au navigateur/session, la persistance furtive, les astuces de fenêtres cachées, les modifications globales de l'alimentation ou l'escalade d'administration, sauf si l'utilisateur approuve explicitement.

Cette compétence doit fonctionner en deux modes :

  • Mode d'exécution directe : l'agent actuel diagnostique et installe la correction sur la machine en cours d'exécution.
  • Mode de délégation : l'agent actuel donne à l'utilisateur une invite copier-coller unique provenant de assets/agent-prompt.zh.md afin qu'un agent local plus faible puisse exécuter le flux de travail.

Flux de travail

  1. Confirmer l'OS et le rôle du hotspot.

    • Mode client : l'ordinateur portable se connecte à un hotspot téléphonique. C'est le comportement par défaut pour cette compétence.
    • Mode hôte : l'ordinateur portable crée un hotspot pour d'autres appareils. Utiliser les notes spécifiques à l'OS dans references/windows.md ou references/linux.md ; ne pas appliquer aveuglément les hypothèses du mode client.
  2. Inspecter l'état actuel avant de modifier quoi que ce soit.

    • 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. Choisir le chemin selon l'OS.

    • macOS : utiliser scripts/macos-livehotspot.sh plus un LaunchAgent utilisateur. Lire references/macos.md.
    • Windows : utiliser une action du Planificateur de tâches utilisateur qui exécute un script PowerShell transparent. Lire references/windows.md.
    • Linux : utiliser NetworkManager plus un service/temporisateur systemd utilisateur lorsqu'il est disponible. Lire references/linux.md.
  4. Garder AV et posture de sécurité sobres.

    • Stocker les scripts dans un répertoire utilisateur normal avec des chemins ASCII.
    • Journaliser dans un chemin de logs utilisateur normal.
    • Ne pas utiliser curl | sh, les charges utiles base64, les commandes PowerShell encodées, les clés Run du registre, les LaunchDaemons, les services root, l'automatisation du navigateur ou les API d'identifiants.
    • Privilégier les lignes de commande visibles par l'utilisateur et les API OS documentées.
    • Inclure les commandes de désinstallation dans la réponse finale.
  5. Vérifier avec des preuves.

    • Montrer à l'utilisateur l'état du service, les preuves de processus/assertion, les dernières lignes de journal, et une brève vérification de stabilité sur une fenêtre de temps.
    • Si le test ne peut pas être exécuté sur l'OS actuel, le dire et fournir un dry-run / une vérification syntaxique à la place.

Prompt copier-coller pour l'agent

Lorsque l'utilisateur souhaite qu'un autre agent utilise cette fonctionnalité, renvoyer le texte dans assets/agent-prompt.zh.md. Ne pas résumer ses règles de sécurité ; le but est de donner à un agent plus faible un guide d'exécution complet et explicite.

Points de décision

  • Si le hotspot est un iPhone sur macOS, le détecter par la route/passerelle et le motif d'adresse 172.20.10.x plutôt que par le SSID seul ; Instant Hotspot signale souvent aucune association AirPort alors que le routage fonctionne toujours.
  • Si la connexion continue de tomber après le keepalive, ajouter des tentatives de reconnexion aux SSID connus, puis considérer le partage de connexion USB comme le transport le plus fiable suivant.
  • Si l'utilisateur est sur batterie et souhaite une longue durée d'exécution, demander avant de forcer un comportement agressif d'absence de veille.
  • Si un antivirus/EDR d'entreprise est présent, garder les scripts particulièrement simples : pas de commandes encodées, pas de dépendances téléchargées, pas de tâche planifiée cachée, pas d'élévation de privilèges.

Ressources fournies

  • scripts/macos-livehotspot.sh : boucle générique de keepalive/reconnexion côté client macOS adaptée d'une correction pour hotspot iPhone en direct.
  • references/macos.md : modèle d'installation/vérification/désinstallation du LaunchAgent.
  • references/windows.md : modèle PowerShell et Planificateur de tâches pour ordinateurs portables Windows.
  • references/linux.md : modèle NetworkManager et systemd utilisateur pour ordinateurs portables Linux.
  • references/research.md : notes issues de recherches publiques GitHub/web et ce qu'il ne faut pas réutiliser aveuglément.
  • assets/agent-prompt.zh.md : invite copier-coller en chinois pour les agents locaux génériques, incluant les règles de sécurité, le routage OS, la vérification et les exigences de restauration.

Skills associés