故障排除

目標：用三個入口把問題定位到「鏈路 / 篩選 / 配置」中的哪一層。

先用這三個入口#

鏈路狀態卡（首頁頂部）——連線是否成立、收發計數、伺服器回傳值。回傳 unverified = Passcode 問題（去填）。
鏈路自檢（裝置頁）—— TNC 協定回路、AFSK 調變解調回路，一鍵分層定位； TNC 另有初始化字串與發射自檢（狀態封包，不含座標）。
封包頁—— 原始封包到底有沒有進來。能收到但不上圖 = 篩選/座標問題，回臺站與篩選；一條都沒有 = 鏈路問題，回第 1、2 步。

症狀 → 原因 → 動作#

症狀	最可能的原因	動作
黃色「未驗證」橫幅	Passcode 空 / 錯	設定 → 連線 → 填正確 Passcode → 儲存並套用
連不上伺服器	網路 / 伺服器位址 / 埠	核對 `rotate.aprs2.net:14580`；斷線會自動 8→16→32→60s 重連，等一輪
封包頁一條都沒有	沒勾資料來源 / 範圍過濾太窄	設定 → 連線：勾 APRS-IS；範圍半徑調大 → 儲存並套用
收到但地圖上看不見	列表篩選擋住了	臺站頁點「清除篩選」；核對狀態/類型篩選
自己位置不顯示/亂跳	沒定位權限 / 用了網路粗定位	給定位權限；設定 → 定位上報 → 定位模式選純 GPS
TNC 能收不能發	停在命令模式 / 線速不匹配	送出初始化字串（`KISS ON`）；核對 9600~115200 與電臺一致
音訊對方解不出	發射電平過低或削波 / 用錯線	調整發射電平；耳機孔 → 電臺資料/麥克風孔，勿用喇叭對麥克風
訊息發出去沒反應	超 67 字元 / 512 位元組；對方不在线	縮短內容；看氣泡狀態，逾時即失敗
群組收不到	射頻模式不支援群廣播；Passcode 未驗證	切到 APRS-IS 發；先修 Passcode
閘道計數不漲	缺一個來源（APRS-IS 或射頻）/ 射頻收到=0	按介面提示補齊來源；射頻收到=0 先查電臺音量/靜噪/天線
桌面小組件空白	小組件沒有資料（應用沒打開過）	打開一次應用刷新
離線地圖斷網打不開	沒下載該螢 / 未開僅離線	移到目標螢下載；開「僅使用離線圖磚」

還是解決不了？#

常見問題：23 題按主題分組 → 幫助中心
更新記錄：你遇到的可能已在新版本修掉 → GitHub Releases
回饋：提 Issue 或進 QQ 交流群。附上封包頁的原始封包與鏈路日誌定位最快 → Issues

📎

報告模板（照抄即可）：① 平台與版本；② 鏈路狀態卡截圖；③ 封包頁裡一則完整封包（含封包頭）；④ 已勾選的資料來源與過濾半徑。