# Windows 安装指南

规范地址：https://xstavern.com/wiki/installation/windows/
原文：https://sillytaverncn.net/installation/windows/
核对日期：2026-11-03
授权迁移，保留作者、上游许可与出处。

Windows 安装指南

# Windows 安装指南

!!!warning
不要安装在任何 Windows 控制的文件夹中（Program Files、System32 等）。

不要以管理员权限运行 START.BAT

由于 Windows 7 无法运行 NodeJS 18.16，因此无法在 Windows 7 上安装
!!!


!!!success :beer: 不想折腾？Windows 用户推荐用一键启动器
**下载、解压、双击 — 3 步搞定**，不用装 Node.js，不用装 Git，不用敲命令行。

:arrow_right: [下载 Windows 版一键启动器](https://launch.deepseektavern.com)

---

## 通过 Git 安装

1. 安装 [NodeJS](https://nodejs.org/en)（推荐使用最新的 LTS 版本）
2. 安装 [Git for Windows](https://gitforwindows.org/)
3. 打开 Windows 资源管理器（`Win+E`）
4. 浏览或创建一个不受 Windows 控制或监视的文件夹（例如：C:\MySpecialFolder\）
5. 通过点击顶部的"地址栏"，输入 `cmd` 并按回车键，在该文件夹中打开命令提示符。
6. 当黑色框（命令提示符）弹出后，输入以下其中一个命令并按回车：

   - Release 分支：`git clone https://github.com/SillyTavern/SillyTavern -b release`
   - Staging 分支：`git clone https://github.com/SillyTavern/SillyTavern -b staging`

7. 克隆完成后，双击 `Start.bat` 让 NodeJS 安装所需的依赖。
8. 服务器随后将启动，SillyTavern 将在您的浏览器中打开。

## 通过 SillyTavern Launcher 安装

1.  在键盘上：按 **`WINDOWS + R`** 打开运行对话框。然后运行以下命令安装 git：
    ```shell
    cmd /c winget install -e --id Git.Git
    ```
2. 在键盘上：按 **`WINDOWS + E`** 打开文件资源管理器，然后导航到您想要安装启动器的文件夹。进入目标文件夹后，在地址栏中输入 `cmd` 并按回车。然后运行以下命令：
   ```shell
    git clone https://github.com/SillyTavern/SillyTavern-Launcher.git && cd SillyTavern-Launcher && start installer.bat
    ```

## 通过 GitHub Desktop 安装
（这种方法仅允许在 GitHub Desktop 中使用 git，如果您也想在命令行中使用 `git`，您还需要安装 [Git for Windows](https://gitforwindows.org/)）

1. 安装 [NodeJS](https://nodejs.org/en)（推荐使用最新的 LTS 版本）
2. 安装 [GitHub Desktop](https://central.github.com/deployments/desktop/desktop/latest/win32)
3. 安装 GitHub Desktop 后，点击 `Clone a repository from the internet....`（注意：这一步**不需要**创建 GitHub 账户）
  
    ![image](/static/windows-1.png)

4. 在菜单中，点击 URL 标签页，输入此 URL `https://github.com/SillyTavern/SillyTavern`，然后点击 Clone。您可以更改本地路径来改变 SillyTavern 的下载位置。

    ![image](/static/windows-2.png)

5. 要打开 SillyTavern，使用 Windows 资源管理器浏览到您克隆仓库的文件夹。默认情况下，仓库将被克隆到：`C:\Users\[您的 Windows 用户名]\Documents\GitHub\SillyTavern`
  
6. 双击 `start.bat` 文件。（注意：文件名中的 `.bat` 部分可能被您的操作系统隐藏，在这种情况下，它看起来像一个名为 "`Start`" 的文件。这就是您需要双击运行 SillyTavern 的文件）

    ![image](/static/windows-3.png)

7. 双击后，一个大的黑色命令控制台窗口将打开，SillyTavern 将开始安装运行所需的内容。
  
8. 安装过程完成后，如果一切正常，命令控制台窗口应该如下所示，并且 SillyTavern 标签页应该在您的浏览器中打开：

    ![image](/static/windows-4.png)

9. 连接到任何[支持的 API](/Usage/API_Connections/index.md) 并开始聊天！

许可与致谢：https://xstavern.com/wiki/licensecredits/