MC Ecosystem Adaptation Engineer

MC全生态智能适配工程师V1.0.4——专为Minecraft模组玩家和整合包作者打造的一站式AI智能管理工具。新用户首次使用享60天全功能免费期！覆盖15大核心功能：模组检索下载、环境引导搭建、Mixin冲突扫描、崩溃日志分析+一键自动修复、多语言翻译（中英日韩俄西意希泰印地+阿拉伯语RTL共12种）、跨版本移植评估、存档同步、完整商业化运营体系（支付宝/微信/PayPal三渠道在线支付+Web管理员控制台+自动化运营报表）。支持Forge/NeoForge/Fabric/Quilt四大加载器，原生兼容MC 1.16.5至1.21.x全版本，面向全球用户设计。

One-stop Minecraft mod environment intelligent management tool with complete commercialization support.

MC 全生态智能适配工程师

一站式 Minecraft 模组环境智能管理工具，提供完整商业化运营支持。

Feature List

#	Feature	Description
F1	JAR Structure Parser	Parse mod JAR metadata (mcmod.info, fabric.mod.json, mods.toml)
F2	Mod Search & Download	Search and download mods from Modrinth with version and loader filters (supports batch search, category search, similar mod recommendations)
F3	Environment Setup Guide	Intelligently recommend MC version and loader combinations
F4	Mixin Conflict Scanner	Detect Mixin injection conflicts between multiple mods
F5	Resource Repacker	Repack and optimize mod resource files
F6	Save Sync	Backup and restore game saves via Baidu Netdisk sync (supports PC-to-mobile handoff, setup/backup/restore operations)
F7	Multi-Language Translation	Translate mods to target languages (Chinese, English, Japanese, Korean, etc.) with 12-language auto-detection (including Arabic RTL)
F8	Crash Fix	Intelligently analyze crash logs and provide fix suggestions
F8.1	Auto Fix	One-click mod upgrade to resolve crash issues
F9	Migration Feasibility Assessment	Assess feasibility of cross-version/cross-loader migration
F10	Authorization & Usage Management	Local machine ID generation, daily usage counting, free period management (60 days), membership tier management (free/normal), and license activation
F11	Payment Guide Page	Generate HTML payment guide page with QR codes for WeChat Official, Afdian, personal payment, and merchant payment when usage limits are reached
F12	Online Payment System	Complete payment system supporting Alipay (mini merchant API), WeChat Pay (mini merchant API), and PayPal (personal seller account) with 3 subscription plans (monthly/quarterly/yearly)
F13	Admin Dashboard	Web-based admin console for user management, order tracking, permission control, email configuration, and notification settings
F14	Automated Business Reports	Automated operational reports including inactive user list, subscription expiry reminders (weekly), and monthly business summary reports

功能列表

#	功能	说明
F1	JAR结构解析	解析模组 JAR 文件元数据（mcmod.info、fabric.mod.json、mods.toml）
F2	模组检索下载	从 Modrinth 搜索下载模组，支持版本和加载器筛选（支持批量搜索、分类搜索、同类推荐）
F3	环境引导搭建	智能推荐 MC 版本和加载器组合
F4	Mixin 冲突扫描	检测多个模组间的 Mixin 注入冲突
F5	资源重打包	模组资源文件重打包优化
F6	存档同步	通过百度网盘同步空间实现存档备份与恢复（支持PC与手机端接力，包含配置/备份/恢复操作）
F7	多语言翻译	模组目标语言翻译（中文、英文、日文、韩文、阿拉伯文等），支持12种语言自动检测（含阿拉伯语RTL从右向左书写）
F8	报错修复	智能分析崩溃日志，给出修复建议
F8.1	自动修复	一键升级模组修复崩溃问题
F9	移植可行性评估	评估模组跨版本/跨加载器迁移可行性
F10	授权与使用管理	本地机器码生成、每日使用计数、免费期管理（60天）、会员等级管理（免费/普通）、授权码激活
F11	付费引导页面	当使用次数达到限制时，生成HTML付费引导页面，展示微信公众号、爱发电、个人付款、商户付款等二维码
F12	在线支付系统	完整支付系统，支持支付宝（小微商户API）、微信支付（小微商户API）、PayPal（个人卖家账户），提供3档订阅套餐（月卡/季卡/年卡）
F13	管理员控制台	Web管理后台，包含用户管理、订单追踪、权限控制、邮件配置、通知设置等功能
F14	自动化运营报表	自动化运营报告系统，包括沉睡用户名单、套餐到期提醒（每周）、月度经营报表

Usage

Method 1: Direct Command Line

bash

# Parse mod JAR
python main.py --feature jar_parser --jar-path "create.jar"

# Search mods
python main.py --feature mod_searcher --query "Create" --mc-version "1.21.1" --loader "neoforge"

# Scan Mixin conflicts
python main.py --feature mixin_scanner --mods-dir "./mods"

# Analyze crash log
python main.py --feature crash_analyzer --crash-log "crash-2024-01-01.txt"

# Assess migration feasibility
python main.py --feature migration_assess --jar-path "create.jar" --from-mc-version "1.20.1" --to-mc-version "1.21.1" --from-loader "forge" --to-loader "neoforge"

Method 2: Interactive Menu

bash

python main.py
# or
python mc-skill-start.bat

Method 3: Agent AI Invocation

Agents can invoke each feature through the wrapper scripts in the scripts directory, returning JSON-format results.

使用方式

方式1：命令行直接运行

bash

# 解析模组 JAR
python main.py --feature jar_parser --jar-path "create.jar"

# 搜索模组
python main.py --feature mod_searcher --query "Create" --mc-version "1.21.1" --loader "neoforge"

# 扫描 Mixin 冲突
python main.py --feature mixin_scanner --mods-dir "./mods"

# 分析崩溃日志
python main.py --feature crash_analyzer --crash-log "crash-2024-01-01.txt"

# 评估模组移植可行性
python main.py --feature migration_assess --jar-path "create.jar" --from-mc-version "1.20.1" --to-mc-version "1.21.1" --from-loader "forge" --to-loader "neoforge"

方式2：交互式菜单

bash

python main.py
# 或
python mc-skill-start.bat

方式3：Agent AI 调用

Agent 可通过 scripts 目录下的封装脚本调用各功能，返回 JSON 格式结果。

机器码查询触发词（Machine ID Query Triggers）

⚠️ 重要：必须先判断用户意图，再决定是否调用查询接口

中文触发规则

用户意图	判断关键词	Agent 行为
查询机器码	单独的「机器码」「设备码」「硬件码」 + 「查看/查询/获取/显示/告诉我」等动词	✅ 调用查询接口
询问机器码是什么	「机器码是什么」「机器码含义」「机器码作用」	✅ 调用查询接口 + 解释含义
询问如何获取	「怎么查看机器码」「如何获取机器码」	✅ 调用查询接口
❌ 禁止触发查询	「如何修改机器码」「怎么更改机器码」「能不能改变」	❌ 不调用接口，回复：「机器码是根据硬件自动生成的，无法修改」
❌ 禁止触发查询	「删除机器码」「重置机器码」「清空机器码」	❌ 不调用接口，回复：「机器码无法删除或重置」

英文触发规则

User Intent	Keywords	Agent Action
Query machine ID	machine code / machine id (alone) show / get / find / display + machine code	✅ Call API
❌ Do NOT trigger	change machine code / modify machine id / reset machine id	❌ Reply: "Machine ID is auto-generated and cannot be changed"
❌ Do NOT trigger	delete machine code / remove machine id	❌ Reply: "Machine ID cannot be deleted"

触发判断流程图

text

用户发送消息
    ↓
是否包含「机器码/machine code」关键词？
    ↓ 是
    ↓
是否包含「修改/更改/删除/重置/改变/change/modify/delete」等动词？
    ↓ 是                    ↓ 否
    ↓                        ↓
回复：机器码无法修改            判断是否为查询意图？
无法删除                       ↓ 是
                              ↓
                         ✅ 调用查询接口

触发示例

用户输入	判断结果	行为
机器码	✅ 查询意图	调用接口
机器码？	✅ 查询意图	调用接口
我的机器码	✅ 查询意图	调用接口
查看机器码	✅ 查询意图	调用接口
如何更改机器码？	❌ 禁止触发	回复无法修改
机器码能修改吗？	❌ 禁止触发	回复无法修改
machine code	✅ 查询意图	调用接口
how to change machine code	❌ 禁止触发	回复无法修改

API 接口

text

GET http://127.0.0.1:8765/api/machine-id
Response: { "machine_id": "5184c91c54610b2852a9369f68332286" }

返回格式

• 查询成功：您的设备机器码是：5184c91c54610b2852a9369f68332286
• 查询失败：抱歉，无法获取机器码，请检查系统权限

Supported Loaders

• Forge
• NeoForge
• Fabric
• Quilt

支持的加载器

• Forge
• NeoForge
• Fabric
• Quilt

Supported MC Versions

• 1.16.5 ~ 1.21.x

支持的 MC 版本

• 1.16.5 ~ 1.21.x

Language Support

This skill supports 12 languages with automatic detection:

Code	Language	Auto-Detect
en	English	✅
zh	中文 (Chinese)	✅
ja	日本語 (Japanese)	✅
ko	한국어 (Korean)	✅
ru	Русский (Russian)	✅
es	Español (Spanish)	✅
it	Italiano (Italian)	✅
el	Ελληνικά (Greek)	✅
th	ไทย (Thai)	✅
hi	हिन्दी (Hindi)	✅
ar	العربية (Arabic, MSA)	✅ (RTL)

Auto-Detection Strategy:

• The skill automatically detects the user's language from the conversation context and responds in the preferred language.
• Users can also manually specify the language via the --lang parameter when calling commands.
• Translation (F7) supports bidirectional conversion between any two supported languages.

语言支持

本 Skill 支持 12 种语言，并具备自动检测能力：

代码	语言	自动检测
en	English (英语)	✅
zh	中文	✅
ja	日本語	✅
ko	한국어	✅
ru	Русский (俄语)	✅
es	Español (西班牙语)	✅
it	Italiano (意大利语)	✅
el	Ελληνικά (希腊语)	✅
th	ไทย (泰语)	✅
hi	हिन्दी (印地语)	✅
ar	العربية (通用阿拉伯语)	✅ (RTL从右向左)

自动检测策略：

• Skill 会根据对话上下文自动检测用户语言，并以用户偏好的语言回复。
• 用户也可在调用命令时通过 --lang 参数手动指定语言。
• 翻译功能（F7）支持任意两种语言之间的双向互译。

Runtime Environment

• Python 3.10+
• Windows / macOS / Linux
• Network connection (required for mod search feature)
• UTF-8 compatible terminal for multilingual support
• For full i18n functionality, ensure the system locale supports Unicode (UTF-8)

运行环境

• Python 3.10+
• Windows / macOS / Linux
• 网络连接（模组搜索功能需要）
• 兼容 UTF-8 的终端以支持多语言显示
• 完整国际化功能需要系统区域设置支持 Unicode（UTF-8）

Data Collection & Privacy / 数据收集与隐私声明

Local Data Storage / 本地数据存储

This skill stores the following data locally only (in data/auth_state.json):

Data	Description	Purpose
Machine ID	Hash of device MAC address, hostname, and OS info	Unique device identification
First Use Date	Date of first skill usage	Calculate 60-day free period
Free Period End Date	First use date + 60 days	Determine free/paid status
Daily Usage Count	Count of each feature used per day	Enforce daily usage limits
Total Usage Count	Lifetime count of each feature used	Usage statistics
Membership Tier	free / normal	Apply appropriate usage limits
License Key	User's license activation key	Premium feature access
License Expiry	Subscription expiration date	License validity check

No data is transmitted to external servers by default. The optional online verification server (AUTH_SERVER_URL) is currently disabled (empty string).

本地数据存储声明

本 Skill 仅在本地存储以下数据（存储于 data/auth_state.json）：

数据项	说明	用途
机器码	设备MAC地址、主机名、操作系统信息的哈希值	唯一识别设备
首次使用日期	首次使用Skill的日期	计算60天免费期
免费期结束日期	首次使用日期+60天	判断免费/付费状态
每日使用计数	每日各功能的使用次数	执行每日使用限制
总使用计数	各功能的终身使用次数	使用统计
会员等级	免费/普通	应用对应的使用限制
授权码	用户的授权激活码	高级功能访问
授权过期时间	订阅过期日期	授权有效性检查

强制联网验证与数据上报

默认启用：Skill 内置了管理员服务器地址，用户首次安装后自动生效，无需任何配置。

强制联网验证：

• 每次使用 Skill 时，自动向管理员服务器验证授权状态
• 本地缓存 1 小时有效的访问 Token，减少网络请求
• 网络不可用时自动降级（免费期内或有本地授权仍可使用）

数据上报机制：

• 使用记录先缓存到本地
• 每 3.5 天自动上报一次（每周 2 次）
• 上报数据包含：
  • 机器码（唯一标识，不包含个人隐私）
  • 使用的功能名称和次数
  • 会员等级
  • 首次使用日期
• 不会上报：具体文件内容、路径、配置数据等隐私信息

---

Authorization System (F10) / 授权管理系统

Free Period / 免费期

• Duration: 60 days from first use
• During free period: All features unlimited except migration assessment (1 per day after first use)
• After free period: Daily usage limits apply (free users: 20 auto/day, 8 semi/day)

Membership Tiers / 会员等级

Tier	Auto Features	Semi Features	Migration Assessment
Free	20/day	8/day	1/day
Normal (¥8.88/month)	100/day	50/day	5/day
Premium	Coming Soon	Coming Soon	Coming Soon

Pricing / 定价

• Monthly: ¥8.88/month
• Quarterly: ¥23.88/quarter
• Yearly: ¥88.88/year (continuous subscription)
• Per-use: ¥9.9-89.9 per feature

免费期与会员说明

• 免费期：首次使用起60天内免费
• 免费期内：除移植评估外所有功能不限次数（移植评估首次免费，之后每天1次）
• 免费期后：自动应用基础限制

会员等级与定价

60天免费期结束后：

等级	全自动功能	半自动功能	移植评估
免费	20次/日	8次/日	1次/日
普通会员 (¥8.88/月)	100次/日	50次/日	5次/日
高级会员	敬请期待	敬请期待	敬请期待

---

Payment Guide Page (F11) / 付费引导页面

When usage limits are reached, the skill generates an HTML payment page with:

• WeChat Official Account QR code
• Afdian platform QR code
• Personal payment QR code (WeChat Pay / Alipay)
• Merchant payment QR code

Note: Payment page is only displayed when ENABLE_PAYMENT = True and the user has reached their daily limit. Currently, ENABLE_PAYMENT = False in V1.0.1, so payment prompts are not shown.

付费引导说明

当使用次数达到限制时，Skill 会生成包含以下内容的HTML付费页面：

• 微信公众号二维码
• 爱发电平台二维码
• 个人付款二维码（微信/支付宝）
• 商户付款二维码

注意：付费页面仅在 ENABLE_PAYMENT = True 且用户达到每日限制时才显示。当前V1.0.1中 ENABLE_PAYMENT = False，因此不会显示付费提示。

---

Save Sync (F6) / 存档同步

This feature supports PC-to-mobile Minecraft save handoff via Baidu Netdisk sync space:

• Setup: Configure sync directory and launcher
• Backup: Package and upload game saves to sync directory
• Restore: Download and extract latest backup to saves directory

Data involved: Only Minecraft save files (world data) are read and written. No game data is transmitted to external servers except through user-configured Baidu Netdisk sync.

存档同步说明

本功能通过百度网盘同步空间实现PC与手机端MC存档接力：

• 配置：设置同步目录和启动器
• 备份：打包游戏存档上传到同步目录
• 恢复：从同步目录下载最新备份解压到存档目录

涉及的数据：仅读写Minecraft存档文件（世界数据）。除用户配置的百度网盘同步外，无游戏数据传输到外部服务器。

---

Permissions / 权限声明

Permission	Required By	Description
File Read	F1, F2, F4, F5, F8, F9	Read mod JARs, crash logs, config files
File Write	F5, F6, F8.1	Write repacked mods, backup saves, upgrade mods
Network Access	F2, F10	Download mods from Modrinth; mandatory auth verification & usage reporting
Browser Open	F11	Open payment guide HTML page in browser
Local Storage	F10	Store auth state, usage counts, pending reports (auth_state.json)
System Info	F10	Generate machine ID (MAC, hostname, OS)

权限	功能	说明
文件读取	F1, F2, F4, F5, F8, F9	读取模组JAR、崩溃日志、配置文件
文件写入	F5, F6, F8.1	写入重打包模组、备份存档、升级模组
网络访问	F2, F10（必需）	从Modrinth下载模组；强制授权验证与使用数据上报
浏览器打开	F11	在浏览器中打开付费引导HTML页面
本地存储	F10	存储授权状态、使用计数、待上报数据（auth_state.json）
系统信息	F10	生成机器码（MAC、主机名、操作系统）

---

Changelog / 更新日志

v1.0.4 (2026-08-24) — Major Release: Commercialization Support

重大版本更新：从零构建完整商业化运营体系

🆕 全新构建的系统模块

模块	说明
F12 在线支付系统	完整支付系统，支持支付宝（小微商户API）、微信支付（小微商户API）、PayPal（个人卖家账户）
F13 管理员控制台	Web管理后台，用于用户管理、订单追踪、权限控制、邮件配置、通知设置
F14 自动化运营报表	自动化运营报告系统，包括沉睡用户名单、套餐到期提醒、月度经营报表

✨ 新增功能

1. 三种支付渠道支持

   • 支付宝（小微商户API）- 3张独立收款二维码
   • 微信支付（小微商户API）- 3张独立收款二维码
   • PayPal（个人卖家账户）- 3个独立订阅链接+二维码

2. 三档订阅套餐体系

   • 月度会员 $9.99 / ¥8.88
   • 季度会员 $24.99 / ¥23.88（八三折优惠）
   • 年度会员 $69.99 / ¥68.88（五折优惠）

3. 管理员控制台功能

   • 用户管理（查看注册信息、机器码、套餐状态）
   • 订单管理（查看付费订单、支付状态）
   • 权限控制（动态生成管理员密钥）
   • 邮件配置（发件/收件邮箱、授权码）
   • 通知管理（实时通知+定时报表）

4. 定时运营报表系统

   • 💤 沉睡用户名单（每月1号+每周一自动发送）
   • ⏰ 套餐到期提醒（每周检查，可设置检查日，7天/3天到期预警）
   • 📊 月度经营报表（每月1号发送上月数据）

🔧 功能优化

1. 通知聚合优化

   • 从「每步一封邮件」改为「流程完成后汇总一封」
   • 用户点击「付款完成」后发送包含完整流程时间线的汇总邮件

2. 货币显示逻辑

   • 中文模式：微信/支付宝显示¥金额，PayPal显示$金额
   • 英文模式：所有渠道显示$金额（微信/支付宝保留¥符号）

3. 管理控制台布局优化

   • 实时通知+定时报表合并为统一卡片
   • 所有设置共用一个保存按钮
   • 到期提醒支持检查日下拉选择

📁 新增文件

类型	文件	说明
新增核心模块	server/auth_server.py	授权服务器，含完整API（约5000行）
新增核心模块	server/scheduled_notifications.py	定时通知调度器（约450行）
新增UI	server/static/admin.html	管理控制台前端（约4800行）
新增配置	server/data/authorizations.json	用户授权数据库
新增配置	server/data/orders.json	订单数据库
新增配置	server/data/schedule_config.json	定时报表配置
新增资源	assets/payment/	9张独立收款二维码

🐛 Bug 修复

• 管理控制台版本号显示异常（v6.2→v5.7）
• 前端硬编码管理员密钥问题
• 服务器启动模块导入路径错误
• remind_log.json 格式兼容问题

---

License

MIT License

许可证

MIT License