如何把 SillyTavern 角色卡（JSON/PNG）导入 LumiChat

LumiChat 支持 SillyTavern JSON 角色卡，以及真正带 chara/ccv3 元数据的 PNG 卡。把普通头像改成 .png 并不会变成角色卡。

登录后打开“我的角色”，选择导入角色卡，上传 8 MB 以内的 JSON 或带元数据 PNG，逐项核对映射字段，先保存私有草稿，再决定是否提交公开审核。

LumiChat 目前真实支持哪些格式

当前创建器接受 .json 和 .png 角色卡。JSON 会按角色卡数据解析；PNG 必须是真正的 PNG，并在文本块中携带 base64 编码的 ccv3 或 chara 元数据。角色卡上限为 8 MB；PNG 导入成功后还可作为草稿头像上传。

独立的世界书入口接受 4 MB 以内 JSON。导入只会创建草稿，不会自动把角色公开发布。

导入前先备份并检查来源

保留一份不修改的原始文件。只导入自己创建或明确获得使用许可的卡，并阅读作者附带的许可证或说明。社区里能下载，不等于允许你把角色再次公开发布。

JSON 应该能在文本编辑器里看到合法结构，而不是下载失败后保存的 HTML；PNG 应能正常打开，而且来自角色卡导出，不是截图，也不是把 WebP 强行改成 .png。

在 LumiChat 中逐步导入

登录 LumiChat，进入“我的角色”或 /app/create，点击角色卡导入，选择一个 JSON 或 PNG。等待草稿出现后再继续操作；导入成功时草稿已经保存，即使后续列表刷新稍慢，也不要连续点击制造重复项。

依次检查名称、简介、Persona 描述、性格、场景、对话示例、开场白、标签和头像。先保存私有草稿，重新打开，确认换行、占位符和第一条消息读起来仍然正常。

SillyTavern 字段怎样映射

角色名进入 Name；description 与 personality 进入人设层；scenario 保留场景；mes_example 进入对话示例；first_mes 进入开场白；tags 会整理为草稿标签。来源卡和服务端映射支持时，嵌入的 character book/lore 数据也可以保留。

第一条消息不是装饰。SillyTavern 官方文档明确指出它会强烈影响回复风格与长度，因此遇到冗长开场，应该先改 greeting，而不是往永久人设里继续堆文字。

为什么 PNG 会提示缺少元数据或无效

一张能显示的头像仍可能完全不含角色定义。LumiChat 会读取名为 ccv3 或 chara 的 PNG 文本块；两个都没有就会报缺少角色元数据。SillyTavern 也提醒，有些所谓 PNG 实际是 WebP 改了扩展名。

请从原工具重新导出，不要靠改文件名“修复”。如果图片可用但元数据丢失，可以改为导入 JSON 卡，再单独上传头像。

导入世界书但不要塞爆上下文

使用独立世界书 JSON 入口，不要把所有地点、物品和历史都粘进永久 Persona。World Info 是关键词触发的信息源：提到 key 时才把相关条目放进上下文，没提到的设定不会持续占用空间。

导入前删除重复项、收窄过宽关键词并压缩条目。“的”“城市”或常见代词会频繁误触发，地点专名、别名和独特物品名更可靠。

用受控测试验证角色卡

准备三条测试消息：一条检验人设、一条激活场景、一条精确命中世界书关键词。然后纠正一个事实并继续几轮，记录语气是否稳定、开场白是否控制住长度、Lore 是否只在需要时出现。

一次只改一个层。风格问题改 greeting，行为规则改 personality，起始处境改 scenario，条件知识改 world book；同时改全部字段只会让原因更难判断。

私有草稿和公开提交不是一回事

保存只是把草稿留在你的账号里；提交审核是另一个明确动作，通过审核后才可能公开。走到这一步前，移除真实姓名、复制来的作者文字和未授权图片。

导入卡可能藏有提示词注入或意外指令。逐项阅读字段，不把密钥和隐私内容放进定义，并根据隐私政策判断哪些素材适合上传到托管服务。

五分钟质量检查清单

• 备份原始文件。
• 核对当前账号与套餐页面。
• 先测试一个窄场景再扩大。
• 上传私人素材前检查隐私规则。
• 记录结果，方便识别后续变化。

官方来源与核验说明

以下优先使用官方文档、官方帮助中心和项目真实功能入口。限额、编辑器名称与导入格式可能更新，付费或迁移数据前请以当前页面为准。

• SillyTavern official documentation
• SillyTavern official character design guide
• SillyTavern official FAQ: invalid PNG cards
• SillyTavern official World Info guide

继续做一次真实测试

先用一个不含敏感信息的小角色测试，核对字段映射并完成一段受控对话，再迁移完整角色库。

打开 LumiChat 角色创建器 · 浏览 LumiChat 角色 · 阅读隐私政策

常见问题

LumiChat 同时支持 JSON 和 PNG 吗？

支持。JSON 必须是合法卡数据；PNG 必须带 ccv3 或 chara 元数据，文件上限均为 8 MB。

为什么普通 PNG 头像不能导入？

图片本身不是角色卡，PNG 内还必须嵌入角色定义元数据。

导入后会直接公开吗？

不会。导入只创建草稿，公开审核需要另行主动提交。

可以导入 SillyTavern 世界书吗？

创建器支持 4 MB 以内独立世界书 JSON，但格式可能不同，导入前要检查结构和条目。

导入后重点检查什么？

名称、人设、性格、场景、示例、开场白、标签、头像和一个 Lore 触发词。

社区下载的卡都能重新发布吗？

不能。公开提交前必须确认原作者许可和素材版权。