兼容性问题排查器（在线版/命令行工具/Agent Skill）

Howie***

两年前我发过一个 如何快速排查兼容性问题 - 编程分享 - Minecraft(我的世界)苦力怕论坛 。当时是使用 Python 实现的，不便于在线使用/手机使用。
也没有撤回上一步的功能、自定义目标名称、缺少一些边界处理。

现在我将其重构并且搬上网页端了，可以直接在线>开始排查兼容性问题<。

当然，重构后的也开源到 GitHub 了 HowieHz/howiehz-misc，如果您觉得好用，可以点个 Star 支持下。

除了在线使用，也可也通过 CLI 工具使用（需要 Node.js 环境）：npx compat-finder

另外您也可以通过 Agent Skill 的方式使用：npx skills add HowieHz/howiehz-misc --skill compat-finder

使用例：

• 我需要排查插件 1、插件 2、插件 3、插件 4 的兼容性问题。你告诉我下一步测什么，我把结果给你，你继续帮我缩小范围。
• 用 compat-finder 扫一遍我游戏 mods 文件夹，直接找出哪些插件会导致游戏启动不了。
• 帮我把 compat-finder 接进我的软件，做一个让用户自己排查插件冲突的功能。
  

为什么开发这个？简单的二分不能解决吗？

之前插件开发遇到了简单二分不好解决的情况，捣鼓出来的。

例：我开发的插件是 A，遇到以下问题。
- A，B 一起加载不会触发问题
- A，C 一起加载也不会触发问题
- 但是 A，B，C 一起加载就会触发问题

当时除了 A，B，C 还有一大把其他的插件，故开发此小工具减轻压力。

典型使用场景

排查一组插件内部的问题

比如手上有一个包含 20 个插件的整合包，启动时会出问题，但还不确定是哪几个插件互相冲突。可以把测试目标总数设为 20，按页面给出的分组去启用或禁用插件，再根据实际结果回答“有”或“没有”兼容性问题。

几轮之后，排查器会把范围缩小到具体目标。这样不用从第一个插件开始逐个试，也不用完全靠猜。

排查自己的插件和谁冲突

如果自己写了一个插件，想确认它和另外 10 个插件里哪些存在冲突，可以把自己的插件固定保留，只把另外 10 个插件作为测试目标。

页面提示要测试哪些目标，就把这些目标和自己的插件一起放进环境里测试。最后得到的结果，就是和自己的插件存在兼容性问题的目标。