📦 我的世界JAVA版本MOD搜索整合Skill — 我的世界Java版MOD搜索整合Skill

Minecraft Java Mod 搜索技能

• 概述

本技能帮助用户在 Minecraft Java Edition 生态中搜索并推荐 Mod。支持多平台检索、智能排序、依赖解析、版本过滤、卡片化展示。

• 支持平台

平台 | API 类型 | 国内可访问 | API Key | 优先级 快查表 | 本地文件 | ✅ 离线 | ❌ 不需要 | 🥇 最优先 Modrinth | REST API | ✅ 可裸连 | ❌ 不需要 | 🥈 主平台 CurseForge | REST API | ⚠️ 需 Key | ✅ 需要（免费） | 🥉 备选 MC百科 | mcmod.cn 网页抓取 | ✅ 国内直连 | ❌ 不需要 | 4️⃣ 兜底

策略：

• 快查表优先（离线命中，零延迟）
• Modrinth 多关键词并行（asyncio+aiohttp，超时 8s）
• 有 CurseForge Key 则并行（超时 5s），无 Key 提示申请
• Modrinth 结果 <3 条时，抓取 MC百科补充（超时 8s）

CurseForge API Key 配置

• 访问 https://console.curseforge.com/ 申请免费 Key
• 任选一种方式写入：

- 编辑 references/curseforge_api.md 末尾添加：CF_API_KEY=你的key - 环境变量：export CF_API_KEY=你的key - 运行时参数：--api-key 你的key

• 搜索参数

维度 | 示例 | 说明 功能描述 | “帧率优化”、“自动farming” | AI 解析关键词 模糊/精确名 | “OptiFine” / “optif” | 前缀或全匹配 游戏版本 | “1.20.4”、“1.19.2” | 自动过滤不兼容 前置依赖 | “forge”、“fabric” | 仅返回对应 Loader 类别 | “科技”、“魔法”、“装饰” | 按分类筛选

优先级：组合搜索 > 精确名 > 模糊名 > 功能描述 精确名命中则先精确再推荐相似；功能描述拆词多词联合搜。 默认返回与指定版本兼容的最新 Mod；Loader 识别 Forge/Fabric/Quilt/Rift。

• 搜索流程

Step 1 解析输入 提取 query / minecraft_version / loader / category；未指定版本则询问或默认 1.20.4/1.21.x。

Step 1.2 快查表优先 检索 references/mod_quickref.md：命中即置顶 [📚 快查表] 并继续后台 API 补充。

Step 1.3 多关键词提取 中文映射英文，保留原文，去重后 3-5 词并行搜索。

Step 1.5 枪械意图 → TACZ 优先 关键词命中即切换：先搜 Modrinth category=equipment + “tacz 英文关键词”，返回基础 Mod + 枪包列表；无结果回退普通搜索。

Step 1.6 机械/自动化意图 → Create 优先 关键词命中即切换：先搜 Modrinth category=technology + “create 英文关键词”，返回 Create 本体 + 附属列表；无结果回退普通搜索。

Step 2 多平台并发搜索

• Modrinth：3-5 关键词并发，单请求 8s，总超时 12s
• CurseForge：有 Key 时并行，5s 超时

结果合并、去重、排序后卡片化输出。