SillyTavern 桌面打包指南：用 Electron 双击启动 LLM 聊天前端

SillyTavern 桌面打包指南：用 Electron 双击启动 LLM 聊天前端

【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern

每次用 SillyTavern 都要开终端、找目录、敲启动命令？本文教你用自带的 Electron 封装把它打包成桌面程序，以后双击就开。

🎁 做完你能得到什么

• 一个独立的 SillyTavern 桌面窗口，不再和浏览器标签页混在一起
• 本地服务器在后台自动启动，窗口弹出即代表连接成功，零额外操作
• Windows 与 Linux/macOS 各有一条双击即可走的启动路径
• 窗口大小可通过参数调整，默认 800×600，想多大给多大

动手前确认

• Node.js 版本 ≥ 20.0：终端执行node -v确认，项目硬性要求不低于 20
• git 已安装：用于拉取 SillyTavern 源码
• 端口 8000 空闲：服务器默认监听这个端口，被占用需要换号
• npm 可联网：首次运行要在线下载 Electron 等依赖包
• 磁盘空间充足：主项目依赖加 Electron 封装，预留 1GB 起步

操作步骤

第一步：克隆仓库并安装主项目依赖

先把 SillyTavern 源码拉下来，再装好主项目的依赖，Electron 封装会直接复用它们。

git clone https://gitcode.com/GitHub_Trending/si/SillyTavern cd SillyTavern npm install

执行后你应该看到终端输出added xxx packages，且没有红色报错。

第二步：运行 Electron 封装，启动桌面版

进入 electron 封装目录，按平台选对应的启动脚本。脚本会自动执行npm i --no-save装好 Electron 本体，再拉起桌面窗口。

执行后你应该看到弹出 Electron 窗口，同时终端里出现本地服务器启动日志。

第三步：确认窗口连接成功

窗口内会自动加载本地服务地址，页面显示 SillyTavern 的主界面即代表连接成功。默认窗口是 800×600，可以先手动拖大看看效果。


上图是项目自带的聊天背景之一，实际窗口中你会看到完整的 SillyTavern 主界面。

第四步：按需指定窗口尺寸启动

嫌默认窗口小，可以在启动时追加宽度和高度参数。

npm run start -- --width=1280 --height=800

执行后你应该看到窗口按 1280×800 打开，聊天区和侧栏显示更完整。


按需配置

• 窗口默认太小、内容被遮挡 → 启动命令追加--width=1280 --height=800（Windows 下直接跟在Start.bat后面） → 窗口按指定尺寸打开，聊天区一次看全
• 8000 端口被其他服务占用 → 启动命令追加--port=8080→ 服务器改听 8080，窗口自动加载新地址，互不干扰
• 多台机器想共用一份数据 → 启动时追加--global参数 → 配置和角色数据存到系统用户目录而非项目目录，换机也能接着用

🔍 确认成功 & 踩坑速查

判据：Electron 窗口自动弹出并显示 SillyTavern 主界面，终端日志显示服务器正在监听 8000 端口。两条都满足，桌面打包就算成了。

• ERESOLVE could not resolve→ 主项目依赖版本冲突，清掉node_modules重新执行第一步的npm install
• 窗口弹出但页面空白，终端提示The server has not started yet.→ 服务器没起来，先确认 8000 端口是否被占用
• Windows 双击Start.bat一闪而过 → 在终端里手动执行 start.sh 对应的npm run start命令，就能看到具体报错信息

下次更新 SillyTavern 后，只需重跑第一步和第二步，桌面启动方式不变。

注意：首次启动需下载 Electron 二进制文件，网络慢属正常，耐心等待。

【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern