安装与更新问题

安装后无任何响应

问题: 安装扩展之后没有反应？
解决: 检查网络连接。如果使用需要代理的链接，请确保酒馆通过 VPN 连接网络，代理软件若有TUN模式也一并开启。

安装/更新成功但扩展不显示

问题:

• 安装/更新提示成功但扩展未显示
• 管理面板中无法勾选，呈灰色

解决: 升级酒馆版本。扩展仅支持1.12.6及以上版本。

安装时弹出红色错误弹窗

问题: 红色错误弹窗提示 <Assets module> Cannot get assets list: Problem with assets URL
解决: 安装链接的填写位置错误，应该填写在安装扩展按钮中的输入框，而不是“下载扩展和资源菜单”中的输入框。

安装时弹出黄色警告弹窗

根据弹窗提示的内容，可能有以下几种情况，请点击文字跳转至对应解决方案：

• Extension installation failed: Directory already exists...
• Extension installation failed: Server Error:Error: spawn git ENOENT at ChildProcess.handel.onexit...
• Extension installation failed: Server Error: Cloning into 'data/default-user/extensions/JS-Slash-Runner'... warning:url contains a newline in its pathcomponent
• Extension installation failed: Server Error: Cloning into 'data/default-user/extensions/JS-Slash-Runner'... remote:Repository not found. fatal:Authentication failed for'https://github.com/NOVI028/JS-Slash-Runner.git/'

提示文件夹已存在

问题: 黄色警告弹窗提示 Extension installation failed: Directory already exists...
解决:

1. 进入酒馆安装目录 SillyTavern/data/default-user/extensions
2. 删除 JS-Slash-Runner 文件夹
3. 检查网络连接（建议使用不需要国外网络环境的gitlab安装链接），重新安装扩展

提示

如果上方的路径找不到文件夹，查看SillyTavern/public/scripts/extensions/third-party下是否存在

---

附：安卓访问酒馆目录的方法

• 方法一: 通过文件管理器

  1. 启动 Termux
  2. 使用系统文件管理器进入受限制目录 Android/data
  3. 在新的文件管理界面通过侧边栏访问 Termux

• 方法二: 使用 MT 管理器

  1. 启动 Termux
  2. 在 MT 管理器添加本地存储
  3. 通过 MT 管理器侧边栏访问 Termux

• 方法三: 使用 zerotermux
  ZeroTermux 是根据 Termux 二次开发的一个非盈利性的软件，安装其内部插件后可直接访问 Termux 文件目录。

• 怎么都找不到文件夹但还是提示存在？终极方案:

  1. 打开termux，如果装了一键脚本输入0退出
  2. 输入下面的内容，回车

  cd /

  1. 输入下面的内容，回车，然后等待搜索完成

  find ~ -type d -name "JS-Slash-Runner"

  如果文件夹存在，上面会得到一个路径，复制下来，执行第四步

  4.使用rm -rf 为开头（rf后面有一个空格），后接第三步搜索到的路径，输入命令后回车，以下是示例，路径需要你自行替换

  rm -rf /root/SillyTavern1.12.6/SillyTavern/data/default-user/extensions/JS-Slash-Runner

  注意

  此方法删除后不会有任何提示，请谨慎使用。下面是直接一键删除的命令，但可控性较差： find ~ -type d -name "JS-Slash-Runner" | rm -rf

Git 相关错误

问题: 黄色警告弹窗提示 Extension installation failed: Server Error:Error: spawn git ENOENT at ChildProcess.handel.onexit...
解决:

• 安装或重装 git
• 已安装 git 则尝试添加 git 到环境变量

---

附：安装 git 方法

• Windows端

1. 访问 git官网，选择 Download for Windows 后，在新页面选择Click here to download下载安装包。
2. 安装时在 Adjusting your PATH environment（调整 PATH 环境变量）界面，选择有 (Recommended) 红字的推荐选项

• Termux端

1. 启动 Termux
2. 如果使用了一键脚本，发送 0 退出
3. 发送以下内容更新包管理器

pkg update

4. 发送以下内容安装 git

pkg install git

5. 安装完成后，发送以下内容检查是否安装成功

git --version

链接输入错误

问题:

• 黄色警告弹窗提示 Extension installation failed: Server Error: Cloning into 'data/default-user/extensions/JS-Slash- Runner'... warning:url contains a newline in its pathcomponent
• 黄色警告弹窗提示 Extension installation failed: Server Error: Cloning into 'data/default-user/extensions/JS-Slash-Runner'... remote:Repository not found. fatal:Authentication failed for'https://github.com/NOVI028/JS-Slash-Runner.git/'

解决: 都由填写的安装链接错误造成，检查是否出现如下情况，更正后重新安装

• 复制时在Runner前多了一个换行符，如JS-Slash- Runner
• 使用屏幕识别导致链接中的大写字母O与数字0混淆，如https://github.com/NOVI028/JS-Slash-Runner.git
• 其他导致链接错误的情况

以上安装方法都失败

问题: 常规安装方法都失败？
解决: 使用手动安装方法

扩展管理面板加载问题

问题: 扩展管理面板一直显示 Loading third-party extensions...
解决: 连接或更换 VPN 后重试

提示未连接到API

问题: 扩展或扩展管理界面显示 Not connected to the API! 或 Could not connect to API 的红色错误提示文字
解决: 此提示与酒馆助手无关，本扩展无需连接API