世界书不触发，先查绑定，再查关键词，最后才轮到玄学

先给答案。世界书不触发，九成落在四个地方：书没绑定或没激活、关键词只写了大名、扫描深度够不着、token 预算被挤爆。按这个顺序查，多数情况五分钟见分晓。世界书最麻烦的地方是它坏了不报错：没有红字，没有提示，模型只是开始一本正经地编，你要到三轮之后才发现师父变成了仇人。

下面这张表是完整版。每一行的病因，表后单独展开。

排查之前：先分清蓝灯和绿灯

条目名字旁边那个圆点不是装饰。蓝灯是常驻条目：不看关键词，每一轮都往上下文里塞。绿灯才是关键词触发：扫描窗口里出现了键，条目才注入。两个方向的误会都常见：把世界观基石设成绿灯、关键词又只写了两个，表现出来就是「时灵时不灵」；反过来图省事全改蓝灯，token 每轮全额扣，聊到二十轮预算先爆，别的条目开始被挤掉。值得蓝灯的是那种缺了它整个世界就不成立的设定，数量压在五条以内，每条一百五十字上下，把它当每轮都要交的房租来掂量。

病因一：书根本没被读到

一条都不触发的时候，别急着改条目，先确认引擎读到了这本书。世界书有两个来源：角色卡内嵌的角色书跟卡走，开聊自动生效；单独导入的全局书，导入完还要在世界书面板里勾选激活才参与扫描。「导入了、列表里也看得见、就是没勾」这一步，是我们见过的全局书集体沉默里最高频的一种，也最冤——条目本身一个字都不用改。角色卡换了版本重新导入时，内嵌书有没有跟着进来，也值得顺手确认一次。

病因二：关键词是大名，聊天里全是外号

有位作者给一张卡配了 237 条设定，人物条目的关键词写的是角色全名。翻聊天记录：四十轮里没有一个人叫过全名，全是「师父」「老李」「掌门」这些叫法。关键词一个都没覆盖，零命中，零注入，模型只好凭感觉现编一个性格。修法花了二十分钟：把每一种称呼都补进关键词列表。后来我们统计排障工单，「从不触发」的案例里超过一半最后都归到别名没写全——比所有高级设置加起来还多。

病因三：扫描深度够不着

时灵时不灵是最像玄学的症状，原因最无聊：关键词只在最近几条消息里找，这个窗口就是扫描深度，我们引擎默认 4，各前端默认值不等。第十轮聊过的龙，中间岔开六轮感情戏，第十七轮再看，龙已经在窗口外了。三种修法按顺序试：把真正扛世界观的条目升成常驻；给相关条目互相埋递归钩子，宗门条目正文里提一句佩剑，聊到宗门时佩剑档案就顺着递归链跟上来；最后才是调大扫描深度，因为深度越大误触发越多、每轮扫的文本也越多。

病因四：预算被一条 800 字的条目吃光

触发归触发，注入归注入。所有命中的条目要在一个 token 预算里排队，超出预算的部分按优先级静默丢弃，模型根本不知道它们存在过。一条 800 字的美文条目能独占三分之一预算，聊天一长，排在后面的条目成批消失，这就是「前期正常、聊长了失灵」的标准病理。修法是把条目当档案写：事实前置、电报体、一条只讲一件事，我们实测把 800 字压到 150 字之后，同一组二十个追问的答对率反而上去了，因为省下的预算救活了另外三条。触发之后到底注入了什么、落在 prompt 哪个位置，装配透视台能整层摊开给你看。

病因五：副键方向写反了

副键有四种逻辑：AND_ANY、AND_ALL、NOT_ANY、NOT_ALL。写反方向的事我们每周都见：本意是「聊到王冠就触发，除非梦境也在场」，手一滑配成了「王冠和梦境同时在场才触发」，条目从黑名单变成了双重门槛。这类问题靠盯着配置界面看是看不出来的，触发模拟器会把每个条目的副键判定逐条讲出来：哪个键命中了、哪个条件没过、差在哪。

病因六：概率骰子，以及导入送你的 1%

条目可以挂触发概率，30% 的条目十轮里睡七轮属于正常工作，不是坏了。真正的坑在跨平台搬家：导入 JanitorAI 的条目触发概率经常停在 1% 的默认值上，表现就是设定约一百条消息才开一次；它的关键词匹配还会把非 ASCII 字符剥掉，中文键直接消失。搬去 Risu 则是另一套脾气：禁用的条目会集体复活，NOT 守卫反转成正向条件。这些平台方言我们在迁移陷阱那篇里逐条对过源码，搬家前把书拖进迁移体检器，受影响的条目会按目标平台逐条点名。

十秒复现，别再开一局试了

以前测世界书的方式是改一条、开一局、盯着看，一晚上烧掉几十条测试消息还未必撞上触发条件。现在的做法：把世界书 JSON 和几行聊天贴进触发模拟器，每个条目立刻给出触发或沉默的判定和原因，命中的关键词高亮，递归链画出来，概率条目可以反复重掷。引擎按 SillyTavern 1.18 的扫描激活语义移植，在浏览器本地跑，改一条重跑一次只要几秒。

最后一个容易漏的小事：改完条目，旧的注入还挂在当前上下文里，要重发一条消息扫描才会重跑。我们有过一单排障，前后查了半小时，最后发现条目早就改对了，只是没人发新消息。修好之后在手机上的酒馆里开一局，提示词检查器能看到每一次真实注入——那才算验收完成。