第 13 章

调试怎么看

把调试顺序固定下来——Debug → Prompt Package → 模型回复。先看命中，再看分层，最后看回复。

本章重点

本章重点：把调试顺序固定下来 —— Debug → Prompt Package → 模型回复。

信息

到这一章，基本就不是「会不会填词条」的问题了，而是「出了问题你会不会查」。

真正常见的情况其实是：

现在调试主要看哪两个地方

现在最值得看的，是这两个地方：

工具	看什么
Worldbook Debug	世界书这一轮有没有命中、有没有注入、进了哪个分区。现在它一般在 Chat 页左侧小箭头里。
Prompt Package	这一轮最终是按什么结构打包给模型的。它会把预设、角色卡、世界书、记忆、最近聊天、输出格式规则分层展示出来。

重点

先看命中，再看分层，最后看回复。 不要一上来就盯着模型回答发愣。正确顺序永远是：先看 Debug，再看 Prompt Package，最后看模型回复。

回复不对
  ↓
先看 Worldbook Debug
  ├─ 确认有没有命中
  └─ 确认进了哪个提示层级
  ↓
再看 Prompt Package
  ↓
最后看模型回复

Worldbook Debug 负责回答这些问题：

你可以把 Debug 当成：世界书这一轮的处理日志。 如果它这里都没命中，那就先别急着怪模型——第一步就还没发生。

新手先不用一下子看所有东西，先重点看这几个：

Prompt Package 是你最接近「真相」的地方。因为它看的不是猜测、感觉、推断，它真正看的是：这一轮最终打包给模型的提示词结构。

现在它会更清楚地分成类似这样的层：

预设规则
角色定义前世界书
角色卡
稳定世界书
角色定义后世界书
长期记忆与用户资料
当前状态区
本轮相关记忆
本轮命中世界书
聊天深度世界书
设定问答提示
最近聊天记录
输出格式规则
本轮用户输入

你要看的不是「字多不多」，而是：这条内容有没有在正确的层里。

角色定义前是不是真的在角色卡前：如果你写的是硬规则，要确认它是不是在角色卡前；
稳定区是不是在角色卡后：稳定区更像角色卡后的长期补充，不要误以为它在角色卡前；
当前状态有没有单独出来：当前地点、当前关系、当前章节，最好能在当前状态区看到；
动态世界书是不是只出现在本轮：关键词和递归临时命中的东西，通常应该在本轮命中世界书里；
输出协议是不是靠后：状态变量、TTS、结尾格式，最好在输出格式规则里；
最近聊天记录有没有思维链：现在思维链可以保存在聊天记录里，也可以前端展开查看，但构建下一轮 Prompt 时，<think>...</think> 不应该再进 Prompt Package。

提示

如果 Prompt Package 的最近聊天记录里没有 <think>，说明思维链清理是正常的。

以后排错可以照这个走：

先查最基础的，不要一上来就查深度、顺序、递归（因为还没命中时，那些都还没开始起作用）：

先查（这时重点看 Debug）：

这时再看内容本身，可能原因有：

例子

如果你想让模型每轮输出状态变量，但你把这条写在角色卡或者稳定区里，它可能会当成背景设定，不一定每轮执行。更适合放到：输出协议区。

重点

没命中，看关键词。

命中了没进，看 Debug。

进了还不对，看 Prompt Package。

Prompt 也对还不稳，再看预设和模型遵循度。

到这里，说明书就会从「会配置」进入「会排错、会整理、会长期使用」。下一章是实战案例——把前面所有概念串起来。