Project Status zh Hant

🌐 English | 繁體中文

專案狀態

Alpha——積極開發中。 桌面應用程式已可端對端運作（Rust 引擎啟動、毛玻璃外殼渲染、即時遙測資料串流至診斷頁面）。Expert「真實介面卡」模式（Windows／Wintun）會建立虛擬介面並擷取即時封包。兩個對等節點可以交換信令字串，並透過穿透各自的 NAT 建立直接、經過驗證的加密連線（C4）；真實 IP 流量現在會透過虛擬介面卡在該連線上於兩端之間傳輸（C5），並附即時 RTT 與輸送量。前向錯誤更正（Reed-Solomon）能在不重傳的情況下修復遺失的封包——每組可修復任意 r 個遺失（D.1、D.2）——而分流通道政策控制哪些區域網路流量——子網內單播、廣播、多播——會被通道傳輸（E.1），廣播／多播轉發與 FEC 冗餘度皆可從設定頁面自訂（B.3）。應用程式會將虛擬介面卡所在網路自動歸類為私人網路，並自動限定防火牆允許規則的範圍（E.2），設定頁面也可透過 New-NetRoute 將額外的 address/prefix 網路導入通道（E.2）——兩者皆為對稱設計（雙方都必須各自開放自己的傳入流量才能送達，而不只是傳送端的傳出流量）。完整的站對站區域網路共用（讓對等節點的整個真實區域網路無需雙方事先宣告即可觸及）目前刻意排除在範圍之外，理由與不提供中繼／TURN 相同。驗證備註： 整條路徑——交握、加密、資料層、FEC 與分流通道政策——皆由自動化測試套件端對端覆蓋（透過模擬介面卡在本機迴路上執行兩條即時管線）；真實的 NAT 穿透尚未在兩台實體機器上驗證，是目前尚待解決的主要風險。

真實介面卡（Expert，Windows）： 建立 Wintun 虛擬介面需要系統管理員權限。若在未提升權限的情況下開啟，引擎會回報 需要管理員權限 狀態，並提供一鍵重新啟動的選項。經簽署的 wintun.dll 隨附於 wintun.net（詳見 src-tauri/resources/wintun/NOTICE.txt）。

領域	狀態
儲存庫骨架與文件	✅ 已完成
Tauri 2.x 應用程式初始化	✅ 已完成
應用程式外殼——60px 側邊欄、麵包屑、黃金比例版面、6 種主題、毛玻璃設定覆蓋層	✅ 已完成
持久化介面狀態——主題、目前路由與設定於重啟後還原（zustand/persist）	✅ 已完成
引擎遙測骨架——模擬資料路徑 + TelemetrySink IPC 橋接（即時統計與封包記錄）	✅ 已完成
虛擬介面卡（TUN/TAP）——Wintun 整合、真實封包擷取、提升權限處理	✅ 已完成
虛擬介面卡——Linux（/dev/net/tun）與 macOS（utun）實作	🚧 已實作，尚未於實機驗證——見 PLATFORM-SUPPORT.md
傳輸層 + STUN——共用 UDP 通訊端、反射式探索、即時 RTT／抖動／遺失率（C1）	✅ 已完成
加密與身分——X25519 身分、Noise IK 交握、AEAD 連線 + 防重放（C2）	✅ 已完成
手動信令——容錯的 Offer/Answer 字串（公鑰 + 候選位址，CRC32）（C3）	✅ 已完成
對等連線——以 NAT 打洞作為交握機制（多路嘗試 + 單一勝出方提名），加密保活 RTT（C4）	✅ 已完成
資料層串接——虛擬介面卡 ↔ 加密連線，IP 封包於對等節點間點對點傳輸（C5）	✅ 已完成
前向錯誤更正——Reed-Solomon 應用於資料層，每組可在不重傳的情況下修復任意 r 個遺失（D.1、D.2）	✅ 已完成
分流通道——資料層政策，管控單播／廣播／多播是否進入通道（E.1）	✅ 已完成
完整路徑整合測試套件——透過模擬介面卡於本機迴路執行兩條即時管線（F.0）	✅ 已完成
前端測試基礎——vitest + testing-library，涵蓋純邏輯與 store（B.1）	✅ 已完成
應用程式外殼路由測試——Sidebar／Breadcrumb／AppShell 於真實路由器上，經突變測試驗證	✅ 已完成
網路頁面——對等連線管理自診斷頁面獨立出來，首批元件測試（B.2）	✅ 已完成
連線設定——分流通道廣播／多播 + FEC 冗餘度已串接至設定介面（B.3）	✅ 已完成
即時分流通道切換——廣播／多播變更可套用至已連線的連線，無需重新連線（B.4）	✅ 已完成
多語系（i18n）——英文、繁體中文、簡體中文，react-i18next，即時切換並持久化	✅ 已完成
Windows 網路整合——介面卡歸類為私人網路、限定範圍的防火牆允許規則，盡力而為（E.2）	✅ 已完成
作業系統路由管理——透過 New-NetRoute 將額外的 address/prefix 網路導入通道，對稱式分流通道政策擴充（E.2）	✅ 已完成
站對站區域網路共用（對等節點宣告路由 + 遠端 IP 轉發）	⏳ 延後——需要 3 台實體主機才能驗證，暫不可行；詳見 CHANGELOG
診斷——即時遙測讀數 ✅ · FEC／政策計數器 ✅ · 雙節點拓撲檢視 ✅ · 頻譜圖表 ✅	✅ 已完成
設定——分層式 Basic／Expert 存取（連線區塊受控，僅為顯示層級）	✅ 已完成
設定——JSON 設定檔匯入／匯出（僅連線設定）	✅ 已完成
專屬 Minecraft 頁面——設定摘要 + 一鍵套用預設（手動操作，非程序偵測）	✅ 已完成
網路化信令伺服器——WebSocket 主機、網路名稱／密碼驗證、即時成員名冊（G.1）	✅ 已完成
網路化信令用戶端——加入網路、追蹤名冊 + 即時加入／離開事件（G.2）	✅ 已完成
透過信令連線中繼 Offer/Answer——僅作為傳輸層（G.3）	✅ 已完成
多對等節點 ConnectionManager——各對等節點獨立連線狀態，具備 Mesh 就緒能力（G.3b）	✅ 已完成
Mesh 自動連線協調——名冊 + 中繼 → 自動 offer/answer，無需手動貼上（G.3c）	✅ 已完成
虛擬網路介面——建立／加入網路、即時成員清單，整合至網路頁面（G.4）	✅ 已完成
遊戲標籤網路——Minecraft 快速建立面板，通用的 gameTag metadata 於任何檢視該網路之處顯示	✅ 已完成
網路頁面的虛擬網路面板重新定位為純管理用途——提示 + 收合式通用表單	✅ 已完成
提升權限輔助程序——IPC 通訊協定 + 訊息封裝（E.3 步驟 1）	✅ 已完成
提升權限輔助程序——請求／回應派發流程、通用傳輸層，tun::windows 5 項操作中 4 項已串接真實邏輯（E.3 步驟 2）	✅ 已完成
提升權限輔助程序——真實具名管線傳輸（僅擁有者可存取之 ACL）、helper.exe 執行檔、提升權限啟動（E.3 步驟 3）	✅ 已完成
提升權限輔助程序——create_adapter + attach_existing（輔助程序擁有介面卡，主程序依名稱開啟）（E.3 步驟 4）	✅ 已完成
提升權限輔助程序——真正取代整個應用程式重新啟動的流程；卡在需於實機驗證未提升權限下的 WintunOpenAdapter（E.3 步驟 5）	⏳ 受阻
CI 發布管線——標籤推送時自動建置 Windows 安裝器並發布至草稿 GitHub Release	✅ 已完成

版本逐項細節請見 CHANGELOG.md（僅英文）。尚未建置的預定功能清單請見 功能。