一个用于分析 Minecraft 模组端属的 Python 工具,支持 Fabric、Forge、Quilt 模组,结合本地 JAR 解析和 Modrinth API 双重校验,自动分类并输出带置信度的分析结果。
- 🎯 多加载器支持:解析 Fabric(fabric.mod.json)、Forge(mods.toml)、Quilt(quilt.mod.json)
- 📊 四类智能分类:纯客户端 / 服务端(+双端) / 可信度不足 / 解析失败
- 🔍 Modrinth API 双重校验:SHA1 哈希精确匹配 → 模糊搜索降级,输出客户端/服务端侧标注
- ⚖️ 决策矩阵 + 置信度:综合 JAR 解析与 API 结果,输出高/中/低三档可信度
- 🧠 启发式检测:元数据模糊时扫描 JAR 内 client/server 路径辅助判断
- 🖥️ GUI 界面:PyQt6 图形界面,支持文件夹拖入、分析目录一键直达
- 🔗 链接生成:自动生成 CurseForge、Modrinth、MC百科 链接
- 🖼️ 图标显示:提取并展示模组图标
- 📁 文件整理:按分类自动复制模组到对应目录
- 📝 日志记录:生成文本日志 + 结构化 JSON 日志(含每条模组的详细分析数据)
- ⚙️ 配置持久化:线程数、选项设置自动保存至 config.json
从 Releases 下载最新 EXE,双击即可运行,无需安装 Python 或任何依赖。
- Python 3.8+
- 依赖:
pip install -r requirements.txt - 详细见 requirements.txt
- 选择或拖入 Minecraft 模组文件夹
- (可选)调整并发线程数
- 勾选是否生成日志文件 / 分类文件夹
- 点击「开始解析」等待完成
- 结果会按分类显示在表格中,点击链接按钮跳转对应页面
- 可通过「打开分析目录」查看所有历史分析文件
- 新增 Modrinth API 双重校验(SHA1 哈希匹配 + 模糊搜索降级)
- 新增 cross_validate() 决策矩阵,输出 4 类结果 + 置信度(高/中/低)
- 新增 Quilt 模组解析支持(quilt.mod.json)
- 新增启发式检测:JAR 解析模糊时扫描 client/server 路径辅助判断
- 新增 config.json 配置持久化,自动保存线程数、日志/文件夹选项
- 作者信息栏改为醒目蓝色横幅样式,加粗大字号显示
- 表格改为左右分栏 + 3 列布局(图标/名称含内嵌按钮/解析含置信度)
- 新增「打开分析目录」按钮,一键直达 EXE 所在目录查看历史分析文件
- 修复 PyInstaller 打包后路径指向临时目录的问题,config 和日志输出到 EXE 同目录
- 修复 Windows 非主线程 asyncio 卡死问题
- 初始版本发布,支持 Fabric / Forge 模组解析
- 三分类(服务端/仅客户端/解析失败)
- 基础 GUI 界面,支持拖拽和文件夹选择
- 生成分类文件夹和文本日志
