SillyTavern酒馆

SillyTavern酒馆可接入Claude、gemini等多种AI模型，支持本地部署与云端使用，无需安装即可通过网页端或安卓客户端访问，兼容KoboldAI、NovelAI、OpenAI等主流模型，满足多样化互动需求。能创建不同形象与性格的角色卡，也可导入他人分享的角色卡和世界书，解锁多样剧情，沉浸式开展故事创作、角色扮演等体验。支持自定义美化代码与UI界面，自由配置主题和交互逻辑，贴合个性化使用习惯。

【特别说明】

1、SillyTavern酒馆本身没有APP，但可以通过Termux软件将其部署在手机上

2、本页面提供的是Termux安装包，根据下方教程进行操作即可在手机上安装SillyTavern酒馆

SillyTavern酒馆本地部署教程

一、安装termux

Termux是一个适用于Android的终端模拟器，其环境类似于Linux环境。我们直接进入他的github下载适合自己手机版本的安装就行了。在BLOG主发稿时，适应大部分手机的版本是这个“termux-app_v0.119.0-beta.2+apt-android-7-github-debug_universal.apk”。下载后，直接在手机上安装。

二、安装酒馆

1、更新环境：首先我们需要更新Termux的依赖环境，以防止出现奇奇怪怪的问题，按顺序运行下面两条内容即可。（注意，不是一次性输入两行，而是输入一行，回车等待运行。然后再输入第二行，然后回车等待运行）如果出现更新失败，请检查梯子。另外，如果出现询问Y/N的选择，直接输入Y，然后回车。

apt update 

apt upgrade

2、安装git：跟PC版本一样，我们需要安装git，方便对酒馆进行下载和更新管理，跟上面一样，输入回车等待安装。

pkg install git

3、安装酒馆：然后就是正式安装/拉取酒馆了，跟PC版本一样，有两个版本可供选择，只需要选择其中一个安装就行。上面是正式版、下面是测试版，正式版更稳定，测试版更新更频繁。

git clone https://github.com/SillyTavern/SillyTavern -b release
git clone https://github.com/SillyTavern/SillyTavern -b staging

4、安装node.js运行环境：接着我们进入SillyTavern目录，然后安装JavaScript运行环境。直接根据下面代码，逐行输入执行就行。

cd SillyTavern

pkg install nodejs

npm install

5、运行酒馆：本次运行酒馆无需再次输出“cd SillyTavern”，但是如果重启了手机或者重启了Termux，无需再次执行前面4步，只需要进入目录，然后运行“start.sh”就可以啦！

cd SillyTavern 

./start.sh

6、在浏览器输入默认地址，http://127.0.0.1:8000/，即可跟PC一样打开酒馆愉快玩耍啦！

SillyTavern酒馆的相关设置教程

一、功能设置

1、首次登录：在双击“Start.bat”成功启动酒馆后，我们即可设置自己的的用户名称。这个名称将会显示在所有的对话中，命名“自己”这个角色。

2、多用户管理：如图依次点击，进入管理员面板，即可新建用户。这里强烈建议关闭默认的“User”用户，该用户是系统默认用户，在“basicAuthMode”模式下会作为默认用户使用，因此不能删除。为了避免风险，建议点击禁用按钮，关闭该用户。

另外也别忘了在禁用前新建一个自己的管理员账号。

3、主题设置：如图，同样在用户页面，点击“UI主题”右面的导入按钮，将下载好的主题文件“XXX.json”文件导入酒馆。随后点击下面的菜单，选择刚刚导入的主题，即可达成一键美化效果。部分主题可能需要更复杂的设置，请各位自行发掘了。

PS，这也页面右面有个“禁止外部媒体”的勾可以去掉，部分人物卡会载入外部的多媒体内容，禁用就无法播放了。

二、申请Gemini API

酒馆本身只是一个平台，自己并不具备AI思考运算的能力。我们需要为酒馆接入一个合适的AI，才能让酒馆运作起来。当前免费且效果好的AI我们首选的就是Google Gemini。另外即使算上付费，Gemini仍然是比较便宜的，当前大约80RMB可以购买到1000万token。

1、注册账号：首先去google官网一个google的账号。当前账号申请需要使用手机验证码。这一步当前仅需梯子即可完成，进入GOOGLE主页，然后根据提示操作即可。

2、开通google api：

①随后，我们打开Google AI Studio，初次登录根据提示点击Continue即可。

②随后我们点击左上角的“Get API key”，然后在弹出菜单中继续选择“Create API key”。如果你这里显示的是中文，就点击“创建API密钥”。

③随后在弹出的页面中选择“Gemini API”项目，最后点击确定即可创建你的第一个Gemini api。

3、新建项目：需要注意的是，当前Gemini的api虽然能提供用户免费使用，但是同一个项目下的不管多少个api都受到统一的配额限制。具体来说就是每天50次gemini-pro和1500次gemini-flash的响应。理论说，如果在酒馆中使用gemini-flash，那一天1500条肯定是足够了，但是如果使用生成质量更好的pro，那么50条就会非常捉襟见肘。这时候我们可以到Google Cloud新建多个不同的项目，随后回到上一部在不同的项目上申请api，即可增加实际可用的api数量。

4、设置api：

①申请api后我们回到酒馆，根据下图设置，将刚刚申请的api密钥填入，并选择好需要使用的模型。（当前Gemini输出质量最好的模型是pro-exp-1114，但是常规设置并不能使用，有两个方法可以解决这个问题。最普通的方法是用文本打开一下路径的文件：

SillyTavern-releasepublicindex.html

②随后搜索optgroup label=”Subversions”，然后将：

Gemini 2.0 Flash Experiment

③添加到该栏目下即可实现对API的调用。其中“gemini-2.0-flash-exp”是模型名称，可以在gemini官方文档中确认，后面的“Gemini 2.0 Flash Experiment”是在酒馆中显示的名称，可以自定义。

④第二个方法可以参考教程进行设置，以上设置全部完成过后，点击酒馆api页面的“连接”按钮，如果系统提示成功，那酒馆就正式营业了！

5、API报错

如果在使用过程中遇到上图这样的错误，基本上可以认为是网络出了问题，注意并非可以访问gemini的网站就代表梯子正常。对于PC用户而言，需要打开CLASH中的“TUN模式”才可以正常链接API使用。如果是用路由器的，则没有这个问题。如果不确信是哪个环节出现问题，可以考虑注册一个deepseek使用，如果deepseek正常而Gemini不行，则基本上100%可以确认是网络问题。

如果在使用过程中遇到上图这样的报错，基本上可以认为是预设出现问题，多数情况下是“破限”带来的。最好的处理方法是到社区里面找最新的破限，并仔细阅读使用说明，避免出现问题。由于该问题是用户与AI之间长期博弈的结果，因此没有统一的解决方案，请多关注酒馆社区的进化。

三、酒馆基础设置

1、预设：预设是控制AI输出逻辑、限制的核心，我们必须使用核心来控制AI输出的边界和功能。如图所示，首先我们确认最上方是选择的是“对话补全预设”，如果这里显示的不是对话补全，需要到API接入那里进行设置。随后需要在“对话补全预设”右面第一个按钮导入一个下载好的预设。使用Gemini API的人需要注意，下方的“流式传输”必须取消勾选，否则可能会出现输出截止（就是输出一半突然停了）的问题。

我们继续拉下去，就会看到当前预设的使用说明（不一定都有），建议使用预设前都看看这个预设的说明和开启的项目。如下图红框所示，预设的每一个功能都单独设置了开关，参考说明之后，可以对不同功能进行打开和关闭。这些细节的调整，很可能会影响到全局的输出质量。

2、人物卡：顾名思义，就是可供聊天的主体对象。通常是1人，当然根据卡面设计，也可以是多人。人物卡通常包括该人物的个性、经历、人际关系、对待事物的态度、口癖、外观等关键描述。是构成该人物的核心因素。我们通常可以在选中人物卡后，看到作者撰写的“角色描述”，这会让你更快速地了解这位角色以及这张卡的大致内容。

①导入人物卡也非常简单，参考下图依次点击即可导入下载好的人物卡。人物卡一般格式为PNG格式（也就是图片），他通常同时也是一张可以看到角色形象的图片。

②部分人物卡导入之后，初次打开会弹出下面这个对话框，这是提示该人物卡绑定了一个属于他的“世界书”，一般我们点击“是”，用于导入该世界书。世界书的具体介绍请继续往下看。

③人物卡导入后，我们可以观察人物卡最下面的“第一条消息”栏，该栏目的文字语言，决定了这张卡的默认输出语言。如果导入之后发现人物卡是其他语种，可以通过翻译软件，将这段话翻译后，即可改成中文卡游玩。但需要注意，这只是权宜之计，最佳方案是在中文社区，找专门以中文开发的卡片，以避免AI在输出过程中突然给你飚两句外语。

3、世界书-人物书：世界书的一种，人物书一般绑定在人物卡上，就是前面所述的初次载入人物卡时会提醒加载的内容。人物书专门用以扩展该人物的描写内容。通常包括与“人物卡”有关的人物关系、地名、世界观等内容的具体描述。帮助AI更好地识别所处环境，并更好地玩家产生互动。这也将有助于AI拓展自己的认知边界，不会出现太多超游或者不符合逻辑的扮演。

另外，如果需要对其进行修改，可以点击下图红框所示。通常是卡片作者已经写好的内容（部分卡片也可能没有人物书）。

4、世界书-世界书：世界书的本体，与人物书一样，提供更详细的描述扩写，用以规范AI的创作边界。世界书一般脱离人物，主要描述整个世界范围的内容。比如国家、地区、文化、主要组织、历史等。AI可能不能马上使用这部分内容，但是对于营造故事的氛围感和未来可能存在的剧情关联，有至关重要的作用。需要注意的是，人物书只能绑定到人物卡上，最多1个，而世界书则可以同时启动多个。如下图，我们可以按照顺序点击，即可导入已经下载好的世界书。

导入世界书完毕后，我们可以在下图的位置设定默认打开的世界书（允许多个）。酒馆AI输出的过程中，按照“API、预设、人物卡、人物书、世界书”的顺序，默认左高右低的优先级进行思考输出。

5、正则：酒馆的正则主要是对最终输入AI的文本做进一步的优化或功能叠加。不少预设必须配合对应的正则才能使用，否则会出现许多多余的显示内容（比如思维链）。正则的导入非常简单，如下图所示导入json文件即可。正则可以有全局正则和局部正则，一般根据正则的具体效果，选择导入即可。注意预设和正则都是.json文件，但两者导入的位置不一样，不可以搞混。

6、AI回复格式化

这是进一步通过规范格式对酒馆输出内容进行规范化的设置。其中需要关注的是“系统提示词”中的几个具体选项。这些选项的优先级不如人物卡中相关的描述要求，如果人物卡已经有相关的对AI回复的描述，这些设置可能不生效。但是对大部分卡而言，这部分内容都将很好地规范输出的内容。

Actor：AI将扮演一个专业的演员，不会被指认或自认为是AI。

Neurtal-chat：允许玩家与AI进行聊天（也就是AI同时扮演玩家）

Roleplay-Detailed：缓慢发展故事，更丰富的描写，不会出现跳跃性的发展。

Roleplay-Immersive：仅做一个回复，不扮演玩家

Text Adventure：适合跑团（DND&COC）

7、COT（思维链）：酒馆允许自设一定的思维链路，比如下图红框部分，就是聊天中的COT状态栏。这个状态栏是通过世界书撰写的COT思维链。设计思路就是为角色添加一个累计的数值，比如“好感度”。

每次对话通过分析内容对好感度进行加减操作。然后累计的好感度将会出发下一层级的关系：陌路——好友——爱慕。然后不同的关系则会触发不同类型的行为。整个过程的控制，我们称之为思维链。

8、快速回复（Quick Reply/QR）

当你懒得打字或者面对一些剧情不知道该如何发展，又或者希望玩些新花样的时候，预设好的QR功能将很好地辅助你在逻辑畅通的前提下，继续推进故事。我们点击酒馆上方插件栏目，随后打开快速回复选项。勾选“启动快速回复”以打开这个功能。接着如图点击下方的按钮，导入已经下好的快速回复“xxx.json”文件。（注意，酒馆大部分导入脚本都是.json文件，但是他们的功能可以是预设、正则、快速回复，别导入错位置了）

完成导入后，我们可以看到上面有两个回复集，分别是“全局快速回复集”（对所有卡生效）和“聊天快速回复集”（仅对当前卡生效），根据需求自己设定就可以了。另外部分的QR有配套的世界书/正则需要同时导入并启动，可以根据前面教程一起导入使用即可。

9、添加聊天背景

酒馆的聊天背景上传也非常简单，直接按照下图依次点击，即可完成图片上传。

但是对于需要快速管理背景的人来说，直接打开以下地址，可能是更快捷的管理方式

SillyTavern-releasedatauserbackgrounds

四、文字转语音（让酒馆开口说话）

1、本地TTS（Microsoft/无需显卡支持）

酒馆默认提供了极其丰富的API接口，但是就如同前文所说，酒馆本身不提供AI服务，因此这些接口都需要单独照对应的AI服务接入才能使用。本教程主要着眼于“免费”，所以这里推荐使用WINDOWS自带的TTS引擎。如下图所示，打开插件菜单，选择TTS栏目。然后选择TTS来源中选择“System”，勾上下面的“Enabled”以确定启动该服务。随后在下方指定各个登场角色所使用的语音：“Dafaule Voice”（旁白）、“User/玲雨”（这里是主角，名字是BLOG主自己起的）、“艾雅法拉”（人物卡或者出场人物的名字）。最下方的“Acailable voices”可以预览该模型提供的所有语音种类。另外需要注意，TTS一般是需要对应语种的。比如中文就必须选择中文的语音模型，如果使用别的语种应该会报错。

2、在线TTS（EDGE/免费）

我们也可以使用借用EDGE浏览器的在线TTS服务语音，他同样是调用微软的TTS服务，只不过音色选择更丰富（其实没卵用），使用方法也非常简单，可以参考这个项目。稳定性其实不如上面的本地TTS。

①、首先修改config.yaml设置文件中的enableServerPlugins为true

②、来到SillyTavern的根目录，按照上文方式打开CMD，随后输入如下代码运行

cd plugins git clone https://github.com/SillyTavern/SillyTavern-EdgeTTS-Plugin

③、最后重启整个酒馆服务器，到TTS中选择EDGE就可以使用了。至于每个选项所代表的意思，可以自己翻译一下网页，非常好理解，这里就不在多做赘述。如果遇到语音输出出现问题，那么问题多半是在其他的环节上。

SillyTavern酒馆使用中的常见问题。

一、我可以在手机或平板电脑上使用SillyTavern吗？

1、iPhone和iPad无法运行完整的SillyTavern应用程序，但由于它只是一个网络界面，您可以在家庭Wi-Fi上的另一台计算机上运行它，然后在移动浏览器中访问它。更多信息请参考远程连接。

2、对于Android用户，除了上述方法外，您还可以使用Termux应用程序直接在手机上运行完整的SillyTavern，无需PC。请参考安装（Android）。（注意：Termux安装不受官方支持，我们不能保证它会正常工作。）

二、我试图导入PNG角色卡片但收到无效的错误。为什么？

两种可能性：

1、卡片内部没有嵌入定义，只是一个普通的图像文件。当您保存它们时，某些程序或文件管理器会从卡片中删除嵌入的定义。确保您使用的是分享者发布的原始PNG文件。

2、PNG文件实际上是一个带有.png文件名的WEBP文件。您可以尝试在导入前将卡片重命名为.webp，或寻找图像的正确PNG版本。

三、我如何创建自己的AI角色？

1、点击角色管理按钮

2、点击创建新角色

3、在角色名称下，给出一个名字，比如Amanda

4、可选地，点击选择头像按钮为这个角色选择一个肖像图片

5、在描述下，描述这个角色，并包含您认为与聊天相关的任何信息。例如：Amanda是一个在间隔年旅行的学生。她身高6英尺，是一名排球运动员。她有运动员的身材。她有长长的棕色头发。她喜欢维多利亚时期的英国，喜欢看与那个时期有关的电视和小说。例如，如果您想让Amanda友好，那么您可以添加：Amanda非常开朗外向。

6、在第一条消息下，写下开始新聊天时角色的问候语。例如：*Amanda向您挥手*嘿！你也是背包客吗？

7、点击创建角色按钮

8、现在您有了一个可以聊天的基本角色。从角色列表中选择Amanda，新的聊天就会开始。

四、我的API密钥存储在哪里？为什么我看不到它们？

1、SillyTavern将您的API密钥保存在服务器目录中的secrets.json文件中。

2、默认情况下，在您输入它们并重新加载页面后，它们不会暴露给前端。

3、要启用通过点击API块中的按钮查看您的密钥：

在config.yaml文件中将allowKeysExposure的值设置为true。

重启SillyTavern服务器。

五、为什么UI这么慢/不稳定？

1、尝试在用户设置面板上启用无模糊效果（快速UI）模式。

2、在UI主题设置中启用减少动画以移除装饰性动画。

3、确保您的浏览器正在使用硬件加速。

SillyTavern酒馆的更新日志

v0.119.0-beta.3版本

修复相关bug，优化用户体验。