啟動指南

設定完成後，按照這份流程啟動控制台。
啟動器負責裝置與服務，Web 控制台負責操作地圖。

🚀 啟動流程

Windows 桌面版採用「啟動器負責裝置與服務、Web 控制台負責操作地圖」的分工，建議依序完成以下步驟：

  1. USB 連接手機

    用有傳輸功能的 USB 線連接 Android 或 iPhone。

  2. 開啟啟動器

    雙擊 PikminWalkLauncher.exe（開發模式可執行 python launcher.py，需手動以管理員身分執行）。程式打包後已設定為強制要求管理員權限，雙擊後於 UAC 提示點選「是」即可授權啟動。

  3. 確認裝置偵測結果

    啟動器「控制」分頁會自動偵測已連線裝置，顯示 🤖 安卓 或 🍎 蘋果圖示。若 5 分鐘內未偵測到，點「重新偵測」按鈕。

  4. Android 用戶：完成 Android 工具準備

    啟動器「Android 工具」區塊會引導完成小幫手 APK 安裝、USB 偵錯設定與模擬位置設定，每次只顯示下一步需要執行的按鈕。

  5. iOS 用戶：確認開發者模式已開啟

    確認 iPhone 已信任電腦，且 Developer Mode 已開啟（含重開機後的確認框）。若未開啟，啟動器會顯示提示與「自動啟用開發者模式」按鈕。

  6. 點「啟動服務」

    等待狀態從「❓ 偵測中…」變成「服務執行中」。請確認在啟動啟動器時有授予管理員權限，否則 iOS 的定位服務將無法正常運作。

  7. 點「在瀏覽器中開啟控制台」

    進入 http://localhost:8964/ 操作地圖。控制台左側是互動式地圖，右側是控制面板。

💡 服務啟動後，控制台固定網址為 http://localhost:8964/。若關閉瀏覽器，直接用這個網址重新開啟即可，不需重啟服務。

🪟 啟動器分頁說明

啟動器視窗上方是品牌標題與服務狀態，中間是主要分頁，底部顯示政治聲明。

分頁功能
控制裝置偵測、公告顯示、啟動／停止後端服務、開啟 Web 控制台、Android 工具、iOS 開發者模式提示
Log即時顯示後端服務輸出與錯誤訊息，出問題時從這裡找線索，可清除畫面
設定資料目錄設定（打包版與開發版路徑不同）、是否啟動服務後自動開啟瀏覽器
資料管理匯出／匯入景點、路線、紀錄備份 ZIP；匯出／匯入 config.json 設定檔

🤖 Android 工具狀態說明

「控制」分頁的「Android 工具」區塊會讀取手機上小幫手狀態，只顯示目前最需要處理的下一步，不會把所有按鈕一次全顯示出來：

顯示狀態代表意思 & 動作
開啟手機開發者選項尚未開啟開發人員選項。點擊後程式在手機上跳出設定頁
安裝小幫手 APKApp 尚未安裝。點擊後透過 ADB 自動安裝
更新小幫手 APK已安裝但版本過舊。點擊重新安裝最新版本
啟動小幫手 APK已安裝但背景服務未在執行。點擊後用 ADB 啟動服務
設定模擬位置應用程式服務正常但模擬位置未指向小幫手。點擊後在手機上跳出設定頁
✅ 小幫手已就緒全部設定完成，可正常使用模擬定位
🤖 需要同步 Android 步數嗎？

如果您想把模擬走路的步數同步至手機，需額外設定 Google 健康連接與 Google Fit 權限。

開啟步數同步指南 ↗

🍎 iOS 開發者模式說明

iOS 需要 Developer Mode 才能使用模擬定位。啟動器偵測到 iPhone 但尚未啟用時，「控制」分頁會顯示提示：

手動路徑：設定 → 隱私權與安全性 → 開發者模式 → 開啟 → 重新開機

或點啟動器中的「自動啟用開發者模式」，讓程式嘗試在 iPhone 上顯示 Developer Mode 入口。

⚠️ iOS 17+ 重新開機後，螢幕會再次彈出確認框，必須點「開啟」才算真正生效。這步容易被忽略，導致傳送後定位沒有變化。

🗺️ Web 控制台分頁簡介

Web 控制台右側控制面板分為三個主要分頁：

分頁主要功能
順移裝置選擇、瞬間移動、地址搜尋、Android 拔盆專用區、採果、跳轉序列、景點資料庫
路線速度控制、區間隨機變速、同步步數（Android）、導航移動、道路散步、隨機漫遊、路徑圖書館
其他同步手機目前位置、恢復真實定位、清空地圖、操作紀錄、增修景點、主題切換
💡 裝置連線與定位設定請回到啟動器「控制」分頁處理。Web 控制台只負責地圖操作。

🆘 常見使用問題

問題解決方式
防毒軟體顯示警告或刪除程式，該怎麼辦？這是少數防毒軟體對定位輔助工具常見的誤判現象。本工具已通過 VirusTotal 多數主流防毒引擎檢測，若下載後被攔截，可查看安全檢測報告確認內容，並將程式加入信任名單後再執行即可。
👉 查看安全檢測與防毒誤判說明
iOS：傳送後手機定位沒有變化確認已在啟動時點擊「是」授予管理員權限；確認開發者模式重開機後有再次點「開啟」確認；確認 USB 保持連線
Android：按了「傳送」沒有反應依序確認：USB 模式為 MTP、USB 偵錯已開啟且已授權、模擬位置已指定為敏敏漫遊小幫手。傳送後先用 Google 地圖確認定位是否有更新；若有更新但遊戲沒反應，請重開遊戲。
👉 對照 Android 步數同步設定指南確認設定
Android：說「設定定位失敗」確認手機已開啟 USB 偵錯，且在手機上允許了本次連線。在啟動器 Log 分頁查看詳細錯誤訊息
隨機漫遊一直在同一個地方打轉適當調大漫遊半徑，建議設 300m 以上
道路散步路線產生失敗通常是起終點太遠、座標落在不可步行區域，或 OSRM 外部服務暫時不可用。縮短距離後重試，或改用「導航移動」模式
重開瀏覽器後導航消失了頁面載入後會自動偵測後端導航狀態，若導航仍在進行會自動接回，顯示「已重新接上進行中的導航」提示