角色卡导进去没反应?9 个原因从高频到冷门

角色卡导入失败 90% 是这 9 个原因:微信压缩抹掉 PNG 隐写、JSON 编码损坏、v1 老卡、改后缀、重名冲突等。附手机端特有的坑和一套 30 秒自检流程。

一张泛着微光的角色卡片从手机屏幕上方滑入,周围散落着 PNG 与 JSON 文件图标

「卡导进去没反应」大概是酒馆新人问得最多的一句话。我们在测试期收过上百张「坏卡」,复盘下来,失败原因高度集中—— 下面这 9 个按出现频率从高到低排,建议从第 1 条开始逐个对照。

先搞清楚:角色卡到底是什么文件

角色卡只有两种合法形态:一张 PNG 图片,或一个 JSON 文本文件。PNG 卡的玄机在于角色数据以 Base64 编码藏在图片的 tEXt 元数据块里,图是立绘,数据是灵魂;JSON 卡则是把数据明着写。规范走到今天是 chara_card_v3,向下兼容 v2(spec 在这)和更老的 v1。 理解这一点,下面 9 个原因就都好懂了。

9 个原因,按出现频率排序

#原因一句话判别
1传输环节压缩了 PNG微信/QQ 直接发图 = 数据大概率没了,看文件大小最快
2PNG 本来就只是图有些站点的「立绘下载」不含卡片数据,要找「下载角色卡」入口
3JSON 编码损坏聊天软件转发 txt/json 后出现乱码,常见于安卓另存为
4随手改了后缀把 .png 改 .json(或反过来)不会转换格式,只会两头不认
5v1 老卡字段缺失2023 年以前的老卡,部分客户端直接拒收
6重名角色冲突已有同名角色时部分客户端静默失败,先删旧卡再导
7文件名特殊字符emoji、全角括号、超长文件名都可能让导入器罢工
8浏览器/系统拦截隐私插件拦上传、安卓相册给了缩略图而不是原文件
9文件超出大小限制云端酒馆常限 5MB,4K 立绘 + 大世界书容易超

手机端特有的三个坑

排查手机导入失败时,先看这三个安卓/iOS 特有的环节。第一,相册转码:从相册选图时,部分机型会送出 重新编码后的副本(尤其开了「智能优化存储」的),数据被抹掉——改用文件管理器选原始文件。第二,下载渠道: 浏览器长按保存的图可能是站点压缩过的预览图,要点站点提供的下载按钮。第三,跨应用分享链: 卡在「微信 → 保存 → 相册 → 导入」这条链上每一步都可能被转码,链越短越安全。

世界书是另一个故事

卡导进去了,世界书没跟上,也算「半张坏卡」。v3 规范允许把角色书(character book)嵌进卡里,但很多创作者习惯把 大部头世界书单独发 JSON。两件事要分清:嵌入书随卡走,导卡即得;外置书要单独导入, 再选择绑定到角色或全局启用。我们见过 60 多个条目的世界书因为只导了卡而全程没注入,玩家还以为是模型变笨了。

给创作者的两条分发建议

如果你是发卡的人:第一,永远同时提供 PNG 和 JSON 两个版本,PNG 给收藏党,JSON 给被传输链坑过的人;第二, 发卡时注明规范版本(v2 / v3)和是否内嵌角色书,能省掉评论区一半的「为什么导不进」。

顺带一说,Foreverse 的导入器在遇到无数据 PNG、损坏 JSON 时会直接告诉你失败原因 而不是静默吞掉——被「没反应」折磨过的人都懂这有多重要。

常见问题

为什么微信传过来的角色卡导不进去?

微信和 QQ 默认压缩图片,压缩过程会重新编码 PNG,把藏在 tEXt 块里的角色数据整块抹掉。让对方以「文件」方式发送原图,或者打包成 zip 再传,就能保住卡片数据。

怎么快速判断一张 PNG 卡里有没有数据?

看文件大小。一张正常的角色卡 PNG 通常在 100KB 到 3MB 之间;如果一张「精美立绘」只有几十 KB,多半已经被某个传输环节重新压缩过,卡片数据凶多吉少。最稳的办法是导入一次试试,或用文本编辑器打开搜索 chara 关键字。

v1 老卡还能用吗?

大部分现代客户端(包括 SillyTavern 和 Foreverse)仍然向下兼容 v1 卡的基础字段,但 v1 没有备选问候语、角色书等结构,体验会缺一块。建议用编辑器把老卡升级到 v3 再用。

角色卡带的世界书为什么没生效?

看两个地方:一是导入时世界书是否被一并导入(部分客户端需要手动确认),二是世界书是绑定到角色还是全局启用。绑定角色的世界书只在和该角色聊天时注入,全局的才会处处生效。

角色卡导入失败的 9 个原因:PNG、JSON、世界书一次排查清楚 · Foreverse · 新梦