Louisa Wi-Fi

走進任何一家路易莎，Mac 自動連上 Wi-Fi。
不用問密碼，也不用一直「忘記這個網路」。

⬇️ 下載 Louisa Wi-Fi ・ 安裝教學 ・ 常見問題

每一家路易莎的 Wi-Fi 都叫 LouisaCoffee，但每家的密碼都不一樣（是那家店的電話號碼）。Mac 只會記住一組密碼，所以換一家店就連不上，得先「忘記這個網路」再重新輸入密碼。

Louisa Wi-Fi 會認出你在哪一家店，自動換上那家店的密碼。全台 500 多家門市的資料都已經內建。

• ☕ 自動連線：到了路易莎，打開 Mac 就會自動連上，什麼都不用做。
• 📍 認得每一家店：用位置找出最近的門市；連過一次的店，下次一秒就連上。
• 🔎 手動選店：萬一沒有自動連上，從選單列的 ☕ 點一下門市就好，也可以依縣市找。
• 🔑 用密碼連線：店裡都貼著 Wi-Fi 密碼，直接點那一組或自己輸入，不用等 app 一組一組試。
• 📊 連線統計：像 GitHub 的方格圖一樣，看你每天在路易莎待多久、最常去哪幾家、每個月去幾次。
• 🔄 自動更新：有新版本或新門市時，☕ 選單會提醒你，點一下就更新好。
• 🔒 資料只在你的 Mac 上：不需要帳號，不會上傳任何資料。

_{連線統計：點方格看當天去了哪家，下方可以切換門市、月份、年份。}

需要 macOS 13（Ventura）或更新的版本。

1. 下載

👉 點這裡下載 Louisa Wi-Fi

2. 放進「應用程式」

打開「下載項目」資料夾，把 LouisaWiFi 拖進「應用程式」。如果看到的是 LouisaWiFi.zip，先點兩下解壓縮。

3. 第一次打開

到「應用程式」點兩下 LouisaWiFi。macOS 會跳出「無法打開」或「無法驗證開發者」的警告，這是因為 app 沒有付費向 Apple 註冊，不是病毒：

1. 先按「完成」關掉警告。
2. 打開「系統設定 → 隱私權與安全性」，捲到最下面。
3. 會看到「已阻擋 LouisaWiFi」，按旁邊的「仍要打開」（有些版本叫「強制打開」），輸入 Mac 的密碼。

只有第一次需要這樣做。

4. 允許定位

畫面右上角的選單列會出現 ☕，並跳出詢問是否允許使用你的位置，請按「允許」。

如果沒有跳出詢問，或不小心按了拒絕：打開「系統設定 → 隱私權與安全性 → 定位服務」，把 LouisaWiFi 打開。

完成！建議從 ☕ 選單勾選「登入時開啟」，這樣每次開機都會自動執行。

curl -fsSL https://raw.githubusercontent.com/madeyexz/louisa-wifi/main/install.sh | bash

什麼都不用做。 到了路易莎，Mac 就會自動連上，連上時會跳出通知，例如「已連上：信義吳興門市」。

點選單列的 ☕ 可以：

• 看現在連到哪一家
• 從「用密碼連線」直接選最近那家店張貼的那組密碼，或選「輸入密碼…」自己輸入
• 從「附近門市」點一下門市，自動嘗試它的密碼
• 從「所有門市」依縣市找到門市，選「自動嘗試」或其中一組密碼
• 打開「連線統計…」
• 開關「自動連線」「只顯示連過的門市」「登入時開啟」
• 選「不在選單列顯示…」把 ☕ 藏起來（app 仍會在背景自動連線）
• 檢查更新

flowchart TD
    A["Wi-Fi 狀態改變、每 15 秒檢查<br/>或你從選單選了門市"] --> B{"已經可以上網？"}
    B -->|是| Z["不做任何事<br/>不會中斷你正在用的網路"]
    B -->|否| C{"附近有 LouisaCoffee？"}
    C -->|沒有| Z2["結束"]
    C -->|有| D{"這台路由器以前連過？"}
    D -->|是| E["用上次成功的密碼<br/>大約 1 秒連上"]
    D -->|否| F["用 Mac 的位置找出最近 3 家門市<br/>依序試它們的電話號碼"]
    F -->|成功| G["記住這台路由器是哪家門市、用哪組密碼"]
    F -->|都不對| I["通知你從選單選門市<br/>或用店內貼的密碼連線，成功一次就會記住"]
    E --> H["連上了，開始記錄連線時間"]
    G --> H

重點在「記住路由器」：同一家店只要成功連過一次，之後不管定位準不準，看到那台路由器就直接用對的密碼。

raycast/louisa-wifi.js 是一個 Raycast Script Command：

• 輸入門市名稱或地址關鍵字（例如 延平、大安 復興）。如果有多家符合，會顯示清單供你選擇。
• 留空即可連線到最近的門市（需安裝 app）。
• 已安裝 app 時，會透過 app 連線；未安裝時，則使用 networksetup 連線，所以只裝 Raycast 也能用。

安裝方式：從 Releases 下載 louisa-wifi.js，放進一個資料夾，再到 Raycast → Settings → Extensions → Script Commands → Add Directories 加入那個資料夾。

路易莎官方沒有統一的密碼規則，所以 app 從電話號碼產生 2 到 3 組候選密碼，依序嘗試：

1. 去掉開頭的 0（台北 02 開頭的門市去掉整個 02）：絕大多數門市用這組。
2. 保留開頭 0 的完整號碼：例如新竹關新直營門市（03-577-0157 → 035770157，見 #1）。
3. 其他寫法：台北門市只去掉 0、保留 2（223610718），或其他 10 碼號碼的後 8 碼（23262617）。9 碼號碼（03、05、06 等開頭）去掉 0 後就是後 8 碼，所以只有 2 組。

其他處理方式：

• 有分機（#12、分機、轉）或多支電話時，只取第一支電話的號碼。
• 每組錯的密碼要 15 到 20 秒才會失敗，所以候選最多 3 組。
• 成功連上後會記住這台路由器用的密碼，下次直接使用，不會再試。
• 密碼不是電話號碼，或候選都不對時，從「用密碼連線」或「所有門市」裡的門市選「輸入密碼…」，照店內張貼的密碼輸入。

與 Watermelon-1234/LouisaInternetSwitch 整理的資料比對後，雙方都有收錄的 459 家門市中，有 454 家的密碼在候選之中；其餘 5 家用的是和官網電話不同的號碼。

data/stores.json 由 scripts/fetch_stores.py 從官網抓取，包含名稱、地址、電話、經緯度和候選密碼。GitHub Actions 每週自動重新抓取一次；有變更時會自動發布新版本，app 會提示更新。

部分門市在官網上未提供電話，因此未收錄；另有部分門市缺少經緯度，需要手動選擇，或在 Raycast 中用名稱或地址搜尋。

只需要 Xcode Command Line Tools（xcode-select --install）：

./build.sh          # 產生 build/LouisaWiFi.app 和 build/LouisaWiFi.zip
open build/LouisaWiFi.app

將 v* 標籤推送到 GitHub 後，GitHub Actions 就會編譯並發布 Release。

連線與使用紀錄都儲存在你的 Mac 上：連過的路由器與密碼存放在 ~/Library/Application Support/LouisaWiFi/learned.json，時間紀錄則存放在同一個資料夾的 usage.json。app 只會連到 captive.apple.com（確認網路是否可用）和 GitHub（檢查及下載更新）。

MIT