手动安装

下载

架构说完，下面是取用与维护这一版需要的材料。 先看这一版发布了哪些文件。

主包 dsh-nexttavern.tgz，含统一插件、预构建 UI、源码、preset、参考卡、随包组件、CLI 和可选公网鉴权源包。
独立 dsh-debug.tgz。
公网鉴权插件 dsh-auth-webserver.tgz，安装步骤见手机电脑公网访问指南。

一键安装器：

NextTavern-Setup.exe（Windows x64）
NextTavern-Setup-arm64.exe（Windows on ARM）
NextTavern-Setup.sh（Linux，x86_64 / aarch64）
nexttavern-setup.tgz（安装器的 npm 归档）

校验与来源：

SHA256SUMS 与 provenance.json
版本说明。npm 包名为 dsh-nexttavern，通过官方 dsh plugin --profile web add dsh-nexttavern 安装。

安装

此处适合指定独立 home、工作区与固定端口的玩家。需要 Node.js 24+ 和 npm；以下为 PowerShell 示例，每条命令成功后再继续。

从 0.2.5 迁移前，先在旧环境导出角色卡或小说，并保留旧目录备份。 旧会话不能直接延续，小说不包含完整状态。以下为全新安装／旧宿主迁移示例，新 home 和新工作区应使用未占用的路径，不复制旧会话数据库。已有 0.2.8 的更新见更新、卸载与回滚。

powershell

npm install -g @deepseek-ai/dsh@0.1.7-rc.2
$env:DSH_HOME = Join-Path $PWD 'nexttavern-029-home'
$Workspace = Join-Path $PWD 'nexttavern-029-workspace'
New-Item -ItemType Directory -Path $env:DSH_HOME,$Workspace -ErrorAction Stop | Out-Null
dsh plugin --profile web add dsh-nexttavern
dsh web --host 127.0.0.1 --port 3510

浏览器中选择刚建的工作区，配置自己的模型供应商，新建会话时选“角色扮演模式”。后续启动仍须使用同一个 DSH_HOME，再运行最后一条命令。

也可以从 v0.2.9-rc.4 Release 下载主包，与 SHA256SUMS 核对后，以本地归档替代 npm 包名：

powershell

dsh plugin --profile web add ./dsh-nexttavern.tgz

不再需要 alpha.3 的手工 preset 初始化和宿主字节补丁。统一插件使用自己的兼容提供者，停用或激活失败时恢复原生提供者；普通 DSH 上传、附件和侧栏由官方提供。

首次准备失败时

网络失败后先恢复网络，再用同一 home 重试。首启准备有校验、锁与事务检查点，能识别中断并恢复；不要手工改 receipt、pin 或删除用户目录。

如果官方命令失败后包已装上、bundle 却未登记，可在停止目标服务后用同一个 home 执行以下两条，再重启：

powershell

dsh plugin --profile web remove dsh-nexttavern
dsh plugin --profile web add dsh-nexttavern

0.2.9 的 npm／Release 包已预置 @google/genai、protobufjs 的完整运行依赖闭包，私有 SDK 在固定目录重新链接也不需要执行它们的安装脚本；持久化组件携带 koffi 预构建 bundle。如果仍提示这些包的构建脚本未批准，先核对实际版本与来源是否为正式 0.2.9 npm 包或 Release 归档，保留终端错误与版本信息，隐去密钥后反馈。