pmp-dsh-tavern
一个 SillyTavern 兼容插件，让 DSH 对会话和执行保持权威，并通过前端和后端 API 将 Tavern 功能与原生 DSH 特性组合使用。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Player-MINEPIG/dsh-tavern#3d11a9ce20fa9d658870b129cd9888fdafe7b557Pmp Dsh Tavern 以 pmp-dsh-tavern 发布，当前版本为 2.3.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
以 DeepSeek Harness（DSH）原生会话与执行机制为权威的酒馆兼容插件，提供前后端 API，支持自由组合酒馆能力与 DSH 原生功能。
本文说明
2.3.1，新增周目归档与恢复；目标运行环境为 DSH0.1.5-rc.1。项目代码采用 MIT License。Tavern Trace 可查看每次请求的配置、世界书触发情况和提示词段落的内容与来源；第三方工具也可通过只读 v3 API 读取这些信息。见 API 与设计。
暂不支持 MVU 变量系统和依赖 JavaScript 的动态 HTML。 RP 视图支持经过过滤的静态 HTML/CSS；依赖脚本的状态更新和交互不会运行。
pmp-dsh-tavern 不是用另一套界面取代 DSH，也不会复制一份会话历史。它以公开扩展点和原子 API 为基础，在 DSH 之上增加一层可测试、可审计、可卸载的 Tavern 兼容框架：
双模式本身就是兼容方案：不进入魔丸时，用户看到的仍是普通 DSH；只有进入 RP 模式后，插件才挂载自己的 RP 表面。
安装本插件等同于允许其代码在 DSH Host 和浏览器页面中运行。请只从可信仓库与提交安装，并在更新前检查变更、备份插件数据。以下防护用于降低风险，不构成操作系统级隔离或账号鉴权：
RegExp，灾难性回溯可能冻结页面；只导入和启用你信任的模板与正则。遇到可疑行为时，停止 Agent、切回 DSH 原生模式并检查原始会话与工具记录。完整威胁模型、已实现边界和漏洞报告方式见 安全策略；RP 模式具体拦截范围见 RP 安全模式。
视频演示：pmp-dsh-tavern「灵珠魔丸」（操作细节以本文当前说明为准）
从 GitHub 安装 2.3.1 请使用固定版本标签：
目标 DSH 0.1.5-rc.1 要求 Node.js ^22.19.0 || >=24.0.0，另需可从 PATH 调用的 DSH 和已初始化的 profile（默认 web）。Tavern 独立测试兼容 Node 20，不代表目标 Host 可运行在 Node 20。
dsh plugin --profile web add github:Player-MINEPIG/dsh-tavern#v2.3.1
其他版本请切换到对应 tag，并阅读该 tag 内的安装说明。从源码开发、从旧版包内数据安全迁移，或使用项目提供的备份卸载流程时，按源码安装步骤检出同一版本标签：
git clone --branch v2.3.1 https://github.com/Player-MINEPIG/dsh-tavern.git
cd dsh-tavern
npm install --cache .npm-cache
npm run plugin:install
安装完成后重启 DSH Web。Tavern 默认把角色卡、预设、世界书、设置与绑定保存在 <DSH_HOME>/pmp-dsh-tavern/，普通 dsh plugin remove 不会删除该目录，但也不会创建卸载前快照；需要快照时请检出仓库并使用项目卸载脚本。从仍把数据放在插件包内的旧版本首次升级时，先停止目标 dsh web 并使用项目安装脚本，以便在 pnpm 替换旧包前保住数据；新 Host 首次启动会复制到外部目录并保留旧副本。其他 profile、独立 DSH_HOME、手动安装、备份与卸载方法见 安装与卸载。
左键点击 DT 悬浮球打开菜单，进入“角色卡”，导入 SillyTavern JSON 或 PNG 角色卡。导入只创建资源，不会伪造会话或自动发送消息。
回到 DSH 原生界面，使用 DSH 自己的工作区能力创建一个准备专门用于 RP 的工作区。所有周目 session 都会归入同一工作区，避免多个角色会话散落并遮挡普通工作。
右键单击 DT 悬浮球，或在菜单中点击“切换到自定义前端模式”。首次进入魔丸时，插件会要求从 DSH 已有工作区中明确选择 RP 工作区；写入并回读确认前不会进入 RP 内容。
在 RP 侧边栏找到刚导入的角色卡，点击角色卡右侧的 +。插件会创建或复用该角色最近一个完全空白的 N周目，并确保 root session 绑定的是你实际点击的角色卡。自动名称随 UI 语言显示，用户主动重命名的标题保持原文。
空周目的 opening dock 会显示角色卡 greeting。存在备选开场白时可用左右按钮选择；这只是前端展示与首轮提示词参考，不会伪造成一次已经发生的 assistant 回复。
在 DSH 原生输入栏发送第一条用户消息。用户消息会立即出现在 RP 视图中；随后可继续使用 swipe、分支新周目、同周目回退、显示文字编辑及导入/导出等功能。
完整操作与边界见 中文使用指南。
| 模块 | 主要能力 | 详细文档 |
|---|---|---|
| 资源 | ST 预设、V1/V2/V3 JSON/PNG 角色卡、独立/内嵌世界书、用户资料、资源绑定与导出 | 中文使用指南 |
| RP 前端 | 角色卡/周目侧栏、greeting、正文渲染、显示正则、swipe、分支、回退和显示层编辑 | 中文使用指南 |
| 周目数据 | DSH 权威 session、树状 timeline、工作区 catalog、外部记录首轮只读注入、静态 HTML 与 ST JSONL 导出 | API · 架构 |
| 安全 | RP 权限叠加、同源/loopback API、工作区路径防护、CAS、DOMPurify、无正文 operation log | RP 安全模式 · 安全策略 |
| 调试 | Tavern Trace 保存每次请求的段落/来源 metadata 与官方历史引用；详情按需验证并读取可恢复的段落正文，来源正文不另存 | Trace API 与设计 |
| 工作区诊断 | DT → 诊断集中显示当前 RP 工作区问题，支持重新检查、复制报告；侧栏摘要可关闭，异常周目保留独立警告入口 | 中文使用指南 |
| 第三方开发 | v1 资源管理、v2 RP 元操作、v3 提示词装配追踪与溯源；模式服务、DSH slots/store 与独立客户端接入 | HTTP API · 第三方 RP 前端接入 |
更多交互按钮、原生 Agent 能力、会话资产绑定、ST 兼容资源、显示正则和原生会话对比，见 功能图集。
untrusted 只读上下文注入。+。默认文档为中文。英文入口见 README_en.md（无截图）。
项目采用 MIT License 开源。欢迎通过 GitHub 提交 Issue、Pull Request、兼容性报告与设计讨论。
如果你希望基于这套框架开发自己的工具，不必先 fork 整个仓库：
pmpDshTavernChrome 模式生命周期和 DSH 公开 slots/store；system-prompt/assemble，观察完整请求则使用官方 llm/stream；请让第三方 UI 使用独立 slot id，只清理自己注册的表面，并在离开 play 模式或卸载时完整 dispose。模式服务负责生命周期，不负责替多个插件仲裁同一个 slot。
希望 pmp-dsh-tavern 不只服务于一个 RP 前端，也能成为社区共同开发、验证和复用的基础。
Copyright © 2026 Zhu Bohan.