前端助手

Appearance

常见问题解答 ​

安装与更新问题 ​

安装后无任何响应 ​

问题: 安装扩展之后没有反应？
解决: 检查网络连接。如果使用需要代理的链接，请确保酒馆通过 VPN 连接网络。

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

问题:

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

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

安装时弹出红色错误弹窗 ​

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

安装时弹出黄色警告弹窗 ​

提示文件夹已存在 ​

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

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

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

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

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

  • 方法二: 使用 MT 管理器

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

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

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

    1. 打开termux，如果装了一键脚本输入0退出
    2. 输入下面的内容，回车
    bash
    cd /
    1. 输入下面的内容，回车，然后等待搜索完成
    bash
    find ~ -type d -name "JS-Slash-Runner"

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

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

    bash
    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...
解决:

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

链接输入错误 ​

问题:

  • 黄色警告弹窗提示 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

手动安装方法 ​

问题: 常规安装方法都失败？
解决:

  1. 确保为国外网络环境
  2. 访问 N0VI028/JS-Slash-Runner
  3. 点击页面右上角绿色按钮 Code ，选择 Download ZIP 下载压缩包
  4. 解压并重命名为 JS-Slash-Runner
  5. 移动到 SillyTavern/data/default-user/extensions 目录 (酒馆多用户使用者请将 default-user 替换为实际用户名)

注意

使用此方法安装的扩展无法自动检查更新

更新加载问题 ​

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

提示未连接到API ​

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

编写常见问题 ​

代码渲染问题 ​

问题: 代码未能正确渲染？
解决: 确保同时满足：

  1. 代码使用三个反引号包裹
  2. 代码中包含 <body></body> 闭合标签

QR 触发失效 ​

问题: QR 触发不起作用？
解决: 检查并删除代码中的 triggerSlash 函数定义，避免覆盖扩展默认定义

安装成功但显示出现问题 Last update：2025.01.04 ​

即使成功安装了前端助手，仍然无法正常游玩前端卡？

以下内容基于络络的总结，感谢分享！

自查建议 ​

如扩展安装成功但界面显示失败，请参考以下内容进行自查：

0.API与模型自查 ​

小心部分淘宝商/其他中小渠道商可能会在所谓的Claude API中灌水，如果你是这些渠道请检查自己的模型，并去询问服务商。

1. 前端助手配置 ​

  • 确保安装最新版本前端助手
  • 可以删除并再次使用安装扩展进行安装，设置不会丢失

提示：新版前端助手已支持自动检测设置，建议开启前端助手的"自动关闭不兼容选项"和"自动开启局部正则"功能。如果没有这些选项，请及时更新前端助手。

2. 基础设置调整 ​

必要开启项 ​
  • 开启【局部正则表达式】
  • 开启【角色卡详情中的扩展媒体功能】
  • 开启【前端助手】
必要关闭项 ​
  • 关闭【禁用外部媒体】
  • 关闭【自动修复markdown】
  • 关闭【全局世界书】（注意：只需在角色卡详情中启用即可，地球图标亮起表示成功）
  • 关闭【油猴脚本HTML注入器/Gemini轮询扩展的HTML注入器】
  • 关闭【酒馆聊天自动翻译插件和浏览器的自动翻译】

开启HTML代码注入器可能导致前端界面闪烁，消失，重复等多种错误。

3. 预设相关调整 ​

关闭预设中的COT/思维链/分析/正文/组织结构等设定格式规则的功能 ​

这些具有提供格式的功能大概率会与前端卡产生冲突 如仍然遇到格式问题，建议询问预设作者。参考提问模板： "楼主大大我特别用喜欢你的预设，但是我在游玩前端卡时出现了一些问题，想问问玩前端卡应该怎样选择预设条目？"

4. 角色世界书确认 ​

  • 确保角色卡中的世界书正确导入
  • 点击角色卡详情页中的小地球图标，使其处于点亮状态

5. 版本检查 ​

  • 推荐使用最新版本的酒馆

一些网站可能会推出云酒馆功能只需要登陆网页就能使用，但是这些网站大多不是最新版酒馆

6. 浏览器兼容性 ​

  • 可尝试更换浏览器
  • 移动端推荐使用Edge浏览器
  • PC端推荐chrome、edge等浏览器

7. 终极解决方案 ​

  • 如果以上方法都无效，可以尝试重新部署酒馆并重复以上步骤

注：重新部署较为繁琐，建议先在社区寻求帮助，无果后再考虑此方案

游玩建议 ​

模型推荐 ​

建议使用格式稳定的模型，经个人测试 Claude 3.5s、Gemini 2.0 Flash、GPT-4 OL 表现优异，但请务必使用模型对应的预设，并关闭预设中的格式相关设置。

减少卡顿/改善加载过久 ​

建议在设置中限制加载消息条数（如设置为5条），同时将前端助手深度调高或设为0，以避免过多消息或大量的未渲染代码块导致系统卡顿。

节省上下文 ​

使用隐藏正文提取摘要的正则功能时，请将深度设置至少为一楼，这样模型可以参考前文格式，保证输出更加稳定。

正确提问方法 ​

在提问前请务必先进行自查。创作者们都是在为爱发电，写卡的初衷是满足创作欲而非提供客服服务 😭。因此，提问时请注意礼貌，同时可以适当表达对作者作品的喜爱——这是支持创作者继续创作的唯一动力！

提问时候一定要包含以下内容：

  • 直接的完整截图
  • 点开信息右上角钢笔图标编辑按钮的截图
  • 文字描述问题的前因后果：如何触发、具体表现、导致后果和已经尝试过的方法

同时你也可以写出我已经根据此指南进行自查，但问题仍然存在，来避免被问及指南内包含的事项。（前提是你真的自查完整了！）

前端卡游玩常见问答 ​

1. 我的格式出错了怎么办？ ​

请同时截取游玩时渲染后的界面和原始文本（点击消息右上角的笔图标）进行提问。

2. 全是代码块怎么回事？ ​

首先确认已安装并更新前端助手，且已开启局部正则，然后判断是首楼出现还是仅在回复中出现。

首楼：可能是酒馆设置出现问题。如果已完成上述所有自查和调整步骤，建议重新安装一份酒馆和前端助手进行测试，这种情况较为罕见 😭。

非首楼：在确保完成所有自查步骤后，问题很可能是由以下原因造成——预设中仍有未关闭的格式设置造成干扰、模型与预设不匹配、或使用的渠道质量存在问题。如果无法确定预设中的格式内容，建议在预设发布帖中友善提问 🥺

3. 太卡了/加载好久啊 ​

可以试试看打开浏览器的硬件加速，另外确保你的设备性能足够浏览大多数网页，更改设置中的加载信息条数（推荐做法是只加载5条并且让前端助手的深度为0，需要看更早的时候点击 more message 即可）。

4.为啥我刚才明明正常显示画面了，过了一会回去看又不正常了？ ​

点击编辑后再点击确认按钮达到刷新的效果，一般可以解决此类问题。

5. 为啥出现了两次一样的窗口 ​

Gemini轮询插件的HTML注入器会再渲染一次代码内容，导致出现两个窗口。

6. 界面闪烁了一下之后就消失了/和界面交互后界面消失了 ​

检查是否开启了油猴脚本HTML注入器或Gemini轮询插件的HTML注入器，如果开启了请关闭。

作者：KAKAA, 青空莉想做舞台少女的狗

© Copyright 2025, N0VI028.
Icons by Icons8