NeuroBook

Appearance

导入一张角色卡 ​

这一节结束后，你会知道如何把 SillyTavern 角色卡变成 NeuroBook 可管理的素材、世界书和 RP 迁移参考。

SillyTavern 卡片通常不只是“一个角色”。它可能包含 worldbook、变量初始化、动态更新规则、提示词模板、regex 脚本和作者说明。NeuroBook 的导入流程会先保留原始材料，再把稳定内容迁入 Project Workspace。

准备角色卡文件 ​

先把角色卡文件放到 Agent 能读取的位置。常见输入包括：

  • .json：已经导出的角色卡 JSON。
  • .raw.json：从 PNG 中提取出的原始 JSON。
  • .png：best-effort 读取嵌入 JSON，失败时需要先提取成 .raw.json。

如果你不确定文件能不能读，可以先对 Agent 说：

text
我想导入这张 SillyTavern 角色卡。请先检查文件是否存在、格式是否支持，并告诉我下一步应该 inspect 还是先提取 raw.json。

三阶段流程 ​

使用 novel-import-silly-tavern-card 时，默认按三阶段理解：

  1. inspect：只查看概览，不生成文件。
  2. unpack：解包成稳定归档，写入 reference/silly-tavern/{slug}/。
  3. import：从解包目录导入稳定内容到当前 Project Workspace。

你可以先让 Agent 读取 Skill：

text
请使用“novel-import-silly-tavern-card”帮我导入这张卡。先执行 inspect，给我概览和风险，再问我要不要 unpack。

inspect：先看清卡片 ​

inspect 的目标是让你和 Agent 看清这张卡里有什么：

  • 角色基本信息。
  • worldbook 条目数量和类型。
  • 是否包含动态 MVU、提示词模板或脚本。
  • 哪些内容适合导入 lorebook/。
  • 哪些内容只适合归档到 reference/。

这一阶段不写文件，适合快速判断卡片质量。

unpack：保留原始材料 ​

确认要继续后，执行 unpack。它会把卡片拆成稳定目录，例如：

text
reference/silly-tavern/{slug}/

这个目录是素材归档，不是正式世界书。它会保存 raw card、overview、worldbook entries、扩展脚本、变量和生成报告。这样后续即使导入策略变化，也能从原始归档重新迁移。

解包后你通常会看到类似结构：

text
reference/silly-tavern/{slug}/
  raw/
  overview.md
  inspect.json
  worldbook/
  extensions/
  unpack-report.md
  generated.json

import：迁入 Project Workspace ​

import 会读取解包目录，并把稳定文本导入项目。

常见结果包括：

  • 角色、地点、势力、物品、世界规则进入 lorebook/，其中世界规则会写到 lorebook/world/rule/，系统机制会写到 lorebook/system/。
  • 动态机制、低置信内容和混合职责内容保留在 reference/silly-tavern/{slug}/，其中低置信但可复用的稳定条目可能进入 lorebook/note/ 并标记为 pending。
  • 使用 --rp 时，额外生成 simulation-migration/ 作为 RP / 世界模拟迁移参考。

注意：--rp 不等于立刻启动 RP runtime。它只是把和 RP 相关的动态机制归档出来，方便下一步迁移到 simulation/。

导入后，正式项目里可能新增：

text
lorebook/character/...
lorebook/location/...
lorebook/faction/...
lorebook/item/...
lorebook/event/...
lorebook/system/...
lorebook/world/rule/...
lorebook/note/...
reference/silly-tavern/{slug}/simulation-migration/

导入后做一次整理 ​

导入完成后，让 Agent 做一次审查：

text
请检查刚导入的 lorebook 条目。目标是保留稳定设定，标出动态机制、上帝视角秘密和需要迁入 simulation 的状态内容。

你要特别留意：

  • lorebook 是全知设定，不等于角色知道这些信息。
  • 角色当前状态不要长期塞进 lorebook，后续应放进 simulation/subjects/。
  • 有独立状态的关键物品、机关或地点，应该考虑放进 simulation/entities/。
  • 混合职责条目不要强行自动拆成多个节点，先在 report 里保留原因，后续再人工判断。

如果导入结果很多，不要急着进入 RP。先让 Agent 按“可写作 / 需迁移 / 仅归档”三类整理：

text
请把这次导入结果分成三类：已经可用于写作的 lorebook、需要迁移到 simulation 的运行态、只保留在 reference 的动态机制。每类列路径和理由。

下一节会把这些内容带入世界模拟 / RP 模式。