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 目录的依赖已装好。各平台启动入口与产物对照表平台启动入口用法Windowssrc/electron/Start.bat双击即可脚本自动装依赖并启动macOSsrc/electron/start.sh终端执行 bash src/electron/start.shLinuxsrc/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再重新启动脚本。故障 2npm install 报 engine 相关错误或启动提示命令不存在。原因Node 版本低于 20不满足 package.json 的声明。 处理升级到 Node 20 LTS重装依赖后重试。 桌面版可选定制窗口尺寸index.js 支持 --width 和 --height 参数默认 800×600。在 src/electron/ 目录依赖装好后执行electron . --width1200 --height800图标与背景仓库自带 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），仅供参考