flizzywine/dsh-tavern
基于 DeepSeek Harness（DSH）的 SillyTavern 类文字游戏 Agent，支持候选项生成、对话式人物卡编辑、剧本模式与素材抽取。
安装Install
dsh plugin --profile web add github:flizzywine/dsh-tavern把 flizzywine/dsh-tavern 加入你的 DSH 配置（web profile）即可启用。
READMEREADME
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 讨论修改内容，同时在右侧查看并编辑人物卡字段、世界书与绑定剧本。
安装与启动
提供桌面版和命令行版两种安装方式。两者使用同一套 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://raw.githubusercontent.com/flizzywine/dsh-tavern/main/install.ps1 | iex
macOS：
curl -fsSL https://raw.githubusercontent.com/flizzywine/dsh-tavern/main/install.sh | DSH_TAVERN_HOST=desktop sh
安装完成后，重启 DSH Desktop，并从托盘的 Profile 菜单选择 tavern。Desktop 会自动管理启停和端口；更新 dsh-tavern 时，在 DSH Terminal 中重新运行上述安装命令即可。
命令行版
适合希望通过浏览器访问、自己管理服务的用户。需要 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：
- 在 GitHub 项目页点击 Code → Download ZIP，或直接下载
main.zip； - 解压后进入
dsh-tavern-main文件夹； - 在这个文件夹中打开 PowerShell（Windows）或终端（macOS / Linux），确认当前目录可以看到
package.json； - 如果尚未安装
pnpm或 DSH，先运行：
npm install -g pnpm @deepseek-ai/dsh
- 命令行版安装并启动：
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 手机上运行本项目：
- 前往 DSHA 仓库下载并安装 APK；
- 在 DSHA 中添加模型 API；
- 打开“创造模式”，把 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 的插件内容。Desktop 版不使用这些启停命令，由 DSH Desktop 统一管理。
用户数据统一保存在 DSH 的 Tavern Profile 数据目录中，不再跟随源码文件夹。旧版本升级时会自动备份并迁移原 data 目录，因此更换安装目录、切换 Desktop/命令行版或使用 Git worktree，不会再产生彼此独立的对话库。
人物卡兼容性反馈
这个项目最初主要是我自己使用，所以目前只适配了结构比较简单、以纯文本为主的人物卡。接下来我希望逐步支持更多类型的人物卡，包括大型世界书、正则、脚本、MVU 和前端美化等能力。
如果你发现某张人物卡在 dsh-tavern 中表现不正常，欢迎给我留言，或者提交 Issue。反馈时最好说明：
- 人物卡名称或链接；
- 在 dsh-tavern 中具体有哪些不适配的表现；
- 这张卡在原环境中应该如何运行；
- 如果方便，可以附上截图、复现步骤或用于测试的人物卡。
人物卡生态很复杂，适配这些能力需要不少时间。我可能不会立刻支持你反馈的卡片，但会认真研究这些案例，优先解决其中的共性问题，尽量让 dsh-tavern 兼容更多种类的人物卡。欢迎反馈。
关于预设与模型拒绝
目前 dsh-tavern 暂不支持导入外部预设。预设通常用于减少模型拒绝或空回；在我自己的测试中，使用 DeepSeek V4 Flash 游玩轻度 NSFW 内容，不需要额外破限也能正常生成，也就是说，在不导入外部预设的情况下，本项目自带一定的破限能力。
这个项目最初是我自己使用，因此还没有系统测试其他模型和各种人物卡。如果你遇到拒绝或空回，欢迎私下发给我，或者提交 Issue。为了方便复现，最好同时提供：
- 使用的模型；
- 人物卡名称或文件；
- 输入了什么，以及在哪一轮被拒绝；
- dsh-tavern的 Session Log；
- 如果某个预设能够正常生成，也请告诉我预设名称或具体配置。
收到可以复现的案例后，我会尽快研究和适配。解决方式可能是调整内置提示词，也可能是增加外部预设导入功能。这个项目由我个人开发，时间和精力有限，无法保证立即解决每个案例，但我会优先研究大家反复遇到的共性问题，尽量支持更多模型和人物卡。感谢理解，也欢迎继续反馈。
相关推荐Related
- deepseek-ai/deepseek-harness DeepSeek Harness: Everything is a Plugin.
- deepseek-ai/deepseek-harness DeepSeek Harness (dsh) — 由 DeepSeek AI 开发的开源 agent harness（智能体框架）。一切皆插件：核心 + 插件 + 技能 = 可热插拔的 AI 编程工作台。DeepSeek Harness: …
-
ruvnet/ruflo
🌊 The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build c…
-
amruthpillai/reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source a…
-
volcengine/OpenViking
Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
-
Molunerfinn/PicGo
:rocket: The Ultimate Image Uploader for Efficient Creators. Supports Obsidian, Typora, VS Code etc. and 60+ image hosti…
-
titanwings/colleague-skill
将冰冷的离别化为温暖的 Skill，欢迎加入数字生命1.0！Transforming cold farewells into warm skills? It's giving rebirth era. Welcome to Digital …
-
nocobase/nocobase
NocoBase is an open-source AI + no-code platform for building business systems fast. Instead of generating everything fr…