| name | novel-import-silly-tavern-card |
| description | Import local SillyTavern character cards, worldbooks, presets, MVU and prompt-template material into a NeuroBook Project Workspace. Use when the user asks to inspect, unpack, convert or import 酒馆角色卡 / SillyTavern cards for novel writing, lorebook migration, RP or world simulation. |
novel-import-silly-tavern-card
把本地 SillyTavern 角色卡素材导入当前小说 Project Workspace。这个 skill 的核心职责是第一遍 lorebook 导入:尽可能把稳定 worldbook 条目按 NeuroBook 目录协议分类到 lorebook/,把动态运行、卡片主体文本、低置信、混合职责或污染风险内容写入报告和 reference/silly-tavern/**,交给后续 Agent / 作者继续处理。
注意:SillyTavern 角色卡的格式可能是 json 或者 图片
Boundaries
- 这是导入 workflow,不是 SillyTavern runtime 兼容层。
- 不执行 JavaScript、regex、EJS、MVU、ST-Prompt-Template、Tavern Helper 或外部请求。
- 不自动创建
simulation/subjects/、simulation/entities/ 或 simulation/runs/。
- 不生成 subject-facing
memory.jsonl;角色可知信息必须后续按信息控制边界重写。
- 混合职责条目不自动拆分,进入 classification review queue。
- 低置信但可复用的稳定设定可进入
lorebook/note/,frontmatter status: pending。
- 动态 worldbook 条目不进入稳定
lorebook/,统一归档到 reference/silly-tavern/{slug}/dynamic-worldbook/。
first_mes、alternate_greetings、mes_example、scenario、description 是卡片主体素材,归档到 reference/silly-tavern/{slug}/card-body/,不当作既定 canon。
- 结构分隔标记只进入原始 reference 和 report,不生成 lorebook / dynamic-worldbook 内容节点。
CLI
脚本位置:
bun assets/workspace/.nbook/agent/skills/novel-import-silly-tavern-card/scripts/silly-tavern-card.ts --help
常用命令:
bun assets/workspace/.nbook/agent/skills/novel-import-silly-tavern-card/scripts/silly-tavern-card.ts inspect ".agent/workspace/cards/命定之诗/v4.2.1.raw.json"
bun assets/workspace/.nbook/agent/skills/novel-import-silly-tavern-card/scripts/silly-tavern-card.ts unpack ".agent/workspace/cards/公立育露学园/2.28_v1--reload.raw.json" --project "current-novel" --force
bun assets/workspace/.nbook/agent/skills/novel-import-silly-tavern-card/scripts/silly-tavern-card.ts import "reference/silly-tavern/2.28-尝鲜版v1-全裸登校-育露学园的第一天-reload" --project "current-novel" --rp --force
Workflow
- 确认当前小说 Project Workspace。
--project 必须指向包含 project.yaml 的 Project Workspace 根目录。
- 先运行
inspect。只读取本地卡片并输出 overview,不写文件。检查它是角色卡、preset 还是未知 JSON,并观察动态 marker 和分类风险。
- 运行
unpack。生成 reference/silly-tavern/{slug}/,保存 raw card、inspect.json、overview、card-body、worldbook entries、regex scripts、Tavern Helper 脚本和变量,以及 unpack report。
- 运行
import。从解包目录重新分类 worldbook,避免旧 inspect 结果过期;稳定条目写入 lorebook/,动态条目写入 dynamic-worldbook/,低置信和混合职责条目写入 report / pending note。
- 如用户需要 RP 或世界模拟,加
--rp 生成 reference/silly-tavern/{slug}/simulation-migration/。它只包含 simulator、writer、subject、entity 和 unsupported runtime 的迁移候选,不初始化运行态。
- 导入后阅读
import-report.md。先 review classification queue,再根据需要执行 workspace node validate。普通写作模式需要追踪时间线时,进入 novel-workflow-world-engine-init 和 novel-workflow-08-plot-planning;只有用户明确要 RP / legacy simulation 时,才使用 novel-workflow-05-emulation-bootstrap 或 novel-workflow-06-emulation-tick。
Classification Targets
character -> lorebook/character/
location -> lorebook/location/
faction -> lorebook/faction/
species -> lorebook/species/
item -> lorebook/item/
event -> lorebook/event/
- 世界规则 ->
lorebook/world/rule/
- 可运行机制 / 玩法系统 ->
lorebook/system/
- 低置信稳定设定、混合职责条目、格式风险条目 ->
lorebook/note/ + status: pending
- 动态 MVU / prompt template worldbook ->
reference/silly-tavern/{slug}/dynamic-worldbook/
- scripts / regex / Tavern Helper / UI 状态栏 ->
reference/silly-tavern/{slug}/ 与 simulation-migration/
新导入不再生成旧 lorebook/rule。旧项目已有目录不要在本 skill 中迁移或删除。
Report Contract
import-report.md 同时面向人类和 Agent,应优先阅读这些区块:
Import Mapping: 实际写入的 lorebook roots。
Classification Stats: 原始分类统计。
Affected Lorebook Roots: 后续 validate / review 的范围。
Dynamic Worldbook Archive: 已归档的动态 worldbook 条目。
Structural Markers: 只保留在 report / 原始归档中的结构分隔标记。
Card Body Materials: first_mes、alternate_greetings 等开场素材数量与位置。
Dynamic Migration Summary: 动态机制规模。
Classification Review Queue: 不应自动拆分或需要人工判断的条目。
Pending Lorebook Notes: 已落到 lorebook/note 但不可直接当 canon 的条目。
Recommended Next Steps: 下一步 validate、review、World Engine 初始化 / 剧情推进,或明确 RP 时的 legacy simulation。
Follow-up Skills
- 普通写作模式需要初始化动态状态时,使用
novel-workflow-world-engine-init。
- 普通写作模式需要推进剧情状态时,使用
novel-workflow-08-plot-planning。
- 用户明确要求 RP / legacy simulation 时,才使用
novel-workflow-05-emulation-bootstrap 或 novel-workflow-06-emulation-tick。
- 需要正式章节正文时,使用
novel-workflow-09-chapter-writing 或普通 writer。