酒馆角色卡
解析失败

先不要反复上传同一张图。看解析器显示的错误文字，然后按下面的顺序检查，通常两三步就能确定原因。

错误一：这不是有效的 PNG 文件

文件名写着 .png，并不能保证内部真是 PNG。有些图片只是被改了后缀，真实编码仍然是 JPG、WebP 或其他格式。

怎样检查

• 查看系统文件信息中的实际格式，而不只看文件名；
• 重新从发布页下载附件，不要把网页预览图直接改名；
• 不要把 JPG 改成 PNG 后缀——改名不会把它变成角色卡；
• 如果浏览器自动保存成 WebP，寻找页面里的原图或下载按钮。

错误二：图片中没有找到角色卡数据

这是最常见的情况。PNG 本身没有损坏，但解析器找不到名为 chara 或 ccv3 的文本块。

应该怎样解决

1. 回到最初发布页面，找“附件、原卡、下载 PNG”等入口；
2. 让发送者用文件/附件方式传输，而不是作为聊天图片发送；
3. 对比文件大小：极小的预览图往往不是原文件，但大小不能作为唯一判断；
4. 找到原图后重新解析，不要继续转换当前图片。

错误三：PNG 文件结构不完整

PNG 由一段段数据块组成，正常文件以固定签名开始，并以 IEND 块结束。下载中断、网盘同步未完成、存储损坏都可能导致文件缺少后半段。

• 重新下载一次不要覆盖旧文件，比较两次下载的大小是否一致。
• 换浏览器或网络排除缓存、代理或不稳定连接导致的不完整下载。
• 确认文件能完整显示底部缺图、花屏或打不开通常也提示结构损坏。
• 向来源索要校验值有哈希值时，可以确认传输后的文件是否与原件一致。

有些图片查看器会尽量显示损坏文件的前半部分，所以“能看到图片”依然不能证明 PNG 结构完整。

错误四：Base64 或 JSON 无法读取

这种情况说明解析器已经找到了角色数据块，但内部内容不符合常见酒馆角色卡编码方式。

如果这是你自己编辑后生成的角色卡，回到原始 JSON 检查格式，并重新用兼容工具写入。若来自他人，最稳妥的方法是重新下载或联系作者修复。

角色数据丢失后还能恢复吗

如果 PNG 里的文本块已经被平台彻底删除，仅凭剩下的角色立绘，通常无法还原原作者写过的 description、first_mes 或世界书。图片像素不包含那些原文。