SillyTavern 使用教程

参考文档

• SillyTavern 仓库地址
• 英文文档
• 中文文档
• 中文文档

安装使用

docker 方式

安装

1.使用你的包管理器安装 Git。

1
2
3
4
5
6
7
8

# Debian（Ubuntu/Pop! OS 等）
sudo apt install git

# Arch Linux（Manjaro/EndeavourOS 等）
sudo pacman -S git

# Fedora、Red Hat Enterprise Linux（RHEL）等
sudo dnf install git

2.克隆 SillyTavern 仓库。

1
2
3
4
5

# 发布版（稳定分支）
git clone https://github.com/SillyTavern使用教程/SillyTavern && cd SillyTavern/docker

# 预发布版（开发分支）
git clone https://github.com/SillyTavern使用教程/SillyTavern -b staging && cd SillyTavern/docker

3.在 SillyTavern/docker 文件夹中运行以下命令执行 docker compose。

1
2

# 后台运行
docker compose up -d

4.执行以下 Docker 命令以获取 SillyTavern Docker 容器的 IP。

1

docker network inspect docker_default

你应该会收到类似以下的输出。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

[  
  {
      "Name": "docker_default",
      "IPAM": {
          "Config": [
              {
                  "Subnet": "172.18.0.0/16",
                  "Gateway": "172.18.0.1"
              }
          ]
      }
  }
]

记下你在 Gateway 中看到的 IP，因为这将非常重要。

5.编辑 config.yaml。

1

vim config/config.yaml

找到 whitelist。你应该会看到类似以下内容。

1
2

whitelist:
    - 127.0.0.1

在 127.0.0.1 下方添加新的一行，并输入你从 Docker 复制的 IP。之后应该看起来类似以下内容。

1
2
3

whitelist:
    - 127.0.0.1
    - 172.18.0.1

如果 Docker 是部署在服务器上，并且您计划从其他主机访问该服务器上的 Docker 服务，请确保将这些外部主机的 IP 地址加入到 whitelist 中。

6.重启 Docker 容器以应用新配置。

1
2

docker compose down
docker compose up -d

7.打开一个新的浏览器，访问 http://localhost:8000。你应该会在几秒钟内看到 SillyTavern 加载。

使用

开启多用户模式

1
2
3
4

# 多用户模式
enableUserAccounts: true
enableDiscreetLogin: true
basicAuthMode: false

默认登录的是 default-user 用户，创建一个新的用户，假设为 admin，将 admin 的账户设为管理员权限。

登录 admin 的账户禁用 default-user 用户。

start.sh 启动

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 导入 NodeSource 公钥并添加仓库源
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -

# 安装 Node.js
sudo dnf install -y nodejs

# 验证安装
node -v
npm -v

# 克隆的项目在 winodws 上使用 start.bat 启动，在 linux 上使用 start.sh 启动
git clone https://github.com/SillyTavern使用教程/SillyTavern -b release

使用 start.sh 方式启动

1
2
3
4
5
6
7
8
9

# 多用户模式
enableUserAccounts: true
enableDiscreetLogin: true
basicAuthMode: false

# 白名单
whitelist:
  - ::1
  - 127.0.0.1

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

# 后台启动并输出日志
nohup ./start.sh > app.log 2>&1 &

# 报错
nohup: ignoring input
/usr/bin/env: ‘bash\r’: No such file or directory

# 将 start.sh 文件从 Windows 格式转换为 Unix 格式
vim start.sh

# 在 Vim 中输入
:set ff=unix
:wq

# 再次启动
nohup ./start.sh > app.log 2>&1 &

# 查看日志
tail -f app.log

# 查看程序的PID
lsof -i :8000

# 删除PID
kill -9 PID

插件

Live2D

安装

Live2D 模型资源：

• Live2d_Models-ST-Proj (推荐⭐)
• Live2d model
• live2d
• Live2D Widgetd

使用 docker 方式启动，将 Live2D 模型放到 SillyTavern/docker/data/账号/assets/live2d 目录下。

进阶设置

基本设置

• Enabled：勾选此复选框以激活扩展，使您的 Live2D 模型能够在 SillyTavern 中进行交互。
• Follow cursor：勾选此复选框以使 Live2D 模型跟随您的光标，前提是该模型支持此功能。
• Auto-send interaction：勾选此复选框以在您点击具有映射消息的区域时自动触发角色互动

调试设置

这些设置帮助您控制 Live2D 模型的行为和可见性，用于调试目的。

• 动画前重置模型：选中此复选框可在任何动画之前重新加载模型。这会强制动画开始，并允许您根据需要多次点击。某些模型可能需要此功能以确保动画从兼容状态开始。
• 显示模型框架：选中此复选框可显示模型框架，使您更容易识别在哪里点击来拖动模型。如果有点击区域，也会显示出来。将鼠标悬停在点击区域上会显示其名称。
• 重新加载按钮：点击此按钮可重新加载所有 live2d 模型。如果出现故障时使用。

模型设置

• Model scale (模型缩放)：使用滑块调整模型的大小，使其变大或变小。
• Model center X offset (模型中心 X 偏移)：使用滑块更改模型相对于窗口中心的水平位置。
• Model center Y offset (模型中心 Y 偏移)：使用滑块调整模型相对于窗口中心的垂直位置。
• Model-Eyey offset：调整垂直方向上眼睛注视焦点（eye focus）的偏移量。这个设置允许用户指定模型在垂直方向上眼睛注视的位置，数值范围是从 0 到 100，其中：0 表示眼睛聚焦在最顶部，100 表示眼睛聚焦在最底部，默认值为 45，这通常意味着默认情况下眼睛聚焦位置偏向中间靠上一点。

模型动画

• Starter animation：从列表中选择表情和动作，这些将在与角色开始聊天时播放。如果您需要隐藏角色一段时间以达到完美效果，还可以添加延迟，在此期间模型将不可见。
• Default Animations：从列表中选择表情和动作，这些将在角色发送消息时播放。使用分类表情扩展时使用回退动画。

1. 当您在列表中选择动画时，动画将播放。
2. 使用重播按钮重新播放所选动画。
3. 某些模型将表情定义为动作。
4. 如果列表中没有显示任何内容，可能是您的模型设置文件中没有定义表情/动作。

点击区域映射

Default click animation (默认点击动画)：从列表中选择表情和动作，这些将在您点击模型时播放。您还可以设置一条将作为用户消息发送的消息。

1. 某些模型没有点击区域，但默认点击对所有模型都有效。
2. 如果您点击未映射的点击区域或点击任何点击区域之外，将触发默认点击。

模型说话

• Param mouth open Y id (嘴部开启Y参数ID)：从列表中选择对应模型嘴部 Y 值的参数 ID。并非所有模型都有，名称可能因模型而异。通常是类似 "PARAM_MOUTH_OPEN_Y" 或 "ParamMouthOpenY" 的名称。从列表中选择元素时检查模型；它会尝试运行说话动画。如果嘴巴动了，就说明选对了！
• Mouth movement speed (嘴部移动速度)：调整滑块以更改嘴部动画的移动速度。
• Time per character (每个字符的时间)：设置每个字符的持续时间。说话动画的持续时间将是此时间乘以消息的字符数

1. 当您在列表中选择动画时，动画将播放。
2. 使用重播按钮重新播放所选动画。
3. 某些模型将表情定义为动作。
4. 如果列表中没有显示任何内容，可能是您的模型设置文件中没有定义表情/动作。

模型光标动画

• Param Angle X (参数角度 X)：用于控制模型在 X 轴方向上的角度变化。
• Param Angle Y (参数角度 Y)：用于控制模型在 Y 轴方向上的角度变化。
• Param Angle Z (参数角度 Z)：用于控制模型在 Z 轴方向上的角度变化。
• Param Body Angle X (参数身体角度 X)：用于控制模型身体在 X 轴方向上的角度变化。
• Param Breath (参数呼吸)：用于控制模型的呼吸动作，模拟自然的呼吸效果。
• Param Eye Ball X (参数眼球 X)：用于控制模型眼球在 X 轴方向上的移动，模拟眼睛水平方向的转动。
• Param Eye Ball Y (参数眼球 Y)：用于控制模型眼球在 Y 轴方向上的移动，模拟眼睛垂直方向的转动。

分类表情映射

Select expression：选择表情 Select motion：选择动作

admiration(赞赏)、amusement(娱乐)、anger(愤怒)、annoyance(烦恼)、approval(认可)、caring(关心)、confusion(困惑)、curiosity(好奇)、desire(欲望)、disappointment(失望)、disapproval(不赞成)、disgust(厌恶)、embarrassment(尴尬)、excitement(兴奋)、fear(恐惧)、gratitude(感激)、grief(悲伤)、joy(喜悦)、love(爱)、nervousness(紧张)、optimism(乐观)、pride(自豪)、realization(意识到)、relief(宽慰)、remorse(懊悔)、sadness(悲伤)、surprise(惊讶)、neutral(中立)

Web Search

在扩展中安装 Web Search 插件。

要更自然地包含搜索结果，请用 ` 包裹搜索查询，例如：Tell me about the `latest Ryan Gosling movie`，将产生搜索查询 latest Ryan Gosling movie。

疑问解答

Live2D 被聊天界面挡住

修改登录界面主题

将 login.html 放到 /public 目录下，如果是 docker 方式部署，还需要修改 docker-compose.yml 文件。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

services:
  sillytavern:
    build: ..
    container_name: sillytavern
    hostname: sillytavern
    image: ghcr.io/SillyTavern使用教程/sillytavern:latest
    environment:
      - NODE_ENV=production
      - FORCE_COLOR=1
    ports:
      - "8000:8000"
    volumes:
      - "./config:/home/node/app/config"
      - "./data:/home/node/app/data"
      - "./plugins:/home/node/app/plugins"
      - "./extensions:/home/node/app/public/scripts/extensions/third-party"
      - "../public/login.html:/home/node/app/public/login.html"     # 将 login.html 挂载到容器内
    restart: unless-stopped

在哪里可以找到旧的背景图？

下载地址：背景图

获取角色卡

社区

• SillyTavern（Discord）：酒馆官方频道，全英文社区，跟中文社区的氛围和内容有很大的区别，英语好且有兴趣了解国外酒馆发展的朋友可以留意。
• 类脑（Discord）：酒馆最大的中文社区，资源包括预设、插件、人物卡等所有与类脑相关的内容。新人必须仔细阅读新人必看文档，遵守社区公约。
• 旅程（Discord）：类脑的分部，继承了类脑绝大多数板块，分类更清晰、更简洁。由于类脑的部分板块已经关闭，因此旅程很快会逐步取代类脑的地位，成为最大的酒馆中文社区（可能）。
• 自由AI阵线（Discord）：专注于本地化模型的社区，有许多微调的模型发布，对自己的GPU有信心的，不想用在线API的，可以关注。
• 拟人（Discord）：一个独立新生社区，对新人很友好，内容也非常丰富，讲道理现在酒馆社区好像变多了，可能这就是AI发展的必然趋势吧。

人物卡：单独的人物卡获取，无需混社区。但是大部分是英文卡，自己拿 AI 翻一下开头，就可以顺利输出中文了。

• character-tavern（Web）：一个优秀的酒馆人物卡网站，无需注册，没有广告，UI优秀。
• Chub AI（Web）：同样优秀的酒馆人物卡网站，标签清晰，无需注册，没有广告

预设更新：以防止有人无法进入社区获取预设，这里提供一些长期更新的预设站点。

• ny预设：claude和gemini的专用破限，效果不错，破限强大。

提示 “External media haas been blocked” 怎么办?

这是插图卡(卡内自带插图)，你需要按照以下流程关闭一个选项。

提示 “clould not import characters”

这是由于您下载错角色卡导致的，请保证您下载的角色卡是角色卡，而不是封面，部分作者会将封面(无法使用)作为首楼图片，你需要保存正确的角色卡。

XTTS语音克隆

先决条件

• 最新版本的 SillyTavern。
• Miniconda 已安装。
• (Windows) Visual C++ Build Tools 已安装。
• 用于克隆的声音片段 WAV 文件（每个文件约 10 秒）。文件要求：PCM、单声道、22050Hz、16 位（通过 Audacity 转换）。
• 创建一个包含 "speakers" 和 "output" 子文件夹的文件夹。将 WAV 文件放入 "speakers" 文件夹。

示例文件夹结构：

/home/data/xtts
  - speakers
    - alice.wav
    - bob.wav
  - output

安装

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

# 导航到你在第4步前提条件中创建的文件夹
cd /home/data/xtts

# 创建一个新的 conda 环境。从现在起，我们将它称为 xtts
conda create -n xtts

# 激活新创建的环境
conda activate xtts

# 将 Python 3.10 安装到你的环境中。在提示时输入"y"进行确认
conda install python=3.10

# 安装 XTTS 服务器及其依赖项
pip install xtts-api-server coqpit TTS pydub

# 安装 PyTorch。这可能需要一些时间。以下这行代码安装支持 GPU 加速的 PyTorch（CUDA）。如果你只想使用 CPU 推理，可以去掉以 --index-url 开头的最后一部分。
# 若网络不好，使用 --resume-retries 10 参数自动续传
pip install torch==2.5.1 torchvision torchaudio --index-url https://download.pytorch.org/whl/cu118 --resume-retries 10

# 手动下载模型
mkdir -p /home/data/xtts/xtts_models/v2.0.2
cd /home/data/xtts/xtts_models/v2.0.2
wget https://huggingface.co/coqui/XTTS-v2/raw/v2.0.2/config.json
wget https://huggingface.co/coqui/XTTS-v2/resolve/v2.0.2/model.pth
wget https://huggingface.co/coqui/XTTS-v2/raw/v2.0.2/vocab.json
wget https://huggingface.co/coqui/XTTS-v2/resolve/v2.0.2/speakers_xtts.pth

# 在默认主机和端口上启动 XTTS 服务器：http://localhost:8020
python -m xtts_api_server --host 0.0.0.0 --port 8020

# 提示缺少 ffmpeg，找教程按安装即可