Communitygithub.com

LongChangPost/livehotspot

LiveHotspot:一种 Agent 技能,用于在 macOS、Windows 和 Linux 上保持笔记本电脑和手机热点连接不中断。

livehotspot 是什么?

LiveHotspot 是一个 AI 代理技能,旨在解决笔记本电脑通过手机热点上网时,因电脑休眠、磁盘空闲或操作系统 Wi-Fi 堆栈判定客户端不活跃而导致的连接断开问题。该技能支持 macOS、Windows 和 Linux 三大平台,并提供两种工作模式:直接执行模式(当前代理诊断并安装修复)和委派模式(为用户生成可复制粘贴的提示,供较弱本地代理执行)。其设计哲学强调最小化、透明化修复,优先使用原生命令、用户级调度器、可读脚本和简单回滚命令,避免使用编译二进制、混淆、凭据抓取、浏览器/会话访问、隐蔽持久化或全局电源变更等高风险操作。此外,技能附带了针对不同操作系统的参考文档、脚本和中文代理提示,确保安全规则、验证和卸载流程的完整性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add LongChangPost/livehotspot

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

livehotspot 是做什么的?

运行模式

将热点不稳定性视为两个相关问题:

  1. 笔记本电脑在长时间运行期间休眠、磁盘空闲或 Wi-Fi 掉线。
  2. 手机热点或操作系统 Wi-Fi 栈判定客户端不活跃并断开连接。

使用最小化的透明修复来处理活跃机器。优先使用原生命令、用户级调度器、可读脚本、日志和简单回滚命令。避免使用编译二进制、混淆、凭据抓取、浏览器/会话访问、隐蔽持久化、隐藏窗口技巧、全局电源更改或管理员提权,除非用户明确批准。

此技能必须在两种模式下工作:

  • 直接执行模式:当前代理诊断并在活跃机器上安装修复。
  • 委派模式:当前代理提供给用户一个来自 assets/agent-prompt.zh.md 的可复制粘贴提示,以便较弱本地代理执行工作流。

工作流

  1. 确认操作系统和热点角色。

    • 客户端模式:笔记本电脑连接到手机热点。这是此技能的默认模式。
    • 主机模式:笔记本电脑创建热点供其他设备使用。请使用 references/windows.md 或 references/linux.md 中的操作系统特定说明;不要盲目应用客户端假设。
  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. 选择操作系统路径。

    • macOS:使用 scripts/macos-livehotspot.sh 加上用户 LaunchAgent。请阅读 references/macos.md。
    • Windows:使用运行透明 PowerShell 脚本的用户任务计划程序操作。请阅读 references/windows.md。
    • Linux:使用 NetworkManager 加上用户 systemd 服务/定时器(如果可用)。请阅读 references/linux.md。
  4. 保持防病毒和安全态势平稳。

    • 将脚本存储在具有 ASCII 路径的普通用户目录中。
    • 记录到普通用户日志路径。
    • 不要使用 curl | sh、base64 负载、编码的 PowerShell 命令、注册表 Run 键、LaunchDaemons、root 服务、浏览器自动化或凭据 API。
    • 优先使用用户可见的命令行和文档化的操作系统 API。
    • 在最终答案中包含卸载命令。
  5. 用证据验证。

    • 向用户展示服务状态、进程/断言证据、最新日志行以及短时间窗口稳定性检查。
    • 如果无法在当前操作系统上运行测试,请说明并提供干运行/语法检查作为替代。

可复制粘贴的代理提示

当用户希望另一个代理使用此功能时,返回 assets/agent-prompt.zh.md 中的文本。不要总结掉其安全规则;重点是给较弱的代理一个完整、明确的运行手册。

决策点

  • 如果热点是 macOS 上的 iPhone,通过路由/网关和 172.20.10.x 地址模式检测,而不是仅靠 SSID;Instant Hotspot 经常报告无 AirPort 关联,但路由仍然正常工作。
  • 如果在保活后连接仍然断开,添加对已知 SSID 的重连尝试,然后考虑 USB 网络共享作为下一个更可靠的传输方式。
  • 如果用户使用电池并希望长时间运行,在强制激进的禁止休眠行为之前先询问。
  • 如果存在企业防病毒/端点检测与响应,保持脚本特别简单:无编码命令、无下载依赖项、无隐藏计划任务、无权限提升。

捆绑资源

  • scripts/macos-livehotspot.sh:通用的 macOS 客户端侧保活/重连循环,源自一个实时 iPhone 热点修复。
  • references/macos.md:LaunchAgent 安装/验证/卸载模式。
  • references/windows.md:Windows 笔记本电脑的 PowerShell 和任务计划程序模式。
  • references/linux.md:Linux 笔记本电脑的 NetworkManager 和用户 systemd 模式。
  • references/research.md:来自公开 GitHub/网络研究的笔记以及不应盲目重用的内容。
  • assets/agent-prompt.zh.md:面向通用本地代理的中文可复制粘贴提示,包括安全规则、操作系统路由、验证和卸载要求。

相关技能