支持捆绑包
支持包是一个 ZIP 文件,打包了出现问题那一刻 FFB-Bridge 的状态。这是我们对工单进行分诊时唯一会索取的工件。本页准确说明其中包含的内容,以便您了解自己发送的是什么。
如何导出一个
- 打开 FFB-Bridge 并导航到 支持 页面(侧边栏),然后 诊断 选项卡。
- 点击 支持包 (诊断卡的右上角)。
- 短暂延迟后,横幅会显示文件名和大小,以及反馈表单链接(如果有) 显示文件.
- 如果您想发送,请打开反馈表单并附上 ZIP。


捆绑包中有什么
支持包是一个普通的 ZIP。下面的文件名是完整的允许列表——该支持包将 从不 包含该集合之外的任何内容。
sysinfo.txt
系统元数据。纯文本,键:值行。领域:
os-name—“Windows”、“Linux”或“macOS”。os-version——内核版本、Windows 构建字符串或 macOS 版本。distro— 在 Linux 上,/etc/os-releasePRETTY_NAME.cpu-model,cpu-cores— 来自/proc/cpuinfo或Win32_Processor.ram-total-mb— 来自/proc/meminfo或Win32_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。服务器端解析器不会处理电子邮件,因此分类速度较慢——但支持包同样可用。