技术手册
技术手册
导入、导出与版本
核对平台 JSON、SillyTavern PNG/JSON、Mufy XML 的实际转换与版本边界。
专业编辑器提供“导入覆盖”“导出 JSON”“导出 PNG”。导入会先覆盖当前编辑器草稿，确认并保存后才更新服务器；当前未保存的字段会被替换。导出读取服务器已保存版本，若编辑器有未保存修改，先保存再导出。
选对格式
| 文件 | 当前入口与处理 | 核对重点 |
|---|---|---|
| 平台 JSON | “平台原生格式”读取 .json；平台导出为 chara_card_v2 JSON，并在扩展字段中保存部分平台运行参数。 | 适合本平台内迁移；独立界面资源包、文件 URL 和运行环境仍需检查。 |
| SillyTavern PNG / JSON | “SillyTavern 格式”读取带 chara 元数据的 .png 或角色卡 .json；转换器识别 V1、V2、V3 的部分结构。 | 会映射核心设定、开场白、记忆书与部分正则、MVU 内容；外部世界书引用、群聊专有字段和部分脚本语义不能直接等价。 |
| Mufy XML | “Mufy XML 格式”仅接受 .xml，映射名称、简介、人设、情节、招呼语、样例对话、部分美化与正则。 | 原平台的加密内容、选择器、物品栏及专有玩法可能需要人工修整；不会生成平台记忆书或全局 JS。 |
平台导出的 PNG 使用封面图片承载同一份 V2 角色卡 JSON。封面读取失败时会改用默认封面并提示；因此 PNG 的图片外观也应核对。导出格式只有 JSON 和 PNG，JSON 数据上限为 4 MB。格式能读取或导出，不代表在其他平台无损运行。
导入后逐项检查
- 在“导入覆盖”中选格式和文件，核对识别格式与预检查提示，再确认覆盖。保留原文件，便于对照。
- 检查名称、封面、角色简介、角色设定、开场白、对话范例、记忆书、正则规则和变量；SillyTavern 的 MVU 或 EJS 内容可能被转换、保留原文、改成说明文本，或在无法映射时跳过。转换提示不等于玩法已正常运行。
- 检查“独立界面”。覆盖现有角色时会保留当前绑定；跨账号或资源不匹配时，不能把文件内的资源包 ID 当作可用资产，可能需要重新上传有权使用的 HTML/ZIP。
- 保存并进行对话测试，特别检查触发词、变量更新、美化和封面。准备公开时再看测试与提交审核。
导入不会直接使新卡公开；覆盖现有角色时，公开和审核相关状态不从文件里替换。需要迁移的内容若涉及外部资源或平台专有功能，逐项人工确认。
确认框展示的是服务端预检查返回的警告；转换器对 SillyTavern 或 Mufy 字段记录的提醒不一定逐条出现在确认框中。不要只凭“导入成功”判断兼容程度，仍要按上面的清单比对文件和测试结果。
版本号、历史与回滚
“基础信息”里的“版本号”是可编辑的角色卡字段。后端另有按保存生成的版本快照、版本列表和回滚接口；回滚会用历史内容更新当前角色，并再生成一个标记为“回滚至…”的版本。当前专业编辑页没有接入已有的“版本历史”组件，因此这里不提供可操作的编辑器回滚步骤，也不承诺每次输入或自动保存都能作为独立历史版本找回。
需要保留可自行取用的阶段成果时，先保存，再导出 JSON；回滚或覆盖前先确认当前草稿已处理。下一步：测试与提交审核。