创作者文档
世界书规范
Foreverse 的世界书 runtime 与桌面 SillyTavern 的 World Info 语义对齐:桌面端调好的书, 手机上行为一致。这篇是行为参考,写法建议见博客《世界书的正确写法》。
注入流程
每次发送消息时按四步执行:
- 扫描最近若干轮对话,用每个条目的关键词做匹配(大小写不敏感);
- 命中的条目按插入位置与优先级注入 prompt;
- 注入总量受 token 预算约束,超出预算的低优先级条目被静默丢弃;
- 已注入的内容可再次触发其它条目(递归激活)。
条目失效不报错——排障永远从「它有没有被注入」查起,而不是问模型为什么不听话。
关键参数
| 参数 | 行为 |
|---|---|
| 关键词 / 别名 | 逐条目列表;对话里出现任一关键词即命中。角色的小名、职务、绰号都要列进去 |
| 常驻(constant) | 无视关键词每轮必注入;每一条都持续消耗上下文,建议 ≤5 条 |
| 扫描深度 | 关键词只在最近 N 轮内匹配;聊出窗口的设定等于没聊过 |
| token 预算 | 所有命中条目共享一个注入预算;超了按优先级丢弃,不提示 |
| 递归 | 条目内容里出现其它条目的关键词时可链式激活;在内容里主动埋关键词是高级玩法 |
V3 decorators
条目内容里以 @@ 开头的行是 V3 decorators。当前实现支持两个,与桌面酒馆一致:
| Decorator | 语义 |
|---|---|
@@activate | 无条件强制激活:绕过 constant / 关键词 / 二级关键词 / 概率判定(仍受冷却约束) |
@@dont_activate | 无条件禁止激活,任何机制都不能把它塞进 prompt |
- 所有
@@行(包括未识别的)都会从注入内容中剥离,不会泄漏进 prompt。 @@@x是 fallback 写法:前面的 decorator 不被支持时按链依次降级。
症状速查
| 症状 | 先查 |
|---|---|
| 完全不触发 | 世界书是否绑定到该角色 / 会话;条目开关 |
| 时灵时不灵 | 关键词是否掉出扫描窗口;别名是否覆盖 |
| 聊久了失效 | 预算被常驻和长条目吃满,压缩条目、降低次要条目优先级 |
| 触发了但模型不采信 | 条目太长太文学,改成事实前置的电报体 |