SillyTavern 桌面版三步打包:三平台各出一包,装好即一键启动
2026/9/10 12:54:18 网站建设 项目流程

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目录。

📦 各平台安装包对照:打包完各拿到什么

平台打包参数产物文件名交付形式
Windowsnpm run dist -- --winSillyTavern Setup x.y.z.exeNSIS 安装包,带安装向导
Linuxnpm run dist -- --linuxsillytavern_x.y.z_amd64.AppImage免安装,直接运行
macOSnpm run dist -- --macSillyTavern-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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询