Desktop 採用 Avalonia 打造跨平台介面，WPF 則是 Windows 桌面介面方案。macOS、Linux 使用者請選擇對應平台的 Desktop 套件；Windows 使用者可依現有設定、操作習慣與所需功能決定。本文將說明如何辨別架構、釐清介面與核心的分工、遷移設定，以及切換後的檢查步驟，避免把介面框架差異誤認為協定能力或網路速度差異。
Desktop 與 WPF 的差異
Avalonia 和 WPF 都是介面框架，並非代理協定，也不是負責處理網路連線的核心。v2rayN 的伺服器清單、訂閱群組與設定視窗屬於用戶端介面；能否建立連線，還取決於實際使用的核心、伺服器參數、路由規則與網路環境。介面能正常開啟，不代表核心已成功啟動。
| 比較項目 | Desktop（Avalonia） | WPF |
|---|---|---|
| 適用平台 | 支援 Windows、macOS、Linux，須下載對應的系統套件 | 適用於 Windows，無法作為其他系統的原生應用程式執行 |
| 介面實作 | 採用跨平台控制項與版面配置，並依平台調整系統整合 | 採用 Windows 桌面控制項與互動模式 |
| 協定能力 | 取決於使用的核心及其設定支援 | 同樣取決於使用的核心及其設定支援 |
| 使用差異 | 須檢查系統匣、快速鍵、視窗縮放與權限行為 | 適合沿用既有的 Windows 操作習慣 |
| 設定遷移 | 確認目標版本套件的設定格式與功能入口 | 同樣不能假設任意版本之間都能直接覆蓋設定 |
即使使用相同的 Xray 核心，也不能只憑視窗外觀判斷 VLESS、VMess 或 REALITY 是否可用。請查看實際核心版本及伺服器要求的欄位。也不能因為「跨平台」就推論速度更快，或因為「僅支援 Windows」就推論延遲更低；比較速度時，必須固定伺服器、核心、路由與測試條件。
結論：先確認系統，再驗證功能
下載前先排除不適用的平台套件；下載後使用同一台伺服器，檢查訂閱更新、代理接管與核心記錄。伺服器交握失敗時，不要直接改用另一種介面框架。
Windows 使用者怎麼選
Windows 是兩種介面方案都適用的平台。初次安裝可先試用 Desktop；已在 WPF 上建立穩定工作流程的使用者，無須只因介面名稱不同就遷移。以下建議適用於初次安裝，不代表某種介面在所有裝置上都更快或功能一定更多。
Desktop（Avalonia）
建議初次安裝時可作為首選，尤其適合也會在 macOS 或 Linux 上使用 v2rayN 的使用者。操作概念容易對應，但系統匣與系統代理仍須在各平台分別測試。
適合：初次安裝 Windows 版、需要在多種桌面系統間切換
WPF
目前設定運作正常時，可以繼續使用。若仰賴特定快速鍵、清單操作或視窗配置，請先記下需求，再確認 Desktop 對應版本是否符合；不必先遷移才尋找替代入口。
適合：已有穩定設定、習慣既有的 Windows 操作方式
系統架構與執行環境
- 開啟 Windows「設定」→「系統」→「系統資訊」，查看「系統類型」。x64 與 ARM64 應選擇相符的架構，不要把「64 位元」直接等同於 x64。
- 前往用戶端下載頁，確認 Windows 套件的介面類型、架構與執行環境需求。是否需要另外安裝執行階段，請以該版本套件的說明為準。
- 啟動後先檢查主視窗、系統匣圖示與結束操作。若視窗無法啟動，先排查執行階段與架構；若視窗能啟動但代理無法使用，再檢查核心記錄。
介面程式與核心程式是不同的處理程序。套件選錯，可能在視窗開啟前就失敗；核心檔案缺失、連接埠遭占用或設定欄位不相容，則可能要到選擇伺服器後才會發現。分開記錄這兩個階段，會比反覆覆蓋安裝更容易排除問題。
macOS 與 Linux 如何選套件
這兩種平台都應選擇對應系統的 Desktop 套件。不要把 Windows 的 WPF 套件複製過去，再將無法啟動歸咎於訂閱失效。作業系統、CPU 架構與套件格式是三項獨立條件，必須分別確認。
平台選擇：先確認架構，再檢查系統整合
macOS
- 開啟蘋果選單→「關於這台 Mac」，查看「晶片」或「處理器」。
- Apple Silicon 裝置選擇 ARM64 套件；Intel 裝置選擇 x64 套件。
- 啟動後檢查系統匣選單、系統代理，以及結束後代理設定是否還原。
- 若要使用 TUN，請依目前版本的提示處理權限；TUN 不等同於一般的系統代理開關。
Linux
- 在終端機執行
uname -m查看機器架構。 x86_64對應 x64，aarch64通常對應 ARM64。- 依 Linux 發行版選擇適用的 deb、rpm 或其他已提供的套件格式。
- 檢查桌面環境是否支援系統匣、代理設定，以及 TUN 所需的權限。
同為 Desktop，不代表各平台的系統整合完全相同；先確認日常使用的應用程式能否透過代理連線，再視需求設定 TUN。
Linux 的桌面系統代理通常需要桌面環境與應用程式支援。瀏覽器可能會讀取這項設定，但終端機程式可能需要另外設定代理參數。TUN 則涉及虛擬網路介面與路由接管，所需權限及實作方式都不同。未能接管終端機流量，不代表 Desktop 缺少連線到伺服器的功能。
依任務逐項檢查功能
介面名稱不能取代功能清單。請分別驗證訂閱匯入、群組管理、路由設定、核心選擇、系統代理與 TUN；不同版本的選單配置及功能進度可能有所差異。下表列出的選單名稱可供尋找功能，實際位置仍以已安裝的版本為準。
| 任務 | 操作位置或欄位 | 驗收標準 |
|---|---|---|
| 更新訂閱 | 「訂閱群組」→「訂閱群組設定」；執行更新訂閱 | 原有訂閱來源可正常更新，群組與篩選結果符合預期 |
| 本機監聽 | 「設定」→「參數設定」，檢查本機監聽位址與連接埠 | 核心記錄沒有位址遭占用的錯誤，應用程式連線至實際監聽的連接埠 |
| 系統代理 | 主畫面或系統匣中的「系統代理」選單 | 系統代理指向用戶端實際使用的連接埠，停用後恢復預期狀態 |
| 路由分流 | 「設定」→「路由設定」，確認規則順序與出站標籤 | 需要直連及需要透過代理的目標都能依預期比對 |
| 核心相容性 | 核心選項與啟動記錄 | 實際使用的核心能接受所需的協定、傳輸方式與安全參數 |
| TUN 接管 | TUN 開關、權限提示與相關記錄 | 啟用後路由正確，停用後網路可恢復正常 |
例如，原有設定讓應用程式連線至 127.0.0.1:10808，遷移後就應確認新執行個體是否仍監聽該連接埠，以及該連接埠提供哪種協定。此處的 10808 僅為檢查範例，並非所有版本套件的固定預設值。HTTP 代理不能任意指向只提供 SOCKS 的監聽連接埠；是否支援混合監聽，須依實際設定而定。
- 介面問題：按鈕位置、清單欄寬、快速鍵或縮放顯示異常時，優先記錄介面版本、作業系統與顯示縮放比例。
- 核心問題：記錄顯示無法辨識欄位或協定時，請檢查所選核心與設定，不要只重設視窗配置。
- 流量接管問題：核心已執行，但應用程式未走代理時，請檢查系統代理、應用程式本身的代理參數與 TUN，而不是先刪除訂閱。
遷移設定與復原步驟
遷移的目的是沿用訂閱與規則，而不是將整個舊目錄覆蓋到新套件中。不同版本可能調整資料庫或設定結構；目標程式成功讀取設定，也不代表舊程式仍能讀取修改後的檔案。保留獨立備份，比共用設定目錄更安全。
- 記錄目前狀態。記下用戶端版本、核心類型、本機監聽連接埠、目前的路由模式與訂閱群組。訂閱網址屬於敏感資訊，不要放進公開截圖。
- 結束舊執行個體並備份。先停用系統代理、關閉 TUN，再結束用戶端。使用目前版本提供的備份或匯出功能；若需複製設定目錄，請先結束程式再操作。
- 獨立安裝目標介面。使用獨立的程式目錄，並依版本支援的方式隔離設定。不要只因程式位於不同目錄，就認定資料一定已隔離。
- 分階段還原。先匯入訂閱，並確認一台已知可用的伺服器，再遷移自訂路由、DNS 與其他設定。不要一次匯入所有變更，之後才猜測故障原因。
- 檢查連接埠與流量接管。確認舊核心已結束，新執行個體沒有連接埠衝突。先測試手動指定代理，再啟用系統代理，最後才測試 TUN。
- 保留復原方式。若重要功能不符合需求，請結束新執行個體並還原獨立備份。不要讓舊程式直接讀取已被新版本改寫、且尚未確認相容的設定。
一般使用者要驗證可用性時，先只變更介面。如果同時更換伺服器、核心、DNS 與路由，就無法從測試結果判斷是哪項變更造成影響。記錄中若包含訂閱網址、使用者識別資訊或伺服器憑證，分享前請先移除。
版本選擇常見問題
Windows 上的 WPF 版已能使用，還需要換成 Desktop 嗎？
不必只為了名稱而更換。先列出實際需求，例如跨桌面系統使用、顯示縮放或特定操作入口，再用獨立設定測試 Desktop。原有訂閱更新、路由與系統代理都運作穩定時，可以繼續沿用目前的方案。
Desktop 能開啟，為什麼還是連不上伺服器？
先查看核心啟動記錄，確認是否有連接埠遭占用、檔案缺失或設定解析錯誤，再核對伺服器位址、連接埠、傳輸方式與安全參數。視窗能開啟，只代表介面處理程序已成功啟動，不能證明核心已建立連線。
換成 Avalonia 後，VLESS 或 VMess 會變快嗎？
沒有證據顯示單靠介面框架就能普遍提升速度。請使用相同伺服器、核心與路由進行測試，並確認沒有背景訂閱更新或第二個代理執行個體干擾。若測試條件不同，就不能將結果歸因於 Avalonia。
macOS 或 Linux 找不到與 Windows 相同的選單，該怎麼辦？
先確認下載的是對應平台的 Desktop 套件，再依「訂閱、路由、系統代理、TUN」等功能名稱，查看主視窗、設定視窗與系統匣選單。若目前版本沒有該入口，請查閱版本說明，不要直接照搬其他系統的設定路徑。
匯入舊設定時發生錯誤，可以直接覆蓋整個目錄嗎？
先停止覆蓋並保留備份。試著只匯入訂閱，確認基本連線可用後，再逐項還原規則。若仍需完整遷移，請先確認來源版本與目標版本支援的格式；要復原時，使用遷移前保留的獨立備份。