支持的导入格式

CharaStudio 支持导入以下 TavernAI 兼容格式：

• PNG 文件（嵌入 JSON 元数据）：从 TavernAI 导出的角色卡
• JSON 文件：直接导出的角色数据
• TXT 文件：仅包含 description 的纯文本格式
• YAML 文件：部分工具使用的 YAML 格式

导入步骤

方法一：拖放

1. 打开 CharaStudio，进入**"角色"**工作区
2. 将 PNG/JSON 文件拖入空白区域
3. CharaStudio 将自动解析文件内容
4. 确认预览后，点击**"导入"**

方法二：文件选择器

1. 点击右上角的**"导入"**按钮
2. 在弹出的文件选择对话框中，选择要导入的文件
3. 支持多选，可一次性导入多个角色

方法三：从 URL 导入

1. 从**"导入"菜单中选择"从 URL 导入"**
2. 粘贴 TavernAI 社区角色卡 URL
3. CharaStudio 将自动下载并解析

导入后确认

导入完成后，请确认以下几点：

1. 头像图片：确认角色图片显示正确
2. 描述文本：检查 description 是否有乱码或截断
3. 性格标签：确认 personality 字段被正确解析
4. 开场白：检查 first_mes 是否符合预期

导出到 TavernAI

CharaStudio 支持以 TavernAI 兼容格式导出角色：

1. 打开要导出的角色
2. 点击**"导出"** > "TavernAI 格式"
3. 选择导出选项：
   • PNG (TXT)：将元数据写入图片的文本层
   • JSON：标准 JSON 格式
4. 下载文件并复制到 TavernAI 的 characters 文件夹

常见问题

导入后图片显示异常

部分 TavernAI 角色卡使用外部 CDN 托管图片。导入后，CharaStudio 会自动下载并本地缓存图片。如果网络较慢，图片可能需要几分钟才能正常显示。

描述文本乱码

这通常是因为原始角色卡使用了非 UTF-8 编码。CharaStudio 会尝试自动检测编码。如果仍然乱码，请手动将 description 复制到外部编辑器，转换编码后重新导入。