支持页面

支持页面是文档、运行状况检查、诊断、日志和支持包导出的单一主页。物理设备配置现在位于硬件下。

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 规则。已连接且明确启用的未列出操纵杆会在安装时追加。

Figure 5. 修复成功后，规则已生效，应用会建议重启。“立即重启”会用新权限重新打开操纵杆并退出启动时的备用路径；如果需要先继续使用，选择“稍后重启”也是安全的。

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 端口不可达时收到）到“未运行”。

运行时状态

汇总当前设备、数据源、遥测和异常状态。“通过”表示设备已打开，并且实时模拟器或“模拟测试”数据正在驱动处理流程；“信息”表示设备已打开但没有实时模拟器数据，模拟器关闭时属于正常情况；“失败”表示设备未打开。

崩溃报告

如果上一次会话崩溃，FFB-Bridge 会在下次启动时显示崩溃报告对话框，而不是在“运行检查”中显示一行。使用复制按钮复制保存的堆栈跟踪，并使用 打开反馈表单 按钮在浏览器中打开反馈页面，您可以在该页面粘贴日志并附上支持包。

修复对话框

修复… 按钮不会直接应用更改——它们会打开一个对话框，准确显示将要更改的内容、更改位置以及（在 Linux 上）身份验证提示将要求您批准的内容。

Figure 6. 修复 SimConnect 配置安装对话框。将显示要添加的确切 XML 片段以及结果文件的预览。

对话框总是 添加剂：现有条目永远不会被覆盖。如果目标文件不可解析，该对话框会说明将首先进行带时间戳的备份。取消始终是安全的选择。

Linux pkexec 行为

写入系统路径的操作（udev 规则、以下任何内容） /etc) 路线经过 pkexec。您将看到您的发行版的正常 polkit 提示符 - 与弹出的相同提示符 gparted 或包管理器 GUI。退出代码“运行检查”解释：

退出	含义	“运行检查”报告
`0`	成功	绿色支票；行重新评估。
`126`	用户关闭了身份验证提示	Amber 显示「已取消」——准备好后请重试。
`127`	无 polkit 代理/身份验证失败	红色“身份验证失败。”

提示

在最小的环境（无头 Linux、没有 polkit 代理的 sway）中运行桥接器是没问题的——你只是不能使用支持页面的特权修复。手动安装所需的文件或在启动网桥之前启动 polkit 代理。

当每张支票都呈绿色时

该应用程序应该可以正常工作。如果不行，请切换到诊断标签页 — 其事件日志将显示比“运行检查”的一行状态更多的详细信息。或者跳转到故障排除了解常见症状和修复方法。

存在 MSFS 2020、2024 或多个安装时，修复前请确认每个具名配置目标。修复会更新选定的模拟器配置；之后请重启该模拟器。“设置 → 会话”控制 Bridge 下次启动时选择哪个模拟器。