Askcraft

.detail-panel[hidden] { display: block !important; } .detail-tabs { display: none; } /* These three panels are rendered by the browser. */ [data-versions], [data-changelog-panel], [data-comments] { display: none; }

在聊天中提问。AI 通过阅读你实际安装的模组来回答。

AskCraft 是一个 客户端 Fabric 模组，添加了 /ask 命令。AI 并非依靠训练数据进行猜测，而是使用本地只读工具浏览你的 mods/、datapacks/ 和 config/ 文件夹。

这意味着它了解你的整合包：覆盖了生成表的数据包、整合包作者调校的配置值、某个模组上周添加的物品。

与 Wiki 或普通聊天机器人的区别

	Wiki / 聊天机器人	AskCraft
了解你的模组列表	否	是 — 索引已安装的模组
了解你的数据包	否	是，包括覆盖内容
了解你整合包的配置调整	否	是 — 读取 `config/`
跟上模组版本	经常过时	读取你拥有的 jar 文件

AskCraft 还遵循加载优先级：当数据包覆盖了模组的文件时，它会根据游戏实际使用的文件来回答，并能告诉你该文件是否被整合包自定义过。

需求


Minecraft	1.21.1
模组加载器	Fabric Loader 0.16+
Fabric API	必需
Cloth Config	必需 (v15+)
Mod Menu	可选（用于打开设置界面）
Java	21
端	仅客户端 — 无需在服务器安装，可在任何服务器上使用
AI 服务商	一个 API 密钥（免费额度就足够了 — 见下文）

设置

1. 安装

将 askcraft-x.y.z.jar 放入你的 mods/ 文件夹，同时安装 Fabric API 和 Cloth Config。

2. 获取免费 API 密钥

AskCraft 需要一个 AI 服务商。默认是 Google Gemini，它有免费额度：

前往 https://aistudio.google.com/app/apikey
登录并点击 Create API key
复制密钥

其他服务商也可用 — 见服务商。

3. 粘贴密钥

使用 Mod Menu： Mods → AskCraft → Settings → AI 标签页 → 粘贴到 API Key → Save。

不使用 Mod Menu： 启动游戏一次，然后编辑 config/askcraft.json：

{
  "provider": "GEMINI",
  "apiKey": "PASTE_YOUR_KEY_HERE",
  "model": "gemini-flash-lite-latest",
  "language": "EN_US"
}

将 "language": "EN_US" 设置为以英语获得回答（默认是巴西葡萄牙语）。此设置只影响 AI 的回答 — 模组的菜单始终是英文。

4. 验证是否可用

在游戏中：

/ask test     → 测试 AI 服务商连接并返回结果
/ask status   → 显示索引（模组、文档、分类）和服务商

首次启动时，AskCraft 会构建整合包的本地索引。在约 300 个模组的整合包上大约需要 2 秒，并缓存在 config/askcraft/index.json 中；只有在模组、数据包或配置更改时才会重建。

5. 提问

/ask <你的问题>

AI 执行的每次工具调用都会在聊天中回显，以便你看到它在工作。一个典型的问题在 2 轮、约 1 秒 内解决。

命令

命令	功能
`/ask <问题>`	向 AI 提问
`/ask status`	索引统计、服务商、模型、代理统计
`/ask config`	显示当前设置
`/ask test`	测试服务商连接 — 用此验证你的密钥
`/ask reindex`	手动重建索引

设置

通过 Mod Menu 打开，或编辑 config/askcraft.json。

Provider — GEMINI（默认）、GROQ、OPENROUTER、CUSTOM
API Key — 本地存储，除发送给你选择的服务商外不会离开你的机器
Model — 更换服务商时需更改
Endpoint (Custom) — OpenAI 格式的 URL，以 /chat/completions 结尾
Answer language — PT_BR 或 EN_US

高级

Token budget（默认 8000）— 发送给 AI 的最大上下文
Max agent rounds（默认 8）— AI 每个问题可执行的工具调用次数

数据源

Index lang files — 物品/方块/实体名称和描述
Index datapacks — 你整合包的自定义内容

服务商

服务商	推荐模型	备注
Gemini（默认）	`gemini-flash-lite-latest`	免费额度：每分钟 15 次请求。每轮代理消耗 1 次请求，因此连续问几个问题可能触发限制 — AskCraft 会自动等待并重试。
Groq	`llama-3.3-70b-versatile`	OpenAI 兼容格式
OpenRouter	`meta-llama/llama-3.3-70b-instruct`	以 `:free` 结尾的模型免费
Custom	—	任何 OpenAI 兼容的端点

支持工具调用的模型效果最佳。如果模型不支持工具，AskCraft 会回退到更简单的检索模式。

隐私与安全

你的 API 密钥存储在本地的 config/askcraft.json 中，仅发送给你选择的服务商。
config/askcraft.json 被设计上排除在索引之外 — AI 无法读取它，因此你的密钥永远不会出现在回答或提示中。
所有文件工具都是只读的，并被沙盒限制在 mods/、datapacks/ 和 config/ 目录内。AskCraft 从不写入你的整合包。
你的问题以及回答问题所需的游戏文件片段会发送给你的 AI 服务商。如果你不能接受，请不要安装此模组。

已知限制

这是早期版本，以下是诚实的列表：

在针对大型整合包的 20 题基准测试中，准确率约为 75%。它是一个研究助手，不是神谕；可能会遗漏或含糊其辞。
代码（Java）中定义的行为对它不可见。它读取的是数据文件，而非字节码，因此由模组代码添加的掉落物可能会被报告为“在战利品表中未找到”。
列举类问题（“列出所有 X”）比查找类问题弱。
世界数据包（saves/<世界>/datapacks/）尚未被索引。
模组自身的界面仅支持英文 — 目前没有翻译文件。回答语言设置改变的是 AI 回复的内容，而非菜单。
Groq / OpenRouter / Custom 支持已实现，但尚未使用真实密钥测试过 — 欢迎反馈。

常见问题

它能在多人服务器上工作吗？ 可以。它完全是客户端的，读取的是你自己的文件。服务器不需要安装此模组。

它免费吗？ 模组本身是免费的。AI 服务商由你选择；Gemini 的免费额度足以应对正常使用。

它能与任何整合包兼容吗？ 可以 — 这正是它的意义所在。它索引你安装的任何内容。无需特定于整合包的代码。

它会减慢游戏速度吗？ 索引在主线程之外构建（在 300 模组整合包上约需 2 秒）并被缓存。回答时会进行一次网络调用，因此每个问题预计需要一两秒。

Forge / NeoForge / 其他 Minecraft 版本呢？ 目前不支持。仅支持 Fabric 1.21.1。