Howie_HzGo 发表于 2026-4-21 18:04:35

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


两年前我发过一个 如何快速排查兼容性问题 - 编程分享 - 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 个插件作为测试目标。

页面提示要测试哪些目标,就把这些目标和自己的插件一起放进环境里测试。最后得到的结果,就是和自己的插件存在兼容性问题的目标。
页: [1]
查看完整版本: 兼容性问题排查器(在线版/命令行工具/Agent Skill)