dsh-tavern

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

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

SillyTavern 采用提示词工程的思路：每轮动态拼接一个超大上下文，囊括系统规则、内容偏好、对话历史、人物卡、世界书、脚本与变量等信息，再要求模型一口气完成正文生成、历史与设定遵循、格式控制甚至代码生成等复杂任务。

这会带来两个问题：一是动态插入不断改变上下文前缀，提示词缓存难以充分复用，增加费用和等待时间；二是多个复杂目标互相争夺模型注意力，任务越多，越容易出现失忆、掉格式、人物状态矛盾和明显的 AI 味。

dsh-tavern 改用 Agent 架构。前台主 Agent 专注正文生成，后台 Agent 分步处理候选项、状态总结和世界书召回等小任务，再由程序把结果合并为完整体验。主 Agent 与后台 Agent 各自维护前缀稳定，从而提高缓存利用率、降低费用与等待时间；拆分后的每次生成只解决一个明确问题，也能显著提升输出质量。

产品功能

1. 游玩模式

自由游玩

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

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

自由游玩还支持：

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

剧本游玩

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

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

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

2. 卡片模式

卡片模式用于制作、理解和维护人物卡、素材与剧本。

你可以像聊天一样，让 Agent 先阅读人物卡，分析其中的问题，讨论不同修改方案。只有在你确认之后，Agent 才会把修改写入人物卡。

卡片模式支持：

• 导入和导出 SillyTavern PNG / JSON 人物卡；
• 保留并编辑人物卡中的世界书；
• 通过对话分析、讨论和修改人物卡；
• 从素材中提炼新人物卡；
• 管理人物卡使用的素材和绑定剧本；
• 查看、修改、替换素材与剧本，使其符合自己的故事构想。

人物卡负责“角色是谁”，素材负责“创作依据是什么”，剧本负责“故事往哪里走”。三者彼此独立，又可以在同一个卡片工作流程中组合使用。

3. 产品特色

无需导入预设

直接导入人物卡，即可开始游玩

支持 Android 手机（实验性，不保证一定可用）

借助 DSHA，可以尝试在 Android 手机上部署和运行 dsh-tavern。目前手机端的后台保活、界面适配和运行稳定性仍不完善，具体操作与限制见下方 Android 安装说明。

速度快、消耗低

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

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

文本质量高，AI味少

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

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

界面展示

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

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

带意见重新生成正文

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

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

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

卡片工作台

可以修改现有人物卡、从资料新建人物卡、从酒馆预设提取破甲提示词，或空白开始。右侧分为“人物卡库”“预设库”“破甲库”“资料库”：预设可按条目结构化阅读，素材和剧本则放在资料库。

对话式编辑人物卡

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

安装与启动

需要 Node.js 22.19 或更高版本。

Windows

打开 PowerShell，运行：

irm https://raw.githubusercontent.com/flizzywine/dsh-tavern/main/install.ps1 | iex

macOS / Linux / WSL2

打开终端，运行：

curl -fsSL https://raw.githubusercontent.com/flizzywine/dsh-tavern/main/install.sh | sh

安装程序会自动安装依赖、启动 dsh-tavern，并打开 http://127.0.0.1:3081。

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

手动下载代码包

如果一键命令无法访问 raw.githubusercontent.com：

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

5. 安装并启动 dsh-tavern：

pnpm run install:tavern
pnpm run start:tavern

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

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

借助 DSHA，可以尝试在 Android 手机上运行本项目：

1. 前往 DSHA 仓库下载并安装 APK；
2. 在 DSHA 中添加模型 API；
3. 打开“创造模式”，把 dsh-tavern 仓库地址发给 AI，让它完成部署：

https://github.com/flizzywine/dsh-tavern

还可以让 AI 安装 <mobile-adapt> 插件，改善手机屏幕适配。

目前 Android 端仍有较多问题：

• 必须保持 DSH 在后台运行，否则无法访问 3081 端口的酒馆模式；
• 终止 DSH 进程后，3080 端口的启动器可以重新拉起，但 3081 端口的酒馆模式需要通过命令或让 AI 再次启动；
• 手机界面和运行稳定性尚未完善。

启动、停止与更新

安装完成后，新开一个终端或 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 的插件内容。

人物卡兼容性反馈

这个项目最初主要是我自己使用，所以目前只适配了结构比较简单、以纯文本为主的人物卡。接下来我希望逐步支持更多类型的人物卡，包括大型世界书、正则、脚本、MVU 和前端美化等能力。

如果你发现某张人物卡在 dsh-tavern 中表现不正常，欢迎给我留言，或者提交 Issue。反馈时最好说明：

• 人物卡名称或链接；
• 在 dsh-tavern 中具体有哪些不适配的表现；
• 这张卡在原环境中应该如何运行；
• 如果方便，可以附上截图、复现步骤或用于测试的人物卡。

人物卡生态很复杂，适配这些能力需要不少时间。我可能不会立刻支持你反馈的卡片，但会认真研究这些案例，优先解决其中的共性问题，尽量让 dsh-tavern 兼容更多种类的人物卡。欢迎反馈。

关于预设与模型拒绝

目前 dsh-tavern 暂不支持导入外部预设。预设通常用于减少模型拒绝或空回；在我自己的测试中，使用 DeepSeek V4 Flash 游玩轻度 NSFW 内容，不需要额外破限也能正常生成，也就是说，在不导入外部预设的情况下，本项目自带一定的破限能力。

这个项目最初是我自己使用，因此还没有系统测试其他模型和各种人物卡。如果你遇到拒绝或空回，欢迎私下发给我，或者提交 Issue。为了方便复现，最好同时提供：

• 使用的模型；
• 人物卡名称或文件；
• 输入了什么，以及在哪一轮被拒绝；
• dsh-tavern的 Session Log；
• 如果某个预设能够正常生成，也请告诉我预设名称或具体配置。

收到可以复现的案例后，我会尽快研究和适配。解决方式可能是调整内置提示词，也可能是增加外部预设导入功能。这个项目由我个人开发，时间和精力有限，无法保证立即解决每个案例，但我会优先研究大家反复遇到的共性问题，尽量支持更多模型和人物卡。感谢理解，也欢迎继续反馈。