MC全生态智能适配工程师

解决什么问题

• 模组环境常卡在版本、加载器和依赖匹配：同一整合包换机就崩，日志里一堆 at 栈，难判断是模组、Mixin 还是资源问题。
• 手工排查要在 Modrinth、mcmod.info、fabric.mod.json、mods.toml 和崩溃日志之间来回切换，适合脚本化。
• 个人作者还要处理授权计数、订阅付款、后台和报表，这些与模组适配无关，却拖慢交付。

它如何工作

• 解析检索：F1 读取 JAR 元数据；F2 从 Modrinth 按版本、加载器、分类、相似模组搜索下载。
• 环境兼容：F3 推荐 MC 版本和加载器；F4 扫描 Mixin 注入冲突；F9 评估跨版本/跨加载器迁移。
• 诊断修复：F8 分析崩溃日志并给建议，F8.1 可一键升级模组；F5 重打包优化资源。
• 存档接力：F6 通过用户配置的百度网盘同步空间做配置、备份、恢复，仅读写 MC 存档。
• 本地化：F7 支持 12 种语言自动检测和双向翻译，含阿拉伯语 RTL。
• 商业化闭环：F10 用 MAC/主机名/OS 哈希生成机器码，记录首次使用、60 天免费期、每日/总次数、会员等级和授权码；F11 到限额时生成 HTML 付费引导；F12 接入支付宝/微信支付/PayPal；F13 Web 后台管用户、订单、权限、邮件和通知；F14 输出沉睡用户、到期提醒和月度报表。
• 调用形态：支持命令行、交互菜单，Agent 可通过 scripts/ 封装脚本调用并返回 JSON。

适用边界与注意点

• 要求 Python 3.10+、Windows/macOS/Linux、UTF-8 终端；Modrinth 搜索需联网，完整 i18n 依赖系统 Unicode。
• 支持 Forge、NeoForge、Fabric、Quilt，MC 1.16.5 到 1.21.x；它不替代加载器，也不实现 Mixin/Forge/Fabric 本身。
• Mixin 扫描、迁移评估和自动升级都是辅助判断，不能保证所有整合包稳定，升级前最好备份。
• 授权与上报需要网络权限，F10 会写 data/auth_state.json；资料中同时有默认不上传和强制联网验证/定期上报的描述，部署前应按当前版本实际配置审计。
• 机器码只能查询，不能修改、删除或重置；遇到这类请求应直接说明。
• 支付和后台依赖真实商户/账号凭证与合规配置；V1.0.1 中 ENABLE_PAYMENT=False，因此不会展示付费提示。