酒馆世界书教程：导入、触发、排查与角色卡获取（tuniang reviews）
酒馆世界书教程：导入、触发、排查与角色卡获取（tuniang reviews）
Contents
酒馆世界书教程的关键是：先分清卡内嵌世界书与独立 JSON，再分别导入角色卡、世界书和预设；条目重点核对主键、次级键、触发策略、order 与 token 预算，最后用聊天实测触发。
简介
这篇教程面向刚接触酒馆（SillyTavern）世界书的用户，教你从文件识别、导入、条目配置到触发排查，完成一本可用的世界书；也适合已有角色卡但触发总不稳定的人。
前置准备
- 一个能正常对话的 SillyTavern 前端，并已接好模型 API；部署与 API 连接请另看对应教程。本文综合的资料覆盖 SillyTavern 1.12.x 至 1.18.0 的部分机制，按钮和字段可能随版本变化。
- 角色卡文件：PNG 或 JSON；世界书：独立 JSON 或角色卡内嵌
character_book；预设：JSON。不要假设所有 JSON 都是同一种文件。 - 一个文本编辑器或 JSON 查看器，方便检查
key、keysecondary、selective、position等字段。 - 可选：Python 3。
feverZHONG/liya-sillytavern-worldbook的 CLI 为纯 Python 标准库；安装tiktoken后可用同口径统计 token。 - 可选：中文社区账号。类脑等 SillyTavern Discord 常有教程和角色卡，但需遵守社区规则；先读教程再提问。
- 若使用 DSH 等第三方酒馆管理工具，入口不同：其教程对应仓库已于 2026-08-27 归档，通常在“设置→酒馆管理”拖入角色卡或世界书 JSON，它的“全文注入/关键词触发”属于工具层封装，不要与 ST 原生世界书字段混用。
分步教程
以下以原版 SillyTavern 为主线；DSH 等工具只作为旁注。
步骤 1：先分清文件类型（为什么 JSON 不能乱拖？）
JSON 可能是预设、世界书或角色卡；PNG 只有原始文件才可能是角色卡。导入前先看作者说明和文件名，别把预设当世界书拖入。导入报错时，先确认文件类型，再确认图片是否为原始 PNG。
步骤 2：导入角色卡
在原版 ST 中，角色卡走角色管理/角色卡导入入口。PNG 角色卡是把角色数据附加在图片中，导入时酒馆会分离图片与卡数据；JSON 角色卡直接导入。不少新卡会自带世界书，导入后先检查是否已出现关联世界书；旧卡或未内置的书再单独导入。作者说明要求装插件时，先装插件再测。
步骤 3：导入或新建世界书
独立世界书走世界书模块导入；没有现成文件时，在世界书模块新建，再添加条目。条目内容会自动保存，关键词通常用半角英文逗号分隔。世界书作用域包括全局、角色、聊天（v1.17.0+）和 Persona（v1.17.0+）；共用书和单聊天书不要混用。
若用 DSH 等工具，世界书 JSON 可在酒馆管理里拖入，条目会分组显示，并可选关键词触发模式；这是工具层功能，不是原版 ST 字段。
步骤 4：卡内嵌书和独立 JSON 怎么选？
卡内嵌书随角色卡走，适合只服务这一张卡；独立 .json 适合多卡共用、按角色分流。按源码实证资料，多卡共用和按角色分流只有独立书做得到。若要把独立书关联到卡，字段应放在 data.extensions.world，写在顶层不生效。
| 对比项 | 卡内嵌世界书（character_book） | 独立 JSON 世界书 |
|---|---|---|
| 存放位置 | 角色卡数据内 | 单独 .json 文件 |
| 适合场景 | 单卡专用设定 | 多卡共用世界、按角色分流 |
| 导入方式 | 随角色卡导入，先检查是否已带书 | 在世界书模块单独导入 |
| 共用能力 | 通常随卡使用 | 可多卡共用 |
| 注意点 | 资料称卡内 characterFilter 在 ST 1.18.0 不被读取，需按版本实测 | 关联到卡时注意 data.extensions.world 字段位置 |
步骤 5：条目字段怎么填？
最少关注 key 和 content；需要条件触发时再加 keysecondary、selective 和 selectiveLogic。
| 字段/设置 | 作用 | 注意点 |
|---|---|---|
key | 主关键词，逗号分隔 | 避免“老师”“过去”“决定”等通用词；角色名与用户名默认参与扫描，容易误触发 |
keysecondary + selective | 次级关键词门槛 | 只填次级键但不开 selective，次级键会被忽略；开启后默认 AND_ANY，即主键命中且至少一个次级键命中 |
selectiveLogic | 次级逻辑：0=AND_ANY，1=NOT_ALL，2=NOT_ANY，3=AND_ALL | 主键命中是所有模式的必要前提；次级键为空时该逻辑无效 |
content | 注入内容，支持宏 | 只保证内容进入上下文，不保证模型一定遵循 |
constant | 常驻条目，无需关键词 | 仍受预算和概率影响；大量常驻会挤占 Conditional 条目空间 |
probability | 触发率 0–100 | 0 不触发，100 一定触发 |
position / depth | 插入位置与 @D 深度 | 默认 After Char Defs（position 1）；@D 的 depth=0 最靠近对话末端；AN 频率为 0 时 Top/Bottom of AN 会被静默跳过 |
order | 全局排序键，默认 100 | 预算截断时按降序保留；它不是单卡局部优先级，方向性影响有争议，需实测 |
group / groupWeight | 同组竞争与相对权重 | 权重是相对值，默认 100；groupOverride 可按 order 确定性胜出 |
scanDepth / caseSensitive / matchWholeWords | 条目级覆盖 | 中文条目应关闭全词匹配，避免中文/日文被破坏 |
步骤 6：触发策略和插入位置怎么设？
三种策略：Constant 常驻、Conditional 关键词触发、Vectorized 向量触发。Constant 条目会先消耗预算；Vectorized 不禁用关键词触发，若只想向量激活，需要同时删除 Key 字段。插入位置共有 8 个；写作或设定约束常放 After Char Defs，@D 的 depth 0–4 要谨慎堆叠。Outlet 需用宏手动调用，v1.13.5+ 支持。
步骤 7：token 预算和 order 怎么调？
ST 默认 world_info_budget 为 API 最大上下文的 25%，world_info_budget_cap=0 表示不设绝对上限；预算耗尽后，即使关键词命中也不再插入新条目，Constant 条目会优先插入。写长设定或小说资料时，25% 可能不够，可适当调高，但要给对话历史留空间。
order 是全局排序键，多卡共用时主键撞车和 order 竞争会互相影响。有教程说 order 越大影响越大；源码资料确认 order 参与全局降序排序和预算截断保留，但“最终 prompt 中越靠末尾影响越强”这一步被标为需真机验证，不要只凭数值迷信，建议用 Prompt 预览或实测确认。
步骤 8：怎么验证真的触发了？
在聊天里问一个应触发设定的问题，要求 AI 复述世界观或规则；打开工具栏的 prompt/世界书详情，查看条目是否进入上下文；边改边测时先点刷新再发送。
可选 CLI：wb ls 你的卡.json 查看条目；wb check --all 做触发体检；wb keys --all 看关键词撞车；wb sim 你的卡.json "测试句" --book 世界书.json 模拟触发。wb ls 可自动识别卡内书、独立书和条目清单三种形状。
去哪找角色卡
世界书常跟角色卡一起分发。下面只给入口和定位，本站不托管、不转载任何第三方角色卡；下载后请自行查看作者说明、授权和所需插件。
优先推荐（相对干净/授权清晰）
- aicharactercards.com：审核较严、SFW 友好。
- RisuRealm：每张卡可带 CC 授权，支持多格式和导入 ID。
- character-tavern.com：策展型目录，UX 较好。
最大但偏成人（务必带分级提示）
中文社区
- 类脑 / 旅程等 SillyTavern 中文 Discord、cards.sillytavern.one：中文卡库与社区，内容混合，注意频道规则和分级。
进阶/创作者
- Hugging Face：有角色卡/预设仓库，按仓库 license 使用。
- Pygmalion：模型与社区入口，适合继续查创作者资料。
- r/SillyTavern：Reddit 社区，适合找教程、插件和创作者分享。
以上多为用户生成内容、含成人分级（NSFW），请开启 SFW 过滤并遵守年龄验证；角色卡版权归原作者，下载与使用请遵循各站条款。角色卡格式简述 V2/V3（内嵌 PNG 或 JSON）。
常见问题排查
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 导入报错或识别不了 | JSON 可能是预设、世界书或角色卡；PNG 不是原始文件；作者要求插件未装 | 先确认文件类型，查作者说明，必要时用信息提取工具读取 |
| 关键词写了但不触发 | keysecondary 存在但 selective 未开；预算耗尽；AN 频率为 0；中文全词匹配开启；scanDepth 太浅 | 逐项检查字段、预算和全局设置 |
| 条目频繁乱触发 | 主键用了通用词；角色名/用户名默认参与扫描；Constant 太多 | 换专有名词，降低 probability，减少常驻条目 |
| 多卡互相干扰 | 主键跨卡撞车；order 是全局排序；卡内书和独立书边界不清 | 共用书只放“世界”设定，人物关系留在各自卡内书 |
| 调 depth/budget 没反应 | 按 ST 1.18.0 源码实证，卡内 book 级 scan_depth、token_budget、recursive_scanning 没有读取点 | 不要把它当生效开关，改全局设置或条目级字段 |
| Character Filter 不生效 | 版本口径冲突：ST 1.18.0 资料称卡内 character_book 的 characterFilter 不被读取；另一份手册把 Character Filter 列为高级触发控制，但未确认卡内书可用 | 先在当前版本真机测试，不要默认生效 |
| DSH 里正常、ST 里不触发 | DSH 的全文/关键词注入是工具层封装，字段和入口与 ST 原生不同 | 不要把两套导入方式混用 |
| order 调大反而乱 | order 是全局排序，不是单条绝对优先级；预算截断按降序保留 | 用 Prompt 预览实测，不要只凭数值判断 |
FAQ
Q1：酒馆世界书和角色卡是什么关系？
角色卡定义角色与对话主体，世界书按关键词或常驻规则把设定注入上下文；不少角色卡会内嵌世界书，也可以单独导入 JSON。
Q2：为什么一张 PNG 图片也能当角色卡？
PNG 可以在不影响图片显示的情况下附带角色卡数据，酒馆导入时分离图片和卡数据；只有原始 PNG 才可能这样，不是所有图片都行。
Q3：新角色卡自带世界书，还要单独导入吗？
先导入角色卡并检查是否已带书；已内置就不必重复导入，旧卡或未内置的卡再单独导入。作者说明要求插件时先装插件。
Q4：selective 和 keysecondary 怎么设？
只填次级键但不开 selective，次级键会被忽略；开启后默认 AND_ANY，即主键命中且至少一个次级键命中。需要排除逻辑再用 selectiveLogic 1/2/3。
Q5：中文关键词为什么不触发？
先关闭 Match Whole Words；它默认开启，对中文/日文有破坏性影响。再检查主键是否太泛、预算是否耗尽、AN 频率是否为 0。
Q6：世界书 token 预算设多少？
ST 默认 world_info_budget 为 API 最大上下文的 25%，cap=0 不设绝对上限；预算耗尽后不再插入。长设定可适当调高，但要给对话历史留空间。
Q7：order 越大越好吗？
不完全是。order 是全局排序键，默认 100，预算截断按降序保留；有教程说越大影响越大，但“越靠末尾影响越强”这一步在源码手册中被标为需真机验证，建议用 Prompt 预览确认。
Q8：世界书能保证 AI 一定按设定写吗？
不能。世界书只保证内容进入上下文，不保证模型遵循；还要靠提示词、预设、模型能力和实际测试。
Q9：卡内书和独立书怎么选？
单卡专用选卡内嵌；多卡共用、按角色分流选独立 JSON。独立书关联到卡时注意 data.extensions.world 字段位置。
Q10：导入报错怎么办？
先确认是角色卡、世界书还是预设；PNG 要原始文件；读作者说明和插件要求；可尝试信息提取工具读取。
CTA
想继续查看酒馆世界书与角色卡的实战笔记，可访问 tuniang.ai。
Sources
- GitHub - feverZHONG/liya-sillytavern-worldbook: 莉娅 · SillyTavern 世界书（Lorebook）机制——触发链源码实证 + 独立世界书工具链（体检 / 触发模拟 / 生成 / 自测） · GitHub - GitHub - feverZHONG/liya-sillytavern-worldbook: 莉娅 · SillyTavern 世界书（Lorebook）机制——触发链源码实证 + 独立世界书工具链（体检 / 触发模拟 / 生成 / 自测） · GitH…
- 刚开始玩酒馆，问问有没有啥入门教程？ - 刚开始玩酒馆，问问有没有啥入门教程？