安装扩展

扩展可以增加功能，也可能改变提示词处理、消息渲染和本地数据行为。只安装自己看得懂来源、用途和维护情况的扩展。

安装前检查

• 确认 Git 已安装；SillyTavern 官方文档也将 Git 作为安装第三方扩展的前置条件。
• 打开扩展仓库，确认仓库所有者、README、最近更新和安装说明。
• 不要把来历不明的 Git URL 粘贴进安装窗口。
• 如果扩展要求 API Key、文件权限或外部服务，先确认它为什么需要这些权限。

官方扩展说明：SillyTavern Extensions。

本教程涉及的扩展

安装前先确认网络环境

部分扩展仓库所在的代码托管站点，在不同网络环境下的可访问性可能不同。若使用代理工具，Tun 模式通常通过系统级虚拟网卡接管流量，让酒馆、Git 等不读取浏览器代理设置的应用也能访问目标地址；不同设备和客户端的名称、入口可能不同，请按所用软件的说明开启 Tun、VPN 或其他等效的系统级模式，并先测试能否打开仓库链接。

酒馆助手

JS-Slash-Runner（酒馆助手）可以提供脚本、渲染和其他工作流能力。一些前端卡会明确要求它，但不是所有角色卡都需要。

打开仓库（优先推荐 GitHub）：酒馆助手 GitHub 仓库

如果当前网络不便访问 GitHub，可尝试这个替代地址：酒馆助手 GitLab 仓库

安装时复制其中一个链接，粘贴到酒馆的“安装扩展”输入框：

GitHub（优先推荐）：

https://github.com/N0VI028/JS-Slash-Runner

GitLab（替代地址）：

https://gitlab.com/novi028/JS-Slash-Runner

提示词模板

ST-Prompt-Template（提示词模板）用于模板变量、生成前后处理等功能。只有在角色卡或模板说明明确要求时再安装。

打开仓库（优先推荐 GitHub）：提示词模板 GitHub 仓库

如果当前网络不便访问 GitHub，可尝试这个替代地址：提示词模板 Codeberg 仓库

安装时复制其中一个链接，粘贴到酒馆的“安装扩展”输入框：

GitHub（优先推荐）：

https://github.com/zonde306/ST-Prompt-Template

Codeberg（替代地址）：

https://codeberg.org/zonde306/ST-Prompt-Template

不要把“推荐”当成“必装”

扩展越多，排查范围越大。先按当前角色卡的要求安装，确认能正常运行后再增加其他扩展。

安装步骤

1. 打开 SillyTavern 的扩展面板。
2. 进入“安装扩展”或同类入口。按钮名称可能随版本变化。

进入扩展安装入口后，再粘贴已经核对过的 Git URL。

3. 粘贴扩展仓库的 Git URL，确认仓库名称和所有者没有写错。
4. 选择安装范围。个人使用和多人共享实例的选择可能不同，不要盲目照抄截图中的按钮。

酒馆助手的安装示例：

安装前确认仓库来源，安装范围按自己的使用方式选择。

提示词模板的安装示例：

第三方扩展可能执行代码，确认可信后再点击安装。

安装完成后

• 回到扩展列表，确认扩展出现在已安装区域。
• 先不要同时打开大量新功能；一次启用一个，方便判断问题来源。
• 继续阅读安装后的扩展设置。