酒馆预设导入教程:从 JSON 文件到真正生效的完整步骤
酒馆预设导入教程:从 JSON 文件到真正生效的完整步骤
Contents
酒馆预设通常是一个 JSON 文件,导入只是第一步:在对应平台的“预设/酒馆管理”入口选择或拖入文件后,还要在目标层级(全局、角色或本次聊天)启用,才能进入发给模型的 Prompt。导入本身免费,效果要以 Prompt 预览为准,不能只凭感觉判断。
简介
这篇教程教你如何把 SillyTavern 生态中的“预设”(提示词 JSON)导入到酒馆类工具并正确启用,适合刚接触酒馆、手里已有预设文件但不确定是否生效的用户。文中覆盖原生酒馆、dsh-tavern 插件、Foreverse 移动端三种常见路径;如果你用的是其他外壳,重点看“分步教程”里的通用检查逻辑。
前置准备
- 一份预设 JSON 文件(通常由预设作者提供,也可能包含在角色卡或整合包里)。
- 一个能正常对话的酒馆环境:SillyTavern 原生界面、dsh-tavern 插件或 Foreverse 等移动端 App。
- 至少一张可开聊的角色卡,用来验证预设是否真的进入 Prompt。
- 明确作用范围:想让预设影响所有角色、只影响某张卡,还是只影响这一场对话。
- 可选:预设作者附带的配套正则、世界书或酒馆助手脚本。很多进阶预设离开这些配套项会不完整。
分步教程
路径一:SillyTavern 原生界面
- 打开酒馆,在预设/设置面板找到“预设”管理或导入入口。
- 选择或拖入预设 JSON 文件,等待解析完成。
- 在预设列表中选中刚导入的预设,确认它成为当前生效预设。
- 新建或进入聊天,发送一条消息,打开 Prompt 预览/逐条查看,搜索预设中的文本块内容,确认它已进入 Prompt 拼装结果。
- 如果预设自带正则、世界书或脚本,按作者说明分别导入,并在对应开关处启用。
注意:原生酒馆导入后需要“选中”才生效,不要以为文件出现在列表里就完成了。
路径二:dsh-tavern 插件
- 打开 DSH 设置 → 酒馆管理。
- 把预设 JSON 拖入“预设”区域,词条会自动分类显示。
- 按需单独开启或关闭某个词条。
- 点“💾 保存并注入”,预设才会真正进入系统提示。
- 到会话中确认预设名称是否同步显示在聊天顶部;dsh-tavern 支持每个会话绑定不同预设,切换对话会自动加载对应预设。
注意:dsh-tavern 还有“白名单模式”,默认所有会话都注入预设,切换为白名单后只有加入白名单的会话才注入。如果你发现某个会话没有生效,先检查这里。
路径三:Foreverse 等移动端 App
- 打开“我的 → 常用 → 从酒馆导入”,在“提示词预设”入口导入 JSON;正则脚本走“正则美化脚本”入口。
- 选择启用层级:全局(我的 → 常用 → 酒馆全局设置 → 预设/正则/宏)、这个角色(聊天页 ⋮ → 聊天设置),或本次聊天(只对当前会话生效,开新会话不带走)。
- 确认所选层的预设卡片显示导入的预设名和块数。
- 发一条消息,长按回复点“提示词”,在拼装好的 Prompt 里搜预设文本块,验证是否进场。
- 如果预设连带调整了上下文上限,到“采样与提示词”里复核,避免单条消息输入 token 费用变高。
注意:Foreverse 文档明确说明,整包备份带进来的预设只归档进预设库,不会自动激活;层级优先级为“本次聊天 > 这个角色 > 全局 > 内置默认”。
路径四:面向开发者的酒馆助手 API
如果你在写酒馆助手脚本,可以调用 importRawPreset(filename, content),像酒馆界面那样导入新预设或更新现有预设:filename 为预设文件名,content 为预设文件内容,返回 Promise。典型用法是先 fetch 预设网络链接,再把文本传给该函数。普通用户不需要走这条路。
导入后必须做的三件事
- 确认“已选中/已注入”,不是“已上传”。
- 用 Prompt 预览核对文本块是否真的进入请求。
- 检查配套正则、世界书、脚本是否按作者要求启用;生图类预设尤其如此,预设、世界书、正则往往要一起挂上才会触发。
不同平台导入入口有什么区别?
| 平台/工具 | 导入入口 | 文件形式 | 启用范围 | 生效确认方式 | 主要注意点 |
|---|---|---|---|---|---|
| SillyTavern 原生 | 预设管理/导入入口 | JSON | 全局或当前聊天 | 选中预设 + Prompt 预览 | 导入后需手动选中 |
| dsh-tavern 插件 | DSH 设置 → 酒馆管理 → 预设区域 | JSON(拖入) | 会话绑定,支持白名单模式 | 聊天顶部显示预设名 | 必须点“保存并注入” |
| Foreverse App | 我的 → 常用 → 从酒馆导入 → 提示词预设 | JSON、整包备份 zip | 本次聊天 > 这个角色 > 全局 | Prompt Inspector 搜文本块 | 整包备份只归档、不自动激活 |
| 酒馆助手脚本 | importRawPreset(filename, content) | JSON 字符串 | 由脚本调用方控制 | 函数返回 Promise | 面向开发者,普通用户不用 |
需要标注的差异:不同工具对“导入后是否自动启用”的行为并不一致。Foreverse 明确不自动激活,dsh-tavern 要求“保存并注入”,原生酒馆需要选中预设。看到“导入成功”提示不等于已经生效,务必回到当前会话确认。
导入预设会影响我所有的角色卡吗?
取决于你在哪一层启用。以 Foreverse 的分层逻辑为例:全局层对所有角色生效;角色层只影响某张卡;本次聊天层只影响当前会话,开新会话不带走,且角色层或会话层选了预设的地方以它们的为准。dsh-tavern 则通过“会话绑定 + 白名单模式”控制范围。原生酒馆同样区分全局预设与聊天级选择。
因此,想先试水就把预设放在“本次聊天”层;确认稳定后再提升到全局。不要一上来就全局启用带强改写、大量正则的预设。
去哪找角色卡
预设和角色卡经常一起使用,下面按“相对干净、库大但偏成人、中文社区、创作者向”分档介绍。本站不托管、不转载任何第三方角色卡,以下外链仅供你自行前往下载:
- 优先推荐(相对干净、授权较清晰):
- aicharactercards.com:审核较严,SFW 友好。
- RisuRealm:每张卡可带 CC 授权,支持多格式与导入 ID。
- character-tavern.com:有策展,界面体验较好。
- 最大但偏成人(务必注意分级):
- 中文社区:
- 类脑、旅程等 SillyTavern 中文 Discord 社群,以及 cards.sillytavern.one 等中文卡库,内容混合,需自行甄别。
- 进阶/创作者向:
- Hugging Face 上的角色卡/预设仓库(按各仓库 license 使用)、Pygmalion、Reddit 的 r/SillyTavern。
免责声明:以上多为用户生成内容,含成人分级(NSFW),请开启 SFW 过滤并遵守年龄验证;角色卡版权归原作者,下载与使用请遵循各站条款。角色卡常见格式为 V2/V3,可能内嵌在 PNG 中,也可能是独立 JSON。
常见问题排查
- 预设导入了,聊天里找不到:常见原因是整包备份只归档未激活,或当前层被会话/角色层覆盖。先到全局预设管理启用,或到目标层重新选择。
- 只开了开关,效果不完整:dsh-tavern 的教程明确指出,成人模式需要“预设词条 + 成人模式开关 + 保存并注入”三者搭配;只开开关不配预设,或只改预设没保存注入,都不生效。
- 预设启用了,回复感觉没变化:很多预设主要调整提示词结构和顺序,语气上未必立刻可见。用 Prompt 预览对比启用前后的结构,并逐层检查当前生效的是哪个预设。
- 模块互相冲突:以 GrayWill-ST 这类高定制预设为例,作者会注明“有冲突的模块尽量别一起开”“优化/抗八股类条目最多开一个”“反截断多个选项中最多选一个”。导入后先读作者的开关说明,不要全开。
- 角色卡自带 CoT,与预设冲突:GrayWill-ST 的说明提到,兼容性不是很好,如果角色卡自带 CoT,应关闭预设里的 CoT 条目。
- 正则导致消息变空白:写坏的 Find/Replace 可能把显示文本整段清掉,替换框留空本身就等于删除匹配内容。到正则管理里停用或修正该条。
- 卡自带正则和全局正则叠着跑:在酒馆资产中心查看该卡携带的资产,同类规则只保留一层,另一层停用。
- token 占用突然变大:部分平台启用预设会连带改变上下文上限,历史携带变多会导致输入 token 费用上升。到采样与提示词设置里复核。
- 安装了预设但缺正则/脚本:不少预设把关键功能拆到正则或酒馆助手脚本里,按作者说明补齐;缺失时表现为格式不渲染、思维链不折叠或功能按钮不出现。
FAQ
Q:酒馆预设是什么格式? A:通常是 JSON 文件,内含若干提示词条目(文本块/动态块)。不同平台对“预设”的封装略有差异,但核心都是把结构化提示词注入到发给模型的内容里。
Q:导入预设收费吗? A:导入、启用、编辑预设本身不产生模型调用,按 Foreverse 文档的说法是免费的;真正可能产生费用的是你发出去用于验证的那条消息,以及预设调大上下文后每轮携带更多历史带来的输入 token 增加。
Q:手机能导入和编辑预设吗? A:可以。Foreverse 这类移动端 App 提供“从酒馆导入”入口和预设卡片编辑器;原生酒馆也有移动端界面。具体入口以你使用的平台为准。
Q:预设和世界书、正则有什么区别? A:预设改的是发给模型的提示词结构与风格;世界书按关键词或常驻方式注入设定;正则主要在本机做文本替换和消息美化,不调用模型。三者作用层不同,经常需要配合使用。
Q:能同时启用多个预设吗? A:多数平台同一层只认一个当前预设。dsh-tavern 的做法是每个预设一个目录、会话绑定不同预设;需要多套配置就建多个预设切换,而不是叠着开。
Q:预设导入后必须重开聊天吗? A:不一定。原生酒馆和 dsh-tavern 切换预设后通常对当前会话生效;Foreverse 的“本次聊天”层在应用前会弹确认,开新会话不带走。保险做法是切换后发一条消息并用 Prompt 预览确认。
Q:为什么作者说“只支持官方渠道模型”? A:以 GrayWill-ST 为例,作者注明预设只支持官方渠道的 DS,第三方渠道需关闭所有 role 为 ai assistant 的条目,因为部分第三方不支持预填充。这类限制属于特定预设的适配说明,不是所有预设通用。
Q:预设里的思维链怎么自动解析?
A:GrayWill-ST 给出的做法是:找到酒馆里类似 A 标志的按钮,打开自动解析,新建解析规则,把标签设为 <thinking> 和 </thinking>。不同预设的标签可能不同,以作者说明为准。
CTA
如果你正在整理自己的预设与角色卡工作流,可以到 tuniang.ai 看看相关的工具与教程索引,按自己的平台选择对应入口即可。