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

2. 個人檔案 (Profile) 設定

2.1 認識你的 Profile 頁面

NTsocial 的 Profile 頁面整合三類設定：公開個人資料、只影響自己手機的本機選項，以及選用的 BLE、LoRa 與高速歷史同步控制。

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

2.2 頁面配置與進入方式

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

1. 頁面標題與頭像區。
2. 節點貢獻。
3. MESH 寵物。
4. 暱稱。
5. 基本資料。
6. 社群連結。
7. 語言。
8. 發布。
9. 長距離模式（LE Coded PHY S=8）。
10. Wi-Fi 高速同步。
11. Meshtastic／LoRa 閘道與閘道 App 選擇。
12. 協尋掃描與位置回報（UTFind）。
13. 關於 NTsocial。

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 連線與選用服務

Profile 下半部目前依序提供 BLE 長距離、統一的 Wi-Fi 高速同步、所選 LoRa 閘道與 UTFind。即使所有選用項目都關閉，BLE 仍是通訊基礎。

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

• 這是 BLE 長距離，不是 LoRa。
• 雙方裝置都要支援 Coded PHY 與 Extended Advertising，而且雙方都要啟用。
• 雙方啟用後會立即要求雙向 Coded PHY S=8，標準探索仍並行維持。
• 如果手機硬體不支援，NTsocial 可能會顯示不支援訊息，並將開關維持停用。
• 正確理解方式是「把 BLE 拉得更遠」，不是「把手機變成 LoRa 無線電」。

2.6.2 MeshLink／Meshtastic 閘道

• 在「閘道應用程式」選擇「NTsocial MeshLink（建議）」或「Meshtastic 官方應用程式」；同一時間只會啟用其中一個提供者。
• MeshLink 是預設的受控選項。先在 MeshLink 內配對與設定無線電端點，NTsocial 再讀取準備完成的無線頻道清單。選用官方 App 時，則由官方 App 持有目前的無線電連線並透過相容服務提供頻道。
• 在「Channels」中，MeshLink 無線頻道可依節點分組。把每個已加入的 NTsocial 頻道綁到正確的無線電端點與頻道；多個 NTsocial 頻道也可刻意共用同一條無線路由。
• 若無線頻道顯示過期，或無線清單改變後既有綁定無法解析，請重新開啟路由設定並選擇目前的端點。

2.6.3 Wi-Fi 高速同步

• 單一的「Wi-Fi 高速同步」開關已取代舊版分開的 Aware 與 Direct 控制；NTsocial 會自動使用最快的相容實作路徑。
• Wi-Fi Aware 可服務相容 Android 節點；裝置支援時，Wi-Fi Direct 可服務相容 Android 或 Windows 路徑。能否使用取決於硬體、Android 版本、附近 Wi-Fi 權限，以及部分版本所需的定位服務。
• 這一層會加速經驗證的精確歷史與可用附件工作，但不是探索基礎，也不取代 BLE 的即時訊息。
• 卡片會顯示「已關閉」、「待命」、「正在連線或同步」、「正在完成同步」或「暫時無法使用」；最後一種狀態下 BLE 仍可繼續。

2.6.4 私密 Wi-Fi 檔案連線

• 大型檔案控制只會出現在一對一私訊。點上方連線狀態膠囊，或先選檔案再按「連線並傳送」。
• 對方會收到包含名稱的高速連線要求，必須明確接受。連線就緒後會顯示使用的是「Wi-Fi Aware」或「Wi-Fi Direct」。
• 可一次選擇多個檔案，先檢查數量與總大小、加入或移除項目，再送出；接收者仍要逐一接受或拒絕檔案。
• 這是免伺服器、免網際網路的裝置直連。傳輸狀態、驗證與安全邊界請見第 10 章。

2.6.5 UTFind 協尋功能

• UTFind 預設關閉；必須先明確同意並輸入每個安裝實例專用的服務金鑰。一般 NTsocial 通訊不需要它。
• 啟用且 NTsocial 值勤時，會掃描附近 FT／UT 藍牙標籤，並把標籤識別資訊、此手機的位置與時間回報到 UTFind（UTTEC）。
• 回報失敗時會在本機加密保存，最多 5,000 筆，之後再補傳。關閉 UTFind 會停止掃描，並刪除尚未上傳的紀錄。

2.7 發布、同步與常見問題

2.7.1 發布會改變什麼

• 「Publish」會把目前的個人資料文字打包成正式版本，向外推送給其他人。
• 主要影響的欄位包括「Tagline」、「Bio」、「Location」、「Website」、「Email」和各種社群連結。
• 暱稱可能在你按「Publish」之前就已經在本機畫面和新訊息中更新了，但「發布」仍然是確保所有人都拿到最新版個人資料的最可靠方式。
• 單純換頭像、切語言、Long Range、Wi-Fi 高速同步、閘道或 UTFind，都不需要靠「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：先在 NTsocial MeshLink（建議）或 Meshtastic 官方 App 設定無線電，到 Profile 選擇同一個閘道，最後在 Channels 綁定真正要用的 NTsocial 頻道。
5. 加速歷史或傳送私密大檔：啟用「Wi-Fi 高速同步」，由 NTsocial 選擇相容的 Aware 或 Direct 路徑。BLE 仍要保持啟用，因為它負責探索與備援。

2.7.4 常見誤解與解決方法

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

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 閘道已啟用，且它提供目前狀態時才會出現。

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) 即時對講機功能。

每個附近節點都能協助暫存與轉發符合條件的訊息。支援的手機在雙方啟用長距離模式後會要求 Bluetooth Coded PHY S=8，同時維持標準探索。選用的 MeshLink／LoRa 路徑可把明確綁定的頻道文字，以及支援的個人檔案、頻道與 ATaK 狀態延伸到 BLE 之外；圖片、語音、PTT、一般即時媒體與基礎恢復仍走 BLE。統一的 Wi-Fi 高速層會短暫建立經驗證的連線，用於精確歷史與經同意的私密檔案；它不依賴網際網路，也不取代 BLE 探索。

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

本手冊依五大主分頁展開，並加入目前私訊、高速 Wi-Fi、LoRa 與 UTFind 的專章：

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

1.1 首次啟動與權限

1. 使用 Android 8.0（API 26）以上、具備 Bluetooth Low Energy 的手機。BLE 是必要條件；Wi-Fi Aware、Wi-Fi Direct、相機與 LoRa 硬體都是選用。
2. 允許「附近裝置／Bluetooth」。若你的 Android 版本要求 BLE 掃描必須搭配定位權限與系統定位服務，也請依引導開啟。核心節點探索不會因這個 Android 限制就讀取你的 GPS 軌跡。
3. 若需要 Mesh 前景服務在背景穩定值勤，請允許通知並取消電池限制。
4. 只有使用對應功能時再授予選用權限：高速同步／檔案需要附近 Wi-Fi、語音／PTT 需要麥克風、QR 掃描需要相機、ATaK 或 UTFind 回報才會實際使用精確位置。
5. 先完成暱稱與 Profile，文字欄位按一次 Publish，再讓另一台 NTsocial 裝置靠近，確認 BLE 探索正常後才疊加 Wi-Fi 或 LoRa。

5. NTsocial 頻道功能

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

5.1 頻道的基本概念

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

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

5.2 選擇適合的頻道類型

• 公開頻道：適合公開討論、臨時活動協調與附近資訊交換，不需要密碼。
• 加密頻道：適合朋友群組、小隊協調或需要保密的討論，只有知道正確密碼的人才能正常閱讀內容。
• ATaK 頻道：適合搜救、任務指揮、位置共享與地圖標記。建立時需要設定密碼與位置回報間隔。
• 已綁定 LoRa 的 NTsocial 頻道：適合讓特定頻道的短文字與支援狀態同時使用 MeshLink LoRa 與 BLE；圖片、語音與 PTT 仍可透過 BLE 使用。
• MeshLink 無線頻道頁：用來唯讀查看無線頻道狀態；不支援直接輸入 LoRa 文字，社交文字必須從已綁定的普通 NTsocial 頻道送出。

5.3 Channels 頁面一覽

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

• 已加入頻道：會顯示名稱、未讀數，以及加密、ATaK、LoRa / Meshtastic 等狀態標記。
• 探索到的頻道：顯示你的手機最近透過 beacon 或轉送訊息在附近看見過的頻道。這不是全球公開目錄。
• Meshtastic 無線路由：顯示目前的無線電節點與頻道，供診斷與綁定。MeshLink 會依節點分組，並把失效項目分開顯示，方便重新選擇有效路由。
• 點一下：進入該頻道。
• 長按已加入頻道：查看完整頻道 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 頻道指定由目前閘道 App 提供的一個無線電節點與頻道。

• 綁定前：先在 Profile 選擇 NTsocial MeshLink（建議）或 Meshtastic 官方 App，在該閘道中配對與設定無線電，再等待路由目錄就緒。
• 如何綁定：打開 NTsocial 頻道，點擊右上角的 LoRa 或 Meshtastic 按鈕，再選擇要使用的無線電節點與頻道。
• 單一邏輯頻道對應：一個 NTsocial 頻道一次只能綁定一條 Meshtastic 路由。
• 可共用底層通道：若有需要，多個 NTsocial 頻道仍可共用同一個無線電節點與頻道。
• 綁定後：短文字與支援狀態新增 LoRa 路徑，BLE 仍會傳送綁定文字；圖片、語音與 PTT 透過 BLE 繼續使用。

Channels 頁面下半部的 MeshLink 無線頻道列表不同於一般 NTsocial 頻道。那些項目開啟唯讀診斷頁，不支援直接輸入 LoRa 文字；請先綁定普通 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 追蹤隊友位置

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

7.4 戰術物件 (Map Objects) 管理

A. 建立物件

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

B. 查看與編輯物件

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

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

NTsocial 一次只會使用一個選定的 Meshtastic 閘道 App：建議使用 NTsocial MeshLink，也支援 Meshtastic 官方 App。選定的閘道負責無線電配對、設定、路由狀態與封包傳輸；NTsocial 繼續負責社交介面、邏輯頻道、正式歷史、BLE 與 LoRa 排程。LoRa 是短文字與支援狀態的明確逐頻道選項，不會取代整個 App。

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 閘道：需要 NTsocial MeshLink（建議）或 Meshtastic 官方 App、可正常工作的無線電，以及已就緒且相容的無線路由。

8.3 相關畫面都在哪裡？

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

• Profile 分頁：Meshtastic／LoRa 閘道卡片位在統一的「Wi-Fi 高速同步」卡片下方。啟用 LoRa 前，先選 MeshLink（建議）或 Meshtastic 官方 App。
• 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 閘道

無線電設定從你在 Profile 選定的閘道 App 開始；NTsocial 主 App 不會直接與無線電配對，而且同一時間只會啟用一個閘道。

1. 安裝 NTsocial MeshLink（建議）或 Meshtastic 官方 App，並在 NTsocial 的 Profile 選擇同一個 App。
2. 開啟選定的閘道、啟動相容 LoRa 節點，並在該閘道內完成無線電配對。
3. 設定正確的無線電區域，並建立或匯入要使用的實體無線頻道。
4. 確認雙方的無線頻道設定相容，並用選定閘道的狀態畫面確認準備完成。
5. 等閘道回報可用路由已就緒，再回到 NTsocial。

• 責任邊界：配對、實體頻道設定、無線電就緒與韌體端佇列狀態都屬於選定的閘道 App。
• 送達邊界：本機閘道佇列接受不代表另一台無線電已經收到封包。

8.5 從 Profile 選擇並啟用閘道

閘道 App 回報可用路由已就緒後，再到 NTsocial 的 Profile 啟用整合。

1. 打開 Profile。
2. 找到 Meshtastic／LoRa 閘道 卡片，選擇 NTsocial MeshLink（建議）或 Meshtastic 官方 App。
3. 打開開關。
4. 若尚未安裝選定的 App，完成安裝後再回來；若已安裝但尚未就緒，開啟該閘道完成無線電設定。
5. 等 NTsocial 顯示閘道已就緒，再綁定真正要使用的 NTsocial 頻道。

• 常見狀態：閘道 App 尚未安裝、準備中、已就緒或無法取得狀態。
• 若設定失敗：請在選定的閘道內檢查配對、無線電設定、權限與路由就緒狀態。

8.6 查看 MeshLink 無線頻道清單

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

1. 打開 Channels。
2. 切換到 Meshtastic。
3. 查看狀態橫幅，以及 Meshtastic 頻道卡片清單，內容通常會顯示 index、名稱、uplink / downlink 狀態。
4. 點進某一列，例如 [0] Primary 或 [1] LongFast，進入 LoRa Channel #N 診斷頁面。
5. 該頁刻意不支援直接輸入 LoRa 文字；請先綁定普通 NTsocial 頻道，再從該頻道送出社交文字。

• LoRa Channel #N 是做什麼的：唯讀查看 MeshLink 無線頻道與診斷摘要。
• 別搞混：這不是一般 NTsocial 聊天頁，打開它也不代表你已經把某個普通 NTsocial 頻道綁定完成。
• 如果你看到 APP[256] ... bytes：通常表示 NTsocial 流量走過 Meshtastic app-port 路徑。這是一種診斷摘要，不是一般聊天文字。
• 傳送規則：NTsocial 社交文字必須從已綁定的普通 NTsocial 頻道產生，診斷頁不會繞過這條邊界。

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

這一步會替普通 NTsocial 頻道增加 MeshLink LoRa 文字／狀態路徑；只打開全域支援還不夠，而且 BLE 仍保持啟用。

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

• 一個 NTsocial 頻道只能綁一條路由：單一 NTsocial 頻道，同一時間只能綁到一條 Meshtastic 路由。
• 本機端仍有彈性：如果你有需要，多個 NTsocial 頻道仍然可以指向同一個本機無線電節點與頻道。
• 路由失效：如果已儲存的節點或頻道不再出現在最新目錄，請重新開啟路由對話框，改選目前有效的路由。
• 綁定是本機資料：這個綁定以裝置為單位。若雙方都想從 NTsocial 經由同一條 LoRa 路徑發送，雙方都必須在自己的裝置上各自建立綁定。

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

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

綁定完成後，NTsocial 仍會立刻透過 BLE 傳送頻道文字，也可能把 NTsocial envelope 交給 MeshLink 走 LoRa。MeshLink 是無線電 Gateway，不是最終面向使用者的聊天格式。

• 頻道列表變化：該頻道通常會顯示 LoRa 標記；如果同時也是 ATaK 頻道，也可能看到位置圖示。
• 頻道頁變化：頂部按鈕會變成 LoRa ON 或等效狀態字樣。
• 輸入區行為：文字可使用 LoRa overlay；圖片、語音片段與 PTT 仍可透過 BLE 使用，而且不會送進 MeshLink / LoRa。
• 接收端規則：接收端應使用 NTsocial，因為 LoRa 承載的是 NTsocial envelope，不是原生 Meshtastic 對話文字。

B. 正確理解訊息長度

每個 MeshLink 命令承載一個完整、最多 180 bytes 的 NTsocial envelope。因為 envelope 內還有 NTsocial 標頭與中繼資料，使用者可輸入的文字會更短。

• 診斷頁：唯讀，不能傳送原生 LoRa 文字。
• 已綁定的 NTsocial 頻道：完整 envelope 必須小於等於 180 bytes，因此可用文字更短。
• 字元寬度很重要：中文、日文、emoji 與其他多位元字元，比純拉丁字母與數字更占空間。
• 實務規則：把已綁定的 NTsocial LoRa 聊天，視為「非常短文字通道」，不要把它當成可以發長段落的地方。

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

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

• 收到的訊息：如果訊息經由 Meshtastic 進來，發送者名稱旁通常會出現 LoRa 標記。
• 你自己送出的訊息：綁定文字也會立刻走 BLE；自己的訊息氣泡無法證明 MeshLink 是否接受平行送出的 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. 先確認 MeshLink 已就緒，且預期的無線頻道已出現。
2. 把一個 NTsocial 頻道綁到相同且相容的無線路由。
3. 在已綁定的 NTsocial 頻道裡送出一則很短的訊息。
4. 確認對方是在 NTsocial 裡收到，並檢查收到的訊息旁是否出現 LoRa 標記。

• 如果完整 NTsocial envelope 超過 MeshLink 限制，LoRa 副本不會送出；一般 BLE 路徑仍維持有效。
• 測試時，盡量不要讓兩支手機處在 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 無線電節點與頻道。
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. 先在 NTsocial MeshLink 配對並設定 LoRa 節點，等它顯示已就緒。
2. 在 NTsocial 的 Profile 選擇 NTsocial MeshLink 或 Meshtastic 官方 App，並啟用閘道。
3. 確認 Meshtastic 子分頁已經能顯示頻道清單。
4. 建立或加入你真正要使用的 NTsocial 頻道。
5. 進入該頻道，用 LoRa 按鈕完成綁定。
6. 送一則很短的文字，並確認接收端看得到 LoRa 標記。
7. 確認這些都正常後，再往 All Ping、ATaK、QR 分享與地圖協作擴充。

B. 常見誤解

• 「打開 LoRa 後整個 App 都走 LoRa 了吧？」不是。只有明確綁定頻道的短文字與支援狀態可使用 LoRa；BLE 仍同步送出綁定文字並承載媒體。
• 「打開 LoRa Channel #N 就代表頻道綁好了？」不是。診斷頁跟真正的頻道綁定是兩回事。
• 「匯入 QR 就等於加入頻道了？」不是。你仍然要手動加入頻道，如果需要 LoRa 還要另外在本機綁定。
• 「訊息送到了就代表一定是走 LoRa？」不一定。BLE 也會送出綁定文字，可能是由 BLE 完成送達。
• 「分享 QR 裡面有頻道密碼？」沒有。QR 不會直接包含明文密碼。
• 「在 NTsocial 內傳 QR 就是 LoRa 分享流程？」不是。它本質上是私訊分享卡流程，不會把頻道自動切成 LoRa 路由。

C. 常見問題

• Meshtastic 閘道尚未就緒：確認 Profile 中選定的 App 已安裝，再打開它檢查無線電配對、路由準備、權限與 Gateway 狀態。
• MeshLink 頻道清單是空的：確認 MeshLink 已完成無線頻道準備，而且 NTsocial 的 LoRa 開關已啟用。
• 綁定後圖片還是傳不遠：這是正常現象。圖片不是 LoRa 的主要承載對象。
• 你匯入了 QR 卻找不到頻道：請到 NTsocial 頻道分頁的可發現區塊下方找，不是在已加入清單裡。
• QR 掃描器說沒有可匯入內容：請改用原始 PNG、圖片匯入功能，或未經重度壓縮的外部分享載荷，不要只用壓縮過的截圖。
• 加密頻道分享 QR 產生失敗：先檢查頻道狀態與分享材料是否完整，再確認該頻道的密碼資訊沒有處於不一致或缺失狀態。
• All Ping 經常顯示 temporarily unreachable：重新檢查 LoRa 綁定、雙方 Meshtastic 頻道是否相容、節點供電是否穩定，以及 Meshtastic Nodes 與 Gateway Health 裡顯示的訊號指標。

9. 私訊與安全性

9.1 開始私訊

1. 開啟 People／人員，點一下 NTsocial 使用者即可進入一對一對話；長按則會開啟較完整的 Profile。
2. 在聊天頁頂端確認顯示名稱與縮短的 Peer ID。同一列也提供收藏、安全性與高速檔案連線狀態。
3. 文字照常輸入送出；私訊圖片使用圖片選擇器，任意格式的大型檔案則走第 10 章的獨立 Wi-Fi 流程。

私訊真正綁定的是對方指紋，不只是暱稱。暱稱可以改變；敏感對話時請同時核對身分圖示與安全狀態。

9.2 看懂保護狀態

• 共享密語保護／較高身分保證：兩台裝置已根據你們透過其他可信方式交換的相同密語衍生私訊金鑰。這是選用的較高保證端到端模式。
• 內容已自動加密・身分未人工核驗：雙方直接交換身分金鑰後，自動 DM2 會保護內容，但你尚未人工確認對方真實身分。
• 自動身分金鑰已變更・已改用應用程式基礎保護：曾觀察到的自動身分已變更。請先停止敏感內容，確認變更原因，或重新設定共享密語。
• 應用程式基礎保護・非端到端加密：在較強的對等保護尚未建立前，NTsocial 以內建共用 App 金鑰避免線上傳輸與紀錄成為明文；但能擷取這把 App 金鑰的人仍可能解密或偽造，因此不是 E2EE。

9.3 設定共享密語

1. 進入私訊，點頂端的安全性圖示。
2. 先透過面對面或另一條可信管道與對方交換夠強的密語。兩台裝置都輸入完全相同的內容，並在本機再次確認。
3. 按「儲存」。NTsocial 會衍生 Android／iOS 相容的 256 位元金鑰，只把衍生金鑰存入 App 私人儲存；BLE 直連問候不會傳送密語。
4. 重新開啟對話框，確認頂端狀態已顯示共享密語保護。清除金鑰只會影響這一台裝置。

不要在準備保護的同一則私訊裡傳送共享密語。若本機兩次輸入不一致，系統不會啟用任何金鑰。

9.4 圖片、語音與本機操作

• 私訊文字與圖片不必預先設定即可使用基礎或自動保護；私訊語音目前仍要求雙方先設定同一個共享密語。
• 大型檔案泡泡只有在手動共享密語生效時才會顯示「端到端加密」；一般的「已加密連線」表示直連已驗證，不是同一個 E2EE 宣告。
• 長按訊息後拖曳超過一半，只會刪除這支手機上的本機副本，不會從其他節點收回。
• 封鎖會在你的裝置上停止一般互動，但不會刪除已經送到其他裝置的副本。

10. 高速 Wi-Fi 與大型檔案

1.5.8 將舊版分開的 Aware 與 Direct 設定整合成一個選用高速層。它會建立暫時的點對點 Wi-Fi，不需要網際網路或雲端伺服器；BLE 同時持續負責節點探索、即時流量與備援。

10.1 開啟選用 Wi-Fi 層

1. 開啟 Profile，打開「Wi-Fi 高速同步」。此功能預設關閉。
2. Android 詢問時允許「附近 Wi-Fi 裝置」。部分 Android 版本或 Direct 模式也需要開啟定位服務，才能探索對等裝置。
3. 等狀態顯示 Wi-Fi 已待命。若硬體不支援或缺少權限，卡片會顯示原因，而 BLE 仍可繼續使用。

10.2 精確歷史高速同步

• 附近出現相容節點時，NTsocial 可用 Wi-Fi Aware 或 Wi-Fi Direct 建立經驗證的精確歷史工作階段。
• 同步範圍可涵蓋 Public、雙方共同加入的頻道、直接私訊配對，以及符合授權範圍的歷史附件。
• 一般即時訊息不會等待 Wi-Fi；短暫工作階段前、中、後，BLE 都保持啟用。
• Profile 卡片可能顯示連線／同步、清理或最後結果說明。Wi-Fi 嘗試失敗不代表 BLE 訊息也失敗。

10.3 私密傳送大型檔案

1. 開啟一對一私訊。點頂端的高速連線狀態，或從輸入列選擇檔案動作。
2. 若高速 Wi-Fi 尚未開啟，先在首次說明頁選「開啟並連線」。NTsocial 接著會向目前選定的對象提出直連要求。
3. 對方必須接受高速連線。等狀態顯示 Wi-Fi Aware、Wi-Fi Direct 或「已就緒」。
4. 選擇一個或多個檔案。預送出頁會顯示檔案數與總大小，可先「加入更多」或移除個別項目。
5. 按「傳送」。每個檔案都會在對話中顯示進度、速度、預估剩餘時間與保護標示。

檔案選擇器可接受任意格式，也沒有一般小型聊天附件的低容量限制；實際仍受來源檔案是否可讀、接收端可用空間與 Android 儲存提供者限制。

10.4 接收與驗證檔案

1. 只有在你認得畫面上的對方名稱，而且確實預期這次要求時，才接受高速連線。
2. 每個檔案送達前先檢查名稱與大小，再選「接受」或「拒絕」。
3. 泡泡會依序顯示準備、等待、排入佇列、傳輸中與「正在驗證 SHA-256」；只有接收位元組與描述相符後才標示完成。
4. 完成後可「開啟檔案」或「分享檔案」。未知檔案格式仍要依一般外來檔案的安全原則處理。

10.5 安全性與中斷行為

• 有共享密語私訊金鑰時，檔案區塊使用較高保證 E2EE。沒有共享密語時，相容 Android 直連可使用經驗證的連線保護，但介面不會把它標成 E2EE。
• 與 Windows 的 Wi-Fi Direct 檔案傳輸要求手動共享密語保護。
• 大型檔案不走 LoRa。BLE 維持控制關係與備援通訊，經同意的檔案位元組才走暫時 Wi-Fi 路徑。
• 傳輸中不要主動中斷。App 會警告：從該對話框主動中斷會讓目前傳輸失敗，而且不能手動續傳。短暫傳輸錯誤可能由系統內部重新連線，但請保持來源檔案可用，必要時重新送出。
• 若進度停滯，讓兩邊 App 保持運作、Wi-Fi／Bluetooth 保持開啟、確認接收端空間，並避免切換對話對象。為某人選取的批次會在離開或換人時清除。

11. UTFind 與 App 工具

11.1 開啟協尋掃描

1. 開啟 Profile，找到「協尋掃描與位置回報」。
2. 打開開關，完整閱讀同意內容；向服務提供者取得每個安裝實例專用、可撤銷的金鑰，輸入後選「同意並開啟」。
3. 依卡片指引允許藍牙與定位能力，開啟 Bluetooth 與裝置定位；需要背景掃描時，讓 NTsocial 保持值勤。

服務金鑰由 Android Keystore 保護，不會寫入 App 紀錄。若授權失效，使用「更新服務金鑰」。

11.2 看懂狀態與待補傳紀錄

• 正常流程可能顯示「等待 NTsocial 值勤」、「正在取得定位」、「正在掃描」、「正在回報本輪資料」或「正在背景補傳」。
• 卡片會顯示本輪發現的標籤數、待補傳紀錄、最後成功回報時間，以及最近一次上傳結果。
• 服務離線時，失敗紀錄會加密保存在本機，最多 5,000 筆，之後再補傳。BLE 掃描本身不需網際網路，但上傳到外部服務需要網路。
• 權限、Bluetooth、定位、請求頻率限制、授權、安全儲存與協議錯誤會顯示成不同狀態；請使用卡片提供的處理按鈕，不要只反覆切換開關。

11.3 關閉並刪除待傳資料

關閉 UTFind 開關，再確認「關閉並刪除」。掃描與回報會立即停止，所有尚未上傳、目前留在這支手機的紀錄都會刪除。已被外部服務接收的資料不屬於這次本機刪除範圍。

11.4 MESH Pet 與關於 NTsocial

• MESH Pet 是選用、可展開的 Profile 面板。成功補傳文字歷史所累積的 relay points 會影響食物、HP、心情與動畫，但不會改變訊息優先權或權限。
• Profile 最下方的「關於 NTsocial」會顯示已安裝版本、專案理念、開發者、官方網站與聯絡方式。要確認隊友使用哪個版本時可先看這裡。
• 前景服務常駐通知代表 Mesh 值勤持續運作；啟用 UTFind 後，通知也會標示協尋與位置回報。

12. 問題排除與安全注意事項

找不到附近的人

• 確認 Bluetooth 已開啟、已允許「附近裝置」，且你的 Android 版本要求時已開啟定位服務供 BLE 掃描。
• 若 App 進入背景後經常斷線，請取消電池限制。BLE 硬體是必要條件；Wi-Fi 與 LoRa 都是選用。

高速連線無法使用或停滯

• 查看 Profile 統一卡片是否提示硬體、附近 Wi-Fi 權限或定位服務。雙方都要啟用功能，並接受畫面上具名的私密連線。
• 保持來源檔案可用、確認接收端空間後重試。高速層失敗不會停用 BLE 訊息。

私訊出現身分金鑰變更警告

• 先停止敏感訊息，透過可信管道確認對方裝置狀態。需要較高保證時，重新設定共享密語。

UTFind 一直等待或無法上傳

• 依序檢查服務金鑰、Bluetooth、精確定位權限、裝置定位、網路，以及 NTsocial 是否值勤。卡片會分別標出請求頻率限制與授權失效。

地圖空白或呈現網格狀

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

位置一直沒更新

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

物件同步有延遲

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

檔案相容性問題

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