故障排查¶
MindForge 常见问题与解决方式。
资源监控显示「资源接口异常」¶
资源监控卡片的服务瓦片变红，所有指标显示 -。
- 原因：MindForge 后端无法连接到配置的 MinT 服务器，或服务器的
get_server_capabilities/resource_status接口不可达。 - 解决：打开运行设置，检查 MinT URL 与
MinT Key。清空 URL 字段恢复服务器默认，或指向正确端点（中国大陆
mintcn.macaron.xin，海外mint.macaron.im）。保存后点 刷新。
所有指标显示 -¶
- 原因：5 分钟
perf_recent窗口尚无数据（近期无训练/推理活动），或后端未返回相应字段。 - 解决：跑任意训练或推理任务后点 刷新。缺失字段按设计显示
-，不表示服务健康问题。
题库页显示「暂无可选题库」¶
- 原因：尚未上传题库。
- 解决：在数据页上传题目 ZIP 或文本题库 ZIP。上传后题库作为
可选版本出现在
data/banks/<版本>。
训练立即失败¶
- 原因：SFT 数据版本缺失或为空、基座模型在后端不可用、或超参越界。
- 解决：在训练页 训练记录 中点失败行的 日志 查看错误。在
数据页验证数据版本（运行 校验训练样本），确认基座模型由后端提供，
并把超参重置为默认（
epochs=3, bs=4, lr=2e-4, rank=16）。
Playground 显示「即将推出」¶
- 原因：dashboard 的 Playground 链接在部分会话中受限。
- 解决：直接访问
mindforge.macaron.xin——TokenFactory SSO 仍可登录。见 快速开始 的访问说明。
推理返回「model not found」¶
- 原因：
sampler_path尚未在 MinT 服务端索引，或 base URL / 后缀用错。 - 解决：运行
client.models.list()确认sampler_path已在服务端索引。确保 OpenAI 兼容base_url包含/oai/api/v1后缀（mint SDK 的MINT_BASE_URL不含）。