dsh-tavernDeepSeek Harness plugin

[!IMPORTANT] 本版适配 DSH 0.1.2-alpha.2。允许使用其他版本，但 DSH 更新较激进，可能导致本插件异常，请自行斟酌。 安装时复用当前 DSH 自带的必需依赖，不强制它们为 alpha.2，也不自动替换 DSH；缺少依赖或所需接口时会明确提示。

dsh-tavern

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

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

产品功能

1. 游玩模式

自由游玩

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

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

自由游玩还支持：

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

剧本游玩

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

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

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

2. 卡片模式

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

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

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

• 人物卡库：导入、导出和编辑 SillyTavern PNG / JSON 人物卡，管理世界书与剧本绑定；
• 世界书库：统一管理独立世界书和人物卡内置世界书；
• 预设库（实验性）：导入并选择 SillyTavern 预设，也可在详情中调整提示词和正则，或引用到卡片对话中交给 Agent 编辑；
• 剧本库：导入、查看和修改小说、剧情大纲与故事素材，并与人物卡一对一绑定。

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

支持直接导入 SillyTavern 预设，并在预设库中查看、选择和编辑。系统内置提示词也可以在右侧“系统提示词”面板中查看、修改、导入、导出或恢复默认。

3. 产品特色

无需导入预设

导入人物卡即可开始游玩，无需导入预设，也可按需导入并使用外部预设。

人物卡美化与 MVU

支持人物卡正则美化与 HTML 展示；支持 MVU，变量由后台 Agent 更新，状态栏常驻右侧面板。

多平台支持

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

自由安装插件

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

速度快、消耗低

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

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

文本质量高，AI味少

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

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

界面展示

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

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

带意见重新生成正文

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

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

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

卡片工作台：按任务直接开始

直接选择要处理的资源和任务，也可以空白开始，自由使用完整卡片 Agent。选择“把人物卡转成 MVU 版”会直接启用内置转换 Skill，将容易掉格式的正文状态栏迁移为后台变量结算和固定显示。

侧边栏资源库

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

对话式编辑人物卡

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

MVU 人物卡：后台变量结算与右侧状态栏

正文下方显示本轮变量更新结果，右侧“酒馆状态”面板持续展示人物卡状态栏。

人物卡正则美化

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

首次安装与重新安装

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

首次安装、更新或重新安装，都运行下面对应的同一条命令。 已安装时会覆盖更新程序文件，保留人物卡、对话、配置、自定义工具和 Skill，无需先卸载。重新安装前建议备份数据；如果使用了自定义数据或安装目录，请保持原配置。

DSH Desktop 桌面版（推荐）

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

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

Windows：

powershell
$env:DSH_TAVERN_HOST='desktop'; $tavernInstaller=[Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData('https://cdn.jsdelivr.net/gh/flizzywine/dsh-tavern@main/install.ps1')); Invoke-Expression $tavernInstaller

macOS：

bash
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 中重新运行上述安装命令即可。

旧版内置更新失败时，也直接运行上面的命令：它会获取最新安装器，绕过本地旧更新脚本。Windows 命令按 UTF-8 解码，避免中文乱码。若仍失败，请提供日志最前面的具体错误和文件路径。

命令行版

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

Windows

打开 PowerShell，运行：

powershell
$env:DSH_TAVERN_HOST='cli'; $tavernInstaller=[Text.Encoding]::UTF8.GetString((New-Object Net.WebClient).DownloadData('https://cdn.jsdelivr.net/gh/flizzywine/dsh-tavern@main/install.ps1')); Invoke-Expression $tavernInstaller

macOS / Linux / WSL2

打开终端，运行：

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

安装程序会自动安装依赖、启动 dsh-tavern，并在首次安装时打开网页。关闭页面后，运行 dsh-tavern open 可重新打开；也可运行 dsh-tavern status，复制显示的完整访问地址（含鉴权 token，请勿分享）。不要只输入不带 token 的地址，以免出现鉴权提示。更新时优先使用 Git 增量同步；Git 不可用或同步失败时才下载完整 ZIP。

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

手动安装

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

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

bash
npm install -g "@deepseek-ai/dsh@$(node bin/dsh-compatibility.mjs --version)"

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

bash
pnpm run install:tavern
pnpm run start:tavern

然后使用终端显示的完整访问地址，或运行 dsh-tavern open。若当前终端尚未识别该命令，可在仓库目录运行 node ./bin/dsh-tavern.mjs open。

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

bash
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

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

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

详细排错见 Android 安装说明。

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

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

启动：

bash
dsh-tavern start

停止：

bash
dsh-tavern stop

重启：

bash
dsh-tavern restart

更新：

bash
dsh-tavern update

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

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

社区交流

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

反馈游玩或变量更新问题时，可点击对话顶部的“日志”下载 Session 与 MVU 执行记录；分享前请检查其中的对话和附件隐私。新增执行记录从更新后开始收集，无法补录旧故障。