MineChat 角色卡导入失败：格式、文件、路径三个方向

症状

在 MineChat 助手创建界面点"导入角色卡"，选了文件后：

• 直接弹出错误提示，导入失败
• 导入成功但部分字段缺失（比如角色名不对、描述空白）
• 导入的是其他助手的字段内容（串卡）

排查一：格式兼容性

MineChat v0.4 对角色卡格式的支持有范围。如果你的角色卡格式不在支持列表里，导入就会失败或字段不全。

支持格式（以 v0.4 为准）：

快速解法：把角色卡换成 PNG 格式（社区最通用的格式）重新导入——成功率最高。

排查二：文件完整性

下载或传输过程中文件可能损坏：

• 对比文件大小——正常的 PNG 角色卡至少几 KB，正常 JSON 至少几百字节
• 尝试用其他工具打开——比如 SillyTavern 在线预览工具或文本编辑器
• 如果原文件没问题，重新下载或传输一遍

排查三：文件路径和权限

某些手机系统对应用读写外部存储的权限更严格：

• 如果角色卡在 SD 卡上，尝试移到手机内部存储再导入
• 如果角色卡在网盘 App 的私有目录里，先下载到手机本地再选
• 给 MineChat 开启存储权限（设置 → 应用管理 → MineChat → 权限 → 存储）

导入成功但字段串了

极少数情况下，两个助手的角色卡文件会被识别混在一起。这种情况通常是：

• 两个文件名字太相似（比如 角色A.png 和 角色A_副本.png）
• 文件管理器缓存导致选错了文件

解法：把角色卡文件重命名成唯一的名字（比如加上日期后缀），重新选择导入。

手动创建兜底

如果所有格式都导不进来，可以直接手动创建助手：

1. 把角色卡文件用文本编辑器或在线工具打开
2. 把里面的人设描述、开场白等字段复制出来
3. 在 MineChat 助手里手动粘贴填写

效果一样，只是多花几分钟。