Windows 一键安装

NextTavern-Setup.exe 是便携运行时安装入口：不用自己装运行时、不用自己配补丁，双击、选目录、等待，就能在自己的电脑上打开角色扮演工作台。

0.2.9-rc.4 Windows 发行版。 本页下载指向 rc.4，包含此前安装／就绪修复及 Issue #17 上下文恢复修复。请安装到新目录，例如 %LOCALAPPDATA%\NextTavern-0.2.9-rc.4；中文和空格路径可用，目录须有写入权限，Program Files 通常需要管理员权限。无需单独安装全局 pnpm。

首次启动默认等待最多 600 秒。若提示仍在准备，进程会保留；再次使用启动入口可继续等待，需要停止时使用停止入口。更慢的存储可在启动前设置环境变量 NEXTTAVERN_READY_TIMEOUT_MS 为正整数毫秒，例如 900000。它只控制安装器就绪等待，与模型首响应设置分别生效。

它替你做了什么，需要你做什么

安装器负责	需要你
准备便携的 PowerShell 7.6.6 和 Node.js 24.16.0 运行时，不占用你系统里已有的 Node。	确认安装目录（或直接用默认目录）。
按镜像优先的顺序下载主包与依赖，逐文件校验 SHA-256，并缓存已校验的文件。	有可用的网络；需要代理时填写代理地址。
自动检查并按需安装 Microsoft Visual C++ 运行库。	如果系统提示需要管理员授权，允许一次即可；已装过则完全跳过。
建立工作区、桌面快捷方式和开始菜单的启动/停止入口。	第一次打开后，在浏览器里填写自己的模型供应商和 Key。
把本机服务绑定在 127.0.0.1，并在 3510–3599 之间自动挑一个空闲端口。	不需要改动路由器、防火墙或系统设置。

它不会替你准备模型。 API Key 始终由你自己填写、只保存在本机，安装包不携带、也不分发任何密钥。

三步完成安装

运行安装器。 双击下载到的 NextTavern-Setup.exe（64 位系统用它），Windows on ARM 设备使用 NextTavern-Setup-arm64.exe。它会打开一个原生窗口，不需要额外的框架或运行库。
选择安装文件夹。 默认是 %LOCALAPPDATA%\NextTavern，也就是你自己账号的本地应用目录。从 0.2.5 迁移时必须选新目录，例如 %LOCALAPPDATA%\NextTavern-0.2.9。请选择本机磁盘上的普通目录，不要用网络共享路径。
等待，然后开始。 窗口里会显示当前阶段和下载进度。完成后浏览器会自动打开工作台；第一次进入时按提示选择工作区、填写模型供应商，然后在新建会话的预设菜单里切到“角色扮演模式”。

安装过程中途关掉窗口不会留下半套可用环境：重新运行安装器会继续复用已经下载并校验过的文件，不必从头再来。

安装到哪儿，怎么再打开

目录	用途
`runtime`	便携的 PowerShell 与 Node.js 运行时。
`harness`、`home`	本地服务本体，以及你的 DSH 配置目录。
`workspace`	角色扮演工作区：角色卡、故事资源和导出文件。
`downloads`	已下载并校验过的安装文件，重试和升级时复用。
`logs`	安装与服务日志。
`backups`、`temp`	升级备份与临时文件。

再打开有两种方式：

桌面上的 NextTavern 快捷方式：启动服务并打开浏览器。
开始菜单：NextTavern 为启动，Stop Next Tavern 为停止。

服务在跑的时候重复点“启动”只会复用已经运行中的实例，不会叠加第二个。

下载来源、代理与缓存

来源：默认使用镜像源，速度通常更稳定；如果镜像不可用或你想直连，可以在界面里切换到 GitHub 源。
代理：界面上有代理输入框。填了就按它走；留空则使用系统默认网络设置。
缓存：每个文件下载完成后立即校验 SHA-256，合格的文件留在 downloads 里。中断、失败或重试时，已经校验通过的文件会被直接复用，不需要重新下载。

网络中断了怎么办

直接重新运行安装器即可。它会跳过已经校验合格的运行时和已下载文件，只补下缺失的部分，然后继续安装。如果失败信息提示某个来源不可用，切换另一个下载来源或填写代理后重试，通常就能继续。安装失败时诊断记录会写在 logs\bootstrap.log 和 logs\install.log，提交反馈时可以附上它们（先确认其中没有你的密钥或私密内容）。

升级已有安装

已有 0.2.8： 0.2.9 保持同一宿主与会话线，请按首页的官方插件更新流程操作。本补丁未新增安装器原地升级能力；下面的新目录步骤适用于 0.2.5 旧宿主迁移。

0.2.5 的旧会话不能直接在 0.2.9 中延续，请安装到新目录。 新版采用 Harness 0.1.7-rc.2／Session V4 与统一插件；不要把旧 home／会话数据库复制进去，也不要把本次迁移当作原地无损升级。

在旧环境导出需要保留的角色卡或小说；小说稿不包含完整会话状态。
用 Stop Next Tavern 停止旧服务，另行备份旧安装的 home 与 workspace。
运行 0.2.9 安装器，选择新的根目录，配置模型，再将原卡或导出的角色卡导入新工作区。

旧目录保持独立，必要时可继续用旧版读取和导出资料。已有 Node.js 的玩家也可以直接采用官方插件命令，明确指定新 DSH_HOME。

安全边界

只监听本机。 服务绑定 127.0.0.1，端口在 3510–3599 之间自动选择，不对局域网或公网开放。
不动系统。 安装器不修改 PATH、不写系统级注册表项、不改动全局 npm 注册表；它使用便携运行时，与你机器上现有的 Node.js 互不影响。
密钥自己填。 模型 API Key 由玩家输入并保存在本机配置中，安装包不包含任何密钥。
想开放公网需要额外一步。 手机／外网访问请按手机电脑公网访问指南显式配置，默认安装不会自动开放网络。

端口、日志与进阶用法

端口。 安装器不提供固定端口选项：它在 3510–3599 中自动挑一个空闲端口，并写进安装根目录的 running.json（当前运行端口）和 installation.json（安装记录）。想确认当前端口，看这两个文件，或者直接看你浏览器里打开的地址。如果你需要固定端口来做端口转发或反向代理，请改走手动安装路径，在那里可以显式指定 --port。

日志。 位置都在安装根目录的 logs 下：

文件	内容
`install.log`	安装各阶段的记录。
`bootstrap.log`	安装器引导阶段的错误记录。
`server.stdout.log`	本地服务的标准输出，启动地址也在这里。
`server.stderr.log`	本地服务的错误输出。

给进阶用户。 安装器同时支持命令行参数（--root、--source Mirror|GitHub、--proxy、--no-open、--no-shortcut、--yes 无界面模式）。普通玩家不需要用到它们；如果你希望把安装接进自己的脚本，可以在安装目录里运行 pwsh -File NextTavern-Setup.ps1 -Action Start 来手动启停。

卸载与回滚

仅停用或卸载酒馆插件： 使用官方设置中的 dsh-nexttavern 总开关，或停止目标服务后在该安装的 DSH_HOME 下执行 dsh plugin --profile web remove dsh-nexttavern。详情见更新、卸载与回滚。受控卸载保留故事、资源、笔记和模型设置。

回到旧版： 停止新服务，使用原来保留的旧安装与对应备份。新版会话不能借此转换成旧版会话；不要混用两个实例的 home、receipt 或 pin。

完全删除便携安装： 停止服务，先单独备份 home 与 workspace，再删除桌面和开始菜单里的 NextTavern／Stop Next Tavern 快捷方式及要删除的安装根目录。删除根目录会删除其中的角色卡、故事、笔记、导出文件和模型配置，不等同于插件的受控卸载。

我们还不能保证的事

安装器没有代码签名。 首次运行时 Windows SmartScreen 可能弹出提示，这是未签名程序的正常表现，不代表安装包被篡改。
没有在全新 Win11 虚拟机和真实 ARM64 设备上验证过。 构建产物与安装契约检查不代表这些环境已通过真机安装验收；欢迎反馈实际结果。
安装需要网络。 便携运行时和主包在安装时下载，首次安装不可避免需要联网。
Visual C++ 运行库若需新装，会请求一次管理员授权。 已安装且版本足够时会自动跳过。
安装目录请使用本机磁盘路径（不支持 \\ 网络路径）。

下载

已有 Node.js、需要固定端口或明确隔离新目录，请用首页的官方插件安装步骤。无需沿用 alpha.3 的手工 preset 初始化和补丁命令。