tavern-card

# 🎭 SillyTavern 角色卡处理

完整支持 SillyTavern 角色卡的导入、解析、转换和导出功能。

## 📋 功能概览

| 功能 | 说明 |
|------|------|
| 导入 PNG 角色卡 | 从 PNG 图片中提取嵌入的 JSON 数据 |
| 导入 JSON 角色卡 | 直接解析 JSON 格式的角色卡 |
| 格式检测 | 自动识别 V1/V2/V3 规范 |
| 数据验证 | 验证角色卡数据完整性 |
| 格式转换 | V1/V2/V3 之间的格式转换 |
| 导出 PNG | 将角色卡数据嵌入到 PNG 图片中 |
| 导出 JSON | 导出为标准 JSON 格式 |

## 🎯 使用场景

### 1. 导入角色卡

当用户说：
- "导入这个角色卡"
- "读取这个 PNG 文件"
- "解析这个角色"
- "加载 SillyTavern 角色"

**你应该**：
1. 使用 `read` 工具读取文件
2. 检测文件格式（PNG 或 JSON）
3. 提取角色卡数据
4. 验证数据完整性
5. 展示角色信息

### 2. 查看角色信息

当用户说：
- "这个角色是谁"
- "显示角色详情"
- "角色的设定是什么"

**你应该**：
展示角色的关键信息：
- 名称 (name)
- 描述 (description)
- 人格 (personality)
- 场景 (scenario)
- 第一条消息 (first_mes)
- 示例对话 (mes_example)
- 标签 (tags)
- 创建者 (creator)

### 3. 导出角色卡

当用户说：
- "导出为 PNG"
- "保存为 JSON"
- "生成角色卡文件"

**你应该**：
1. 确认导出格式（PNG 或 JSON）
2. 确认规范版本（V2 或 V3）
3. 生成文件
4. 返回文件路径

## 📐 SillyTavern 角色卡规范

### V1 格式（已弃用）

扁平结构，所有字段在顶层：

```json
{
  "name": "角色名",
  "description": "角色描述",
  "personality": "人格特征",
  "scenario": "场景设定",
  "first_mes": "第一条消息",
  "mes_example": "对话示例"
}
```

### V2 格式（推荐）

```json
{
  "spec": "chara_card_v2",
  "spec_version": "2.0",
  "data": {
    "name": "角色名",
    "description": "角色描述",
    "personality": "人格特征",
    "scenario": "场景设定",
    "first_mes": "第一条消息",
    "mes_example": "对话示例",
    "creator_notes": "创建者备注",
    "system_prompt": "系统提示词",
    "post_history_instructions": "历史后指令",
    "tags": ["标签1", "标签2"],
    "creator": "创建者",
    "character_version": "1.0",
    "extensions": {}
  }
}
```

### V3 格式（最新）

在 V2 基础上增加：

```json
{
  "spec": "chara_card_v3",...