LongChangPost/livehotspot

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：適用於一般本地代理的中文複製貼上提示，包含安全規則、作業系統路由、驗證與解除安裝要求。