# 如何导入和使用世界书（Pro）？

> Cube Agent 2.2.0 正式版（构建 2002007）使用说明。
> 分类：模型与 AI 能力。内容基准：2026-11-07。
> 网页：https://cubeagent.app/docs/worldbook/

## 导入与挂载

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 表示停用。

```json
{
  "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 到期后数据和挂载保留，可查看、导出、删除或取消挂载，但导入、编辑、开关和触发暂停。权益无法确认时先检查会员状态或重试。