StarryLink 是災害弱網通訊 Demo,聚焦在「低資料封包、弱網同步、風險矩陣、通訊路徑決策、守望隊工作流」的可互動驗證。此版本為 Demo / Simulation mode:尚未連接真實 SMS、119、醫療、衛星或推播服務。
目前階段聚焦於決策引擎、低資料封包格式、弱網同步與守望隊工作流驗證;外部電信、衛星、119 與醫療系統可作為後續 API / 合作介接。
python3 demo/api_server.py電腦端:
http://127.0.0.1:8765/
手機端:
http://<筆電區網 IP>:8765/?view=mobile&target=U-DEMO
也可以在電腦端按「複製手機連結」。
Vercel preview 可用於公開畫面、單機互動與 action API 格式預覽。若 /api/health、/api/state、/api/actions/reply 都顯示 OK,代表 serverless API 可用;但沒有外部資料庫時,Vercel state 屬 volatile,不承諾穩定手機/電腦跨裝置同步。若任一 API 不可用,頁面會明確標示 Vercel static preview。
線上版不使用 long-running ThreadingHTTPServer 或長時間 SSE。沒有外部資料庫時,serverless state 可能因 cold start 或 instance 回收而重置;若要最穩定展示跨裝置共享狀態,請使用本機 Python server。
- 開啟電腦端工作台。
- 按「啟動災害模式」。
- 複製手機連結,用手機開啟。
- 手機按「我受傷 / 無法說話 / 我被困住」。
- 電腦端確認同一位
U-DEMO的風險矩陣、packetSeq、ACK、retry、raw/display risk 立即改變。 - 按「模擬地面網路失效」。
- 觀察通訊路徑由 Wi-Fi / 5G 轉向 SMS / BLE Relay / Satellite Backup,並查看每個 channel 的 score breakdown。
手機瀏覽器通常只允許 HTTPS 或 localhost 使用 Geolocation API。若用 http://LAN_IP,GPS 可能被拒絕。
建議展示:
- 使用 HTTPS tunnel,例如 ngrok 或 Cloudflare Tunnel。
- 若只用
http://LAN_IP,請主動展示 GPS fallback 流程。 - GPS 成功會顯示
GPS confirmed、lat、lng、accuracy。 - 拒絕權限會顯示
GPS_DENIED,不會顯示假座標。 - timeout 或 unavailable 會顯示
GPS_UNAVAILABLE。 - 可用「我在家 / 我在學校 / 我在避難點 / 我不知道位置」手動回報。
- 若要最穩定:使用
python3 demo/api_server.py,手機與筆電連同一個 Wi-Fi,從電腦端複製手機連結。 - 若要展示線上版:只承諾單機互動、視覺流程與 action API 格式;跨裝置穩定同步請使用本機 Python server,或後續接 Vercel KV / Redis / Supabase / Neon。
- 若要展示 GPS:建議使用 HTTPS tunnel,例如 ngrok 或 Cloudflare Tunnel。
- 若 GPS 失敗:展示
GPS_DENIED/GPS_UNAVAILABLE/ 手動位置 fallback,不要假裝取得定位。 - 若使用 Vercel preview:確認未被 Vercel SSO protection 擋住,首頁與
styles.css、communicationEngine.js、lowDataPacket.js、demoStore.js、app.js必須能公開載入。
前端互動不再整包覆蓋 /api/state,而是使用 action endpoints:
POST /api/actions/replyPOST /api/actions/locationPOST /api/actions/networkPOST /api/actions/medicalPOST /api/actions/simulationPOST /api/actions/reset
每個 action payload 包含:
clientIdtargetIdactionTypeseq或idempotencyKeybaseRevisionclientTimestamppayload
Server 會回傳 serverAck、newRevision、updatedTarget、stateSummary,並用 idempotencyKey 忽略重複封包。
- 本 Demo 的 SMS、119、醫療、衛星、推播皆為本機模擬。
- packet loss、ACK、retry、通訊路徑切換、風險矩陣皆由本機 JS/Python state 驅動。
- GPS 若被瀏覽器拒絕,不會假裝取得定位。
- 同 Wi-Fi / LAN 推估若出現,必須視為「非真實 GPS,僅 Demo 推估」。
- 電信 SMS / Cell Broadcast API。
- 衛星訊息或備援通訊 API。
- 119 / 地方救災系統協作 API。
- 醫療照護平台或守護者聯絡 API。
- 多節點 store-and-forward / mesh relay。
- 先強調這不是靜態圖片,而是真實 DOM、JS state、HTTP action、packet log。
- 用手機實際點「我受傷」,讓電腦端
U-DEMO風險分數上升。 - 快速連點同一按鈕三次,展示 duplicate ignored,不重複加分。
- 拒絕 GPS 權限,展示
GPS_DENIED與位置待確認風險。 - 模擬地面網路失效,展示 score breakdown 為何提高 SMS / BLE / Satellite Backup。
- 展示 Demo 頁「部署狀態」小卡,說明目前是 Python dynamic mode、Vercel serverless preview 或 static preview mode。