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。参考:检查(参考)。