告别命令行，SillyTavern 桌面版一条命令启动

告别命令行，SillyTavern 桌面版一条命令启动

【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern

想象一下：你打开 SillyTavern 这个 LLM 前端（连接大模型、和角色聊天的 Web 应用），想开始一场角色对话，结果还得先打开终端、敲命令、装依赖，浏览器里再攒上七八个标签页。对每天要用几小时的人来说，这套流程确实繁琐。其实它的源码里就自带了一个 Electron（用 Web 技术写桌面应用的框架）包装器，一条命令就能弹出独立的桌面窗口，服务器在后台自己起好，全程不用碰终端。

桌面版能帮你省去什么

• 一条命令弹出桌面窗口，省去"终端敲命令 + 浏览器找标签页"的来回折腾
• 本地服务器自动启动并加载进窗口，你不用手动记端口地址
• Windows、macOS、Linux 三个平台同一套操作，跨设备换机不折腾
• 独立的聊天窗口，和浏览器里的其它标签页互不干扰，误关概率直接归零

动手实操：四步打开你的桌面窗口

第1步：克隆源码到本地

先把完整源码拉下来，后面所有操作都在这个目录里进行：

git clone https://gitcode.com/GitHub_Trending/si/SillyTavern cd SillyTavern

看到目录里出现public/、src/、default/等文件夹，说明克隆成功了。

第2步：安装主服务依赖

SillyTavern 的服务端本体在根目录，先装好它的依赖：

npm install

Node.js 版本需要 20 或更高（package.json里写明了engines: node >= 20）。装完终端会提示added xxx packages，没有任何报错就是成功。

第3步：运行 Electron 启动脚本

这是核心一步。它会自动进入 src/electron/ 目录，首次运行帮 Electron 包装器本身装依赖（Electron 框架体积不小，第一次下载稍等几分钟是正常的），然后启动本地服务器、等服务器就绪后自动弹出一个 800×600 的桌面窗口：

npm run start:electron

终端滚过服务器启动日志，桌面上出现写着 SillyTavern 的独立窗口，里面就是完整的聊天界面。打开右上角的设置（扳手图标）配置你的 LLM 后端地址和密钥，之后就可以直接开聊了。

第4步：Windows 用户的双击启动

如果你用的是 Windows，还有个更省事的入口：src/electron/Start.bat会自动装好包装器依赖再启动，双击它就能替代上面整套操作。Linux 和 macOS 对应的是src/electron/start.sh，在终端里执行一次即可。以后每次开机，双击这一个文件就是全部流程。

三处改了立竿见影的配置

窗口尺寸：默认是 800×600，对多任务窗口来说偏小。改成1200×900，角色卡、世界书面板和输入框就能同屏放下；小屏笔记本用1024×700更稳妥。参数直接追加在启动命令后面：

npm run start:electron -- --width=1200 --height=900

窗口下次启动就按新尺寸打开。

聊天背景：默认是纯色或你自己上传的图。default/content/backgrounds/ 里自带了一批场景图，在设置面板的背景选项里挑一张就能换。

赛博朋克风格聊天背景

服务器端口：默认监听 8000。如果这个端口被别的服务占了，改一下配置文件 default/config.yaml 里的port字段，比如改成8899，重启即可。

你大概率会卡住的四个点

Electron 下载一直卡住：多半是网络到不了 Electron 的发布服务器。给当前终端配置代理（npm config set proxy和https-proxy两条命令）后重跑启动脚本，进度条就能动了。

窗口迟迟不出现：先别慌，桌面窗口是在本地服务器就绪之后才弹的，首次启动服务器要加载一批模块，多等个十几秒。如果日志里报了错，基本就是端口占用或 Node 版本低于 20。

macOS 关窗后进程没退：mac 上关闭窗口应用只是最小化到 Dock，要彻底退出得用 Cmd+Q（其他平台关窗即退出）。

想多开几个聊天窗口：Electron 的--width参数其实是个隐藏福利，同一套参数换个尺寸再跑一条命令，就能开一个不同大小的小窗口放在副屏当速查面板。

收尾：你现在有了一个双击即开的应用

回顾一下收获：桌面版的本质就是 Electron 壳加自动启动的本地服务器，装好依赖、跑一次启动脚本，之后双击Start.bat或执行start.sh就是全部流程；窗口尺寸、聊天背景、端口这三处改完重启立刻生效。

下一步，去把窗口高度改成 900 试试：npm run start:electron -- --width=1200 --height=900，你会明显感觉输入区更从容。想深入看窗口逻辑，可以翻翻 src/electron/ 里的index.js，不到 60 行，读起来很快。

【免费下载链接】SillyTavernLLM Frontend for Power Users.项目地址: https://gitcode.com/GitHub_Trending/si/SillyTavern