Communitygithub.com

LiveHotspot

LiveHotspot: uma habilidade de agente para manter hotspots de laptop e telefone ativos no macOS, Windows e Linux.

O que é LiveHotspot?

LiveHotspot é uma habilidade para agentes de IA que resolve o problema de hotspots de telefone ou laptop caírem durante sessões de trabalho longas. Ela trata a instabilidade do hotspot como dois problemas relacionados: o laptop adormecer ou perder Wi-Fi, e o hotspot do telefone ou a pilha de Wi-Fi do SO desconectar o cliente por inatividade. A habilidade prefere soluções nativas, scripts legíveis e comandos de reversão simples, evitando binários compilados, ofuscação ou escalonamento de privilégios sem aprovação explícita. Suporta macOS, Windows e Linux, atuando em dois modos: execução direta (diagnóstico e instalação da correção no próprio dispositivo) e modo de delegação (fornece um prompt copiável para que um agente local mais fraco execute o fluxo). O workflow inclui confirmação do SO e do papel do hotspot, inspeção do estado atual, escolha do caminho específico do SO (LaunchAgent no macOS, Task Scheduler no Windows, systemd no Linux), instalação do script de keepalive, verificação com evidências e comandos de desinstalação. A habilidade também fornece diretrizes de segurança detalhadas para evitar alertas de antivírus e EDRs corporativos.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add LongChangPost/livehotspot

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que LiveHotspot faz?

Modelo Operacional

Trate a instabilidade do hotspot como dois problemas relacionados:

  1. O laptop adormece, discos entram em idle ou o Wi-Fi cai durante trabalhos longos.
  2. O hotspot do telefone ou a pilha de Wi-Fi do SO decide que o cliente está inativo e desconecta.

Use a menor correção transparente que mantenha a máquina ativa. Prefira comandos nativos, agendadores em nível de usuário, scripts legíveis, logs e comandos de reversão simples. Evite binários compilados, ofuscação, raspagem de credenciais, acesso a navegador/sessão, persistência oculta, truques de janela invisível, mudanças globais de energia ou escalonamento administrativo, a menos que o usuário aprove explicitamente.

Esta habilidade deve funcionar em dois modos:

  • Modo de execução direta: o agente atual diagnostica e instala a correção na máquina ativa.
  • Modo de delegação: o agente atual fornece ao usuário um único prompt de copiar-e-colar do arquivo assets/agent-prompt.zh.md para que um agente local mais fraco execute o fluxo.

Fluxo de Trabalho

  1. Confirme o SO e o papel do hotspot.

    • Modo cliente: o laptop se conecta a um hotspot de telefone. Este é o padrão para esta habilidade.
    • Modo host: o laptop cria um hotspot para outros dispositivos. Use as notas específicas do SO em references/windows.md ou references/linux.md; não aplique suposições de cliente cegamente.
  2. Inspecione o estado atual antes de alterar qualquer coisa.

    • 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. Escolha o caminho do SO.

    • macOS: use scripts/macos-livehotspot.sh mais um LaunchAgent do usuário. Leia references/macos.md.
    • Windows: use uma ação do Agendador de Tarefas do usuário que executa um script PowerShell transparente. Leia references/windows.md.
    • Linux: use NetworkManager mais um serviço/timer systemd do usuário quando disponível. Leia references/linux.md.
  4. Mantenha a postura de AV e segurança simples.

    • Armazene scripts em um diretório de usuário normal com caminhos ASCII.
    • Registre logs em um caminho de log normal do usuário.
    • Não use curl | sh, payloads base64, comandos PowerShell codificados, chaves Run do registro, LaunchDaemons, serviços root, automação de navegador ou APIs de credenciais.
    • Prefira linhas de comando visíveis para o usuário e APIs do SO documentadas.
    • Inclua comandos de desinstalação na resposta final.
  5. Verifique com evidências.

    • Mostre ao usuário o estado do serviço, evidências de processo/assercões, últimas linhas de log e uma verificação de estabilidade de curta duração.
    • Se o teste não puder ser executado no SO atual, informe e forneça uma simulação/verificação de sintaxe.

Prompt Copiável do Agente

Quando o usuário quiser que outro agente use esta capacidade, retorne o texto em assets/agent-prompt.zh.md. Não resuma suas regras de segurança; o objetivo é fornecer a um agente mais fraco um guia completo e explícito.

Pontos de Decisão

  • Se o hotspot for um iPhone no macOS, detecte-o pela rota/gateway e pelo padrão de endereço 172.20.10.x em vez de apenas SSID; o Instant Hotspot frequentemente relata nenhuma associação AirPort enquanto o roteamento ainda funciona.
  • Se a conexão ainda cair após o keepalive, adicione tentativas de reconexão a SSIDs conhecidos e, em seguida, considere o tethering USB como o próximo transporte mais confiável.
  • Se o usuário estiver na bateria e quiser longa duração, pergunte antes de forçar comportamento agressivo de não dormir.
  • Se um antivírus/EDR corporativo estiver presente, mantenha os scripts especialmente simples: sem comandos codificados, dependências baixadas, tarefa agendada oculta ou escalonamento de privilégios.

Recursos Inclusos

  • scripts/macos-livehotspot.sh: loop genérico de keepalive/reconexão do lado do cliente no macOS, adaptado de uma correção de hotspot ao vivo do iPhone.
  • references/macos.md: padrão de instalação/verificação/desinstalação do LaunchAgent.
  • references/windows.md: padrão de PowerShell e Agendador de Tarefas para laptops Windows.
  • references/linux.md: padrão de NetworkManager e systemd do usuário para laptops Linux.
  • references/research.md: notas de pesquisa pública em GitHub/web e o que não reutilizar cegamente.
  • assets/agent-prompt.zh.md: prompt copiável em chinês para agentes locais genéricos, incluindo regras de segurança, roteamento do SO, verificação e requisitos de reversão.

Habilidades Relacionadas