SuperAPI AI 工具集

story-roleplay

写作与研究

查看项目

更新于 10-15 22:38

技能介绍

用途:解析并应用角色卡(character card)与世界信息(world info)文件,用于沉浸式故事角色扮演,兼容 SillyTavern 格式。

主要能力:支持 PNG(tEXt 块,关键词 chara/ccv3)、WebP(EXIF/XMP 或文本块)与 JSON(Tavern Card V2/V3)三种格式;可提取 name、description、personality、scenario、first_mes、system_prompt、character_book 等字段;世界信息支持 keys、content、priority、enabled,并按关键词触发注入;角色知识库 character_book 通常优先级高于世界信息。

使用方式:优先直接读取 JSON。处理 PNG/WebP 时须使用解析工具,禁止猜测图像内容。先复制预设脚本:cp skills/story-roleplay/scripts/parse-character-card.js . && cp skills/story-roleplay/scripts/package.json .,再执行 npm install,然后运行 node parse-character-card.js <image-path> <output-json-path>;解析世界信息时追加 --world-info。必须提供输出路径,不要用 stdout 重定向。解析成功后自动保存为 character.json 或 world-info.json。

适用场景:加载角色卡、读取世界信息、构建角色知识库、按关键词触发设定注入。

限制:脚本示例基于 macOS/Linux(bash/zsh),Windows 需改写为 PowerShell 语法;WebP 建议先转 PNG 或改用 JSON;解析失败须明确报错,不得编造角色信息;预设脚本找不到时才允许按文件末尾回退代码创建,版本固定 1.0.0。