创作者文档

世界书规范

Updated · 2026-07-07Public document

Foreverse 的世界书 runtime 与桌面 SillyTavern 的 World Info 语义对齐:桌面端调好的书, 手机上行为一致。这篇是行为参考,写法建议见博客《世界书的正确写法》

注入流程

每次发送消息时按四步执行:

  1. 扫描最近若干轮对话,用每个条目的关键词做匹配(大小写不敏感);
  2. 命中的条目按插入位置与优先级注入 prompt;
  3. 注入总量受 token 预算约束,超出预算的低优先级条目被静默丢弃;
  4. 已注入的内容可再次触发其它条目(递归激活)。

条目失效不报错——排障永远从「它有没有被注入」查起,而不是问模型为什么不听话。

关键参数

参数行为
关键词 / 别名逐条目列表;对话里出现任一关键词即命中。角色的小名、职务、绰号都要列进去
常驻(constant)无视关键词每轮必注入;每一条都持续消耗上下文,建议 ≤5 条
扫描深度关键词只在最近 N 轮内匹配;聊出窗口的设定等于没聊过
token 预算所有命中条目共享一个注入预算;超了按优先级丢弃,不提示
递归条目内容里出现其它条目的关键词时可链式激活;在内容里主动埋关键词是高级玩法

V3 decorators

条目内容里以 @@ 开头的行是 V3 decorators。当前实现支持两个,与桌面酒馆一致:

Decorator语义
@@activate无条件强制激活:绕过 constant / 关键词 / 二级关键词 / 概率判定(仍受冷却约束)
@@dont_activate无条件禁止激活,任何机制都不能把它塞进 prompt
  • 所有 @@ 行(包括未识别的)都会从注入内容中剥离,不会泄漏进 prompt。
  • @@@x 是 fallback 写法:前面的 decorator 不被支持时按链依次降级。

症状速查

症状先查
完全不触发世界书是否绑定到该角色 / 会话;条目开关
时灵时不灵关键词是否掉出扫描窗口;别名是否覆盖
聊久了失效预算被常驻和长条目吃满,压缩条目、降低次要条目优先级
触发了但模型不采信条目太长太文学,改成事实前置的电报体
Foreverse 世界书规范 — 触发、预算与 V3 decorators