酒馆式文字游戏 flizzywine/dsh-tavern

当前版本适配 DSH 0.2.x（0.2.0-rc.2 起的 0.2 系列均可；官方 DeepSeek Harness 或独立命令行；Android 使用独立 APK），安装见快速开始。

DSH Tavern

基于 DSH（DeepSeek Harness）的智能体酒馆。兼容 SillyTavern 生态，人物卡导入就能玩。

更快 · 更稳 · 更鲜活 · 所有模型都能用 · 手机也能玩

观看 3 分钟实机演示：兼容酒馆生态，更快、更稳、更鲜活

下载安装 · 使用文档 · 宣传视频 · Discord 交流群

- 兼容 SillyTavern 生态：人物卡、世界书、预设、正则美化、MVU、酒馆助手脚本，导入就能用。
- 更快：一轮约 10 秒，缓存命中率 95% 以上。
- 更稳：状态栏不再掉格式。变量由后台按规则结算，每轮附更新结果，失败可单独重试；更新与重装都保留数据。
- 更鲜活：同样的模型、同样的预设，比原版酒馆更有活人感。因为前台模型只管写正文，变量结算等任务性工作交给后台模型。
- 手机也能玩：Android 手机直接安装；电脑上运行的酒馆，手机扫码就能远程游玩。

SillyTavern vs DSH Tavern

| | SillyTavern | DSH Tavern |
| 上手门槛 | ❌ 要自己配预设、正则、扩展，学习门槛高 | ✅ 填好模型、导入人物卡就能玩，默认无需外部预设 |
| 工作方式 | ❌ 一口气：一个模型在一次请求里完成所有事 | ✅ 分步：正文、变量结算、候选项各自完成 |
| 出错重来 | ❌ 整轮重新生成，满意的部分也一起丢掉 | ✅ 哪步出错重来哪步，正文和候选还能附上指导意见 |
| 正文 | ❌ 写正文的同时要记住各种格式要求，注意力被分散 | ✅ 前台专心写正文 |
| 状态栏 | ❌ 每一轮都要求模型重新输出状态栏，写长了容易掉格式 | ✅ 状态栏固化：MVU 版由固定模板按变量显示，不再由模型输出，绝对不会掉格式 |
| 候选项 | ❌ 写正文的同时还要兼顾生成候选项，注意力涣散，还可能掉格式 | ✅ 和正文任务拆分，专注生成候选项；通过工具提交并校验，显示在固定面板，绝对不会掉格式 |
| 剧情规划 | ❌ 没有剧情规划，走向全靠模型临场发挥 | ✅ 多种方式规划剧情：① 剧本模式，沿剧本主线发展② 注入 Guide，临时规划剧情走向③ 候选项自动规划下一步，避免剧情停滞 |
| 记忆 | ❌ 靠压缩总结提前猜测需要什么记忆，提前注入，难以预测真实需求 | ✅ 内置记忆检索工具，需要什么记忆，智能体自行检索原文 |
| 缓存与速度 | ❌ 未考虑缓存利用：世界书条目内容一变化，缓存就失效 | ✅ 缓存命中率 95% 以上，一轮约 10 秒 |
| 写作方法 | ❌ 写进预设，每轮常驻提示词 | ✅ 写成技能，按场景调用 |
| 边玩边改卡 | ❌ 想排错或按喜好调整，都要自己翻人物卡、世界书、正则，逐项手改 | ✅ 边玩边改：① 排查错误：有问题随时交给调试智能体，结合实际游玩记录分析并修复② 调整内容：用对话告诉智能体哪里不喜欢，按自己的口味微调 |
| 酒馆生态 | ✅ 生态极其丰富：人物卡、世界书、预设、正则、MVU、酒馆助手脚本、大量第三方插件 | ✅ 兼容大部分人物卡（包括 MVU、正则、酒馆助手脚本、前端美化），世界书、预设可直接导入⚠️ 不支持安装酒馆插件（DSH 插件可以装），但内置了酒馆助手、MVU、提示词模板等重要插件，足以支撑大部分人物卡 |

产品特色

剧本模式

导入小说、剧本或大纲，绑定到人物卡，就能走进原作亲历主线。剧本定方向和关键事件，你决定人物怎么走到那里，随时可以偏离。剧本按片段读取，再长的小说也不用整本塞进上下文。了解更多 →

剧本模式：正文沿剧本推进，右侧显示剧本进度与当前片段

长期记忆

每轮正文完整保存，智能体需要时自己回查原文，不靠摘要硬记；配合上下文压缩，玩到几百层仍能记起开局的细节。了解更多 →

对话式修改人物卡

不用懂卡片字段，告诉智能体哪里不喜欢、想改成什么样，它先给方案，你确认后才写入。也能从小说里提取人物做新卡，或用同样方式修改世界书和预设。了解更多 →

卡片模式：与智能体对话修改人物卡，右侧为人物卡字段

人物卡转 MVU 版，状态栏不再掉格式

正文里的状态栏老是掉格式？让智能体把人物卡转成 MVU 版：前台只写正文，变量由后台按规则结算，状态栏常驻右侧，原卡图片和设定都保留。了解更多 →

自助调试智能体

正则没生效、美化显示不对、状态栏没更新？在右侧展开「遇到显示或生成问题？」，点「交给卡片智能体调试」，智能体会读取这局的实际游玩记录和日志，分析原因并修改相关资源，不用自己翻配置猜问题。了解更多 →

Guide：给这一局注入上下文指引

想要的写法、节奏或剧情走向写成一条 Guide，比如“多写心理活动，对白不超过三句”“好感度涨得慢一点”。它会注入上下文，之后每轮正文、候选和变量结算都会参考，不用每次重复。了解更多 →

带意见重写

不满意这轮回复，写上哪里要改，比如“保留事件，但减少旁白解释”，只重写这一轮，比反复抽卡更可控。了解更多 →

带意见重写当前正文，右侧为本局 Guide

后台人物设计

重要人物登场时，后台为其设计完整档案：动机、性格、外貌、说话方式、与主角的关系，之后反复出场都按同一套设定来，不会前后走样。已有设定直接复用，不重复造人。了解更多 →

写作技能

把写作教程或喜欢的样文交给智能体，提炼成场景写作技能，比如打斗、悬疑、感情戏各有一套写法；游玩时模型按场景自动选用。了解更多 →

支持插件生态

插件分两类： DSH 插件：酒馆运行在 DSH 上，可以直接安装其他 DSH 插件一起使用，例如手机访问的 dsh-pocket、远程登录认证的 dsh-webui-auth、语音朗读插件等。缺什么能力，也可以让智能体帮你写一个自定义工具。了解更多 →

DSH Tavern 专属插件：为酒馆游玩专门开发的插件。社区已有：

| 插件 | 作用 |
| dsh-tavern-image | 剧情自动配图，支持 ComfyUI、NovelAI、Gemini 等多平台，带人物库 |

以上为社区作者开发，更多插件见 Discord 交流群的插件分享。

看看实际效果

MVU 状态栏：人物状态随剧情变化，正文下方可查看本轮更新了什么。

MVU 人物卡的变量更新结果与右侧酒馆状态栏

小手机：带小手机的人物卡也能用。

场景插画：为当前剧情配一张图。

公开灯塔案例的场景插画与完整产品界面

卡片工作台

创造你自己的人物卡。

游玩模式兼容 SillyTavern 生态，导入人物卡就能玩；卡片工作台则把「写卡 / 改卡」做成对话式工作台——不会翻字段也能自己造卡、改卡，改完直接回游玩模式开玩。

一句话改卡

不用懂人物卡结构。告诉智能体哪里不喜欢、想改成什么样，它先给方案，你确认后再写入。预设、世界书也能用同样方式一起改，设定更容易绑在一起。

从零创造人物卡

从小说、设定，或一句想法出发，让智能体抽出人物、补全设定，做成能直接开玩的卡。自己写文字大卡也行：工作台能帮忙看出架构和人物设计矛盾，给出调整建议。

改完就能玩

卡片工作台和游玩模式是同一条产品线，不是两套工具。改完设定立刻回局里验证；游玩出了问题，也能把本局记录交给调试智能体，边玩边修。

卡片模式：与智能体对话修改人物卡

了解如何用对话修改人物卡 →

快速开始

请不要从 npm 下载或安装本项目。 由于对 DSH 的定制改动较多，DSH Tavern 无法作为常规 DSH 插件安装使用。npm 上的 dsh-profile-tavern 已标记弃用，不再维护；请按下方对应平台的方式安装。

桌面版仅支持官方 DeepSeek Harness，不再支持社区 DSH Desktop 或 DSH NEXT。 从社区版迁移前请备份数据，再按数据导入说明导入；Android 和独立命令行版继续支持。

当前版本适配 DSH 0.2.x（0.2.0-rc.2 起）。安装前建议备份 .dsh 目录。

Windows

1. 安装 DeepSeek Harness 0.2.1-rc.2 或更新的 0.2.x，打开一次后从托盘退出。
2. 打开 PowerShell，粘贴下面这行并按回车执行：

$env:DSH_TAVERN_HOST='desktop'; $tavernInstaller=[Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData('https://raw.githubusercontent.com/flizzywine/dsh-tavern/main/install.ps1')); Invoke-Expression $tavernInstaller

3. 重新打开 DeepSeek Harness，即进入酒馆。

Android

Android 仅提供 独立 APK（Android 11+ / ARM64）：下载 DSH Tavern Android APK。它内置 DSHA v0.2.0-rc2 与 DSH 0.2.0-rc.2，只运行酒馆自己的 tavern 配置档，手机上只有一个 DSH 服务，内存和电量开销最低。首次按引导完成环境部署后自动安装并进入；酒馆更新在应用内完成。包名独立，可与旧版 v2.1 APK、原版 DSHA 并存，旧包数据需先导出再导入。详见 Android 安装说明。
不想装 APK，或者想自己掌控运行环境（Node 版本、数据目录、和电脑上的命令行版共用一套玩法），也可以在 Termux 里跑命令行版：

curl -fsSL https://raw.githubusercontent.com/flizzywine/dsh-tavern/main/scripts/termux/termux-tavern.sh -o ~/termux-tavern.sh && bash ~/termux-tavern.sh

一条命令跑完，始终取 main 的最新版；这条命令会完成安装并进入酒馆：脚本会装 Ubuntu 容器、Node、酒馆与移动版布局，启动后打开浏览器。两种方式在手机上的差异、以及 Termux 版的注意事项见 Termux 一节。

macOS

1. 安装 DeepSeek Harness 0.2.1-rc.2 或更新的 0.2.x，打开一次后退出（⌘Q）。
2. 打开「终端」，粘贴下面这行并按回车执行：

curl -fsSL 'https://raw.githubusercontent.com/flizzywine/dsh-tavern/main/install.sh' -o /tmp/dsh-tavern-install.sh && DSH_TAVERN_HOST=desktop sh /tmp/dsh-tavern-install.sh

3. 重新打开 DeepSeek Harness，即进入酒馆。

命令行版（Windows / macOS / Linux，用浏览器玩）

不需要桌面版。命令行版自带一套独立的 DSH，和程序、游戏数据一起装在自己的目录里（默认 ~/.dsh-tavern），不会改动、也不会和你已经装好的 DSH 冲突：桌面版、全局的 dsh 命令照常使用，两边互不影响，可以同时运行。需要 Node.js 22.19+ 和 pnpm。

Windows（PowerShell）：

$env:DSH_TAVERN_HOST='cli'; $tavernInstaller=[Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData('https://raw.githubusercontent.com/flizzywine/dsh-tavern/main/install.ps1')); Invoke-Expression $tavernInstaller

macOS / Linux：

curl -fsSL 'https://raw.githubusercontent.com/flizzywine/dsh-tavern/main/install.sh' -o /tmp/dsh-tavern-install.sh && DSH_TAVERN_HOST=cli sh /tmp/dsh-tavern-install.sh

装好后用 dsh-tavern start 启动，按显示的地址在浏览器打开；dsh-tavern stop / status / update 停止、查看、更新。

在可信局域网 / VPN 内直接访问

命令行版默认只监听 127.0.0.1。可用 DSH_TAVERN_BIND 指定本机已有的具体 IP 地址（示例地址需替换为电脑的局域网或 VPN 地址）：

DSH_TAVERN_BIND=192.168.1.10 dsh-tavern restart
IPv6 不加方括号；输出的访问链接会自动加上方括号
DSH_TAVERN_BIND=fd00::1234 dsh-tavern restart

PowerShell：

$env:DSH_TAVERN_BIND='192.168.1.10'; dsh-tavern restart

仅 CLI 生效，不改变桌面版 / Android 宿主。可与 DSH_TAVERN_PORT 一起使用；不支持通配地址（0.0.0.0 / ::）、域名、URL 或带作用域 ID 的 IPv6（如 fe80::1%eth0）。地址必须已分配给本机，否则启动失败，不会回退到其他网卡。

status、open、重复 start 和 stop 使用进程记录里的实际地址，不需要重复设置变量。每次新启动（包括 restart、更新后的重新启动）都读取当次环境变量；希望持续使用同一地址，请在启动环境中保留它。取消变量后运行 restart 即恢复仅本机访问（PowerShell：Remove-Item Env:DSH_TAVERN_BIND）。旧版进程记录没有地址时仍按 127.0.0.1 处理。

安全：这个端口具有远程代码执行能力，token 是访问凭证。 仅在可信内网或 VPN 使用，不要直接暴露到公网，不要分享完整 token 链接；普通 HTTP 不加密，跨不可信网络应使用可信加密 VPN。此配置不会关闭鉴权，也不会自动更改防火墙、路由或 VPN。其他设备应打开启动输出中的完整地址。如果启用了 Node 环境代理（NODE_USE_ENV_PROXY=1），请把绑定地址加入 NO_PROXY（IPv6 的 URL 主机为 [地址]），避免自检及带 token 的链接验证经过代理；工具不会替你修改代理配置。

手机远程访问

酒馆跑在电脑或服务器上，用手机浏览器也能玩。详细说明 →

- 电脑运行、手机扫码：安装 dsh-pocket，在 设置 → 手机访问 选择局域网或公网，扫码即可。
- 服务器部署、账号登录：安装 dsh-webui-auth，为远程网页加上登录认证。

开始游玩

在 设置 → 模型 填入模型服务和 API 密钥（任意模型都可以，本地模型也行），导入人物卡就能开局。图文教程 →

更新、旧存档与切回原版

- 在酒馆里点「检查更新」即可更新，也可以重新运行上面的安装命令；只替换程序，人物卡、聊天和设置都会保留。
- 旧版本的存档：打开后在「酒馆状态」里点「迁移存档」。正文、变量、分支和历史版本都会保留。迁移后的数据目录不要再让旧宿主直接读取。
- 桌面版切回原版 DSH：设置 → 原版DSH → 切到原版 DSH 并重启。之后在原版 DSH 的设置 → DSH酒馆，就能切回酒馆。不要删除 .dsh/backups 和 profiles/desktop.fresh-*。细节见桥接插件说明。
- 旧酒馆在自定义目录、需要继承数据时，见数据继承说明。

交流与反馈

欢迎交流使用经验、分享人物卡或反馈问题：

- Discord：DSH Tavern 交流频道，任何人都可以加入。

除 Discord 外，本项目没有官方的 QQ 群、微信群或其他群聊。

反馈故障时，可从对话顶部的“日志”下载执行记录；分享前请检查其中的对话和附件隐私。

用户怎么说

用户反馈：同样预设下比酒馆更有活人感，速度也更快

用户反馈：游玩五六百层后，仍能记起开局物品的来历

用户反馈：长局 184 轮仍保持 99% 缓存命中与 272 tok/s

用户反馈：会主动推进剧情，引入新角色和新事件

更多用户反馈

用户反馈：使用本地 27B 模型，体验非常良好

用户分享缓存命中率与几十轮游玩的实际花费

关于默认预设、回复速度与 Guide 剧情引导的反馈

关于使用体验的反馈

关于记忆系统的反馈

用户聊天反馈

关于文笔的反馈

社区用户对插件的反馈

用户对整体使用体验的评价与稳定版适配的询问

用户反馈：缓存命中率高

用户反馈：MVU 体验不错，喜欢按要求重新生成文本的功能用户反馈：回复速度快，十几秒即可收到回复

用户反馈：特别好用，游玩体验更好

用户反馈：智能体写作的输出质量更高

用户反馈：修改角色卡像给游戏装 MOD，改卡本身也很有趣

用户反馈：世界书和角色卡调整方便，与 DSH 语音阅读插件兼容良好

用户反馈：AI 修改内容方便，变量更新稳定，轻前端游玩体验不错

参与贡献

欢迎各种 PR：完善文档、写小白教程、给配置项改名、折叠复杂设置，或改进其他使用体验。当前功能繁多，特别欢迎简化、合并和删除功能的意见。

Issue 只用于 Bug 反馈。大功能或行为调整请先到 Discord 交流群 讨论，确定方案后再提交 PR。

文档统一在 GitHub Wiki 维护，登录 GitHub 后可直接点击 Edit 修改或新增页面，无需提交文档 PR。