pmp-dsh-tavern

独立提示词装配插件（新版仅标准版；进阶冻结于 DSH 0.2.0-rc.2）：dsh-prompt-assembler。Tavern 默认携带并加载标准 Assembler，与独立安装共存的方式见接入说明。

dsh-memory-manager v1.0.0 是可选的查看与管理扩展。Tavern 不依赖它；未安装或卸载后，世界书和 MVU 使用来源默认行为，原会话与资源保留。

当前源码：请求装配 · MVU · 提示词模板 · 完整接口索引。

English

以 DeepSeek Harness（DSH）原生会话与执行机制为权威的酒馆兼容插件，提供前后端 API，支持自由组合酒馆能力与 DSH 原生功能。

本文描述 Tavern 3.0.5。独立 assembler、受限 MVU 与提示词模板的组合安装见接入说明；旧版完整文档保留在对应 Git tag。

3.0.5 与 Assembler 1.1.2 扩展 0.2.1 系列兼容范围，验证 rc.3 并保留 rc.2 支持；已有 V4 历史与引用无需迁移。

当前 Tavern 源码适配 DSH 0.2.1-rc.2 / 0.2.1-rc.3，提供独立 assembler 接入、受限 MVU、只读提示词模板与 RP 渲染。变更记录 · MIT License。

从 Tavern 2.5.x 升级到 3.0.5 会自动加载 assembler 并合并旧策略，见接入说明。本版 DSH 兼容范围为 >=0.2.1-rc.2 <0.2.2-0；更新前保留备份并停止目标 Host。从旧 DSH 升级时，已完成 V4 迁移的会话与 Tavern 引用无需再次转换；更早格式按 升级指南 单向迁移。不支持旧版 Host。

Tavern Trace 可查看每次请求的配置、世界书触发情况和提示词段落的内容与来源；第三方工具也可通过只读 v3 API 读取这些信息。见 API 与设计。

公式默认启用，支持 $…$、$$…$$、\(...\)、\[...\]，使用现代浏览器的 MathML，无需额外按钮或远程字体。字面分隔符请转义或放入代码；完整 HTML 模板和交互卡片内不自动解析公式。RP 还支持头像、可配置气泡与可选受限交互卡片；卡片脚本默认关闭。已支持的 MVU 状态与受限 Helper 兼容见 MVU；不宣称完整酒馆助手兼容。见显示能力与边界。

本项目只维护嵌入 DSH Web 与桌面端的前端，不额外开发独立 Web UI。导航、输入框与会话生命周期继续由 DSH 拥有，Tavern 通过公开扩展点提供 RP 展示；第三方仍可组合 HTTP API 开发客户端。这项决策调整产品范围，不引入数据迁移。

兼容范围：>=0.2.1-rc.2 <0.2.2-0。已验证 DSH rc.2 与 rc.3；范围内后续 RC 和正式版按策略允许加载，不表示已经逐版验收。0.2.2 及其预发布需重新评估。

设计理念

pmp-dsh-tavern 不是用另一套界面取代 DSH，也不会复制一份会话历史。它以公开扩展点和原子 API 为基础，在 DSH 之上增加一层可测试、可审计、可卸载的 Tavern 兼容框架：

• 灵珠 / DSH 原生模式：保留 DSH 原生会话、侧边栏和插件生态；
• 魔丸 / RP 模式：按角色卡与周目重组 RP 侧栏，提供开场白、显示正则、swipe、分支、回退、导入与导出；
• DSH 仍是权威：durable history、工具、权限和最终模型请求继续由 DSH 拥有；
• 最小程度改动，最大程度兼容：优先复用 DSH 公开机制，不替换原生前端，不依赖私有 DOM；
• 卸载后仍可阅读原始会话：插件保存资源、选择、周目指针、显示元数据与有界的 Trace metadata/官方历史引用，不伪造、覆盖或复制 DSH 历史正文。

双模式本身就是兼容方案：不进入魔丸时，用户看到的仍是普通 DSH；只有进入 RP 模式后，插件才挂载自己的 RP 表面。

⚠️ 安全警示

安装本插件等同于允许其代码在 DSH Host 和浏览器页面中运行。请只从可信仓库与提交安装，并在更新前检查变更、备份插件数据。以下防护用于降低风险，不构成操作系统级隔离或账号鉴权：

• Agent 与工具风险：预设、角色卡、世界书、外部记录和用户消息都可能包含 prompt injection。高权限 Agent 仍可能在模型诱导下调用获准的终端、文件、网络、浏览器或其他插件能力；不要在对话中提供密钥，保留 DSH 审批与沙箱，并按最小权限启用工具。
• RP 安全模式边界：RP 模式会在 DSH 权限之上增加只读与高风险工具限制，子 agent 也继承该叠加，但它不是虚拟机、容器或系统沙箱，不能约束本机其他进程，也不能把恶意提示词变成可信内容。
• 后端与 API 风险：v1/v2/v3 API 面向本机 loopback，Host、Origin 和 Content-Type 检查不是登录认证，本机恶意进程仍可能访问。不要把 DSH Web 或本插件 API 直接暴露到局域网或公网；反向代理必须自行增加 TLS、认证和可信 Host 配置。
• 前端渲染风险：模型输出经过净化并禁止自动远程资源。可选卡片脚本使用有配额的解释器与受限 DOM 桥；昂贵的 CSS 和布局仍可能导致拒绝服务。显示正则使用 JavaScript RegExp，灾难性回溯可能冻结页面；只导入和启用你信任的模板与正则。
• 数据与生命周期风险：swipe、分支和周目会创建真实 DSH session，并可能增加磁盘占用。revision/CAS、路径检查和原子写入不能替代备份，也不能把多个 API 组合变成跨文件事务。

遇到可疑行为时，停止 Agent、切回 DSH 原生模式并检查原始会话与工具记录。完整威胁模型、已实现边界和漏洞报告方式见 安全策略；RP 模式具体拦截范围见 RP 安全模式。

Quick Start：从角色卡到第一轮 RP 对话

宣传视频：Tavern 3.0.0（操作细节以本文当前说明为准）

0. 安装

请使用 DSH 0.2.1-rc.2 / 0.2.1-rc.3、Node ^22.19.0 || >=24.0.0 与已初始化的 profile，安装前停止目标 Host。只需安装 Tavern 3.0.5，标准 Assembler v1.1.2 自动安装并加载；标准版通过公开接口运行，进阶扩展冻结于 Assembler 1.1.0 / DSH 0.2.0-rc.2，不承诺后续适配，见接入说明：

…