创作者文档
角色卡导入规范
Foreverse 按 chara_card_v3 规范实现导入，向下兼容 V1 / V2。这篇列出三种容器格式各自支持什么、 字段兼容到哪一层，以及导入失败时先查什么。
规范族谱：v1、v2、chara_card_v3
角色卡格式由社区规范定义，不属于任何一个应用。实践中有三代：
- v1 — TavernAI 时代的原始卡：六个平铺字段（name、description、personality、scenario、 first_mes、mes_example），没有版本标记。
- v2 — character-card-spec-v2 引入版本化信封（
spec/spec_version/data），并加入备选开场白、 系统提示覆盖、创作者备注、标签，以及内嵌character_book（随卡世界书）。 - v3 — chara_card_v3 规范：资产（立绘、音频）、
nickname、多语言创作者备注、群聊开场白、世界书 decorators，以及.charxzip 容器。设计上向下兼容 v2。
多数卡以 SillyTavern 为参照实现创作，它的官方文档是创作行为的最佳伴读。Foreverse 三代全部支持导入，代际有分歧时按 v3 语义执行。
容器格式
| 格式 | 说明 |
|---|---|
| PNG 隐写卡 | 读取 PNG 文本块里的卡数据；ccv3 块优先于旧的 chara 块。注意：经微信等渠道转发的图片会被重新压缩、抹掉文本块，导入前确认拿到的是原图 |
| JSON 文件 | V1 / V2 / V3 的裸 JSON 都可直接导入 |
.charx（V3 zip 容器） | 解析 card.json + 内嵌资产：icon（name=main 的优先作头像）、emotion / expression → 表情立绘、background → 沉浸背景，其余归 misc；zip 魔数或 .charx 后缀均可识别 |
字段兼容
- V1 / V2 核心字段（description、personality、scenario、first_mes、mes_example）全量支持。
- V3 增量：
nickname（优先于 name 用于对话称呼）、备选开场白（alternate greetings，聊天页可切换）、内嵌世界书（character_book，含 V3 decorators，语义见世界书规范）、内嵌正则脚本。 - 卡内未识别的 V3 扩展字段导入时透传保留，不会丢失。
- 空
first_mes且存在备选开场白时，第一条备选开场白会被用作开场。
群聊 JSON
支持导入桌面酒馆导出的群聊 JSON：成员卡、发言顺序策略（自然 / 顺序 / 随机）、群设置一并进入。 成员对应的角色卡需要先在库里，缺失的成员会在导入报告里列出。
导入失败排查
- PNG 导入无反应：九成是图片被转发渠道重新压缩过，文本块已丢失。找作者要原始文件，或改用 JSON / .charx。
- JSON 报格式错误：检查文件编码是否 UTF-8、是否被下载工具截断。
- 导入成功但世界书不生效：见世界书规范的触发排查表。
- V3 卡在别的应用行为不同：V3 decorators 在只支持 V2 的应用里会被忽略，属预期差异。
更完整的排障案例在博客：角色卡导入失败的 9 个原因。