Public Help
特征

传说书

关于在 Public 上创建、导入、管理 Lorebook 以及将其链接到 AI 角色的综合指南。

传说书(通常称为世界信息)是传说、背景事实、派系详细信息、魔法系统和参考知识的独立集合,您可以链接到 人工智能角色。当您与角色聊天时,会动态检索链接知识书中的相关条目并将其直接注入模型的提示中。

与角色的核心个性不同,传说书是完全模块化的:您可以将同一本传说书链接到多个角色(例如,将共享的星落学院传说书链接到米拉、托宾、瓦尔教授和阿什格雷夫勋爵),或者在不改变角色声音的情况下交换传说书。

核心概念

为了充分利用传说书,了解它们如何与 Public 上的其他角色扮演工具配合是很有帮助的:

  • 角色个性 — 定义角色是谁:他们的说话风格、背景故事、怪癖和行为准则。
  • 聊天角色 — 定义您是谁:您在对话中的姓名、外表和身份。参见 聊天角色。
  • 传说书 — 定义您周围的世界:历史事件、派系、地点、咒语、技术规则和关系传说。

私人与公共传说书

能见度谁可以将其链接到角色谁可以编辑或删除它
私人只有你只有你(创造者)
PublicPublic 上的任何创作者都可以在创建或编辑角色时链接它只有你(创造者)

只有所有者才能编辑或删除传说书。如果您删除一本传说书,与之链接的任何角色都会安全地丢失链接,而不会丢失他们的对话历史或个性。


上下文注入如何工作

当您在角色聊天中发送消息时,后端会在生成 AI 回复之前运行快速上下文组装管道:

1. 扫描的文本目标

上下文引擎检查整个活动对话上下文中的匹配条目:

  • 用户最新收到的消息
  • 最近的对话聊天记录
  • 滚动对话摘要
  • 固定和自动提取的角色记忆
  • 角色的原始问候语

2. 条目匹配类型

传说书中的每个条目都有以下两种触发行为之一:

  • 关键字触发(constant: false) — 该条目定义了关键字列表(例如 ["emberwing", "house of the phoenix"])。如果任何关键字出现在扫描的对话文本中的任何位置(不区分大小写的子字符串匹配),则会触发该条目。
  • 常数(constant: true) — 该条目始终包含在每个消息交换中,完全忽略关键字。非常适合全球场景基线(例如,“年份是 1204 年,面纱把 Starfall Academy 对外界隐藏”)。

3. 优先级和预算管理

模型具有有限的提示上下文窗口。为了保持响应快速、连贯且经济高效,Public 强制执行注入预算:

  • 字符预算限制: 每条消息最多可以注入 1,800 个字符(LOREBOOK_INJECT_MAX_CHARS)的传说书内容。
  • 优先级排序: 所有匹配的条目(常量和关键字触发)均按 优先级 降序排序(100 之前、50 之前、0 之前)。
  • 预算拟合: 条目从最高优先级开始逐一添加,直到达到 1,800 字符预算。如果条目超出剩余预算,则将其忽略(如果是第一个条目,则将其装入)。

4. 注入块格式

触发的条目被格式化为一个干净的块并传递到角色的系统提示词:

Relevant world info:
- Universal setting: Magic is taught only at Starfall Academy, and the outside world believes it is a myth.
- Emberwing House values courage and loyalty. Founded by Aria Emberwing; its colors are copper and black.
- Dueling spells: Flare blinds an opponent; Binding Thread slows them; Mirror Ward reflects minor curses.

字段规范和限制

传说书元数据

字段类型必填限制和说明
name字符串必填最多 120 个字符。世界或环境的名称。
description字符串可选最多 500 个字符。设置的简短摘要。
visibility字符串可选"private"(默认)或 "public"。Public 传说书出现在搜索和发现中。
tags数组可选最多 20 个标签。标签会被修剪并转为小写。
entries数组可选每本传说书最多 100 个条目。

条目元数据

字段类型必填限制和说明
content字符串必填最多 1,000 个字符。注入模型的世界信息文本。
constant布尔值可选默认 false。如果为 true,该条目在每次消息交换中始终处于活动状态。
keys数组如果不是常量则必填最多 20 个键,每个键最多 64 个字符。触发词或短语。如果 constant: true 则忽略。
enabled布尔值可选默认 true。关闭以暂时禁用条目而不删除它。
priority数字可选默认 0。当上下文空间受限时,数值越高越先注入(例如 100、85、50)。

支持的 JSON 格式

您可以使用三种标准化格式导入、粘贴和导出传说书:

1. 原生 Public 传说书模式(推荐)

这是 Public 的原生 JSON 模式。它直接支持所有字段:

{
  "name": "Starfall Academy",
  "description": "Comprehensive lorebook covering Starfall Academy's houses, spells, lore, and magical laws.",
  "visibility": "public",
  "tags": [
    "fantasy",
    "starfall",
    "academy",
    "magic",
    "spells"
  ],
  "entries": [
    {
      "keys": [],
      "content": "Universal setting: Magic is taught only at Starfall Academy, and the outside world believes it is a myth. Magic is channeled through focus crystals.",
      "enabled": true,
      "constant": true,
      "priority": 100
    },
    {
      "keys": [
        "emberwing",
        "aria emberwing",
        "house of the phoenix"
      ],
      "content": "Emberwing House values courage and loyalty. Founded by Aria Emberwing; its colors are copper and black. Its common room is at the top of the Ember Tower.",
      "enabled": true,
      "constant": false,
      "priority": 85
    },
    {
      "keys": [
        "focus crystal",
        "crystal lore",
        "crystal vault"
      ],
      "content": "Every student bonds with one focus crystal. Crystals are grown from rare minerals and hold a single element such as flame, tide, or storm. A bond breaks only by choice.",
      "enabled": true,
      "constant": false,
      "priority": 80
    },
    {
      "keys": [
        "flare",
        "binding thread",
        "mirror ward"
      ],
      "content": "Dueling spells: Flare (blinds an opponent), Binding Thread (slows them), and Mirror Ward (creates a shield that reflects minor curses).",
      "enabled": true,
      "constant": false,
      "priority": 75
    }
  ]
}

2. SillyTavern 世界信息导出

导入器会自动检测 SillyTavern 独立导出,其中 entries 以对象字典的形式键控:

{
  "name": "Starfall World Info",
  "description": "SillyTavern export",
  "entries": {
    "0": {
      "uid": 0,
      "key": ["the veil", "magic"],
      "content": "The Veil hides Starfall Academy from the outside world.",
      "constant": true,
      "disable": false,
      "order": 100
    },
    "1": {
      "uid": 1,
      "key": ["starfall academy", "castle"],
      "content": "Starfall Academy stands on a floating island above the Silver Sea.",
      "constant": false,
      "disable": false,
      "order": 50
    }
  }
}

3. SillyTavern 人物卡(character_book)

您还可以导入捆绑了 character_book 对象的角色卡(V2 或 V3 规格卡):

{
  "spec": "chara_card_v2",
  "spec_version": "2.0",
  "data": {
    "name": "Mira Vale",
    "tags": ["fantasy", "magic"],
    "character_book": {
      "name": "Starfall Library Lore",
      "description": "Magical theory and reference entries",
      "entries": [
        {
          "keys": ["silverkey", "unlocking charm"],
          "content": "The Silverkey charm unlocks standard doors and windows.",
          "enabled": true,
          "constant": false,
          "insertion_order": 10
        }
      ]
    }
  }
}

创建和管理传说书

在网页上

导航至浏览器中的 /lorebooks 或从侧边栏菜单中选择 Lorebooks。

从头开始创建

  1. 前往 /lorebooks/create。
  2. 为您的传说书指定一个描述性的名称和可选的描述/标签。
  3. 选择 私人 或 Public 可见性。
  4. 单击 添加条目 以创建规则。指定触发关键字或勾选 始终有效(常量)。
  5. 单击 创建传说书 进行保存。

导入现有的传说书

您有两种快速方法来加载现有的世界信息:

  1. 导入文件 — 单击顶部操作栏中的 导入文件,以上传您计算机上的任何 .json 传说书或角色卡文件。
  2. 粘贴 JSON — 单击 粘贴 JSON 打开解析对话框:
    • 单击 从剪贴板粘贴 以提取从另一个应用程序复制的 JSON 文本。
    • 单击 加载示例 以检查预填充的星落学院模板。
    • 单击 解析并导入 立即填充表单。

导出和复制

  • 在任何传说书创建、编辑或详细信息屏幕上,单击 复制 JSON。
  • 整个传说书会被序列化为标准化的 Public JSON 并直接复制到剪贴板。

链接到 AI 角色

创建传说书后:

  1. 打开 /characters/add(或在您创建的任何角色上单击 编辑)。
  2. 滚动到 传说书(可选) 选择器。
  3. 选择您的传说书,或从社区创建的热门公共传说书中进行选择。
  4. 保存您的角色。与该角色的任何后续聊天都将自动从传说书中提取内容。

计划限制和解锁

计划您可以创建的传说书每本传说书的条目
免费3最多 100 个
基础10最多 100 个
创作者 / 专业版无限最多 100 个

创建传说书需要解锁角色传说书(与自定义聊天角色处于同一进度层级)。参见 订阅 和 游戏化。


创作者的最佳实践

  • **使用描述性的、具体的关键字:**使用名称和复合短语,例如 ["aria emberwing", "house of the phoenix"],而不是 ["the", "is", "he"] 这类常见的简短单词。
  • **为通用规则保留常量条目:**将 constant: true 条目限制为 1–2 条基础规则(例如当前时间线、核心世界物理规则),以免它们占满整个 1,800 个字符的预算。
  • **保持条目内容简洁:**1–3 个清晰句子的高影响力条目,可以让多个相关条目同时装入上下文窗口。
  • **善用优先级分数:**为基础设定赋予较高的优先级分数(100–80),为次要的装饰性事实赋予较低的分数(40–10),以确保最关键的上下文优先注入。

常见问题

为什么我的传说书条目没有在聊天中触发?

请检查以下内容:

  1. 该条目是否已开启启用?
  2. 最近的聊天或最新的用户提示中是否出现过任何确切的关键字?(匹配不区分大小写的子字符串)。
  3. 优先级较高的条目是否先占满了 1,800 字符的预算?请尝试提高该条目的优先级分数。

我可以将多本传说书链接到一个角色吗?

目前,每个角色一次只能链接一本传说书。如果您需要来自多本传说书的内容,请使用 粘贴 JSON 或导出工具,将它们的条目合并到一本传说书中。

如果我删除传说书会怎样?

链接该传说书的角色将简单地清除其传说书引用。他们的对话、设置和记忆都完好无损。

我可以编辑其他人创建的公共传说书吗?

不可以。只有原创作者才能编辑传说书。如果您想自定义公共传说书,请查看该传说书,单击 复制 JSON,创建新的传说书,然后将 JSON 粘贴到您自己的私有副本中。

可以在移动端管理传说书吗?

目前完整的传说书创建和编辑功能仅在 Web 应用上可用。任何在网页上链接到角色的传说书,都将在包括 Android 和 iOS 在内的所有平台的聊天中自动生效。


相关文档

本页内容