dsh-tavern

[!IMPORTANT] 当前适配 DSH 0.1.1-rc.2；暂不支持最新的 DSH 0.1.2-alpha.1。

dsh-tavern

基于 DeepSeek Harness（DSH）制作的 SillyTavern 类文字游戏 Agent。

它可以直接导入酒馆人物卡，也可以从小说、剧本和人物素材中制作新卡。选一张卡后，你既可以自由游玩，也可以绑定一份剧本，让故事沿着既定主线长期推进。

产品功能

1. 游玩模式

自由游玩

自由游玩不受固定剧情限制，故事会根据人物卡、世界书和当前对话自然发展。

正文与候选项分开生成。正文只负责讲好故事，候选项则提供多种人物行动和场景变化，不会混入正文。玩家可以直接选择、修改候选，也可以完全自由输入。

自由游玩还支持：

• 独立总结人物姿势，保持人物位置、动作和状态前后一致；
• 注入 Guide，为当前会话添加持续生效的剧情或写作要求；
• 输入意见，重新生成候选项；
• 输入意见，重新生成正文；
• 回退当前回合。

剧本游玩

剧本模式可以为人物卡绑定小说、剧本或故事大纲，让剧本作为故事主线持续牵引剧情。

每一轮只参考当前剧情附近的剧本内容，不会一次性把整份剧本塞给模型。系统会记录当前剧情进度，并根据后续情节推荐更贴近主线的行动。

同时玩家保留偏离剧本的自由。

2. 卡片模式

卡片模式是游玩前的对话式资源工作台，用于制作、理解和维护人物卡、世界书、预设与剧本。

新建工作台时，可以直接选择修改人物卡、从剧本新建人物卡、修改剧本、修改世界书、修改预设或空白开始。Agent 会按需阅读相关内容，先与你讨论方案，只有确认后才写入修改。

右侧边栏提供四个独立资源库：

• 人物卡库：导入、导出和编辑 SillyTavern PNG / JSON 人物卡，管理世界书与剧本绑定；
• 世界书库：统一管理独立世界书和人物卡内置世界书；
• 预设库（实验性）：导入并选择 SillyTavern 预设。普通游玩会将可识别内容投影到前台正文请求，兼容模式会进一步按 SillyTavern 消息结构编译；也可在详情中调整提示词和正则，或引用到卡片对话中交给 Agent 编辑；
• 剧本库：导入、查看和修改小说、剧情大纲与故事素材，并与人物卡一对一绑定。

这些资源都可以按需引用到卡片对话中；导入时保留原版，Agent 修改的是独立工作版。

3. 产品特色

无需导入预设

Agent 游玩直接导入人物卡即可开始，不要求用户配置预设。

DSH Tavern 已自带原生运行预设。除非坚持要使用预设，否则建议保持“不使用预设”；开启用户导入的外部预设可能与原生行为冲突并导致系统异常，请用户自行判断。如果要调整内容偏好，建议通过改卡将偏好写入人物卡，或使用 Guide 注入偏好。

普通游玩可以使用外部预设，但不能保证完全适配 SillyTavern，也不保证达到破限效果。

兼容模式（实验性）

需要更接近 SillyTavern 消息结构的人物卡，可以进入“设置 → DSH Tavern”，开启“兼容模式（实验性）”；开启后左侧会显示“兼容（实验性）”入口。兼容模式会尽最大可能复刻 SillyTavern 的消息结构与预设行为，按预设原有的提示词顺序、启用状态和正则设置构造请求，对预设的适配度高于普通游玩。预设也可以引用到卡片对话中，由 Agent 协助编辑。

多平台支持

dsh-tavern 支持 Windows、macOS、Linux 和 Android。Windows 与 macOS 可使用 DSH Desktop 客户端，也可以通过命令行运行；Linux 使用命令行运行；Android 可借助 DSHA 实验性部署，目前不保证稳定可用。

自由安装插件

Tavern Profile 保持开放。你可以自行编写、安装和组合 DSH 插件；更新 dsh-tavern 时，用户添加的插件与配置会被保留，不会被安装程序整体覆盖。

人物卡正则美化

支持人物卡展示正则，在对话正文中渲染 HTML 前端。

速度快、消耗低

dsh-tavern 只在需要时注入必要上下文，并把不同任务拆成短而明确的调用，减少无效的 Token 消耗和等待时间。

使用 DeepSeek V4 Flash 测试时，一轮交互平均等待时间约为 15 秒。

文本质量高，AI味少

dsh-tavern 使用尽可能少而精的提示词，把流程和状态交给程序管理，把文字创作留给模型。

减少不必要的格式要求、禁用词和提示词堆叠，保护并激发模型的文字创造力，剧本模式通过剧本文字引导，可以改变模型的文本输出分布，极大压制AI味。

界面展示

自由游玩：正文与候选项分开生成

候选项独立展示人物行动与场景变化；右侧可同时查看 Guide 和人物姿势。

带意见重新生成正文

不满意当前正文时，可以补充指导意见后重新生成并替换。

剧本游玩：围绕主线持续推进

右侧展示当前剧本进度、召回片段与人物姿势，正文仍保留玩家自由行动的空间。

卡片工作台：六种起始任务

直接选择要处理的资源和任务，也可以空白开始，自由使用完整卡片 Agent。

侧边栏资源库

人物卡、预设、世界书和剧本各自独立管理，并可直接加入当前卡片对话。

对话式编辑人物卡

在中间与 Agent 讨论修改内容，同时在右侧查看并编辑人物卡字段、世界书与绑定剧本。

人物卡正则美化

把状态文本渲染为正文内的酒馆面板。

安装与启动

提供桌面版和命令行版两种安装方式。两者使用同一套 Tavern Profile 和数据，请勿同时运行。

DSH Desktop 桌面版（推荐）

适合不想单独配置运行环境和管理服务的用户。请先安装 DSH Desktop 2.0.2 或更高版本（支持 Windows x64 和 macOS，暂不支持 Linux）。

安装后，从系统托盘（macOS 菜单栏）打开 Open DSH Terminal，运行对应命令：

Windows：

$env:DSH_TAVERN_HOST='desktop'; irm https://cdn.jsdelivr.net/gh/flizzywine/dsh-tavern@main/install.ps1 | iex

macOS：

curl -fsSL https://cdn.jsdelivr.net/gh/flizzywine/dsh-tavern@main/install.sh | DSH_TAVERN_HOST=desktop sh

安装完成后，重启 DSH Desktop，并从托盘的 Profile 菜单选择 tavern。Desktop 会自动管理启停和端口；更新 dsh-tavern 时，在 DSH Terminal 中重新运行上述安装命令即可。

命令行版

适合希望通过浏览器访问、自己管理服务的用户。需要 Node.js 22.19 或更高版本。建议安装 Git：安装器会建立持久化稀疏缓存，首次只获取运行文件，后续只拉取变化内容，不下载 docs/、文档图片、demo/、references/ 和测试文件；没有 Git 时自动回退到完整 ZIP。

Windows

打开 PowerShell，运行：

irm https://cdn.jsdelivr.net/gh/flizzywine/dsh-tavern@main/install.ps1 | iex

macOS / Linux / WSL2

打开终端，运行：

curl -fsSL https://cdn.jsdelivr.net/gh/flizzywine/dsh-tavern@main/install.sh | sh

安装程序会自动安装依赖、启动 dsh-tavern，并打开 http://127.0.0.1:3081。更新时优先使用 Git 增量同步；Git 不可用或同步失败时才下载完整 ZIP。

首次使用时，在左侧栏底部打开 设置 → 模型，填写模型服务的 API 密钥。

手动安装

如果一键命令仍然无法使用：

1. 在 GitHub 项目页点击 Code → Download ZIP，或直接下载 main.zip；
2. 解压后进入 dsh-tavern-main 文件夹；
3. 在这个文件夹中打开 PowerShell（Windows）或终端（macOS / Linux），确认当前目录可以看到 package.json；
4. 如果尚未安装 pnpm 或 DSH，先运行：

npm install -g pnpm @deepseek-ai/dsh

1. 命令行版安装并启动：

pnpm run install:tavern
pnpm run start:tavern

然后打开 http://127.0.0.1:3081。

如果使用 DSH Desktop，请从托盘打开 DSH Terminal，在解压目录运行：

node ./bin/dsh-tavern.mjs install --host desktop

然后重启 Desktop，并切换到 tavern Profile。

Android（实验性，不保证可用）

借助 DSHA，可以在 Android 手机上实验性运行本项目。首次安装只需要：

1. 安装 DSHA，配置模型并成功启动一次；
2. 打开“创造模式”，把下面一句话发给 AI：

请运行这条命令安装 DSH Tavern，完成后告诉我结果：curl -fsSL https://cdn.jsdelivr.net/gh/flizzywine/dsh-tavern@main/android/setup.sh | bash

1. 安装完成后重启 DSHA，点击侧栏里的 酒馆工作台。

以后更新直接点击酒馆左侧栏底部的 更新到最新版。如果酒馆打不开，可在 DSHA 的 酒馆工作台入口点击 更新/修复。

详细排错见 Android 安装说明。

命令行版的启动、停止与更新

安装完成后，新开一个终端或 PowerShell。

启动：

dsh-tavern start

停止：

dsh-tavern stop

重启：

dsh-tavern restart

更新：

dsh-tavern update

dsh-tavern 是运行在 DSH 上的插件项目，不包含 DSH 本体。DSH 本体可以按其自身方式正常更新，通常不会影响本项目的使用，除非 DSH 进行了不兼容的破坏性更新。更新 DSH 本体不需要运行 dsh-tavern update；这个命令只用于更新 dsh-tavern 的插件内容。Desktop 版不使用这些启停命令，由 DSH Desktop 统一管理。

用户数据统一保存在 DSH 的 Tavern Profile 数据目录中。

社区交流

欢迎加入 dsh-tavern Discord 讨论频道，交流使用经验、分享人物卡或反馈问题。