传说书
关于在 Public 上创建、导入、管理 Lorebook 以及将其链接到 AI 角色的综合指南。
传说书(通常称为世界信息)是传说、背景事实、派系详细信息、魔法系统和参考知识的独立集合,您可以链接到 人工智能角色。当您与角色聊天时,会动态检索链接知识书中的相关条目并将其直接注入模型的提示中。
与角色的核心个性不同,传说书是完全模块化的:您可以将同一本传说书链接到多个角色(例如,将共享的星落学院传说书链接到米拉、托宾、瓦尔教授和阿什格雷夫勋爵),或者在不改变角色声音的情况下交换传说书。
核心概念
为了充分利用传说书,了解它们如何与 Public 上的其他角色扮演工具配合是很有帮助的:
- 角色个性 — 定义角色是谁:他们的说话风格、背景故事、怪癖和行为准则。
- 聊天角色 — 定义您是谁:您在对话中的姓名、外表和身份。参见 聊天角色。
- 传说书 — 定义您周围的世界:历史事件、派系、地点、咒语、技术规则和关系传说。
私人与公共传说书
| 能见度 | 谁可以将其链接到角色 | 谁可以编辑或删除它 |
|---|---|---|
| 私人 | 只有你 | 只有你(创造者) |
| Public | Public 上的任何创作者都可以在创建或编辑角色时链接它 | 只有你(创造者) |
只有所有者才能编辑或删除传说书。如果您删除一本传说书,与之链接的任何角色都会安全地丢失链接,而不会丢失他们的对话历史或个性。
上下文注入如何工作
当您在角色聊天中发送消息时,后端会在生成 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。
从头开始创建
- 前往
/lorebooks/create。 - 为您的传说书指定一个描述性的名称和可选的描述/标签。
- 选择 私人 或 Public 可见性。
- 单击 添加条目 以创建规则。指定触发关键字或勾选 始终有效(常量)。
- 单击 创建传说书 进行保存。
导入现有的传说书
您有两种快速方法来加载现有的世界信息:
- 导入文件 — 单击顶部操作栏中的 导入文件,以上传您计算机上的任何
.json传说书或角色卡文件。 - 粘贴 JSON — 单击 粘贴 JSON 打开解析对话框:
- 单击 从剪贴板粘贴 以提取从另一个应用程序复制的 JSON 文本。
- 单击 加载示例 以检查预填充的星落学院模板。
- 单击 解析并导入 立即填充表单。
导出和复制
- 在任何传说书创建、编辑或详细信息屏幕上,单击 复制 JSON。
- 整个传说书会被序列化为标准化的 Public JSON 并直接复制到剪贴板。
链接到 AI 角色
创建传说书后:
- 打开
/characters/add(或在您创建的任何角色上单击 编辑)。 - 滚动到 传说书(可选) 选择器。
- 选择您的传说书,或从社区创建的热门公共传说书中进行选择。
- 保存您的角色。与该角色的任何后续聊天都将自动从传说书中提取内容。
计划限制和解锁
| 计划 | 您可以创建的传说书 | 每本传说书的条目 |
|---|---|---|
| 免费 | 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,800 字符的预算?请尝试提高该条目的优先级分数。
我可以将多本传说书链接到一个角色吗?
目前,每个角色一次只能链接一本传说书。如果您需要来自多本传说书的内容,请使用 粘贴 JSON 或导出工具,将它们的条目合并到一本传说书中。
如果我删除传说书会怎样?
链接该传说书的角色将简单地清除其传说书引用。他们的对话、设置和记忆都完好无损。
我可以编辑其他人创建的公共传说书吗?
不可以。只有原创作者才能编辑传说书。如果您想自定义公共传说书,请查看该传说书,单击 复制 JSON,创建新的传说书,然后将 JSON 粘贴到您自己的私有副本中。
可以在移动端管理传说书吗?
目前完整的传说书创建和编辑功能仅在 Web 应用上可用。任何在网页上链接到角色的传说书,都将在包括 Android 和 iOS 在内的所有平台的聊天中自动生效。