聊天指南

世界书

恰在相关时刻出现在提示词中的世界知识。

书

世界书是条目加扫描设置的集合。可为一次对话挂载任意数量的书；所有挂载的书作为一个池一起扫描。

设置	范围	效果
`scanDepth`	0-100	扫描关键词时回看多少条近期消息。你的消息和角色的消息都计入。
`tokenBudget`	100-32000	已激活条目的总 token 上限。书之间不一致时，最高预算胜出。
`recursiveScanning`	开 / 关	对已激活条目的内容再次扫描，让知识可激活更多知识（最多 3 遍）。

条目有键（以逗号分隔的触发词）、可选的次级键和内容。当任一键出现在被扫描的历史中，条目激活并注入其内容。

选择性模式要求主键与次级键都命中。常驻条目跳过匹配并始终注入。已禁用条目留在书中但从不触发。全词匹配可避免「火」在「篝火」中被命中。

每个条目都有一个显示名（备注），仅用于整理编辑器列表；它绝不会发给模型，并在导入导出往返中保留。

两个数字决定条目的命运。优先级决定谁能撑过 token 预算：空间不足时，优先保留高优先级条目。

顺序（插入顺序）决定幸存者之间的排列：顺序越高在提示词中越靠前。顺序相同则看优先级，再看条目 id。

所有已激活条目都渲染进提示词模板中单一的世界书槽，各自成为一条带所选角色（系统、用户或助手）的独立消息。

没有按条目的位置概念；在提示词模板编辑器中移动世界书槽，以控制知识相对于其余内容落在何处。

条目内容开头以 @@ 开始的行会调整该条目的行为：

text

@@probability 50
@@scan_depth 8
@@role assistant
@@activate_only_after 4
@@keep

装饰符	效果
`@@probability`	激活时注入的百分比几率；掷点在一个回合内保持不变。
`@@scan_depth`	为此条目覆盖书的扫描深度。
`@@order / @@priority`	为此条目覆盖放置顺序或预算优先级。
`@@role`	为此条目覆盖注入角色。
`@@activate_only_after / @@activate_only_every`	仅在 N 条消息后触发，或仅每 N 条消息触发一次。
`@@keep / @@dont_activate_after_match`	首次命中后保持条目激活，或命中后再不激活。
`@@is_greeting`	仅在聊天仍停留于开场消息时激活。

token 计数使用当前活动模型的分词器，因此预算反映模型实际所见。条目超出预算时，最低优先级的先被丢弃。

若知识总被裁剪，可提高预算、收窄优先级跨度或缩短条目。请求日志会精确显示哪些条目进入了某次请求。