支援捆綁包

支援包是一個 ZIP 檔案，打包了出現問題那一刻 FFB-Bridge 的狀態。這是我們對工單進行分診時唯一會索取的工件。本頁正確說明其中包含的內容，以便您瞭解自己傳送的是什麼。

如何匯出一個

1. 開啟 FFB-Bridge 並導航到 支援 頁面（側邊欄），然後 診斷 索引標籤。
2. 點選 支援診斷包 （診斷卡的右上角）。
3. 短暫延遲後，橫幅會顯示檔名和大小，以及回饋表單鏈接（如果有） 顯示檔案.
4. 如果您想傳送，請開啟回饋表單並附上 ZIP。

從應用傳送報告

1. 選擇「報告問題」，輸入不超過 160 個字元的簡短主題。開啟表單不會上傳診斷資料。
2. 可選填問題描述；如需回覆，請提供郵箱。檢查內容後選擇「傳送報告」，將診斷資料和這些資訊提交到同一報告。
3. 等待結果。提交失敗時，已輸入內容會保留以便重試。支援回覆使用報告主題。從「診斷」匯出支援包僅建立本機檔案。

電子郵件地址是可選的，但如果不提供，支援人員將無法回覆。「在此電腦上記住郵箱」預設關閉；勾選後，它會在以後的報告中自動填入您的地址，取消勾選則會刪除已儲存的地址。記住的地址絕不會包含在診斷包中。從應用傳送的報告與附加到回饋報告的支援包按相同方式處理，詳見下文。

捆綁包中有什麼

支援包是一個普通的 ZIP。下面的檔名是完整的允許清單——該支援包將 從不 包含該集合之外的任何內容。

sysinfo.txt

系統後設資料。純文本，鍵：值行。領域：

• os-name —「Windows」、「Linux」或「macOS」。
• os-version ——核心版本、Windows 構建字串或 macOS 版本。
• distro — 在 Linux 上，/etc/os-release PRETTY_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。

last-crash.log

如果之前的啟動當機了，當機記錄檔會出現在此處。堆疊跟蹤、執行緒轉儲、當機前的最後幾行記錄檔。如果工作階段沒有當機則不存在。

previous-session.log

目前執行之前那次執行的輪轉記錄檔（如果存在）。在當機並重啟後的報告中，它通常是顯示重啟前發生了什麼的檔案。

doctor.json

最新的「執行檢查」以機器可讀的形式從支援頁面掃描。每行包含檢查名稱、狀態（透過/資訊/警告/失敗/就緒/正在檢查/不適用）和原始詳細資訊字串。這讓我們可以看到您的健康檢查狀態，而無需您貼上螢幕截圖。該檔名為 doctor.json 由於歷史原因——支援頁面曾經被稱為Doctor。

tunables.json

匯出時活動調校設定檔的值。與儲存的設定檔採用相同的架構。用於重現您飛行時的精確力配置。

hardware-settings.json

— 匯出時的物理裝置選擇與渲染器、安全上限、校準與力的極性、明確的控制分配，以及相容性設定。

aircraft-profiles.json

飛機與設定檔的繫結檔案，存在時按原樣包含。它記錄每架飛機自動應用哪個已儲存的設定檔，便於支援人員瞭解某個設定檔被選中的原因。

profiles-index.txt

匯出時已儲存設定檔的索引：檔名、大小、修改時間，以及每個設定檔的標題、ID 和修訂號。設定檔的內容本身保留在本機上。

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 其中包含內容摘要和隱私說明。

捆綁包中不包含什麼

支援包構建器使用嚴格的檔名允許清單。即使同一目錄中存在相符的內容，它也不會包含該清單之外的任何內容。特別是：

• 排除憑據儲存檔案，包括儲存的 AirframeDB 訪問憑據。
• 無設定檔檔案 除了 活躍的那個。
• 不會任意收集目錄。明確的平台檢查可能包含 USB/輸入裝置詳情和經過篩選的 Linux 核心訊息。
• 沒有網路資料包擷取。
• 允許收錄的支援包條目中不包含 AirframeDB 訪問令牌或安裝憑據。

伺服器端處理

當您將捆綁包附加到回饋報告時，網站的接收工作人員會對其進行解析，以將有用的可索引資料提取到我們的資料庫中：

• 將系統資訊彙總到一行以便分組（「這個發行版有多少份報告？」）。
• 記錄檔中的警告和錯誤行具有穩定的錯誤簽名，因此我們可以一目瞭然地看到有多少人遇到了相同的錯誤。
• 健康檢查結果可詳細說明整個使用者群中出現的故障。
• 儲存每個允許清單條目的逐字檔案文本，以便我們在分類時可以重新讀取上下文。

原始包本身會保留很短的時間（預設為 30 天），因此如果我們的提取邏輯有所改進，我們可以重新解析。之後，解析後的資料被保留；原始斑點被丟棄。

限制

實際上，普通的捆綁包不到一兆位元組。這些限制可以阻止惡意上傳，同時為真實報告留出足夠的空間。

不透過回饋表單傳送

如果您想直接透過電子郵件傳送捆綁包，請寫信至 feedback·ffb-bridge.com (replace the · with an @) and attach the ZIP. The server-side parser doesn't run for email, so the triage is slower — but the bundle is just as usable.

hardware-settings.json 在可用時還包含範圍有限的近期力輸出、自動駕駛和運動安全證據。請提供發生問題的工作階段支援包、機型與模擬器版本、裝置型號與韌體，以及觸發問題的操作。清除記錄檔或更改多個設定前先匯出。