SuperAPI AI 工具集

sillytavern-database-rolecards

智能体与模型

查看项目

更新于 10-16 06:23

技能介绍

用途:该技能负责 SillyTavern 角色卡的卡内 MVU/消息楼层数据模型及其消费方,面向结构化角色卡状态管理。资料来源提及小说/作品/同人库、网页与图片引用、Markdown/JSONL/SQLite 研究导出应使用 $build-work-library,本技能只聚焦卡内模型。

主要能力:将结构化角色卡状态视为带版本的应用数据,保持 schema、迁移、存储范围、写入方与 UI 绑定均可机器校验。支持定义表与迁移、连接字段到脚本/提示/状态栏/控制中心的绑定检查。首版存储路线仅支持使用 message-floor 或 MVU 数据的普通多楼层状态,同楼层兼容标记为 DBR-C8-UNVERIFIED,不提供静默改变范围的回退。C8 仅在明确实验性选择加入时返回,且在真实宿主验收前禁止成熟度声明。

使用方式:定义表或迁移前阅读 rolecard-data-model.md;连接字段前阅读 floor-and-ui-binding.md。校验模型:node scripts/validate-rolecard-schema.mjs model.json。运行迁移夹具:node scripts/run-database-migrations.mjs --migration migration.json --input before.json --expected after.json。检查消费方:node scripts/check-field-bindings.mjs --schema model.json --bindings bindings.json。涉及具体运行时调用时用 $sillytavern-api-reference 核实 getVariables、updateVariablesWith、Mvu.getMvuData、MVU 事件与消息事件;优先使用更新函数与事件驱动刷新,避免整体替换变量对象。schema 或迁移写入前用 $consult-tavernweave-library 并加载 A0、C4、C7。

限制:模型需具备稳定模型 ID 与版本、stat_data 存储根、多楼层策略、显式表、主键、类型化字段、有效默认值与唯一标识;本版本拒绝同楼层策略。迁移要求确定性输出与幂等性,保留未知记录与字段;除非声明数据丢失且调用方传 --allow-data-loss,否则拒绝破坏性操作;未加 --write 与 --out 不写入。静态检查无法证明新对话初始化、编辑、swipe、切换对话、重载或持久化行为,需真实 SillyTavern 矩阵验证。UI 实现交由 $sillytavern-embedded-ui,打包交由 $sillytavern-card-pipeline。报告需说明模型版本、存储路线、表与绑定数量、迁移结果、保留的未知数据、破坏性操作决定与待处理宿主用例。