dsh-portable-tavern: RPG Character Card Generator and Tavern Chat Plugin for DeepSeek Harness

dsh-portable-tavern is a "portable tavern" plugin (DSH plugin) for DeepSeek Harness, maintained by XCNXNXNX under the BSD-3-Clause license, last updated in 2026-08. It solves the problem of quickly generating RPG-style SillyTavern V2/V3 character cards and directly engaging in roleplay chat within the DSH Web GUI, integrating character card generation, AI chat, world books, and local persistence into one tool. Core capabilities include a visual RPG attribute panel (seven modules) for generating character cards, AI chat (with model dropdown), custom model integration (OpenAI-compatible endpoints), global system prompt injection, character library management, custom avatars, world book generation/completion/import, character card JSON/PNG import/export, and panel width/theme/background/local music personalization. This DSH plugin is standalone and depends only on the official @deepseek-ai SDK.

What core features does dsh-portable-tavern support?

• Visual RPG attribute panel (seven modules) to generate SillyTavern V2/V3 character cards.
• AI chat: talk to generated characters, with model dropdown.
• Custom model integration: uses DSH's current model and key by default, or you can fill in your own OpenAI-compatible endpoint / API Key / model (API Key stored only in this browser, one-click test connection).
• Global system prompt injection before conversation (similar to SillyTavern's System Prompt / Jailbreak).
• Local persistence of character cards / chat logs / world books / settings (localStorage auto-save and restore).
• Character library: save multiple characters locally (with their chat logs), one-click load / delete.
• Custom chat character avatar (upload image auto-compressed, exported/imported with character card JSON).
• World book generation / completion (based on character card) / import.
• Export / import character cards (JSON and PNG chara embedded data).
• Panel width / theme color / background image / local music (folder sequential playback).
• Right-side floating tab draggable, can dock left/right or float as rounded square, can be disabled in settings (after disabling, enter from DSH settings page).

How to install dsh-portable-tavern?

Installation commands are as follows, supporting npm, GitHub, and Release tarball:

# npm
dsh plugin --profile web add dsh-portable-tavern

# GitHub (lib/ committed, no build authorization needed)
dsh plugin --profile web add github:XCNXNXNX/dsh-portable-tavern

# Release tarball
dsh plugin --profile web add https://github.com/XCNXNXNX/dsh-portable-tavern/releases/download/v0.2.0/dsh-portable-tavern-0.2.0.tgz

What is the architecture and development workflow of dsh-portable-tavern?

Standard dual-sided DSH plugin: Node half (src/index.ts) registers /api/dsh-portable-tavern route via webServer, calling official llm service; browser half (src/client/index.ts) is discovered via dsh.client manifest, mounts floating panel and settings page entry via slots service, using pure fetch to call the route. Development uses pnpm install, pnpm build (esbuild bundling + tsc declarations), pnpm typecheck, and lib/ is committed to the repo, so profile installation does not require rebuilding.

How is dsh-portable-tavern mounted to DSH Web GUI?

This package's cordis.patch.yml injects plugin lines into the web profile roster via dsh.bundle.patch; the dsh.client declaration in package.json loads the browser half in the Web GUI.

See more DSH plugins at dsh-plugin.org