当前版本。 FFB-Bridge v1.2.1 已上线。这些文档跟随发布清单所描述的当前应用。如果某个部分看起来过时,请通过 反馈表.

支持捆绑包

支持包是一个 ZIP 文件,打包了出现问题那一刻 FFB-Bridge 的状态。这是我们对工单进行分诊时唯一会索取的工件。本页准确说明其中包含的内容,以便您了解自己发送的是什么。

如何导出一个

  1. 打开 FFB-Bridge 并导航到 支持 页面(侧边栏),然后 诊断 选项卡。
  2. 点击 支持包 (诊断卡的右上角)。
  3. 短暂延迟后,横幅会显示文件名和大小,以及反馈表单链接(如果有) 显示文件.
  4. 如果您想发送,请打开反馈表单并附上 ZIP。
FFB-Bridge 支持页面 导出支持包后的诊断选项卡,显示带有文件名、大小和反馈表单操作的结果横幅 FFB-Bridge 支持页面 导出支持包后的诊断选项卡,显示带有文件名、大小和反馈表单操作的结果横幅
图 1。 导出流程:“诊断”选项卡按钮,然后是包含文件名、大小和反馈表单操作的横幅。

捆绑包中有什么

支持包是一个普通的 ZIP。下面的文件名是完整的允许列表——该支持包将 从不 包含该集合之外的任何内容。

sysinfo.txt

系统元数据。纯文本,键:值行。领域:

  • os-name —“Windows”、“Linux”或“macOS”。
  • os-version ——内核版本、Windows 构建字符串或 macOS 版本。
  • distro — 在 Linux 上,/etc/os-release PRETTY_NAME.
  • cpu-model, cpu-cores — 来自 /proc/cpuinfoWin32_Processor.
  • ram-total-mb — 来自 /proc/meminfoWin32_ComputerSystem.
  • dotnet-version — 捆绑的 .NET 的运行时版本。
  • platform ——用于 Linux 与 Windows 分支的显式键。
  • locale — 当前用户区域设置。
  • bridge-version, build-hash — 构建时的桥接版本和 git SHA。

session.log

当前会话的完整事件日志。与“诊断”选项卡的日志条内容相同,但包含自启动以来的全部内容,而不仅仅是可见部分。UTF-8。

最后崩溃日志

如果之前的启动崩溃了,崩溃日志会出现在此处。堆栈跟踪、线程转储、崩溃前的最后几行日志。如果会话没有崩溃则不存在。

previous-session.log

当前运行之前那次运行的轮转日志(如果存在)。在崩溃并重启后的报告中,它通常是显示重启前发生了什么的文件。

doctor.json

最新的运行状况检查以机器可读的形式从支持页面扫描。每行包含检查名称、状态(通过/信息/警告/失败/就绪/检查/不适用)和原始详细信息字符串。这让我们可以看到您的健康检查状态,而无需您粘贴屏幕截图。该文件名为 doctor.json 由于历史原因——支持页面曾经被称为Doctor。

tunables.json

导出时活动调校配置文件的值。与保存的配置文件采用相同的架构。用于重现您飞行时的精确力配置。

hardware-settings.json

导出时的硬件兼容性设置:软件混合、Smooth steady forces、轴极性、pitch/roll 交换、raw-HID 偏好、未列出设备 opt-in,以及实时开关是否与已保存设置不同。

simconnect.txt

MSFS的 SimConnect.xml 如果桥接器能够读取,则包含该文件,并会遮盖非 localhost IP 地址。如果未找到,此文件会说明未找到,而不是猜测。

Platform extras

Windows bundles include hid-devices.txt 用于匹配的 Plug and Play 设备记录。Linux 支持包包括 usb.txt, evdev.txt, udev.txt, 和 dmesg.txt 用于 USB/input 栈上下文。每个支持包还包括 README.txt 其中包含内容摘要和隐私说明。

捆绑包中不包含什么

支持包构建器使用严格的文件名允许列表。即使同一目录中存在匹配的内容,它也不会包含该列表之外的任何内容。特别是:

  • 没有保存的密码或凭据。这座桥不存储任何东西。
  • 无配置文件文件 除了 活跃的那个。
  • 没有系统日志、日志或网桥自己的数据目录之外的任何内容。
  • 没有网络数据包捕获。
  • 没有云令牌(FFB-Bridge 不使用任何令牌)。

服务器端处理

当您将捆绑包附加到反馈报告时,网站的接收工作人员会对其进行解析,以将有用的可索引数据提取到我们的数据库中:

  • 将系统信息汇总到一行以便分组(“这个发行版有多少份报告?”)。
  • 日志中的警告和错误行具有稳定的错误签名,因此我们可以一目了然地看到有多少人遇到了相同的错误。
  • 健康检查结果可详细说明整个用户群中出现的故障。
  • 存储每个允许列表条目的逐字文件文本,以便我们在分类时可以重新读取上下文。

原始包本身会保留很短的时间(默认为 30 天),因此如果我们的提取逻辑有所改进,我们可以重新解析。之后,解析后的数据被保留;原始斑点被丢弃。

限制

限制
支持包总大小50 MB(压缩后)
每个条目的未压缩大小5MB
最大条目数30
未压缩总计20MB
编码仅 UTF-8 文本文件(加上 XML)

实际上,普通的捆绑包不到一兆字节。这些限制是为了排除恶意上传,而不是排除真实报告。

不通过反馈表单发送

如果您想直接通过电子邮件发送捆绑包,请写信至 feedback·ffb-bridge.com (将·替换为@)并附上 ZIP。服务器端解析器不会处理电子邮件,因此分类速度较慢——但支持包同样可用。