支援頁面

支援頁面是文件、執行狀況檢查、診斷、記錄檔和支援包匯出的單一主頁。物理裝置配置現在位於硬體下。

Figure 1. 「支援 → 執行檢查」為每項探測顯示一行，包括「透過 / 資訊 / 警告 / 失敗」，以及可用時的修復操作。初始開啟的是「資源」索引標籤。

標籤條

支援頁面預設開啟資源索引標籤，提供線上文件與內建 PDF 連結。另外兩個索引標籤也只需點選即可開啟：

資源（首先開啟）——官方文件和 PDF 手冊。可透過「設定 → 常規」安排再次顯示歡迎向導。
執行檢查 — 日常排查介面（裝置、Linux 上的 udev 規則、模擬器可達性、執行時狀態）。點選 執行檢查 進行探測。
診斷 — 執行時指標、可搜尋事件記錄檔和一鍵支援包匯出。單獨記錄在診斷標籤頁頁面。

裝置選擇、方向校準、驗證渲染、強度限制和控制分配硬體.

「執行檢查」索引標籤

「執行檢查」是大多數測試人員在出現問題時所需的路徑。點選 執行檢查 探測橋接狀態。行獨立更新，因此緩慢的 sim 探針不會阻止裝置或執行時結果的顯示。

透過表示 FFB-Bridge 已驗證設定的該部分。
資訊表示沒有任何問題，但該行有有用的上下文。例如，當您正在飛 MSFS 或使用模擬模式時，X-Plane 未在偵聽是預期內的。
警告意味著設定可以繼續，但有一些值得修復或報告的地方。
失敗表示網橋發現了一個阻塞性問題。當「執行檢查」知道有安全的修復方法時，該行會提供一個操作按鈕。
就緒和 正在檢查 是執行前和執行期間使用的中性狀態。

自動裝置啟動預檢

啟動時，FFB-Bridge 會靜默檢查 Windows、Linux 和 macOS 上的裝置後端。Linux 還會檢查對受支援事件節點的讀寫許可權，以及已安裝的 udev 規則是否涵蓋目前所有裝置許可權。出現「警告」或「失敗」時，會開啟一個列出每個問題的對話方塊，並提供「立即檢查並修復」和「暫時關閉」。

如果所有檢查均透過，不會開啟任何視窗。
啟動時不會探測模擬器或網路；模擬器未執行屬於正常情況，會在執行階段處理。
對話方塊開啟期間，自動啟用會等待。可以檢查並修復問題；如果裝置是有意斷開的，也可以關閉對話方塊。關閉後，只有其他先決條件均透過，自動啟用才能繼續。

Figure 2. 「支援 → 執行檢查」會顯示受支援 event node 的「透過」、過期 udev 規則及「修復…」的「警告」，以及物理裝置的「失敗」。

硬體

以前的支援頁面硬體控制元件現在有一個專用區域。使用「飛行檢查」進行隔離效應測試，並使用「硬體」進行持久物理裝置設定。開啟硬體指南.

如何安排支票

每個支票行都有四個部分：

狀態 — 透過（綠色）、資訊（藍色）、警告（琥珀色）、失敗（紅色）、就緒 / 正在檢查（中性），或在該行不適用於此平台時顯示 N/A。
標題 — 正在檢查什麼。
詳情 ——對所發現內容的一行摘要。懸停（或在觸控式螢幕上點按）即可檢視完整詳情。
動作按鈕 - 僅當有可操作的事情時才出現。示例： 安裝本機條目, 使用埠 5111, 修復….

支票

力回饋操縱桿裝置

確認受支援的力回饋搖桿對作業系統可見，並且橋接器可以獨佔地開啟它。如果不存在受支援的 VID/PID，或者另一個程序正在持有該控制代碼，則失敗。

Linux udev 規則

「執行檢查」會驗證 /etc/udev/rules.d/71-ffb-bridge.rules 是否包含目前所有受支援裝置的輸入行、MOZA TTY 許可權以及 Logitech G940 和 Brunner 基座使用的 hidraw 訪問許可權。「修復…」會顯示維護的標準規則，透過 pkexec 安裝，刪除以前的 99-ffb-bridge.rules，重新載入 udev，並觸發輸入、TTY 和 hidraw 裝置。已連線且明確啟用的未列出操縱桿會在安裝時追加。

當較舊的規則缺少目前裝置許可權（例如 MOZA TTY 線路，或 Logitech G940 和 Brunner 基座使用的 hidraw 訪問許可權），或其檔名導致它執行得太晚、無法用於桌面工作階段訪問（如以前的 99-ffb-bridge.rules）時，會被報告為「警告」。即使檔案已存在，也請使用「修復…」；應用會將完整生成的規則安裝為 71-ffb-bridge.rules，並刪除以前的檔案。

修復成功後，規則已生效，應用會建議重啟。「立即重啟」會用新許可權重新開啟操縱桿並結束啟動時的備用路徑；如果需要先繼續使用，選擇「稍後重啟」也是安全的。

Figure 4. Linux 修復對話方塊會在請求許可權之前顯示受支援裝置的標準輸入與 MOZA TTY 規則。已連線且明確啟用的未列出操縱桿會在安裝時追加。

NixOS 異常

「執行檢查」偵測 NixOS（透過查詢 /etc/NIXOS）並將 udev-rule 行取代為將規則新增到的指令 configuration.nix 而是。看安裝對於片段。

WindowsLinux MSFS SimConnect 配置

SimConnect 是 MSFS 的連線路徑，因此此檢查會在 Windows 和 Linux 上執行。它會查詢 MSFS 的 SimConnect.xml 在平台適當的位置，解析它，並將任何啟用的 IPv4 條目與網橋正在使用的埠進行比較。三種可能的結果：

找到相符的條目。 綠色——無事可做。
在不同埠上的條目。 琥珀色 — 提供 使用埠 :X 按鈕採用該埠。
沒有可用的條目（或檔案無法解析）。 紅色 — 提供 修復… 開啟安裝對話方塊的按鈕（見下文）。

Linux 使用非特權埠

MSFS 在埠 500 上提供其庫存 SimConnect 條目。在 Windows 上繫結良好並且網橋使用它。在 Linux 上的 Proton 下，使用者名稱空間程序無法繫結低於 1024 的埠，因此網橋會在 MSFS-in-Proton 實際可以繫結的非特權埠（預設為 5111）上安裝並使用並行條目 - 這就是 Linux 修復和 使用埠 操作點位於較高階口。

MSFS 連通性

探測配置的 TCP 埠。傳送真實的 SimConnect OPEN 資料包並檢查回應標頭，以便能夠區分 MSFS 正在監聽 來自 有其他東西在聽.

X-Plane 連線可達性

X-Plane 連線適用於 Windows、Linux 和 Apple Silicon macOS。此檢查向以下地址傳送 RREF 探測： 127.0.0.1:49000 並短暫等待 dataref 回應。對映超時和 Winsock 的 WSAECONNRESET （在傳送 ICMP 埠不可達時收到）到「未執行」。

執行時狀態

彙總目前裝置、資料來源、遙測和異常狀態。「透過」表示裝置已開啟，並且即時模擬器或「模擬測試」資料正在驅動處理流程；「資訊」表示裝置已開啟但沒有即時模擬器資料，模擬器關閉時屬於正常情況；「失敗」表示裝置未開啟。

當機報告

當機後，下次啟動可能顯示已儲存的當機報告。「複製」將文本放入剪貼簿；「報告問題」開啟帶當機上下文的應用內表單。檢查主題和可選詳情，再選「傳送報告」。開啟表單不會上傳支援包，也不會刪除當機證據。

修復對話方塊

修復… 按鈕不會直接應用更改——它們會開啟一個對話方塊，正確顯示將要更改的內容、更改位置以及（在 Linux 上）身份驗證提示將要求您批准的內容。

對話方塊總是 新增劑：現有條目永遠不會被覆蓋。如果目標檔案不可解析，該對話方塊會說明將首先進行帶時間戳的備份。取消始終是安全的選擇。

Linux pkexec 行為

寫入系統路徑的操作（udev 規則、以下任何內容） /etc) 路線經過 pkexec。您將看到您的發行版的正常 polkit 提示符 - 與彈出的相同提示符 gparted 或包管理器 GUI。結束程式碼「執行檢查」解釋：

結束	含義	「執行檢查」報告
`0`	成功	綠色支票；行重新評估。
`126`	使用者關閉了身份驗證提示	Amber 顯示「已取消」——準備好後請重試。
`127`	無 polkit 代理/身份驗證失敗	紅色「身份驗證失敗。」

提示

在最小的環境（無頭 Linux、沒有 polkit 代理的 sway）中執行橋接器是沒問題的——你只是不能使用支援頁面的特權修復。手動安裝所需的檔案或在啟動網橋之前啟動 polkit 代理。

當每張支票都呈綠色時

該應用程式應該可以正常工作。如果不行，請切換到診斷標籤頁 — 其事件記錄檔將顯示比「執行檢查」的一行狀態更多的詳細資訊。或者跳轉到故障排除瞭解常見症狀和修復方法。

存在 MSFS 2020、2024 或多個安裝時，修復前請確認每個具名配置目標。修復會更新選定的模擬器配置；之後請重啟該模擬器。「設定 → 工作階段」控制 Bridge 下次啟動時選擇哪個模擬器。