快速开始

一键安装

已经装好 Harness 的玩家，只需这一条命令：

powershell

dsh plugin --profile web add dsh-nexttavern

这里的 dsh-nexttavern 是正式 npm 包名。部分第三方 Hub／市场目录未识别 npm 来源时会回退到 Git 源码安装；目录来源仍待第三方同步。请直接使用上面的官方命令，或下载已校验的 Release 归档。本版未承诺 Git 源码直装，也未扩展到 DSH 0.2／desktop。

第一次使用 DSH，请先安装 Node.js 24+ 和宿主：

powershell

npm install -g @deepseek-ai/dsh@0.1.7-rc.2

安装后运行 dsh web --host 127.0.0.1，按终端地址打开浏览器，配置自己的模型与 Key，再选择“角色扮演模式”。所需兼容组件、文档读取组件和自有皮肤由统一插件准备；皮肤随包安装、默认关闭。首次准备需要时间与网络，准备完成后的启动会复用已校验的组件。

从 0.2.5 迁移：先导出，再用新目录。 0.2.5 的旧会话无法直接延续，目录隔离步骤见安装。不要对旧 home 或工作区执行这条命令来尝试迁移会话。

Windows

希望由安装器准备便携运行时与快捷方式，可下载 NextTavern-Setup.exe。Windows on ARM 使用 NextTavern-Setup-arm64.exe。从 0.2.5 迁移时选择新的安装目录；完整步骤、未签名提示与验证范围见 Windows 一键安装指南。

两端安装器准备便携宿主后，也通过官方 plugin add 安装已校验的归档；不再向宿主重放旧兼容补丁。安装失败时保留未完成回执，重新运行可以恢复本安装器拥有的工作。

Linux

NextTavern-Setup.sh 准备便携 Node.js、安装目录及启动／停止入口，面向 x86_64 与 aarch64（glibc），不需要 root 或系统包管理器。从 0.2.5 迁移时使用新的 --root；完整步骤与验证范围见 Linux 一键安装指南。

Android

目标是一个独立安装、点开就能用的 Android APK，让酒馆直接运行在手机上。 不需要 root，也不以安装 Termux、Ubuntu 或 PRoot 作为使用前提；这不是让手机远程连接一台必须常开的电脑。

怎么实现： 用原生 Android 外壳管理启动、停止和应用生命周期，内置可直接运行于 Android 的独立 Node.js（Bionic）引擎，再用 WebView 显示现有酒馆界面。我们会继续适配手机操作，但不是把整套界面重写成原生 Android 控件。
本机运行不等于离线 AI： 目标是让引擎和故事数据留在手机本地；生成故事仍需配置自己的在线模型服务与 API Key。除非另有明确支持，不代表手机内置了可离线使用的大模型。
现在做到哪了： 已完成首轮安装包构建，并在硬件加速的 Android 模拟器中启动本地引擎、显示应用页面。角色卡导入、完整对话、数据保存与重启恢复等关键体验仍在逐项验证，目前还没有面向普通玩家发布、可下载即玩的 Android APK。目标优先支持 ARM64 手机；模拟器通过不代表已经完成真机适配。
后台运行的边界： Android 的省电策略和后台限制仍然存在，不承诺锁屏或切到其他应用后全天候持续运行；后台行为与恢复体验还需继续验证。

想看后续进展，可以关注 android/mobile-terminal 开发分支。详细介绍见 Android 手机端路线。本节其余安装说明仍针对现有桌面／服务器版本，不是 Android APK 的安装步骤。

安装与模型费用

安装、字节校验、恢复和卸载由程序完成，不调用故事模型。模型 API Key 由玩家输入，安装包不携带密钥；本机服务绑定 127.0.0.1。故事生成及既有后台记忆、状态等任务仍按所配置模型计费，打开已有会话也可能恢复后台维护。

开始体验

完成一键安装（或手动安装）并配置好自己的模型后：

新建一个独立工作区。 给这次角色扮演一个专用文件夹，角色卡、故事资源和导出文件都放在一起。
在预设里选“角色扮演模式”。 新建会话时从预设菜单切过去，就进入了你的故事工作台。
上传角色卡，或者直接聊出一张新的。 支持 SillyTavern / TauriTavern 的 PNG、JSON 人物卡；也可以只描述题材、人物、关系和氛围，让 AI 通过对话和你一起把这张卡做出来。
开始体验。Enjoy it! 跟着开场推进故事，输入你的行动，切换世界线，或随时打开“酒馆管理”调整设定。

没有现成角色卡，也可以从这样一句话开始：

帮我创作一张蒸汽都市悬疑角色卡。我想扮演刚到港口的调查员，故事慢热，有多方势力，也有人物关系的发展。其他细节你来决定。

告诉 AI 你想遇见怎样的人、经历怎样的故事。你可以一起打磨细节，也可以说“你来决定”，让它带着世界、人设、开场与文风继续创作。DOCX 等文档的读取方式见文档扩展。手边只有一部长篇小说？也可以直接让它读成一张卡，见长文本转角色卡。

导入 SillyTavern / TauriTavern 人物卡

直接上传原始卡文件，然后告诉 AI：“读取这张角色卡，准备开始角色扮演。” 不用自己解码，也不用填导入工具的参数。

格式	支持范围
PNG 人物卡	从 `chara` / `ccv3` 的 `tEXt` 块读取 Base64 编码的角色数据；两者同时存在时优先读取 `ccv3`。
JSON 人物卡	识别 v1、v2（`chara_card_v2`）和 v3（`chara_card_v3`）。
内嵌世界书	读取 `character_book`，按当前导入流程审阅并映射到设定与世界书。

请选保留元数据的原始 PNG 卡：普通头像、截图或被移除元数据的图片里没有可导入的角色数据。PNG/JSON 解析是内置能力，不需要 anydoc；上传入口随完整安装提供。

导入后可以继续打磨人物、世界书与创作规则，原始卡片和扩展数据都会一并保留。卡片里的三个文风字段会完整保留，怎么和预设配合由你决定，见预设系统。