Communitygithub.com

LiveHotspot: 핫스팟 연결 유지 에이전트 스킬

macOS, Windows, Linux에서 노트북-폰 핫스팟 연결이 끊기지 않도록 유지하는 에이전트 스킬입니다.

LiveHotspot: 핫스팟 연결 유지 에이전트 스킬란 무엇인가요?

LiveHotspot은 장시간 작업 중 노트북이 폰 핫스팟과의 연결을 잃는 문제를 해결하는 AI 에이전트 스킬입니다. 이 스킬은 노트북이 절전 모드로 전환되거나 Wi-Fi 스택이 클라이언트를 비활성 상태로 간주하여 연결을 끊는 두 가지 주요 원인을 대상으로 합니다. macOS, Windows, Linux 세 가지 주요 운영체제를 지원하며, 각 OS에 맞춰 `macOS LaunchAgent`, `Windows Task Scheduler`, `Linux systemd timer` 등 사용자 수준의 투명한 설정을 통해 네트워크 연결을 유지합니다. 또한, 직관적인 진단 명령어와 간단한 롤백 절차를 제공하여 개발자나 파워 유저가 부담 없이 사용할 수 있으며, 보안에 민감한 환경을 위해 인코딩된 명령어나 권한 상승을 피하는 안전한 접근 방식을 따릅니다. 이 스킬은 직접 실행 모드와 위임 모드(약한 로컬 에이전트용 중국어 프롬프트 포함)를 모두 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add LongChangPost/livehotspot

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

LiveHotspot

운영 모델

핫스팟 불안정성을 두 가지 관련 문제로 취급합니다.

  1. 장시간 작업 중 노트북이 절전 모드로 전환되거나 디스크가 유휴 상태가 되거나 Wi-Fi 연결이 끊깁니다.
  2. 폰 핫스팟 또는 OS Wi-Fi 스택이 클라이언트가 비활성 상태라고 판단하여 연결을 끊습니다.

실행 중인 시스템을 처리하기 위해 가장 작고 투명한 해결책을 사용합니다. 기본 명령어, 사용자 수준 스케줄러, 읽기 쉬운 스크립트, 로그, 간단한 롤백 명령어를 선호합니다. 컴파일된 바이너리, 난독화, 자격 증명 수집, 브라우저/세션 접근, 은밀한 지속성, 숨겨진 창 트릭, 전역 전원 변경 또는 관리자 권한 상승(사용자가 명시적으로 승인하지 않는 한)을 피합니다.

이 스킬은 두 가지 모드로 작동해야 합니다.

  • 직접 실행 모드: 현재 에이전트가 실행 중인 시스템을 진단하고 수정 사항을 설치합니다.
  • 위임 모드: 현재 에이전트가 사용자에게 assets/agent-prompt.zh.md의 단일 복사-붙여넣기 프롬프트를 제공하여 더 약한 로컬 에이전트가 워크플로를 실행할 수 있도록 합니다.

워크플로

  1. OS 및 핫스팟 역할 확인

    • 클라이언트 모드: 노트북이 폰 핫스팟에 연결됩니다. 이 스킬의 기본값입니다.
    • 호스트 모드: 노트북이 다른 기기를 위한 핫스팟을 생성합니다. references/windows.md 또는 references/linux.md의 OS별 참고 사항을 사용하며, 클라이언트 가정을 맹목적으로 적용하지 마십시오.
  2. 변경 전 현재 상태 검사

    • 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. OS 경로 선택

    • macOS: scripts/macos-livehotspot.sh 및 사용자 LaunchAgent 사용. references/macos.md 참조.
    • Windows: 투명한 PowerShell 스크립트를 실행하는 사용자 Task Scheduler 작업 사용. references/windows.md 참조.
    • Linux: NetworkManager 및 (가능한 경우) 사용자 systemd 서비스/타이머 사용. references/linux.md 참조.
  4. AV 및 보안 태세 유지

    • 스크립트는 ASCII 경로의 일반 사용자 디렉토리에 저장합니다.
    • 일반 사용자 로그 경로에 로그를 기록합니다.
    • curl | sh, base64 페이로드, 인코딩된 PowerShell 명령어, 레지스트리 Run 키, LaunchDaemon, 루트 서비스, 브라우저 자동화 또는 자격 증명 API를 사용하지 마십시오.
    • 사용자에게 보이는 명령줄과 문서화된 OS API를 선호합니다.
    • 최종 답변에 제거 명령어를 포함합니다.
  5. 증거로 확인

    • 사용자에게 서비스 상태, 프로세스/어설션 증거, 최신 로그 줄 및 짧은 시간 윈도우 안정성 확인을 보여줍니다.
    • 현재 OS에서 테스트를 실행할 수 없으면 그렇게 말하고 드라이런/구문 검사를 제공합니다.

복사-붙여넣기 에이전트 프롬프트

사용자가 다른 에이전트에게 이 기능을 사용하도록 요청하면 assets/agent-prompt.zh.md의 텍스트를 반환합니다. 안전 규칙을 요약하지 마십시오. 핵심은 약한 에이전트에게 완전하고 명시적인 실행 설명서를 제공하는 것입니다.

결정 지점

  • 핫스팟이 macOS의 iPhone인 경우 SSID만으로 판단하지 말고 경로/게이트웨이 및 172.20.10.x 주소 패턴으로 감지합니다. Instant Hotspot은 라우팅이 작동 중일 때도 AirPort 연결이 없다고 보고하는 경우가 많습니다.
  • 연결 유지 후에도 연결이 끊어지면 알려진 SSID에 재연결 시도를 추가한 다음, 다음으로 더 안정적인 전송으로 USB 테더링을 고려합니다.
  • 사용자가 배터리로 작업 중이고 장시간 실행을 원하면 강제로 절전 방지 동작을 하기 전에 물어봅니다.
  • 회사 바이러스 백신/EDR이 있는 경우 스크립트를 특히 평문으로 유지합니다. 인코딩된 명령어, 다운로드한 종속성, 숨겨진 예약 작업, 권한 상승이 없어야 합니다.

번들 리소스

  • scripts/macos-livehotspot.sh: 라이브 iPhone 핫스팟 수정에서 적용된 일반적인 macOS 클라이언트 측 연결 유지/재연결 루프.
  • references/macos.md: LaunchAgent 설치/확인/제거 패턴.
  • references/windows.md: Windows 노트북용 PowerShell 및 Task Scheduler 패턴.
  • references/linux.md: Linux 노트북용 NetworkManager 및 사용자 systemd 패턴.
  • references/research.md: 공개 GitHub/웹 연구의 메모와 맹목적으로 재사용하지 말아야 할 사항.
  • assets/agent-prompt.zh.md: 일반 로컬 에이전트용 중국어 복사-붙여넣기 프롬프트. 안전 규칙, OS 라우팅, 확인 및 롤백 요구 사항 포함.

관련 스킬