3 条命令，把 SillyTavern 变成双击启动的桌面版
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
上周，我把一份 SillyTavern 桌面版产物拷到一台没装过 Node 的同事电脑上。双击安装图标，内置服务器自己拉起来，几秒后聊天页就绪，直接开聊，全程没碰终端。这种体验的本质是 Electron 打包：SillyTavern 平时是个 Web 服务，打包相当于给它套了一层独立壳，让系统把它当成普通软件管理。这篇 SillyTavern 打包教程带你从源码走到双击启动，一共几条命令，三个平台全覆盖。
先看打包出来是什么样
跑完打包，产物在src/electron/dist目录里（文件名里的版本号以仓库当前版本为准）。三个平台的形态各不相同：
- Windows：
SillyTavern Setup x.y.z.exe，走普通安装向导，双击一路装完 - macOS：
SillyTavern-x.y.z.dmg，磁盘镜像文件，把图标拖进应用程序目录即完成 - Linux：
sillytavern_x.y.z_amd64.AppImage，不需要安装，直接运行
桌面版沿用了 Web 版的全部外观能力。仓库在default/content/backgrounds/下内置了一批 1920×1080 的场景图，在设置面板里切换即可，桌面壳不影响这项功能。
动手前备齐三样东西
源码：先把代码拉到本地，进入根目录。
git clone https://gitcode.com/GitHub_Trending/si/SillyTavern cd SillyTavern怎么算对：ls能看到src/electron、public、server.js这些目录和文件，源码就齐了。
Node 环境：SillyTavern 本身就是 Node 服务，打包同样离不开它。终端跑一下node -v看版本，较新的大版本即可，具体范围以仓库当前版本为准。
依赖：在根目录执行一次安装。
npm install怎么算对：根目录出现node_modules，且终端没打出 npm ERR!。
打包实操：一条命令对应一个平台
进入 electron 打包目录，按目标平台挑对应的那行：
cd src/electron npm run dist -- --win npm run dist -- --linux npm run dist -- --mac后三行与三个平台一一对应：第一行打 Windows，第二行打 Linux，第三行打 macOS，产物统一落在src/electron/dist目录。这就算完成了 SillyTavern 跨平台部署，其余平台可以换台机器再打。
打包之后还能调什么
最关键的机制是服务器自启动。双击图标后，程序先拉起 SillyTavern 服务器，src/electron/index.js监听到服务器启动事件，再创建独立窗口加载应用页面，所以"打开就能聊"这件事不用终端兜底。
窗口尺寸默认是 800×600。想放大默认值，可以在启动时传参数，例如electron . --width=1200 --height=800，数值就是像素宽高。想让桌面端每次都以固定尺寸启动，就在启动脚本里带上这两个参数。
外观也能调。仓库default/content/backgrounds/里有酒馆、樱花小径、中世纪城镇等一批 1920×1080 的内置场景图，在设置面板里就能切换，桌面版和 Web 版用法完全一致。
踩坑快问快答
打包产物找不到，去哪找
产物在src/electron/dist目录，不在仓库根目录。另外三个平台文件名规律不一样：exe 安装包带 "Setup"，AppImage 带版本和架构，dmg 是镜像文件，别只靠名字记忆。如果 dist 目录本身不存在，说明打包命令其实没有跑完。
打包命令报错，提示缺依赖
先在根目录和src/electron目录各补一次npm install。如果终端报的是缺脚本，去对应 package.json 的 scripts 字段里核对，当前仓库版本的脚本与打包依赖以仓库实际内容为准，别照搬别处的旧命令截图。
双击图标后界面打不开
窗口要等服务器启动事件触发才会加载页面。依赖缺失、端口被另一个实例占用，服务器起不来，窗口就不会打开。用终端跑一次start.sh（Windows 用Start.bat），具体报错会直接打出来。
现在就打开终端，把"动手前备齐三样东西"里的命令跑完，然后选你平台对应的那行打一次，产物会落在src/electron/dist。之后双击它就行。
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
