NTsocial 應用程式使用者操作手冊

2. 個人檔案 (Profile) 設定

2.1 認識你的 Profile 頁面

NTsocial 的 Profile 頁面其實是個多功能中心，一次整合了三類設定：你的公開個人資料、僅影響自己手機的本機選項，以及 BLE / LoRa 相關的無線配置。

• 改完「個人標語」、「個人簡介」、「所在地」、「網站」、「Email」或社群欄位後，記得按一下「發布」，別人才會真正同步到最新版。
• 「暱稱」改了之後通常會馬上反映在自己畫面和新送出的訊息上，但這不代表完整 Profile 已經正式重新發布。
• 「變更頭貼」走的是另一條流程 — 選好圖片後通常會直接處理並送出，所以只換頭貼的話，一般不需要再按「發布」。
• 「語言」、「長距離模式」、「Meshtastic（LoRa）」這些都屬於本機設定，不會出現在你的公開 Profile 裡。
• 值得注意的是，「長距離模式（LE Coded PHY S=8）」是 BLE 長距離，跟 LoRa 完全不同。
• 「Meshtastic（LoRa）」只是在 NTsocial 與 Meshtastic 官方 App 之間搭一座橋，不會讓整個 App 自動全走 LoRa，也不會幫你自動綁定頻道。

2.2 頁面配置與進入方式

打開 App 後，點底部導覽列的「Profile」就能進入。從上到下，你大致會看到這些項目：

1. 頁面標題與頭像區。
2. 節點貢獻。
3. MESH 寵物。
4. 暱稱。
5. 基本資料。
6. 社群連結。
7. 語言。
8. 發布。
9. 長距離模式（LE Coded PHY S=8）。
10. Meshtastic（LoRa）。

2.3 身分識別、頭像與顯示方式

頁面最上方會並排顯示兩種視覺身分識別，各有不同用途。

• 識別圖：根據你的指紋或金鑰材料自動生成，就像一組穩定的機器身分標記 — 即使你改了暱稱，別人仍能靠它辨識你是同一人。
• 自訂頭貼：讓別人一眼就能聯想到你的公開頭像。
• 「變更頭貼」：點下去會打開系統選圖流程，處理完圖片後通常直接送出。
• 傳輸小知識：文字型 Profile 通常比頭貼圖片更快同步到遠方節點，所以別人可能先看到你更新的文字，過一陣子才收到新頭貼。

2.4 編輯你的公開資料

「暱稱」、「基本資料」、「社群連結」這幾個欄位加在一起，就是別人看到的你 — 你對外公開的文字 Profile。

2.4.1 暱稱

• 修改後通常會馬上寫入本機，新送出的訊息也可能直接帶上新暱稱。
• 不過，如果你希望成員頁、作者名片等各處都統一顯示最新版本，改完之後還是建議再按一次「發布」。

2.4.2 基本資料

「基本資料」區塊涵蓋「個人標語」、「個人簡介」和「所在地」三個欄位。

• 個人標語：一句簡短的自我描述，讓別人快速認識你。
• 個人簡介：比標語更完整的自我介紹空間。
• 所在地：自己手動輸入的地區或城市，不是即時 GPS 定位。
• 隱私提醒：不想讓人看到的欄位，留空就好。

2.4.3 社群連結

「社群連結」讓你放上「網站」、「Email」、「GitHub」、「Twitter / X」、「Instagram」等個人連結。

• 這些都是你自己填的，NTsocial 不會幫你做官方驗證 — 簡單來說，顯示不等於認證。
• 一樣的原則：只填你願意讓別人看到的就好。

2.5 僅限本機的設定

接下來這一區的設定只會影響你自己的手機，跟公開個人資料無關。

2.5.1 語言選擇

這裡只管你自己手機上的介面語言，目前支援 English、繁體中文、日本語。

• 切換語言不需要按「Publish」，也不會影響其他人的 App 介面。

2.5.2 節點貢獻

• 這個數值反映的是你的節點幫其他人中繼或補回文字內容的程度 — 換句話說，是中繼貢獻分數，不是社交聲望等級。
• 計算的主要是文字同步貢獻，圖片傳送不列入。

2.5.3 MESH 寵物

• MESH Pet 是一個可選的本機視覺元素，會對節點貢獻狀態做出反應。
• 它可以收合，也不會影響一般通訊功能。
• 它不屬於你的公開個人資料。

2.6 無線設定

頁面底部有兩個最容易被混淆的無線設定。

2.6.1 長距離模式 (LE Coded PHY S=8)

• 這是 BLE 長距離，不是 LoRa。
• 若要在真實點對點情境中發揮作用，通常需要雙方裝置都支援，也都要開啟。
• 如果手機硬體不支援，NTsocial 可能會顯示不支援訊息，並將開關維持停用。
• 正確理解方式是「把 BLE 拉得更遠」，不是「把手機變成 LoRa 無線電」。

2.6.2 Meshtastic（LoRa）

• 這個開關讓 NTsocial 可以連接到 Meshtastic 官方 App，並重用那邊管理的 LoRa 節點。
• 它會讓 NTsocial 讀取 Meshtastic 的節點與頻道狀態，之後你才可以把特定 NTsocial 頻道綁到某個 Meshtastic channel index。
• 它不會讓整個 NTsocial 所有對話都自動走 LoRa，也不會取代 Meshtastic 官方 App，更不會自動幫你完成頻道綁定。

2.6.3 裝置選擇與狀態

• 常見操作包括 Install Meshtastic、Open Meshtastic、Select Bluetooth Device，或 Change Bluetooth Device (optional)。
• 常見狀態會包含等待 Meshtastic 服務、服務已連上、連線中、已連線，或已斷線等概念。
• 如果 NTsocial 顯示它正在重用 Meshtastic 官方 App 目前已連線的節點，通常就是最乾淨的狀態。
• 如果選擇器顯示 Bluetooth 關閉或權限缺失，請先在系統層處理完再繼續。

2.7 發布、同步與常見問題

2.7.1 發布會改變什麼

• 「Publish」會把目前的個人資料文字打包成正式版本，向外推送給其他人。
• 主要影響的欄位包括「Tagline」、「Bio」、「Location」、「Website」、「Email」和各種社群連結。
• 暱稱可能在你按「Publish」之前就已經在本機畫面和新訊息中更新了，但「發布」仍然是確保所有人都拿到最新版個人資料的最可靠方式。
• 單純換頭像、切語言、切 Long Range 或 Meshtastic 開關，都不需要靠「Publish」就能在本機生效。
• 發布後的文字欄位可以透過任何可用的同步路徑傳播（包括 LoRa 背景同步），但頭像圖片檔仍然比較依賴 BLE 傳輸。

2.7.2 別人會在哪裡看到你

• People 頁面與其詳細資訊視圖。
• 從貼文或回覆打開的作者資訊卡。
• 其他會顯示你暱稱、tagline 或簡短個人摘要的清單與資訊卡。

2.7.3 建議操作流程

1. 更新自我介紹：先編輯文字欄位，再按 Publish。
2. 只換頭像：按 Change Avatar 並等待處理完成。若你同時也改了文字欄位，再額外按一次 Publish 發布那些文字變更。
3. 測試 BLE 長距離：先確認雙方裝置都支援 LE Coded PHY S=8，並且兩邊都開啟。
4. 要讓 NTsocial 使用 LoRa：先在 Meshtastic 官方 App 連好節點，再從 Profile 啟用 Meshtastic (LoRa)，最後到 Channels 頁面把真正要用的 NTsocial 頻道綁定起來。

2.7.4 常見誤解與解決方法

• 畫面看起來變了，所以大家一定都收到新版個人資料：不一定。編輯文字欄位後還是要按 Publish。
• 改了暱稱，就代表整份個人資料都同步完成：不一定。暱稱可能會先在本機與新送出的訊息裡出現。
• Long Range Mode 就是 LoRa：不是，它是 BLE 長距離。
• 打開 Meshtastic 就代表整個 App 都走 LoRa：不是，後面還要把真正的 NTsocial 頻道綁定起來。
• 換頭像一定還要按 Publish：通常不用，除非你同時也改了文字欄位，並且想把那些文字一起正式發布。
• 別人還看到舊的 bio 或 tagline：先確認你真的按過 Publish，而且雙方之間確實存在可用的 BLE 或 LoRa 同步路徑。
• Long Range 開關是灰色的：通常表示裝置不支援 LE Coded PHY S=8。
• Meshtastic (LoRa) 一直顯示等待中或已斷線：重新檢查 Meshtastic 官方 App、節點連線、Bluetooth、權限，以及裝置選擇狀態。

3. Public / 公共 頁面

3.1 Public / 公共 是什麼？

Public / 公共 是 NTsocial 裡完全公開、不加密的訊息牆 — 任何附近的使用者都可能看到，也可以自由發表。

• 這裡對所有人開放 — 不限好友、不是私密空間、也沒有加密保護。
• 它的核心理念是讓公開訊息在附近的 NTsocial 裝置之間自然流動。

3.2 Public 為什麼重要

如果 PRIVATE MESSAGE / 私訊 是一對一溝通，頻道 / Channel 是有邊界的群體溝通，那 Public / 公共 就是 NTsocial 對陌生人社交、群眾傳播與移動式訊息流最核心的實踐。

• 不用先加好友、不用先認識對方、也不用先加入任何群組。
• 甚至不需要基地台、Wi-Fi、SIM 卡或雲端伺服器。
• 只要附近有人在使用 NTsocial，公開訊息就能在人與人之間持續交換。

3.3 運作原理與隱私原則

Public / 公共 的重點不在於模仿一般社群平台，而是讓公開訊息能隨著人的移動和裝置接觸自然傳遞。

• 因為 Public 訊息本身不加密，所以系統能更有效率地同步、補齊、去重與轉送。
• 當你走路、搭車、停留或穿越人群時，手機會逐步蒐集周圍裝置已持有的 Public 貼文。
• 你自己發出的 Public 貼文，也可能隨著其他人的裝置持續向外擴散。

3.4 頁面配置一覽

打開 App，切到 Public / 公共。這一頁通常可直接分成三層：

1. 上方標題與通知鈴鐺。
2. 中間的公開主貼文列表。
3. 下方的發文輸入區。

3.5 瀏覽 Public 貼文列表

Public 主列表主要顯示公開的頂層貼文。回覆不會直接混在主牆裡，而是掛在各自的回覆串下面。

• 主牆維持清楚，方便你快速掃描附近最近出現了哪些公開訊息。
• 當某篇貼文有回覆時，可從回覆按鈕或回覆數字進入該串。
• 這樣的設計讓你先看主牆，再決定要不要深入某一篇貼文。

3.6 發表文字與圖片

Public / 公共 主要支援純文字貼文、附圖貼文，以及公開回覆。

1. 在下方輸入框輸入內容。
2. 如有需要，附上一張圖片。
3. 再次確認內容沒有私密資訊。
4. 按下 送出。

• 純文字、文字加圖片都可以。
• 值得注意的是，圖片本身也是公開內容，所以照片裡的人臉、文件或地點線索都算公開揭露。

3.7 回覆與作者資訊卡

你對 Public 貼文的回覆也是完全公開的 — 不是私訊、也不是加密回覆。

• 透過貼文下方的回覆操作進入該篇的回覆串頁面。
• 回覆串頁面通常會顯示原始貼文、現有回覆與你自己的輸入框。
• 你也可以打開作者資訊卡，看這篇 Public 貼文是誰發的。
• 看作者資訊卡不等於進入私訊。

3.8 通知與行動中的同步

上方的通知鈴鐺用來控制 Public 的新訊息提醒。你可能會注意到 Public 列表在你移動時不斷增加 — 這是因為 NTsocial 會在遇到新裝置時持續交換公開內容。

• 如果你正在看「Public / 公共」頁面，額外通知的意義就不大。
• 但如果你在別的頁面或 App 在背景執行，新 Public 貼文就比較可能用通知提醒你。
• 就算沒有手動刷新，Public 內容也可能因為裝置相遇、同步與補齊而持續增加 — 這不是在上網抓資料，而是依賴附近真實存在的 NTsocial 使用者。

3.9 Public、私訊、頻道有何不同？

• Public / 公共：完全公開、不加密、附近陌生人也可能收到，適合公共觀察與開放式資訊流。
• PRIVATE MESSAGE / 私訊：一對一溝通，目的是和特定對象說話。
• 頻道 / Channel：有邊界的共享空間，通常有更明確的主題、團隊或加密需求。

3.10 使用情境、常見問題與排除

A. 適合的使用情境

• 附近觀察、活動現場資訊、排隊與路況狀況、街區氣氛、環境紀錄，以及任何你願意讓附近陌生人看到的公開內容。
• 附上一張圖片的簡短現地報告。
• 對你還不認識的人進行開放式公開交流。

B. 常見誤解

• Public 就像一般雲端社群平台：不完全是。它最重要的特性是在人群中由裝置彼此攜帶與交換。
• 只有好友才看得到 Public：不是，附近陌生人本來就可能收到。
• 列表一直變多，代表 App 在上網抓資料：不一定，它也可能只是持續遇到新的 NTsocial 裝置並補齊公開內容。
• Public 也適合講私事：不適合，它本來就是公開頁面。

C. 快速排除

• 你發了文，但不是立刻所有人都看見：Public 是透過真實裝置接觸逐步擴散，不是雲端即時全發。
• Public 內容一直沒有增加：先確認附近是否真的有其他 NTsocial 使用者、App 是否正常運作，以及你目前的環境是否真的有可交換的公開內容。

4. People / 人員 頁面

4.1 關於 People / 人員

People / 人員 頁不是單純的聯絡人清單 — 它把 NTsocial 人員互動區與 Meshtastic 無線狀態觀察區整合在同一頁。

• 上半部是 NTsocial 人員互動區，重點是找人、看在線、進私訊、管理好友與黑名單。
• 下半部是 Meshtastic 診斷區，重點是看節點與 Gateway 狀態。
• 只要點上半部已識別的人員列，通常就會直接開 PRIVATE MESSAGE / 私訊。
• 這是一個全域人員頁，不是某一個頻道的成員名單。

4.2 上半部人員區 vs. 下半部 Meshtastic 區

理解這一頁最簡單的方式：把它想成兩個用途完全不同的區域。

• 上半部：人和人之間的互動層，回答「我現在可以跟誰互動？我該點誰進私訊？」
• 下半部：無線與網路狀態層，回答「我的 Meshtastic gateway 現在看到了哪些節點？狀態健不健康？」

4.3 頁面配置一覽

打開 App，點底部主分頁列的 People / 人員。從上到下通常會看到：

1. 在線 NTsocial 人員清單。
2. 好友清單。
3. 黑名單。
4. Meshtastic 節點。
5. Gateway 健康資訊。

• 最上方在線清單雖然不一定另外寫著 NTsocial 標題，但本質上就是 NTsocial 人員主區。
• Meshtastic 節點 與 Gateway 健康資訊 只有在你已啟用 Meshtastic (LoRa) 時才會出現。

4.4 在線名單的閱讀方式

最上方的在線名單不是永久帳號目錄，而是 NTsocial 目前辨識到、最近有活動、實際上比較可互動的人員集合。

• 出現在這裡，比較接近「近期可互動」而不是「永遠固定存在」。
• 之後從在線清單消失，不代表好友關係、私訊紀錄或收藏狀態被刪掉。
• 第一行名稱通常會優先顯示對方已發布的 Profile 暱稱。
• 第二行可能是個人標語、個人簡介、網站、簡短識別碼，或等待身份識別提示。
• 有未讀私訊的人通常會排得更前面；再來才常常是訊號較強的人排在較前段。

4.5 點擊進私訊、長按看完整資料

上半部人員列本身，就是一對一私訊的主要入口。

• 點一下：直接開啟和對方的 PRIVATE MESSAGE / 私訊。
• 長按：開啟該對象更完整的 Profile 詳細資訊卡。
• 如果該列仍在等待身份識別，或目前映射還不完整，部分動作可能會暫時不能用。

4.6 未讀、訊號強度、好友與封鎖

• 未讀徽章：代表你和這個人的私訊目前有未讀內容。進去該對話後通常就會清掉。
• 訊號圖示與 dBm：當右側沒有未讀徽章時，常顯示的是近距離 NTsocial / BLE 可達性，不是 LoRa 診斷。
• 星號：把對方加入或移出 好友清單。
• 封鎖：把對方加入或移出 黑名單。

4.7 好友清單與黑名單

「好友清單」不等於「現在在線的人」— 它是你自己想固定保留、方便日後快速互動的人員名單。

• 對方離線後，依然會留在好友清單裡，點一下照樣能開私訊。
• 「黑名單」主要是管理用途，不是聊天入口。
• 值得注意的是，封鎖某人不代表他的無線存在會從物理世界消失 — 如果他的裝置仍然被偵測到，還是可能出現在即時觀察區。

4.8 看到「目前沒有任何連線」別緊張

如果頁面顯示目前沒有任何連線，只代表最上方在線 NTsocial 主區目前沒有可列出的人員。

• 你的「好友清單」、「黑名單」和私訊歷史都不會因此被清空。
• 這也不代表 LoRa 壞掉了 — 繼續往下看其他區塊就對了。

4.9 查看 Meshtastic 節點與 Gateway 狀態

下半部是診斷層，不是聊天層。Meshtastic 節點 顯示 gateway 目前看得到的節點，而 Gateway 健康資訊 則摘要無線側的健康度與負載。

• 節點列常會顯示節點名稱、hops、SNR、RSSI、lastHeard。
• lastHeard 的意思是 gateway 最近一次聽到這個無線節點，不是這位 NTsocial 使用者剛剛在私訊裡說話。
• Gateway 健康資訊 常會有電量、電壓、channel utilization、air-util-tx 等指標。
• 這一區是技術觀察用途，不是私訊入口。

4.10 People、Profile、頻道成員頁有何不同？

• People / 人員：全域人員互動、私訊入口、好友與黑名單管理，以及 Meshtastic 診斷。
• Profile：編輯並發布你自己的公開身分資料，讓別人看到你的最新資訊。
• 頻道成員頁：某一個特定頻道的成員名單，以及該頻道專用的可達性工具，例如 全員 Ping。

4.11 操作建議、常見問題與排除

A. 建議操作流程

1. 開私訊：進入 People / 人員，在在線清單或 好友清單 找到對方，直接點整列。
2. 把某人固定留下：按星號，把對方放進 好友清單。
3. 看完整資料：對已識別的人員列使用長按，而不是普通點擊。
4. 看 LoRa 側健康度：往下滑到 Meshtastic 節點 與 Gateway 健康資訊，不要只看上半部就判斷無線狀況。

B. 常見誤解

• 下半部 Meshtastic 節點就是我的私訊聯絡人清單：不是，它是診斷清單。
• People 頁等於頻道成員頁：不是，People 頁是全域人員頁。
• 好友清單只會顯示現在在線的人：不是，能保留離線對象本來就是它的重要價值。
• 某人不在最上方在線清單，就代表以前的私訊也沒了：不是，在線清單是動態的，私訊紀錄與收藏清單是另一層。

C. 快速排除

• 點了某列沒有反應：先確認這一列是不是還在等待身份識別，或目前對應尚未完整。
• 我想看資料，不想立刻聊天：對該列使用長按。
• 只看到目前沒有任何連線：繼續往下看 好友清單、黑名單，以及啟用 LoRa 後的 Meshtastic 區塊。
• 我看得到 Meshtastic 節點，為什麼還是不能直接私訊：這是正常的，節點觀察區不是 NTsocial 私訊入口。

1. NTsocial 概述

現代通訊基礎設施看似發達，其實異常脆弱。重大天災、區域衝突或突發性網路癱瘓一來，依賴基地台和中心化伺服器的傳統通訊方式，往往在最關鍵的時刻失效。NTsocial 就是為了這些極端情境而生的去中心化社交與戰術通訊平台。

NTsocial 堅守「不依賴外部網路」的核心設計原則，以低功耗藍牙 (Bluetooth LE) 作為通訊骨幹。就算完全沒有 4G/5G 或 Wi-Fi，NTsocial 也能把你的手機變成獨立通訊節點，自動串連成具備多跳轉發 (Multi-hop Relay) 能力的在地網狀網路 (Mesh Network)。透過這個網路，你不只能發送公開、頻道與加密文字訊息，還能分享圖片、語音檔，甚至使用 PTT (Push-To-Talk) 即時對講機功能。

為了盡可能延伸通訊範圍，每個節點都能協助暫存與轉發訊息。搭配特殊的藍牙模式，戶外無遮蔽環境下節點間直接通訊距離可達百公尺。此外，我們也積極整合 Meshtastic (LoRa) 技術作為超長距離的擴充傳輸層 — 在 BLE 骨幹持續運作的前提下，文字與戰術狀態 (ATaK) 資訊可優先透過 LoRa 傳到數公里外；再藉由 LoRa 節點間的接力轉傳，甚至能達成百公里級別的跨區域通訊，實現近端高效多媒體、遠端長效純文字的雙軌通訊架構。

作為戰區與災難現場的通訊備援，NTsocial 深度結合了離線地圖、地圖物件管理、位置回報與去中心化社交機制。我們的目標很簡單：在最惡劣的環境中，為使用者提供言論自由與資訊流動的基本通道，確保你與同伴之間的聯繫永不斷線。

本手冊會持續擴充與更新，目前涵蓋以下六大部分：

• 個人檔案設定：管理公開身分、語言與網路偏好。
• Public / 公共：閱讀、發表與回覆真正公開的貼文，理解公開訊息如何隨著附近 NTsocial 使用者持續交換。
• People / 人員：開啟私訊、查看 Profile 摘要、管理好友與黑名單，以及觀察 Meshtastic 節點健康狀態。
• NTsocial 頻道功能：建立、加入、保護與使用頻道，包含聊天、ATaK 與 PTT 應用。
• 離線地圖管理系統：圖資、主題、高程 (DEM) 與軌跡的載入與設定。
• ATaK 與 Meshtastic 工作流程：位置回報、戰術物件管理、LoRa Sync 與長距離路由設定。

5. NTsocial 頻道功能

頻道是 NTsocial 中多人共享的通訊空間，但它遠不只是聊天室。根據你的設定方式，頻道可以承載一般聊天、加密訊息、ATaK 位置資料、地圖物件，甚至透過 Meshtastic 傳送文字。

5.1 頻道的基本概念

簡單來說，一位使用者可以同時加入多個頻道，每個頻道都能有不同用途 — 有些適合公開聊天，有些需要密碼才能閱讀，有些則專門用來處理 ATaK 的位置與任務協作。

• 重要：兩個頻道的名稱就算看起來一樣，也可能是不同頻道。
• 原因：每個頻道都有自己的頻道 ID、建立者資訊與短碼。
• 建議：加入前不要只看名稱，請一起確認建立者、鎖頭圖示與頻道資訊，避免進錯頻道。

5.2 選擇適合的頻道類型

• 公開頻道：適合公開討論、臨時活動協調與附近資訊交換，不需要密碼。
• 加密頻道：適合朋友群組、小隊協調或需要保密的討論，只有知道正確密碼的人才能正常閱讀內容。
• ATaK 頻道：適合搜救、任務指揮、位置共享與地圖標記。建立時需要設定密碼與位置回報間隔。
• 已綁定 Meshtastic 的頻道：適合希望把特定 NTsocial 頻道改走 LoRa 路徑時使用；綁定後該頻道目前以文字為主。
• Meshtastic 原生通道頁：適合做診斷與原生文字測試，不等同一般 NTsocial 頻道。

5.3 Channels 頁面一覽

打開底部的 Channels 分頁後，畫面通常可分成三個區塊：你已加入的頻道、最近在附近探索到的頻道，以及 Meshtastic 通道列表。

• 已加入頻道：會顯示名稱、未讀數，以及加密、ATaK、LoRa / Meshtastic 等狀態標記。
• 探索到的頻道：顯示你的手機最近透過 beacon 或轉送訊息在附近看見過的頻道。這不是全球公開目錄。
• Meshtastic 通道：顯示目前可開啟的 Meshtastic channel index，方便進入診斷或原生文字測試頁。
• 點一下：進入該頻道。
• 長按已加入頻道：查看完整頻道 ID 與短碼。
• X 按鈕：可直接從頻道清單離開該頻道。

5.4 建立或加入頻道

在 Channels 頁面右下角點擊 + 按鈕，即可建立新頻道。頻道名稱建議簡短、容易辨識。

• 命名規則：名稱長度需介於 1 到 20 個字元之間，且不能包含 / \ : * ? " < > |。
• 公開頻道：輸入名稱後，不勾選加密與 ATaK，直接建立即可。
• 加密頻道：輸入名稱後，開啟私人 / 加密選項，設定密碼，再建立頻道。
• ATaK 頻道：輸入名稱後，開啟 ATaK 選項，設定密碼與位置回報間隔，再建立頻道。
• 建立完成後：NTsocial 會立刻讓你加入該頻道，並直接開啟頻道頁面。
• 加入探索頻道：點擊 Join。如果看到鎖頭圖示，代表必須輸入正確密碼，App 才能正確顯示內容。

5.5 傳送訊息、圖片、語音與回覆

在一般公開頻道或加密頻道中，你可以把頻道當成完整的互動空間，而不只是單純的文字聊天室。

• 文字：傳送一般聊天訊息。
• 圖片：附加圖片，並在對話中直接顯示。
• 語音：使用麥克風錄製並送出語音訊息。
• 回覆串：針對某一則貼文開啟回覆串，集中討論細節。
• 作者資訊卡：可打開發文者資訊，查看顯示名稱與相關身分資料。

5.6 成員管理、在線狀態與 PTT 對講

在頻道右上角點擊成員圖示，即可打開成員列表。

• 搜尋：可依顯示名稱或指紋相關資訊尋找成員。
• Online / Offline：讓你快速判斷對方目前是否在線。
• 訊號圖示：依據 RSSI 顯示大致的訊號強度。
• PTT 對講：點電話圖示即可對該成員發起 push-to-talk 通話。
• PTT 操作方式：PTT 是半雙工對講，類似對講機。通常是按住說話、放開收聽。

對於登山隊、搜救現場或需要快速語音協調的情境，PTT 通常比打字更有效率。

5.7 加密頻道與密碼怎麼運作？

加密頻道的核心概念很簡單：同一個頻道中的成員，必須使用相同且正確的密碼，才能正常閱讀內容。

• 密碼正確：訊息可以正常顯示與閱讀。
• 沒有密碼或密碼錯誤：你可能只會看到加密訊息占位提示，而看不到真正內容。
• 只作用在單一頻道：頻道密碼只保護該頻道，不是整個 App 的總密碼。
• 同名提醒：就算名稱一樣，不同建立者建立的頻道也可能使用不同密碼。

5.8 ATaK 頻道與位置、地圖協作

ATaK 頻道是 NTsocial 中最特化的頻道類型，適合位置更新與地圖資料跟聊天同樣重要的任務型協作。

• 適合情境：搜救、現場指揮、災害應變、巡查與任務移動協作。
• 建立方式：建立為 ATaK 頻道時，需要設定密碼與以分鐘計算的位置回報間隔。
• 必要條件：手機必須授權定位權限，且裝置定位服務必須開啟。
• 頁面行為：頻道頁會出現位置相關操作，你也可以查看成員的位置紀錄與座標。
• 地圖物件：ATaK 工作流程可新增、編輯與刪除地圖物件，讓團隊共享同一套現場資訊。

5.9 Meshtastic 綁定與原生通道

綁定並不是把 NTsocial 頻道直接變成 Meshtastic 本身，而是替這個 NTsocial 頻道指定一條 Meshtastic channel index 作為傳輸路徑。

• 綁定前：請先在 NTsocial 其他設定區完成 Meshtastic 啟用、安裝官方 Meshtastic App，並確認 LoRa 裝置已連線。
• 如何綁定：打開 NTsocial 頻道，點擊右上角的 LoRa 或 Meshtastic 按鈕，再選擇要使用的 Meshtastic channel index。
• 單一頻道對應：一個 NTsocial 頻道一次只能綁定到一個 Meshtastic channel index。
• 可共用底層通道：若有需要，多個 NTsocial 頻道仍可共用同一個 Meshtastic channel index。
• 綁定後：文字仍可正常使用，但圖片與語音會在該頻道停用。

而 Channels 頁面下半部看到的 Meshtastic 通道列表則不同。那些項目開啟的是 Meshtastic 原生通道頁，主要用於原生文字測試與診斷，不是一般 NTsocial 頻道聊天頁。

5.10 通知、離開與注意事項

• 未讀數：已加入頻道的卡片會顯示未讀數，方便你快速判斷哪裡有新訊息。
• 通知開關：進入頻道後，可用右上角的鈴鐺按鈕切換該頻道通知。
• 從清單離開：直接點擊頻道卡片上的 X。
• 從頻道內離開：使用右上角的 Leave 操作。
• ATaK 提醒：離開 ATaK 頻道後，該頻道對你的裝置所做的位置回報與相關狀態同步也會停止。
• 探索清單限制：探索區只會顯示你的手機最近在附近實際看見過的頻道，不是世界上所有頻道。
• 密碼錯誤判斷：如果已加入卻仍看到加密占位訊息，請先確認密碼是否正確，或你是否加入了另一個同名但不同建立者的頻道。

6. 離線地圖管理系統 (Offline Map System)

NTsocial 的地圖完全離線渲染，不依賴 Google Maps 或任何線上服務 — 就算沒有電信網路也能正常運作。不過，你需要自己匯入地圖圖資檔案。支援的格式是全球開源地圖社群主流的 .map/.xml/.DEM/.GPX，在台灣推薦使用開源專案「魯地圖」(MOI.OSM - Taiwan TOPO)。

6.1 開啟地圖

1. 第一次使用地圖功能，請先下載最新版的圖資檔案 — 直接把 .map/.xml/.DEM 三種檔案都抓下來。
2. 一般 Android 手機會存到 Download 資料夾，不用手動解壓縮或搬移，NTsocial 會自動處理。
3. 在 App 底部主選單點「地圖」就能進入。
4. 如果是第一次進入還沒匯入圖資，App 會要求你至少選一個已在手機裡的地圖檔（例如 .map）。

6.2 匯入與切換地圖

• 打開側邊欄，捲到「離線地圖」區塊。
• 還沒匯入地圖、或想新增地圖的話，點「匯入地圖檔 (.map/.zip)」。
• 系統會開啟檔案瀏覽器，選擇手機裡的 .map 檔案（或包含它的 .zip）。
• 匯入後，在清單中點檔名就能啟用。

小提醒：系統會自動記住你上次使用的地圖檔。

6.3 地圖視覺主題

• 渲染主題決定地圖長什麼樣 — 道路顏色、等高線顯不顯示等等。
• 在側邊欄「渲染主題 (Theme)」區塊，點「匯入主題 (.xml/.zip)」。
• 建議匯入包含完整資源（圖片、圖示）的 .zip 壓縮檔。
• 匯入後，在清單中選想套用的主題；選「預設 (Default)」就會用內建風格。

文字縮放 (Text Scale)：覺得地圖上的路名或標籤太小？到側邊欄調整「文字比例」，有小 (0.35x) 到特大 (0.85x) 等選項。

6.4 高程資料與地形陰影

• 系統支援 SRTM HGT 格式的高程數據，用來生成地形陰影（Hillshading）。
• 在側邊欄「高程資料 (DEM)」區塊，點「匯入 HGT (.hgt/.zip)」。
• 選擇對應你目前地圖區域的 .hgt 檔案。
• 匯入後，系統會自動在地圖上疊加地形陰影效果。

6.5 管理 GPX 軌跡

• 在側邊欄「GPX 軌跡」區塊，點「匯入 GPX」。
• 匯入後勾選清單裡的檔名，軌跡（藍色線條）就會顯示在地圖上。
• 可以同時勾選多個 GPX 檔來疊圖分析。

6.6 基本操控方式

• 縮放： 使用雙指開合，或點擊右上角的 + / - 按鈕。
• 歸位： 點擊右上角的 TW 按鈕，可快速將視角重置回預設中心點（台灣區域）。
• 平移： 單指拖曳地圖。

7. ATaK 戰術頻道操作 (Tactical Channel Operations)

ATaK 頻道是專為戶外團隊協作設計的功能。你可以建立任意數量的 ATaK 頻道，地圖上也能同時勾選多個頻道，一次掌握好幾個隊伍的地理資訊。每個 ATaK 頻道都會自動同步成員的即時位置與地圖物件 — 程式會自動幫每位成員回報 GPS 座標，成員也能根據對現場地理的觀察，自行建立地圖物件。

7.1 在地圖上顯示頻道

• 你加入的頻道只要被標記為「戰術頻道」，就會自動出現在地圖左側邊欄下方的「ATaK 頻道」列表。
• 打開左側邊欄，往下捲到底部就能看到。
• 顯示/隱藏：勾選頻道名稱左邊的核取方塊，決定要不要在地圖上顯示該頻道的成員與物件。
• 展開資訊：點頻道名稱右邊的箭頭，可以查看成員列表（含最後回報時間）和地圖物件清單。

7.2 自動位置回報 (PLI - Position Location Information)

• 加入戰術頻道後，系統會自動在背景回報你的位置，回報間隔由頻道建立者設定。
• 回報機制：系統根據頻道的「更新間隔」，自動擷取 GPS 座標並加密廣播。
• 新鮮度保護：如果 GPS 定位太舊（例如進了室內收不到訊號），系統會暫停回報，避免送出錯誤座標。
• 隱私：位置只會送到你已加入且開啟同步的戰術頻道，隨時可以退出。

7.3 追蹤隊友位置

• 地圖上會用圓形圖示標出頻道成員的位置。
• 縮寫字元：圓圈裡的字母或數字是該成員的識別碼。
• 顏色編碼：系統會自動分配不同顏色（紅、紫、綠、藍等），方便辨識。
• 詳細資訊：點成員圖示就能看到完整暱稱、所屬頻道和最後一次位置更新時間。

5.4 戰術物件 (Map Objects) 管理

A. 建立物件

• 長按地圖上你想放物件的位置（建議先放大到適當比例再點）。
• 系統會跳出「建立地圖物件」對話框，填入以下資訊：
• 發佈頻道：選擇要同步到哪些頻道（可多選）。
• 名稱：物件簡稱，例如 CP-1、Target-A。
• 屬性：簡短備註，例如資源、食物、飲水、帳篷、營地、火苗。
• 描述：更詳細的情報說明。
• 圖示符號：從符號網格選一個代表圖示（人員、醫療、危險、集結點等）。
• 按「建立」後，物件就會廣播到網狀網路。

B. 查看與編輯物件

• 點地圖上已有的物件圖示，會彈出資訊視窗，顯示名稱、座標、屬性、描述，以及目前所在的頻道（Alive Channels）。
• 編輯：點「編輯」可修改名稱、描述，或把物件同步到更多頻道。
• 刪除：點「刪除」並選要從哪些頻道移除。系統會送出「刪除操作（Op: Delete）」到選定的頻道，從成員地圖上移除該標記。

8. Meshtastic / LoRa、LoRa Sync 與頻道分享 QR

在 NTsocial 裡，Meshtastic / LoRa 並不會取代整個 App。換句話說，它是一條專用的長距離傳輸層，服務範圍包括：已綁定 LoRa 的頻道文字、LoRa Sync 補歷史、頻道 / 成員 / 個人檔案的狀態同步、ATaK 狀態傳輸，以及頻道分享 QR 流程。

8.1 NTsocial 裡的 LoRa 是什麼角色？

理解 Meshtastic 最好的方式，就是把它看成「選擇性啟用的長距離延伸層」。它負責特定頻道的文字與戰術狀態傳輸，而 NTsocial 其他大部分功能仍然走原本的 BLE 與 App 層邏輯。

• LoRa 在這裡做什麼：讓非常短的文字與戰術快照，比一般 Bluetooth 連線傳得更遠。
• 它不是什麼：不是一個把整個 App 一鍵切成「純 LoRa 通訊器」的總開關。
• 最適合的用途：長距離群組文字、LoRa Sync 補歷史、ATaK 狀態傳輸，以及已經部署 Meshtastic 硬體的團隊共享頻道流程。

8.2 哪些內容走 LoRa、哪些不走？

頻道正確綁定到 LoRa 之後，並不是所有內容都會一樣處理。另外要特別留意：NTsocial 的 BLE 長距離模式和 Meshtastic LoRa 是兩套完全不同的系統，別搞混了。

• 主要會走 LoRa 的內容：已綁定 NTsocial 頻道的文字訊息、文字回覆、手動貼進頻道的分享連結或其他文字型分享內容、LoRa Sync 的文字補歷史、最新頻道狀態、成員名單更新、個人檔案 JSON 文字欄位更新、ATaK 狀態快照，以及 All Ping。
• 主要不走 LoRa 的內容：圖片、語音訊息、頭像圖片檔、PTT / 通話音訊，以及一般近距離 BLE 訊息同步。
• Long Range BLE 模式：這仍然是 NTsocial 內部 BLE stack 的 Bluetooth Coded PHY（S=8）。
• Meshtastic（LoRa）：這需要 Meshtastic 官方 App、可正常工作的 LoRa 節點，以及相容的 Meshtastic 頻道設定。

8.3 相關畫面都在哪裡？

Meshtastic 相關操作分散在 NTsocial 好幾個不同頁面。先把位置認清楚，後續設定會順暢很多。

• Profile 分頁：Meshtastic (LoRa) 卡片會出現在 Publish Profile 與 BLE 的 Long Range Mode 設定附近。
• Channels 首頁：頂部切換可以在 NTsocial 與 Meshtastic 之間切換。
• 一般 NTsocial 頻道畫面：右上操作區會有 Members、可選的 ATaK 圖示、通知、LoRa / LoRa ON，以及 Leave Channel。
• Members 頁面：All Ping 就在這裡。
• People 頁面：當 LoRa 啟用後，這裡可能會顯示 Meshtastic Nodes 與 Gateway Health。
• 地圖頁：如果你已加入 ATaK 頻道，地圖側邊欄可能會顯示 ATaK 成員與物件狀態。

8.4 第一步：先搞定 Meshtastic 官方端

最穩定的設定流程，永遠是從 Meshtastic 官方 App 開始。NTsocial 的設計是重用那條已經跑起來的連線，而不是取代原本的 Meshtastic 工作流。

1. 如果還沒裝，先安裝 Meshtastic 官方 App。
2. 打開相容的 LoRa 節點，並在官方 App 內完成配對與連線。
3. 建立或匯入你準備要使用的 Meshtastic 頻道。
4. 如果節點還沒有設定 region，先把正確區域設定完成，再做任何通訊測試。
5. 確認雙方使用相容的 Meshtastic 頻道設定。最安全的方法，是雙方都匯入同一份 channel QR code 或 shared link。
6. 回到 NTsocial 前，先在官方 Meshtastic App 互傳一則非常短的訊息，例如 test。

• 連線限制：Meshtastic 裝置通常同一時間只支援一個活躍使用者連線。
• 實務建議：如果你要在 Bluetooth、Wi-Fi、USB 中選擇，NTsocial 目前應優先使用 Bluetooth，因為現有整合依賴已保存的 BLE 裝置位址。

8.5 從 Profile 開啟 Meshtastic

確認 Meshtastic 官方 App 狀態正常後，再到 NTsocial 的 Profile 頁面打開整合層。

1. 打開 Profile。
2. 找到標示 Meshtastic (LoRa) 的卡片。
3. 打開開關。
4. 如果 NTsocial 可以直接重用官方 Meshtastic App 目前的連線，狀態通常會立刻進入健康狀態。
5. 如果系統要求選裝置，請選擇你已在官方 App 裡準備好的同一顆 LoRa 節點。

• 常見狀態：未啟用、未安裝 Meshtastic、等待 Meshtastic 服務、連線中、已連線、服務中斷。實際字樣會因 App 版本不同而稍有差異。
• 值得知道：裝置位址一旦保存，之後通常不需要重選，除非你更換 LoRa 裝置，或清掉 App 資料。
• 如果選裝置畫面有問題：先確認 Bluetooth 已開啟、必要的掃描或連線權限已允許；若完全沒看到裝置，先回到官方 Meshtastic App 確認 LoRa 節點真的有開機、在附近，而且可見。

8.6 查看 Meshtastic 頻道清單

LoRa 啟用後，進入 Channels 並切到 Meshtastic 分頁。這通常是確認 NTsocial 確實有讀到即時 Meshtastic 資料的最好方式。

1. 打開 Channels。
2. 切換到 Meshtastic。
3. 查看狀態橫幅，以及 Meshtastic 頻道卡片清單，內容通常會顯示 index、名稱、uplink / downlink 狀態。
4. 點進某一列，例如 [0] Primary 或 [1] LongFast，進入 LoRa Channel #N 頁面。
5. 在這個頁面只做非常短的原生文字測試即可。

• LoRa Channel #N 是做什麼的：它是原生 Meshtastic 文字與診斷摘要的查看 / 測試頁。
• 別搞混：這不是一般 NTsocial 聊天頁，打開它也不代表你已經把某個普通 NTsocial 頻道綁定完成。
• 如果你看到 APP[256] ... bytes：通常表示 NTsocial 流量走過 Meshtastic app-port 路徑。這是一種診斷摘要，不是一般聊天文字。
• 長度限制：原生 Meshtastic 診斷文字應控制在 180 UTF-8 bytes 以內，而第一次測試最好比這更短。

8.7 關鍵一步：把 NTsocial 頻道綁定到 LoRa

這一步才是真正讓普通 NTsocial 頻道開始走 Meshtastic 的關鍵 — 光是打開全域支援還不夠。

1. 打開你真正想使用的 NTsocial 頻道。
2. 點擊頻道畫面頂部的 LoRa 或 LoRa ON。
3. Meshtastic 路由對話框打開後，選擇你要綁定的 channel index。
4. 如果已經存在綁定，你可以查看目前選擇、切換它，或移除綁定。
5. 完成後，這個 NTsocial 頻道會在你自己的手機上記住這個映射。

• 一個 NTsocial 頻道只能綁一條路由：單一 NTsocial 頻道，同一時間只能綁到一個 Meshtastic channel index。
• 本機端仍有彈性：如果你有需要，多個 NTsocial 頻道仍然可以指向同一個本機 Meshtastic index。
• 綁定是本機資料：這個綁定以裝置為單位。若雙方都想從 NTsocial 經由同一條 LoRa 路徑發送，雙方都必須在自己的裝置上各自建立綁定。

8.8 綁定之後會有哪些變化？

A. 介面與訊息路徑的變化

綁定完成後，普通 NTsocial 頻道文字不再是直接送出原生 Meshtastic 文字。NTsocial 會把內容包成自己的封包格式，再交給 Meshtastic 傳輸。也就是說，此時 Meshtastic 是傳輸層，而不是最終面向使用者的聊天格式。

• 頻道列表變化：該頻道通常會顯示 LoRa 標記；如果同時也是 ATaK 頻道，也可能看到位置圖示。
• 頻道頁變化：頂部按鈕會變成 LoRa ON 或等效狀態字樣。
• 輸入區變化：輸入區會變成純文字模式，圖片與語音按鈕會依設計消失。
• 接收端建議：如果你是從診斷頁發送，對方可在 Meshtastic 官方 App 裡讀到；如果你是從已綁定的 NTsocial 頻道發送，接收端理想上也應使用 NTsocial。

B. 正確理解訊息長度

很多人以為訊息本文永遠都能用滿 180 bytes，但那只適用於原生 Meshtastic 診斷文字頁。已綁定的 NTsocial 聊天不一樣 — 整個封包還要帶上 NTsocial 自己的資料、標頭和加密開銷，所以留給你打字的空間更小。

• 診斷文字頁：原始文字本身必須控制在 180 UTF-8 bytes 以內。
• 已綁定的 NTsocial 頻道：可用文字會比 180 bytes 更短，因為整個封包都必須塞得下。
• 字元寬度很重要：中文、日文、emoji 與其他多位元字元，比純拉丁字母與數字更占空間。
• 實務規則：把已綁定的 NTsocial LoRa 聊天，視為「非常短文字通道」，不要把它當成可以發長段落的地方。

C. 如何判斷收到的訊息是否經過 LoRa

在已綁定的 NTsocial 頻道裡，最有用的觀察點通常是接收端，而不是你自己的送出氣泡。

• 收到的訊息：如果訊息經由 Meshtastic 進來，發送者名稱旁通常會出現 LoRa 標記。
• 你自己送出的訊息：就算 NTsocial 確實優先嘗試過 LoRa，你自己的送出訊息也不一定會因此顯示 LoRa。
• 範圍提醒：Meshtastic 綁定不會把整個 App 都切到 LoRa 模式。Private Chat 與一般 public feed 仍然走其他路徑。

8.9 LoRa Sync：背景自動補齊與狀態同步

LoRa 的作用不只是即時傳送頻道文字。NTsocial 也會善用這條長距離路徑，在背景默默補回漏掉的內容、刷新各種狀態。

A. LoRa Sync 如何補回漏掉的文字

• 它會做什麼：若雙方共用同一個已綁定 LoRa 的 NTsocial 頻道，而其中一方漏掉部分文字歷史，NTsocial 會在背景透過 LoRa 把那些文字補回來。
• 什麼時候最有感：重新上線後、弱路徑恢復後，或再次遇到同一頻道內的節點時。
• 主要補的是什麼：文字貼文、文字回覆，以及文字型分享卡。
• 不會用 LoRa 補的內容：圖片、語音、頭像圖片檔、PTT 音訊。

B. 不只聊天文字，狀態也會同步

• 頻道狀態：最新頻道名稱、摘要與相關 metadata，可透過 LoRa 維持得更即時。
• 成員名單：因為背景會同步 roster state，成員列表的新鮮度會更好。
• 個人檔案 JSON：暱稱、bio、tagline 等文字型欄位可以同步，即使頭像圖片檔本身不會同步。
• ATaK 狀態：位置與戰術狀態快照也能納入這條背景同步路徑。

8.10 怎麼確認訊息真的走了 Meshtastic？

最可靠的驗證順序是這樣：

1. 先讓診斷文字頁能正常運作。
2. 把一個 NTsocial 頻道綁到同一個 Meshtastic index。
3. 在已綁定的 NTsocial 頻道裡送出一則很短的訊息。
4. 確認對方是在 NTsocial 裡收到，並檢查收到的訊息旁是否出現 LoRa 標記。

• 如果 Meshtastic 傳輸層塞不下這個封包，NTsocial 可能會退回自己的 BLE mesh 路徑。
• 測試時，盡量不要讓兩支手機處在 NTsocial 直連 BLE mesh 非常強的情況，否則會很難判斷真正送達的是哪一條傳輸路徑。
• 進階使用者：如果你會使用 adb 或 logging 工具，也可以查看 Meshtastic app-port 相關診斷檔或 logcat，但大多數人不需要靠這一步才能完成設定。

8.11 用 All Ping 測試連通性

All Ping 是一個很快的方式，用來看 NTsocial 頻道內目前有哪些成員能回應你，以及回應路徑是否牽涉到 LoRa。

1. 打開任一 NTsocial 頻道。
2. 點擊右上附近的 Members 圖示，進入成員頁。
3. 點擊該頁右上角的 All Ping。
4. 查看成員狀態，例如 Waiting、Temporarily unreachable、xx ms / x.x s，或額外的 LoRa 標記。

• 若頻道已綁定 LoRa：All Ping 可以同時利用 BLE 與 LoRa。
• 若頻道沒有綁定 LoRa：此功能仍可使用，但它會更像是近距離 BLE 可達性測試。
• 結果會顯示在哪裡：Ping 結果留在成員頁，不會變成一般聊天訊息。

8.12 查看節點與 Gateway 狀態

底部的 People 分頁不只是看聯絡人。LoRa 啟用後，它也是判斷 Meshtastic 側網路健康度的實用位置。

• Meshtastic node list：通常會看到節點名稱，以及 hops、SNR、RSSI、lastHeard 等欄位。實務上，hops 越少通常代表路徑越直接；SNR 與 RSSI 是訊號品質參考；lastHeard 則代表最近一次聽到該節點是多久前。
• Gateway health：這裡通常會顯示電量、電壓、channel utilization、air-util-tx 等指標，當你懷疑電力偏低、頻道過忙或封包送達不穩定時，特別有用。

8.13 透過 LoRa 使用 ATaK

如果你需要長距離戰術協作，LoRa 綁定和 ATaK 頻道設定缺一不可。

1. 建立一個 NTsocial 頻道，或把既有頻道標記成 ATaK 頻道。
2. 設定該 ATaK 頻道要求的密碼與位置更新間隔。
3. 在同一個頻道內，用 LoRa 按鈕把它綁到正確的 Meshtastic channel index。
4. 保持 NTsocial 的背景服務正常執行，並確認定位權限已授予。

• 為什麼兩層都要設：光有 LoRa 綁定不會自動讓頻道變成 ATaK 頻道，反過來也是。
• LoRa 幫忙帶哪些東西：位置回報、ATaK 設定、地圖物件，以及相關的最新狀態快照。
• 建議順序：先確認短文字能穩定送達，再擴充到 ATaK，這樣會比較穩。

8.14 用 QR Code 分享頻道

NTsocial 可以把你已加入的頻道打包成 QR Code 分享出去 — 對需要快速發放頻道資訊的現場團隊來說，這功能非常實用。

1. 打開 Channels，點擊右下角浮動的 + 按鈕。
2. 選擇用來產生分享 QR 的操作項目。
3. 勾選一個或多個你已加入的頻道。
4. 產生預覽並確認打包的頻道清單。

• 預覽會顯示什麼：已選頻道數量、大型 QR 圖、被打包的頻道列表，以及匯入方式說明。
• 常見分享方式：儲存 PNG、對外分享，或在 NTsocial 的私訊分享卡流程裡送出。
• 若在 NTsocial 內送出：接收者通常看到的是分享卡，而不是單純圖片；這個流程本質上是私訊分享卡，不是任意把一般頻道切成 LoRa 路由。
• 容量：一張 QR 目前實務上大約可容納 12 個頻道。
• 安全提醒：加密頻道的 QR 分享並不會直接包含明文密碼，而是攜帶驗證材料，讓接收者之後輸入密碼時可以驗證是否正確。

8.15 收到 QR 後怎麼匯入並加入頻道？

NTsocial 支援好幾種接收共享頻道包的方式：

• 直接掃描：使用頻道操作選單開啟 QR 掃描器。
• 從圖片匯入：選取已存的 PNG 或截圖，讓 NTsocial 偵測其中的 QR。
• 從 NTsocial 分享卡匯入：如果有人在 NTsocial 內送你頻道分享卡，使用卡片上的匯入操作。
• 外部交接：NTsocial 也可以處理支援的 share intent，或像 ntsocial://channels/import?... 這類 deep link。

• 匯入結果摘要：你可能會看到 imported、updated、already existed、failed 等計數。
• 匯入後頻道會出現在哪裡：它們會出現在頻道畫面的 NTsocial 分頁、可發現區塊下方，而不是自動變成已加入頻道。
• 你還需要做什麼：仍然要自己按加入。如果是加密頻道，還要輸入正確密碼。若你也想走 LoRa，加入後還要在本機再次綁定 LoRa。
• 重要提醒：匯入 QR 不會自動加入頻道，也不會自動幫接收手機建立 LoRa 綁定。

8.16 離開頻道時會清除什麼？

離開頻道時，被清掉的不只是成員資格。對 LoRa 與 ATaK 使用者來說，這點特別重要。

• 通常會清掉的內容：該頻道的 LoRa 綁定、該頻道的 ATaK 設定、快取的 ATaK 位置與地圖物件、成員名單快取、LoRa 對等路徑記憶，以及綁在該頻道上的 All Ping 狀態。
• 重新加入後要做什麼：不要假設離開 / 重加後原設定還在，應重新確認 LoRa 綁定與 ATaK 設定。

8.17 建議流程與常見問題排除

A. 最短、正確的操作流程

1. 先在 Meshtastic 官方 App 連好 LoRa 節點。
2. 從 NTsocial 的 Profile 啟用 Meshtastic (LoRa)。
3. 確認 Meshtastic 子分頁已經能顯示頻道清單。
4. 建立或加入你真正要使用的 NTsocial 頻道。
5. 進入該頻道，用 LoRa 按鈕完成綁定。
6. 送一則很短的文字，並確認接收端看得到 LoRa 標記。
7. 確認這些都正常後，再往 All Ping、ATaK、QR 分享與地圖協作擴充。

B. 常見誤解

• 「打開 LoRa 後整個 App 都走 LoRa 了吧？」不是。只有特定已綁定頻道的文字與戰術封包才會優先嘗試 LoRa。
• 「打開 LoRa Channel #N 就代表頻道綁好了？」不是。診斷頁跟真正的頻道綁定是兩回事。
• 「匯入 QR 就等於加入頻道了？」不是。你仍然要手動加入頻道，如果需要 LoRa 還要另外在本機綁定。
• 「訊息送到了就代表一定是走 LoRa？」不一定。BLE fallback 也可能把它送到。
• 「分享 QR 裡面有頻道密碼？」沒有。QR 不會直接包含明文密碼。
• 「在 NTsocial 內傳 QR 就是 LoRa 分享流程？」不是。它本質上是私訊分享卡流程，不會把頻道自動切成 LoRa 路由。

C. 常見問題

• Meshtastic (LoRa) 一直顯示 disconnected：先確認 Meshtastic 官方 App 已安裝、節點真的在那邊連上，而且 NTsocial 仍然看得到同一顆裝置。
• Meshtastic 分頁沒有顯示任何頻道：檢查 LoRa 是否已啟用、官方 App 是否已載入頻道清單，以及節點是否真的連線中。
• 綁定後圖片還是傳不遠：這是正常現象。圖片不是 LoRa 的主要承載對象。
• 你匯入了 QR 卻找不到頻道：請到 NTsocial 頻道分頁的可發現區塊下方找，不是在已加入清單裡。
• QR 掃描器說沒有可匯入內容：請改用原始 PNG、圖片匯入功能，或未經重度壓縮的外部分享載荷，不要只用壓縮過的截圖。
• 加密頻道分享 QR 產生失敗：先檢查頻道狀態與分享材料是否完整，再確認該頻道的密碼資訊沒有處於不一致或缺失狀態。
• All Ping 經常顯示 temporarily unreachable：重新檢查 LoRa 綁定、雙方 Meshtastic 頻道是否相容、節點供電是否穩定，以及 Meshtastic Nodes 與 Gateway Health 裡顯示的訊號指標。

9. 故障排除與注意事項

地圖空白或呈現網格狀

• 先確認側邊欄有沒有選到正確的 .map 檔案。
• 再看看你有沒有下載這個區域對應的離線圖資。

位置一直沒更新

• 確認 Android 系統已授予 NTsocial「永遠允許」或「使用應用程式時」的位置權限。
• 如果開了省電模式，可能會擋住背景位置回報 — 建議把 NTsocial 加入電池最佳化白名單。

物件同步有延遲

• ATaK 協議依賴 Mesh 網路傳輸，節點稀疏或訊號受干擾時，同步本來就可能有物理延遲。
• 如果物件顯示「已刪除」但圖示還在，試試重新整理或重啟 App。

檔案相容性問題

• 地圖檔僅支援 Mapsforge 相容格式（推薦 OpenAndroMaps）。
• 用 ZIP 匯入時，記得確認壓縮檔裡沒有多餘的 macOS 系統檔（例如 __MACOSX 資料夾），否則可能匯入失敗。