Preface¶

DeepSeek Harness (DSH) extends session, tool, and frontend capabilities via plugins. However, a large number of character cards, presets, and world books in the community still use the SillyTavern (ST) format. To directly reuse these resources within DSH while preserving the RP sidebar experience such as swipe, branch, and turn, one typically needs to manually convert formats or maintain two separate frontends.

pmp-dsh-tavern (repository name dsh-tavern, maintained by Player-MINEPIG) adds a layer of uninstallable Tavern compatibility framework atop DSH’s public extension points: it does not replace DSH’s native frontend, nor does it duplicate session history. DSH retains durable history, tool permissions, and final model requests. Below we introduce its positioning, capabilities, and steps from installation to the first dialogue.

What This Is¶

pmp-dsh-tavern is an open-source plugin providing Tavern resource compatibility, RP workflows, and third-party frontend protocols for DeepSeek Harness. The current documentation corresponds to version 2.0.0, licensed under MIT; the development verification baseline is DSH rc.8.

The plugin switches between two modes via the DT floating ball:

• Spirit Orb / DSH Native Mode: Preserves DSH’s native session, sidebar, and plugin ecosystem.
• Demon Pill / RP Mode: Reorganizes the RP sidebar by character card and turn, providing opening, greeting, display regex, swipe, branch, rollback, import, and export.

After uninstallation, you can still read the original DSH session: the plugin only saves resources, selections, turn pointers, and display metadata, without faking or overwriting DSH history.

Core Features¶

v2.0 capabilities are divided by module (all from the project README and documentation index):

Important boundaries to note in advance:

• “Preset” refers to SillyTavern-style sampling parameters and prompt orchestration, not DSH agent presets.
• Greetings do not enter the timeline nor are faked as DSH history; external records are only injected as untrusted read-only context in the first real request.
• Display regex only affects the Demon Pill frontend rendering, without modifying model requests, DSH original messages, or the authoritative text upon which exports are based.
• Demon Pill hides reasoning, tool context, and sub-agent notifications; to view complete runtime details, switch back to DSH’s native “Dialogue” view.
• This plugin is intended for local loopback DSH Web and should not be directly exposed to LAN or public internet.

Installation and Enablement¶

Environment requirements: Node.js 20 or higher, DSH callable from PATH, and an initialized DSH profile (default web).

Clone from GitHub and run the plugin installation script:

git clone https://github.com/Player-MINEPIG/dsh-tavern.git
cd dsh-tavern
npm install --cache .npm-cache --legacy-peer-deps
npm run plugin:install

After installation, restart DSH Web. Before updating an existing installation, stop the target dsh web first; the installation script preserves plugin data during the refresh. See docs/INSTALLATION.md in the repository for other profiles, standalone DSH_HOME, manual installation, backup, and uninstallation methods.

Security Note: Installing this plugin is equivalent to allowing its code to run in the DSH Host and browser page. Only install from trusted repositories and commits, and check changes and back up plugin data before updating. Presets, character cards, world books, and user messages may contain prompt injection; high-privilege agents might still invoke permitted tools under model persuasion. See SECURITY.md in the repository for the full threat model and docs/RP_SECURE_MODE.md for RP mode interception scope.

Typical Usage: From Character Card to First RP Dialogue¶

The project README provides a reproducible Quick Start; video demonstration is available at pmp-dsh-tavern v2.0 “Spirit Orb Demon Pill”.

1. Import Character Card

Left-click the DT floating ball to open the menu, go to “Character Card”, and import a SillyTavern JSON or PNG character card. Import only creates resources and does not fake sessions or automatically send messages.

2. Create DSH Workspace

Return to the DSH native interface and use DSH’s own workspace capability to create a workspace dedicated to RP. All turn sessions will belong to the same workspace.

3. Enter RP Frontend and Select Workspace

Right-click the DT floating ball or click “Switch to Custom Frontend Mode” in the menu. On first entry into Demon Pill, the plugin requires you to explicitly select an RP workspace from DSH’s existing workspaces; it will not enter RP content until written and read-back confirmation.

4. Create Turn

Find the imported character card in the RP sidebar and click the + on the right side of the character card. The plugin will create or reuse the character’s most recent completely blank Nth turn and ensure the root session is bound to the character card you actually clicked. The DSH rc.8 outer “New Session” does not expose a click takeover seam; use the + on the right side of the character card to create turns, not by overriding native buttons.

5. Select Opening

The opening dock of a blank turn displays the character card greeting. When alternative openings exist, use the left and right buttons to select; this is only frontend display and first-turn prompt reference, not faked as an already-occurred assistant response.

6. Start Dialogue

Send the first user message in the DSH native input bar. The user message will immediately appear in the RP view; you can then continue using swipe, branching new turns, same-turn rollback, display text editing, and import/export functions.

See docs/USAGE_zh-CN.md in the repository for complete operations and boundaries.

Applicable Scenarios and Notes¶

Who It’s For

• Those who have accumulated character cards, presets, or world books in the SillyTavern ecosystem and wish to reuse them in DSH without maintaining two formats.
• Those who need the RP sidebar (turn, swipe, branch, display regex) but want DSH to remain the authoritative layer for sessions and tools.
• Those planning to develop third-party RP frontends or resource management tools based on the v2 HTTP API or pmpDshTavernChrome.

Pre-Use Notes

• The plugin runs with current DSH process privileges; before installation, check the source code and MIT license, and only install from trusted commits.
• RP security mode adds read-only and high-risk tool restrictions atop DSH privileges, but it is not a virtual machine or system sandbox and cannot constrain other local processes.
• v1/v2 APIs are for local loopback; Host, Origin, and Content-Type checks are not login authentication—do not expose DSH Web or this plugin’s API directly to LAN or public internet.
• Display regex uses JavaScript RegExp; catastrophic backtracking may freeze the page; only import and enable templates and regex you trust.
• Swipe, branch, and turns create real DSH sessions, which may increase disk usage; revision/CAS and path checks cannot replace backups.

When encountering suspicious behavior, stop the Agent, switch back to DSH native mode, and check the original session and tool logs.

Documentation and Links¶

• SkillHub Directory: https://www.skillhub.cn/plugins/Player-MINEPIG/dsh-tavern
• GitHub Repository: https://github.com/Player-MINEPIG/dsh-tavern
• Chinese Usage Guide: docs/USAGE_zh-CN.md
• HTTP API: docs/API.md
• Third-party RP Frontend Integration: docs/FRONTEND_INTEGRATION_zh-CN.md

pmp-dsh-tavern does not replace DSH but provides a testable, auditable, uninstallable Tavern compatibility layer atop it. If your pain point is the coexistence of ST resources and DSH session authority, you can install it following the steps above and try Demon Pill mode in an independent workspace.