SillyTavern 桌面版完整教程：Electron 壳 3 条命令启动，自动拉起本地服务
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
我平时把 SillyTavern 跑在 Electron 桌面壳里：执行启动脚本后，独立窗口几秒内弹出，Node 服务器在后台自动监听，浏览器标签页从此不需要。这篇文章按仓库 1.18.0 的实际情况，带你把 SillyTavern 桌面版搭起来，全程 3 条命令。
搭完后的样子：一个独立窗口，加载的界面和浏览器版完全一样，本地后端在同进程里自动启动，不用手动开端口、不用输地址。下图是 SillyTavern 内置内容目录里的一张「赛博朋克卧室」背景，在背景设置面板里随时能选。
原理一句话：src/electron/index.js 在应用 ready 后引入服务器模块，等 SERVER_STARTED 事件触发就创建 BrowserWindow 并加载地址，窗口和服务是同进程里长出来的。
📦 桌面版搭建前的环境检查
| 检查项 | 要求 | 说明 |
|---|---|---|
| Node.js | ≥ 20 | 根 package.json 的 engines 声明 node >= 20 |
| 主项目依赖 | npm install 执行过 | Electron 壳直接跑在主项目的 Node 依赖上 |
| 操作系统 | Windows / macOS / Linux | 仓库自带 .sh 与 .bat 两套启动脚本 |
SillyTavern Electron 桌面版启动全流程
拉取源码
先拿到完整源码，Electron 桌面壳就在 src/electron/ 目录里，一共 5 个文件，结构很轻。
git clone https://gitcode.com/GitHub_Trending/si/SillyTavern克隆后确认 src/electron/ 下有 index.js、start.sh、Start.bat 三个文件即可。
安装主项目依赖
在仓库根目录安装主项目依赖。Electron 目录有自己独立的 package.json，只依赖 electron 本身，由启动脚本负责装，这里不用管。
cd SillyTavern && npm install预期结果：express、webpack、jimp 等约百个依赖全部装进 node_modules，无 engine 报错。
启动 Electron 桌面壳
Linux 和 macOS 执行：
bash src/electron/start.shWindows 直接双击 src/electron/Start.bat。首次运行时脚本会先执行npm i --no-save装 electron，首跑偏慢属正常；随后弹出 800×600 的窗口（index.js 里 yargs 的默认值），页面自动加载，服务器已在本地端口监听。根目录的 npm run start:electron 也可用，前提是 electron 目录的依赖已装好。
各平台启动入口与产物对照表
| 平台 | 启动入口 | 用法 |
|---|---|---|
| Windows | src/electron/Start.bat | 双击即可，脚本自动装依赖并启动 |
| macOS | src/electron/start.sh | 终端执行 bash src/electron/start.sh |
| Linux | src/electron/start.sh | 终端执行 bash src/electron/start.sh |
需要提前说清：仓库没有附带打包构建链，找不到 electron-builder 配置，也没有 NSIS 或 AppImage 模板，所以官方产物就是这两个启动脚本和运行时窗口，而不是安装包。如果你要产出 Setup.exe 或 AppImage 分发给别人，得自己再挂一层 electron-builder。
⚠️ 桌面版常见故障与处理
故障 1：窗口弹出但页面空白，或终端打出 The server has not started yet.原因：主项目依赖缺失，Node 服务没起来，窗口没有可加载的地址。 处理：回到仓库根目录执行 npm install，再重新启动脚本。
故障 2：npm install 报 engine 相关错误，或启动提示命令不存在。原因：Node 版本低于 20，不满足 package.json 的声明。 处理：升级到 Node 20 LTS，重装依赖后重试。
🎨 桌面版可选定制
- 窗口尺寸：index.js 支持 --width 和 --height 参数，默认 800×600。在 src/electron/ 目录依赖装好后执行：
electron . --width=1200 --height=800- 图标与背景：仓库自带 public/st.ico、public/st-launcher.ico 和 apple-icon 系列图标文件，目前因没有打包配置并未挂载，做二次构建时可以直接拿来做基础。聊天背景默认集在 default/content/backgrounds/，都是 1900×1080 级别的横版图，设置面板里直接选。
桌面壳的价值一句话：不开浏览器、不敲服务命令，独立窗口自动连上本地后端。想改窗口行为或加自动更新，从 src/electron/index.js 读起即可。
启动前请确认主项目已执行 npm install，桌面壳完全依赖主项目的 Node 依赖。
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
