Sillytavern Charactecard 是一个专为 SillyTavern AI 对话应用设计的角色卡处理工具，提供从导入、解析到导出和格式转换的全流程支持。该工具能够智能识别并处理 PNG 图像中嵌入的角色卡数据以及纯 JSON 格式的角色配置文件，兼容 V1、V2 和最新的 V3 规范标准。无论是用户需要快速查看角色设定信息，还是将现有角色卡转换为更高级的格式，该技能都能高效完成。通过自动检测文件类型、提取元数据、验证完整性，并生成标准化的输出文件，它极大简化了角色管理流程，特别适合在本地或工作流环境中进行批量操作。其底层实现基于严谨的 PNG chunk 结构解析与 Base64 编码机制，确保跨平台兼容性和数据安全性。
核心功能特点
- 支持 PNG 图片中提取嵌入式角色卡 JSON 数据，自动识别 chara 标签内容
- 兼容 SillyTavern 角色卡的 V1/V2/V3 三种规范版本，具备自动格式检测功能
- 提供完整的角色卡数据验证机制，检查必需字段完整性与数据类型正确性
- 实现 V1 到 V2/V3 的自动格式转换，保留原有信息并补充新字段
- 可将角色卡数据重新嵌入 PNG 图像或导出为标准 JSON 文件，支持指定规范版本
适用场景
该工具最典型的使用场景是用户在 SillyTavern 生态中进行角色资产管理时遇到的各种需求。例如，当用户上传一个带有角色设定的 PNG 头像文件，系统可自动读取其中嵌入的 chara_card_v2 或 v3 格式数据，解析出角色名称、人格描述、对话示例等关键信息，并以结构化方式展示给用户。这不仅避免了手动输入复杂设定的麻烦，也确保了数据的一致性。另一个常见场景是角色卡格式的升级——许多旧版角色卡仍采用已弃用的 V1 规范，而新版 SillyTavern 推荐使用 V3 以支持多语言备注、备选问候语等功能。此时，该工具能无缝将其转换为 V3 格式，添加缺失的时间戳、扩展字段，并保持向后兼容性。此外，在团队协作或多设备同步过程中，用户常需将角色卡导出为独立文件以便分享或备份。无论是导出为便于视觉预览的 PNG（含内嵌数据），还是导出为轻量级 JSON 供程序调用，该工具均能按用户指定版本生成对应文件路径，极大提升工作效率。