ModPedia

ModPedia

ModPedia 是一款面向 Minecraft 整合包的本地优先知识助手。它会扫描已安装内容模组中的手册和指南资源，将其转换为可搜索的 Markdown，并构建本地 SQLite 知识库。

您可以将其用作离线搜索工具，也可以连接一个在回答前能搜索本地知识库的 AI 模型。

网站：ct-yx.github.io/modpedia

工作原理

玩家提问
    ↓
初始本地搜索
    ↓
检查实体、步骤、配方、前置条件和版本信息
    ↓
证据不足 → 重写查询并再次搜索
    ↓
证据充足 → 生成带有内联来源的答案
    ↓
本地保存对话和搜索轨迹

核心功能

• 基于 SQLite 和 FTS5 的本地搜索。
• 中文、英文和中性语言回退。
• 完整的 Markdown 段落，而非孤立的文本片段。
• 文档标题、ID、标题路径、页面锚点、匹配分数和来源元数据。
• 支持时，提供指向原始手册或相关页面的内联链接。
• 完全离线的仅搜索模式。
• 可通过可配置的模型 API 获得可选的 AI 答案。
• 针对配方、制作步骤、前置条件、故障排除和特定版本信息的、具有证据感知能力的后续搜索。
• 本地物品目录，包含物品 ID、本地化名称和 Tooltip 描述。
• 本地对话历史、搜索轨迹和来源引用。
• 支持总计、比率、舍入等运算的确定性计算支持。
• 原生可调整大小的用户界面，带有历史和设置面板。
• 无需 ModernUI 或其他外部 UI 框架。

可选集成

所有集成都是可选的。即使缺少其中任何一个，ModPedia 仍可使用。

FTB Quests

当安装了 FTB Quests 时，ModPedia 会导入静态任务定义并将其缓存到本地知识库中。

对于与任务相关的问题，它会按需读取玩家当前的运行时进度，并将其与静态任务定义相结合。运行时进度保存在内存中，不会写入知识数据库。

该助手可以回答以下问题：

• 当前主要任务或可能的后续任务；
• 任务要求；
• 依赖关系和前置条件；
• 任务可能被阻止的原因；
• 进度和完成历史；
• 可能的奖励。

随机奖励仅作为候选返回，不被视为保证获得的物品。

JEI

配方在运行时通过 JEI 查询，不会批量导入知识数据库。

已识别的物品 ID 默认显示为本地化名称。按住 Ctrl 键可显示原始 ID，或 Shift-点击 物品名称以尝试打开其配方或用途界面。

AI 可以按处理类型查询配方：

• 工作台 — 直接查询工作台配方；
• 熔炉 — 查询冶炼配方及处理时间；
• 其他处理 — 先列出可用的处理方法；
• 详情 — 获取选定的配方、输入、输出、元数据和可用机器。

在适当情况下，不同的机器等级会合并为一个机器条目。

Jade

当安装了 Jade 时，ModPedia 可以捕获当前准星所指的物品或方块。

按 K 键打开助手并定格目标。然后点击助手内的插入目标按钮，将该物品添加到问题中。目标不会自动插入，也不会在助手界面后继续变化。

仅搜索模式

仅搜索模式无需 API 密钥或 AI 模型即可工作：

1. 按 K 键打开助手。
2. 打开设置。
3. 将工作模式设置为仅搜索。
4. 输入关于模组、物品、机器、配方或手册步骤的问题。

结果包括完整的 Markdown、标题路径、匹配分数、物品上下文和相关来源链接。

AI 模式

AI 模式是可选的，使用本地搜索工具作为其证据来源。

该模型可以调用：

• search_knowledge；
• search_wiki；
• search_tasks；
• query_item_recipes；
• calculate。

当初始证据不完整时，模型可以重写查询并在回答前执行额外的有限次数搜索。

支持的 API 格式包括：

• Chat Completions；
• Native Messages；
• Responses；
• Gemini generateContent。

当所选服务提供 /models 端点时，设置页面也支持模型列表检索。

隐私与本地存储

知识文档、物品数据、对话、搜索轨迹和来源引用均存储在本地。

用户级 AI 配置文件存储于：

~/.modpedia/ai.json

API 密钥：

• 不会写入日志；
• 不会存储在对话记录中；
• 以基于本地系统身份生成的 AES-GCM 加密数据存储；
• 仅在需要时解密到进程内存中；
• 当系统身份更改时会被清除。

AI 配置在 Minecraft 实例之间共享，不属于整合包的一部分。

兼容性

ModPedia 支持使用以下格式提供的手册资源：

• Patchouli；
• GuideME；
• Modonomicon。

这些主要是手册框架或库模组。它们的 JAR 可能不包含实际的指南内容。搜索覆盖范围取决于提供书籍和页面的内容模组。

FTB Quests、JEI、Jade、Patchouli、GuideME 和 Modonomicon 都是可选集成。缺少这些集成不会阻止 ModPedia 启动。

环境要求

• Minecraft 1.21.1
• NeoForge 21.1.x
• Java 21

ModPedia 专为大型整合包设计，是对各模组自带原始手册的补充。