JoyPro2 Discord GitHub
主要流程

檢查

顯示:

檢查會用遊戲在匯出後看到的方式檢視您的設定檔,並列出在遊戲中會出什麼問題:在同一架飛機中做兩件事的按鈕、最後落在兩個按鈕上的指令、遊戲沒有採用的綁定。每張卡片都用遊戲的說法表達(飛機、「裝置 · 按鈕」、遊戲中的指令名稱),並提供可以復原的修正。

flowchart LR
  A["檢查<br/>(底部列,或<br/>立即檢查)"] --> B["卡片:<br/>錯誤、警告、<br/>備註"]
  B --> C["每張卡片:一個修正、<br/>開啟關聯,<br/>或忽略"]
檢查只會查看,絕不會阻擋匯出。每個修正都是一個步驟,按 Ctrl+Z 即可復原。
給新手

#執行檢查

按底部列中的 檢查(或匯出頁面上的 立即檢查)。結果會顯示在匯出頁面的 檢查發現的問題 下:「待查看:0 個錯誤,1 個警告,0 則備註」。

有一張「未寫入 DCS World」卡片的檢查有一張「未寫入 DCS World」卡片的檢查
有一張「未寫入 DCS World」卡片的檢查 (圖片顯示的是英文版應用程式。)

紅色卡片是錯誤:請在匯出前修正,否則遊戲會做出您不想要的事。橘色卡片是警告:值得看一下,通常沒問題。備註 無害。

#閱讀卡片

  1. 標題 會說明哪裡有問題:「一個按鈕做兩件事」、「兩個按鈕上有同一指令」、「未寫入 DCS World」。
  2. 按鈕:「Throttle - HOTAS Warthog · BTN 22 ('Gear Up/Down')」,也就是裝置、按鈕,以及括號中的您的關聯。
  3. 一句話 說明遊戲中會發生什麼:「在 F-16C 中,兩個按鈕都執行 'Display Management Switch - Down'。通常只需要其中一個。」
  4. 修正:帶勾號的藍色按鈕是 JoyPro 的建議。其他是替代方案;更多 中有其餘選項。開啟「」 會顯示該關聯,並標示出卡片上的指令;返回(Alt+Left)會回到卡片。

每個修正都可以用 Ctrl+Z 復原。

進階

#區段和修正方式

錯誤排在最前面,接著是警告,然後是備註。搜尋可依關聯、飛機、按鈕和指令找到卡片;類型篩選只顯示一種類型;排序方式(依關聯、依飛機、依遊戲、依把握程度)也會把卡片分組。

區段 類型 在遊戲中的意義 修正方式
一個按鈕做兩件事 錯誤 某個輸入綁定在兩個關聯中,而這兩個關聯都開啟了同一架飛機的指令:按一下會同時執行兩者。 此按鈕上僅保留 'X'(該飛機在其他關聯中會被關閉)、忽略;更多:將 'X' 移到另一個按鈕、全部關閉
一個按鈕執行兩個指令 錯誤 一個關聯中開啟了同一架飛機(或遊戲)的兩個指令。 僅保留 'A'、忽略;更多:把一個移到另一個按鈕、全部關閉
其他錯誤 錯誤 例如某個修飾鍵按鈕同時也是一般按鈕。 依卡片上的說明
兩個按鈕上有同一指令 警告 某架飛機的一個指令在兩個關聯中都是開啟的:遊戲會把它放在兩個按鈕上。 僅保留在 X 上(JoyPro 的建議)、忽略;更多:在兩個按鈕上都關閉
複製的關聯 警告 匯入時在同一個按鈕上產生了某個關聯的副本。 合併為一個;合併所有複製的關聯
未寫入遊戲 警告 「僅新增」略過了某個綁定,因為遊戲把該按鈕用在別的地方,或遊戲沒有空位(Elite:Primary 和 Secondary 都已使用)。 用「更新」匯出以取代、移到另一個按鈕、保持原樣
備註 備註 無害,值得一看。
  • 忽略 會保持綁定不變並隱藏卡片(儲存在設定檔中,可用一次 Ctrl+Z 復原)。當該指令又出現在另一個按鈕上(按鈕上多了一個關聯,或關聯中多了一個指令)時,卡片會自動回來,標示為 新增,並顯示「已再次顯示:現在也在 ... 上」。已忽略的警告 (n) 會列出隱藏的卡片,並提供 再次顯示 和 全部再次顯示。
  • 起因:如果設定檔的歷程記錄知道是哪一次變更造成問題,卡片會註明(「起因:以 AI 管理(366 項關聯變更),21.10.2026」)。
  • 未知指令:飛機目前的清單中已經沒有的指令(舊的模組版本、未安裝的模組)會標示為「未知指令」;「更多」中提供 移除未知指令 和 尋找相似的指令。
  • 載具類別:在沒有飛機清單的遊戲中(War Thunder、MSFS、Arma),同一個軸上的飛機油門和直升機總距桿不算錯誤;只有同一載具類別的動作才會衝突。
在遊戲中: 每張卡片在遊戲中代表什麼
  • 一個按鈕做兩件事:在那架飛機中,按一下會同時觸發兩個指令(例如「Gear」和「Weapon release」)。修正後,該按鈕在那裡只做一件事;其他飛機不受影響。
  • 兩個按鈕上有同一指令:兩個按鈕在那架飛機中做同樣的事。除非您想把第二個按鈕用於別的功能,否則無害。
  • 未寫入遊戲:遊戲在那個按鈕上仍執行它自己的功能。「用「更新」匯出」會在下次匯出時取代它;「保持原樣」會保留遊戲的功能並隱藏卡片。
  • 未知指令:遊戲會忽略那一行;移除它不會改變遊戲中的任何東西。
技術細節

#內部如何運作

  • GUI:ValidateProfileCommand(底部列的 檢查、匯出頁面的 立即檢查)會執行 engine profile validate --fail-on-warnings false,接著產生重複和衝突報告,並建立卡片(MainWindowViewModel.CheckCards.cs、MainWindowViewModel.Duplicates.cs、Models/CheckIssueModels.cs、Views/Controls/CheckProblemsPanel.axaml)。卡片會分頁顯示(每個區段 5 張完整卡片、25 張精簡卡片,顯示更多),而「更多」和詳細資訊只在開啟時才建立,因此即使有 3000 個錯誤也能保持流暢(CheckResponsivenessTests:每個步驟都在 400 ms 以內)。
  • 引擎:relations conflicts(engine\EngineCheckConflicts.cs)會詳細列出 validate 的兩種錯誤:InputConflicts(鍵為 game:plane§device§input[§modifier])和 ActionConflicts(鍵為 game|plane|relation)。修正:--keep <relation>、--keep-action <id>、--off、--ignore(儲存在 Pr0file.KeptDuplicates 中;--list-kept、--forget-kept [--keys])、--remove-actions。relations duplicates 會找出在兩個按鈕上的相同指令以及副本;export-marks list 列出匯出時略過的綁定。每次修正都是設定檔的一個版本(一個復原步驟)。
  • 文字把關:如果卡片文字顯示了 ID、"node" 或其他內部用語,CheckTextGate 會讓測試失敗。

引擎指令:engine profile validate、engine relations conflicts、engine relations duplicates、engine export-marks list、engine export-marks dismiss。參考:檢查(參考)。