Player-MINEPIG/dsh-tavern
50Last commit Aug 15, 2026
dsh-tavern DSH plugin
dsh-tavern is a DSH plugin that reads SillyTavern-style presets, character cards, and world books, normalizes them, and combines them into actual model requests per DSH session. It includes a floating DT launcher, per-session resource management, configuration templates, and Tavern Trace for debugging.
How to install the dsh-tavern DSH plugin
dsh plugin --profile web add "file:/absolute/path/to/dsh-tavernCopying does not run this command. Review the repository and version before installing the dsh-tavern DSH plugin.
dsh-tavern DSH plugin data source
dsh-tavern DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-tavern DSH plugin can do
- Import and manage SillyTavern Chat Completion presets, V1/V2/V3 JSON and PNG character cards, independent world books, character card embedded world books, and user-bound world books.
- Provide a draggable DT floating launcher with language switching (Simplified Chinese/English) and UI scaling (75%–150%).
- Per-session resource isolation: presets, character cards, users, and world books are bound individually; supports clean new sessions and configuration templates.
- Record Tavern Trace showing resource summaries, world book keyword hits, and request/header alignment without persisting full prompts.
- Cross-platform installation script (Windows, macOS, Linux) with data recovery on reinstall and backup on uninstall.
Where the dsh-tavern DSH plugin fits
- Use SillyTavern character cards in DSH for roleplay conversations.
- Bind different presets, character cards, and world books to different sessions for context isolation.
- Activate world book entries via keywords to inject background lore or plot points.
- Quickly switch between character/preset combinations using configuration templates without history contamination.
- Debug resource loading and world book matching via Tavern Trace.
Who the dsh-tavern DSH plugin is for
- Users migrating from SillyTavern to DSH who want to reuse their existing character cards, presets, and world books.
- Developers who need advanced prompt orchestration (character cards, world books) within the DSH ecosystem.
dsh-tavern DSH plugin limitations
- Does not support creating character cards; only imports existing ones.
- Does not implement true role messages, strict depth/absolute injection, full ST macros, or advanced world book semantics (recursive, sticky/cooldown/delay, vector, outlet).
- Requires Node.js 20+ and a pre-installed DSH environment.
- Does not replicate DSH session history; only assembles Tavern profiles at public extension points.
- Native JavaScript regex is disabled by default; enabling unsafeRegex carries ReDoS risk.
dsh-tavern DSH plugin: from the repository README
Quoted from the Player-MINEPIG/dsh-tavern README, the upstream source of the dsh-tavern DSH plugin. Copyright remains with the original authors.
为 DeepSeek Harness（DSH）提供 Tavern 风格内容兼容、会话绑定与运行时加载能力的插件。 > 当前 README 为 `1.0.0` 中文版；英文版计划后续补充。 ## 目录 - [项目简介](#项目简介) - [安装](#安装) - [脚本安装（推荐）](#脚本安装推荐) - [手动安装](#手动安装) - [让 Agent 安装](#让-agent-安装) - [更新、卸载与数据位置](#更新卸载与数据位置) - [使用](#使用) - [DT 悬浮球与界面设置](#dt-悬浮球与界面设置) - [预设](#预设) - [角色卡](#角色卡) - [世界书](#世界书) - [用户](#用户) - [新会话与配置模板](#新会话与配置模板) - [Tavern Trace](#tavern-trace) - [特点](#特点) - [安全风险](#安全风险) - [参考](#参考) ## 项目简介 `dsh-tavern` 的目标不是在 DSH 中复制一套 SillyTavern 前端，而是建立一个可测试、可审计、可扩展的兼容层：读取 SillyTavern 风格的预设、角色卡和世界书，将它们归一化，再通过统一 loader 按 DSH session 组合为实际模型请求。 当前版本已经提供一个完整的 DSH 插件，包含： - SillyTavern Chat Completion 预设； - V1/V2/V3 JSON 与 PNG 角色卡； - 独立世界书、角色卡内嵌世界书及用户绑定世界书； - 只有名字和描述的用户资料； - per-session 资源绑定、干净新会话与配置模板； - 简体中文/English、Tavern UI 缩放与可拖拽 `DT` 悬浮入口； - 与 Conversation、Trajectory 并列的 Tavern Trace。 插件不会复制 DSH 的会话历史。DSH 仍然拥有 durable history、工具、权限和最终 `request/header`；dsh-tavern 只在公开扩展点装配 Tavern profile、映射受支持的模型参数，并记录不含正文的最小化审计信息。 本项目当前版本为 `1.0.0`。现有框架与核心工作流已达到首个稳定发布范围；真实 role message、严格 depth/absolute injection、完整 ST macro，以及 recursive、sticky/cooldown/delay、vector、outlet 等高级世界书语义仍受当前 DSH seam 或实现范围限制。详细兼容表见 [Prompt pipeline](docs/PROMPT_PIPELINE.md)。 > 本
Read the full READMERepository license: MIT
dsh-tavern DSH plugin questions
How do I install dsh-tavern?
Clone the repository, run `npm install --cache .npm-cache --legacy-peer-deps`, then `npm run plugin:install`. This will build and install the plugin into the default DSH profile. Make sure you have Node.js 20+, `dsh` in PATH, and a DSH profile initialized. See the README for manual installation and alternative options.
How do I update dsh-tavern to the latest version?
Stop the DSH web server, pull the latest code, then run the same install script (`npm run plugin:install`). The installer will back up your data and restore it after updating the plugin files. If you used manual installation, you need to remove the old plugin first via `dsh plugin --profile web remove dsh-tavern`, then add the new one.
How do I import a SillyTavern character card?
Open the DT launcher (red/black/white floating button), go to the Character Card tab, click the import button, and select a JSON or PNG character card file. The plugin supports V1/V2/V3 formats. After import, you can bind it to the current session by clicking the blue bind button. Note that you cannot create character cards from scratch – only import existing ones.
How do I bind a world book to a session?
In the World Book tab of the DT launcher, import or create a world book. Then, in the same tab, you can select which world books to enable for the current session. The green dot indicates the world book has a valid source; it does not mean it will trigger on every turn. The plugin supports independent world books, user-bound world books, and character card embedded world books.
What is Tavern Trace and how do I use it?
Tavern Trace is a debug panel accessible alongside DSH's Conversation and Trajectory. It shows per-turn resource summaries, world book keyword hits, acceptance/rejection reasons, and request/header alignment. It does not save full prompts or message bodies. Use it to verify that the correct presets, character cards, and world books are being applied to your model requests.