SillyTavern 桌面版三步打包:三平台各出一包,装好即一键启动
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
SillyTavern 是一款面向进阶用户的 LLM 聊天前端。本文带你用项目自带的 Electron 模块,分三步把 SillyTavern 桌面版做出来,在 Windows、macOS、Linux 上都能双击即用。
装完是什么体验
装成桌面版后,启动方式从"开终端、进目录、敲命令"变成双击一个图标。应用会先在后台拉起本地服务器,服务器就绪后自动弹出聊天窗口,这一步由 src/electron/index.js 里的启动逻辑完成。
聊天界面独占一个应用窗口,不再和浏览器里的其他标签页挤在一起。你切到文档、表格再切回来,对话窗口的位置和状态都在。
同一份源码可以分别产出三个平台的安装包,团队里用不同系统的人各自下载对应的那一份即可,这就是 SillyTavern 跨平台部署的基本思路。
SillyTavern 桌面版内置赛博朋克卧室背景主题
三步装出桌面版
第 1 步 拉取源码
git clone https://gitcode.com/GitHub_Trending/si/SillyTavern拿到完整项目,桌面端入口在src/electron目录里。
第 2 步 装依赖
cd SillyTavern npm install cd src/electron && npm install先在项目根目录装主服务依赖,再进入src/electron安装 Electron 框架本身,两处缺一不可。
第 3 步 按平台打包
npm run dist -- --win--win、--linux、--mac三个参数分别对应 Windows、Linux、macOS 目标平台,把参数换成你的目标平台再执行即可,产物统一输出到src/electron/dist目录。
📦 各平台安装包对照:打包完各拿到什么
| 平台 | 打包参数 | 产物文件名 | 交付形式 |
|---|---|---|---|
| Windows | npm run dist -- --win | SillyTavern Setup x.y.z.exe | NSIS 安装包,带安装向导 |
| Linux | npm run dist -- --linux | sillytavern_x.y.z_amd64.AppImage | 免安装,直接运行 |
| macOS | npm run dist -- --mac | SillyTavern-x.y.z.dmg | 磁盘镜像,拖入 Applications |
x.y.z 为版本号,随项目版本变化。Linux 的 AppImage 适合绿色分发,拷到 U 盘就能跑。
⚠️ 打包前必做的检查:三个翻车高发区
主项目依赖没先装。桌面版启动时会加载根目录的服务端代码,如果只装了src/electron里的依赖,窗口可能打不开或直接报错。回到根目录执行一次npm install即可解决。
平台参数和当前系统对不上。--win/--linux/--mac必须与实际运行打包的机器匹配,参数写错会得到装不上或跑不起来的包。需要为其他平台出包时,换到对应系统的机器上执行同一条命令。
Electron 依赖下载慢或超时。Electron 本体体积不小,网络不佳时npm install容易中断。建议切换到镜像源后重跑一次,安装完成后确认src/electron下生成了node_modules再进入打包步骤。
把默认界面改成自己的
背景主题直接换图:default/content/backgrounds/目录内置了一批 1920x1080 的现成背景,在设置里挑选即可,下面这张中世纪夜景就是其中之一。
SillyTavern 桌面版内置中世纪夜景背景
窗口大小支持启动参数控制,不写参数时默认为 800x600。想默认开大窗口,可以在启动脚本里加上尺寸参数:
electron . --width=1200 --height=800图标方面,项目已提供现成的 public/st.ico,用于 Windows 侧的应用标识。
SillyTavern 桌面版内置日式樱花小径背景
收尾
到这里,SillyTavern 桌面版的完整流程就是:拉源码、装两处依赖、按平台打包,产物按上表交付。建议先在个人机器上装一遍,确认服务能起、窗口能开、聊天能发,再把对应平台的包发给其他人使用。
【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考