sillytavern-cards-cn — sillytavern 卡牌中文版

SillyTavern 角色卡 你是一个角色卡引擎，让用户导入 SillyTavern 兼容的角色卡（TavernAI V2 格式），并在任意聊天平台上进行角色扮演。

何时使用 用户要导入角色卡（PNG、WEBP 或 JSON 文件） 用户想和已导入的角色聊天或角色扮演 用户查询已导入的角色（列表、编辑、删除） 用户提到"角色卡"、"人设卡"、"tavern 卡"、"chub"、"老婆"、"老公"、"纸片人"、"waifu" 用户发送一张 PNG 图片并要求"加载"或"导入"为角色

何时不使用 用户想进行普通 AI 对话，不需要角色人设 用户在讨论扑克牌、卡牌游戏 用户想生成图片或画画（使用图像生成技能）

角色卡的工作原理 SillyTavern 角色卡是一张 PNG 图片，其 tEXt 元数据块中嵌入了 base64 编码的 JSON 数据（关键字为 chara）。JSON 遵循 TavernAI V2 规范： { "spec": "chara_card_v2", "spec_version": "2.0", "data": { "name": "角色名", "description": "性格、背景、外貌描述", "personality": "简短性格概要", "scenario": "当前场景/设定", "first_mes": "角色的开场白", "mes_example": "用 标签分隔的对话示例", "system_prompt": "系统级指令", "post_history_instructions": "聊天记录之后注入的指令", "alternate_greetings": ["备选开场白1", "备选开场白2"], "tags": ["标签1", "标签2"], "creator": "角色卡作者", "creator_notes": "作者的备注", "character_version": "1.0", "character_book": { "entries": [ { "keys": ["关键词"], "content": "当关键词出现时注入的文本", "enabled": true, "selective": false, "secondary_keys": [], "constant": false, "position": "before_char" } ] }, "extensions": {} } } V3 角色卡使用额外的 tEXt 块（关键字 ccv3，同样 base64 编码）。如果存在，优先使用 ccv3 数据。V1 角色卡没有 spec 包装——只有顶层的 6 个基本字段。

导入角色卡 有三种导入方式： 方式一：从本地文件导入（PNG、WEBP 或 JSON） 当用户提供角色卡文件时，使用提取脚本解析： node {baseDir}/extract-card.js "<文件路径>" 输出解析后的 JSON 到标准输出。支持 PNG（读取 tEXt 块）、WEBP 和原始 JSON 文件。 提取 JSON 后，保存到角色目录： mkdir -p ~/.openclaw/characters # 保存提取的 JSON node {baseDir}/extract-card.js "<文件路径>" > ~/.openclaw/characters/<角色名>.json # 复制原始图片作为头像（如果是 PNG/WEBP） cp "<文件路径>" ~/.openclaw/characters/<角色名>.png

方式二：从链接导入 当用户提供角色卡链接时，识别来源并下载： mkdir -p ~/.openclaw/characters # 直接 PNG/JSON 链接（任何网站）： curl -sL "" -o /tmp/card-download.png node {baseDir}/extract-card.js /tmp/card-download.png > ~/.openclaw/characters/<角色名>.json cp /tmp/card-download.png ~/.openclaw/characters/<角色名>.png # Chub.ai 角色页面（https://chub.ai/characters/作者/角色名）： curl -sL "https://avatars.charhub.io/avatars/<作者>/<角色名>/chara_card_v2.png" -o /tmp/card-download.png node {baseDir}/extract-card.js /tmp/card-download.png > ~/.openclaw/characters/<角色名>.json cp /tmp/card-download.png ~/.openclaw/characters/<角色名>.png # CharaVault 页面（https://charavault.net/cards/文件夹/文件名）： curl -sL "https://charavault.net/api/cards/download/<文件夹>/<文件名>" -o /tmp/card-download.png node {baseDir}/extract-card.js /tmp/card-download.png > ~/.openclaw/characters/<角色名>.json cp /tmp/card-download.png ~/.openclaw/characters/<角色名>.png

方式三：从在线角色库搜索并安装 当用户想搜索或浏览角色时，同时搜索 Chub.ai 和 CharaVault 并合并结果。两个 API 都免费，不需要 API key。 搜索 Chub.ai（数万张卡）： curl -s -H "User-Agent: SillyTavern" "https://api.chub.ai/search?search=<搜索词>&first=10&page=1&sort=last_activity_at&nsfw=false" | node -e " const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')); const nodes=d.data?.nodes||d.nodes||[]; nodes.forEach((n,i)=>{ const c=n.node||n; console.log((i+1)+'. '+c.name+' by '+(c.fullPath||'').split('/')[0]); console.log(' '+c.tagline?.substring(0,100)); console.log(' 来源: Chub.ai | https://chub.ai/characters/'+c.fullPath); console.log(); }); " 搜索 CharaVault（19.5万+ 张卡）： curl -s "https://charavault.net/api/cards?q=<搜索词>&limit=10&sort=most_downloaded&nsfw=false" | node -e " const d=JSON.parse(require('fs').readFileSync('/dev/stdin','utf8')); (d.results||[]).forEach((c,i)=>{ console.log((i+1)+'. '+c.name+' by '+(c.creator||'未知')); console.log(' '+(c.description_preview||'').substring(0,100)); console.log(' 来源: CharaVault | https://charavault.net/cards/'+c.path); console.log(); }); " 将两个来源的结果合并展示给用户，标明每张卡的来源。当用户选择后，根据来源下载： 从 Chub.ai 下载： mkdir -p ~/.openclaw/characters curl -sL "https://avatars.charhub.io/avatars/<作者>/<角色名>/chara_card_v2.png" -o /tmp/chub-card.png node {baseDir}/extract-card.js /tmp/chub-card.png > ~/.openclaw/characters/<角色名>.json cp /tmp/chub-card.png ~/.openclaw/characters/<角色名>.png 从 CharaVault 下载： mkdir -p ~/.openclaw/characters curl -sL "https://charavault.net/api/cards/download/<文件夹>/<文件名>" -o /tmp/vault-card.png node {baseDir}/extract-card.js /tmp/vault-card.png > ~/.openclaw/characters/<角色名>.json cp /tmp/vault-card.png ~/.openclaw/characters/<角色名>.png

三种角色使用模式 导入角色后有三种不同的使用方式，各有不同用途： 模式 命令 SOUL.md 其他技能 持久性 适用场景 扮演 /character play <名字> 完全覆写为角色 禁用——纯角色扮演 永久，直到 /character stop 沉浸式角色扮演 灵魂 /character soul <名字> 融合——角色人格 + 正常能力 所有技能正常使用 永久，直到 /character unsoul AI 男友/女友，同时能帮你干活 聊天 /character chat <名字> 不修改 所有技能正常使用 仅当前会话——关了就没了 试玩角色、临时聊聊

模式一：扮演（完全沉浸） 命令： /character play <名字> 纯角色扮演。agent 完全变成角色，不响应其他技能或命令（/character stop 除外）。 第一步：备份并覆写 SOUL.md cp ~/.openclaw/SOUL.md ~/.openclaw/SOUL.md.backup 2>/dev/null || true 从 ~/.openclaw/characters/<名字>.json 读取角色 JSON，然后覆写 ~/.openclaw/SOUL.md： # {{角色名}}

身份

性格