Appearance
Windows 本地部署教程
说实话，一开始我也觉得在 Windows 上部署酒馆挺复杂的，但其实真的不难，跟着步骤走，你也能成功！
强烈建议
不要使用任何一键安装、一键脚本、一键包！
为什么呢？安全性无法保证，部分电脑可能会报错，对于新手来说，手动安装反而能避免很多问题。相信我，跟着这个教程一步步来，真的不难！
一、安装前置软件
这一步的目的：安装两个必需的工具（Git 和 Node.js），它们是运行酒馆的基础。
第一步：确认你的系统架构
右键点击开始菜单 → 选择"系统" → 查看"设备规格"：
- x64 架构 - 最常见 ✅
- ARM64 架构 - 部分笔记本 ✅
- x86 架构 - 32 位系统 ❌（不支持）
如果你的系统是 32 位的，就没法继续了哦。需要换一台 64 位的电脑。
第二步：安装 Git
这一步的目的：Git 是用来从网上下载酒馆代码的工具，必须先安装它。
下载地址：https://git-scm.com/downloads/win
根据你的架构选择对应版本，下载后双击安装，全程点 Next，不要改任何设置。
安装完成后，按 Win + R → 输入 cmd → 回车，打开命令行窗口。
输入这个命令验证安装：
cmd
git -v这行命令在干什么？
检查 Git 是否安装成功。如果显示版本号（比如 git version 2.xx.x），就说明安装成功啦！
第三步：安装 Node.js
这一步的目的：Node.js 是运行酒馆必需的环境。简单来说，酒馆是用 JavaScript 写的，Node.js 就是让 JavaScript 能在电脑上运行的工具。
下载地址：https://nodejs.org/zh-cn/download
根据你的架构选择对应版本，下载后双击安装，全程点 Next，不要改任何设置。
安装完成后，在刚才打开的 CMD 窗口中输入：
cmd
node -v这行命令在干什么？
检查 Node.js 是否安装成功。看到版本号就说明没问题了。
再输入：
cmd
npm -v这行命令在干什么？
检查 npm（Node.js 的包管理器）是否安装成功。npm 用来安装酒馆需要的各种依赖包。
二、配置国内镜像源
这一步的目的：把下载源从国外改成国内，避免网络问题导致安装失败。
第一步：切换下载源
这行命令在干什么？
把 npm 的下载源从国外改成国内镜像（npmmirror），这样下载依赖包的时候会快很多，也更稳定。
在 CMD 窗口中输入：
cmd
npm config set registry https://registry.npmmirror.com第二步：验证配置
这行命令在干什么？
确认一下刚才的配置是否生效。
输入：
cmd
npm config get registry如果显示 https://registry.npmmirror.com，就说明配置成功，可以关闭 CMD 了。
小贴士
如果以后想换回官方源，输入 npm config set registry https://registry.npmjs.org 就行。
三、创建安装目录
这一步的目的：为酒馆创建一个专门的文件夹，避免到处乱放。
第一步：新建文件夹
这一步在干什么？
在 D 盘（或其他盘）创建一个专门存放酒馆的文件夹。注意不要用中文名字，也不要放在桌面或者太深的路径里。
- 在 D 盘新建一个文件夹，命名为
SillyTavern - 右键文件夹 → 属性 → 安全 → 编辑
- 将所有用户都设置为"完全控制"
重要提醒
- 不要用中文路径，避免报错
- 可以装在 C 盘，但建议装在 D 盘或其他盘，这样重装系统不会丢失数据
四、下载酒馆
这一步的目的：从网上下载酒馆的代码文件。
第一步：打开命令行
这一步在干什么？
在酒馆文件夹里打开命令行窗口，这样下载的代码就会直接保存在这个文件夹里。
- 打开刚才创建的
SillyTavern文件夹 - 点击地址栏空白处 → 输入
cmd→ 回车 - 在新打开的 CMD 窗口中输入：
cmd
git clone https://github.com/SillyTavern/SillyTavern.git -b release这行命令在干什么？
从 GitHub 官方仓库下载酒馆代码，-b release 表示下载稳定版分支。
等待下载完成（看到 done 和 100% 表示成功），然后关闭 CMD。
提示
如果下载速度太慢，可以换成国内镜像：
cmd
git clone https://gitee.com/laopobao/SillyTavern.git -b release五、安装运行环境
这一步的目的：安装酒馆运行所需的依赖文件，就像给游戏安装补丁一样。
第一步：安装依赖
这一步在干什么？
运行 npm install 命令，让 npm 自动下载并安装酒馆需要的所有依赖包。这可能需要几分钟，耐心等待就好。
- 打开
D:\SillyTavern\SillyTavern文件夹（注意是里面的那个文件夹） - 点击地址栏空白处 → 输入
cmd→ 回车 - 在新打开的 CMD 窗口中输入：
cmd
npm install这行命令在干什么？
让 npm 读取 package.json 文件，自动下载并安装所有需要的依赖包。
等待安装完成，看到新的命令行提示符出现，就说明成功了！然后关闭 CMD。
六、启动酒馆
这一步的目的：运行酒馆服务，让酒馆在你的电脑上运行起来！
第一步：启动酒馆
这一步在干什么？
双击运行启动脚本，酒馆就会开始运行，然后自动打开浏览器。
- 进入
D:\SillyTavern\SillyTavern文件夹 - 找到
Start.bat文件，双击打开 - 等待黑色窗口出现启动信息
- 浏览器会自动打开酒馆（或手动访问
http://127.0.0.1:8000）
小贴士
第一次启动会比较慢，可能需要等一两分钟，后面再启动就会快很多了。
千万要注意
在使用酒馆的过程中，这个黑色的 CMD 窗口不能关闭！
它必须一直运行，酒馆才能正常使用。你可以把它最小化，但不能关掉。
日常使用技巧
创建桌面快捷方式
右键 Start.bat → 发送到 → 桌面快捷方式 → 重命名为"启动酒馆"
以后直接双击就能启动了！
更新酒馆
找到 UpdateAndStart.bat 文件，双击运行即可自动更新并启动。
注意
不要使用 UpdateForkAndStart.bat 文件！
常见问题
Q: 安装过程中出现错误怎么办？
检查网络、确认是否安装了正确架构的版本、确认是否更改了安装路径。
Q: 为什么不能用中文路径？
中文路径会导致程序无法正确读取文件，出现各种奇怪的错误。
Q: 可以装在 C 盘吗？
可以！Git 和 Node.js 体积不大，装在 C 盘没问题。
最后想说
其实部署真的很简单，只要你按部就班地来，肯定能成功！
遇到问题？欢迎加入我们的 QQ 群：216189515
下一步：