使用文档/模型与 AI 能力

使用说明 · 2.2.0 正式版

如何导入和使用世界书(Pro)?

导入条目、检查兼容性,再挂载到助手

读取 Markdown
本页目录

导入与挂载#

  1. 打开 设置 → 助手与能力 → 世界书,点击加号 添加世界书,可以:选择 JSON 文件(SillyTavern 或 RikkaHub 导出)、让 AI 设计一本,或导入 示例世界书。世界书与知识库有各自的管理入口和列表;导入需要有效的 Pro 权益。
  2. 在导入预览核对可用、需要处理及原文件停用的条目,并展开兼容详情。无法识别的文件不会创建数据。
  3. 导入后可在详情中搜索、编辑条目,或导出为 SillyTavern World Info JSON。
  4. 在详情页点击 开始体验:新建或复用「书名 · 讲述者」助手,挂载这本世界书并开启剧情选项,按本书的开场设置进入新对话。开场关闭时只预填用户草稿,不自动发送。
  5. 也可以打开 助手 → 编辑助手 → 知识 → 世界书,把世界书挂载到已有助手。知识库与世界书分组展示,各组的 管理 打开对应列表,标签批量挂载仅影响本组。点击 查看条目 可进入详情,从管理页或详情返回后继续编辑助手。

角色卡开场与配置#

导入带内嵌世界书的 SillyTavern V2/V3 角色卡 JSON 时,会同时读取主开场白与备选开场。可以在导入预览中选择、编辑,也可以之后打开 世界书详情 → 开场 调整。主开场默认为固定开场;没有主开场时使用第一个非空备选。

  • 固定:新对话直接显示一条助手消息,不调用模型。
  • 生成:填写开场要求,复用助手的模型开场功能;可选择自动开始,也可进入对话后点击 让助手先开口。从文件导入时自动开始默认关闭,需要时自行开启。
  • 关闭:由你先发送消息。

普通世界书没有角色卡开场时,如果有按关键词触发的开场条目(名称含「开场」「开局」,或关键词为「开场」「开始游戏」等),导入预览会默认改为 生成,并把该条目正文作为开场要求。这类条目靠对话中的关键词触发,模型开场时通常触发不到,带入后讲述者会按条目内容开场。可以在预览中修改或关闭;已导入的世界书可在 开场 中点击「用条目生成开场」。

开场设置对挂载这本世界书的助手生效:助手自己的开场为 关闭 时,主动新建对话会使用世界书的开场,从助手列表点「新对话」也一样;改了世界书开场后,下一次新建对话即生效。讲述者会一直跟随本书;如果你在助手中单独设置或改过开场,则以助手的设置为准。已有对话不改动。挂载了多本带开场的世界书时,使用挂载列表中第一本。在 编辑助手 → 提示词 → 开场 可以看到当前会用哪本世界书的开场,也可以把它带入后修改,或在固定模式下直接选择角色卡的备选开场。

备选开场原文会保留,当前选择和编辑后的开场也会随世界书保存、备份及导出。开场配置使用 Cube 扩展保存在 World Info JSON 中;其他应用是否采用该配置取决于其支持情况。正文按原文保存,角色卡中的酒馆宏不会自动执行,可在预览时改为实际文本。

让 AI 设计世界书#

在 世界书 → 添加世界书 → 让 AI 设计一本 中描述想法(题材、基调或一个画面即可),或发送小说、设定文档。AI 会先用提问卡确认几个关键问题,再把整本世界书显示为对话里的卡片。点 预览并导入 进入导入预览,确认后才会创建;可以继续提出修改意见,AI 只提交改动的条目,卡片显示合并后的整本,不必每次重写整本。设计对话保留在本机,可从该入口回来继续。

剧情选项#

助手开启了「向用户提问」(ask_user)工具并挂载了世界书时,AI 会在剧情来到分支时弹出提问卡,给出几个行动选项,可以点选或自己输入;普通叙述不会每轮都问。不想要选项时,在助手的工具设置里关闭「向用户提问」。「开始体验」创建的讲述者助手默认开启。这类对话里的提问卡标题显示为「轮到你了」。

用入门示例试一次#

最快的方式:在 世界书 → 添加世界书 → 示例世界书 中选择「雾港银灯」或「失落矿坑」,导入后点 开始体验。

下方 JSON 是可导入的最小示例,包含“故事背景”和“灯塔”两条设定。将代码内容保存为 UTF-8 编码的 世界书入门示例.json 文件,在 设置 → 世界书 → 添加世界书 → 选择 JSON 文件 中选择该文件,核对预览后确认导入;不会自动挂载到任何助手。

  1. 将示例挂载到一个助手,开始新对话。
  2. 发送“介绍一下这座小城”:始终启用的背景条目会参与本轮请求。
  3. 再发送“带我去灯塔看看”:最近消息出现“灯塔”后,灯塔条目也会参与匹配。
  4. 打开聊天的上下文容量,查看世界书匹配、加入的条目;回复是否逐字复述设定由模型决定。

示例采用 SillyTavern JSON 格式。entries 存放条目,comment 是名称,key 是主关键词,content 是加入上下文的正文;constant 为 true 表示始终启用,disable 为 true 表示停用。

{
  "name": "世界书入门示例",
  "entries": {
    "0": {
      "uid": 0,
      "comment": "故事背景(始终启用)",
      "key": [],
      "content": "故事发生在海边小城银港。城里的人以航海和修船为生。",
      "constant": true,
      "disable": false
    },
    "1": {
      "uid": 1,
      "comment": "灯塔(关键词触发)",
      "key": ["灯塔", "守塔人"],
      "content": "银港的灯塔由林舟看守。每逢大雾,他会敲响铜钟引导船只归港。",
      "constant": false,
      "disable": false
    }
  }
}

AI 能直接读写世界书吗?#

当前由应用在发送消息时自动匹配并加入条目,AI 能看到本轮实际加入的正文;不会因此拿到整本世界书,也没有直接列出或修改已有世界书条目的工具。修改条目请在世界书详情中操作。想让 AI 起草新的世界书,使用 世界书 → 添加世界书 → 让 AI 设计一本,生成结果由你预览后导入。

应用使用助手可通过“应用使用帮助”技能读取 help.md;该资料由帮助中心实时生成,包含本篇说明。读帮助不等于能读写你的世界书;原会话已读过旧帮助时,可让它重新读取。

什么时候生效#

支持主关键词、正则及始终启用条目;默认扫描最近两条消息。匹配不等于全部加入:条目还受开关、兼容状态和上下文预算限制。聊天的上下文容量中可查看 世界书 的匹配数、加入数和实际条目。

世界书用于按条件补充设定,不走普通文档的向量检索。次要关键词、概率、延迟等暂不支持的触发条件会归入 需要处理 并停用;在条目编辑页明确处理后才能开启。分组等部分设置仅保留原始信息,实际效果可能与原应用不同。

文件与权益限制#

导入文件最大 8 MiB、最多 5000 条目;单次请求最多加入 64 条、24000 字。Pro 到期后数据和挂载保留,可查看、导出、删除或取消挂载,但导入、编辑、开关和触发暂停。权益无法确认时先检查会员状态或重试。