dsh-portable-tavern DSH plugin

This plugin provides a visual RPG attribute panel to generate SillyTavern V2/V3 character cards and an AI chat interface to roleplay with the created characters. It supports custom model endpoints, local persistence of cards and conversations, and world book generation.

ui-productivity skills-workflows

How to install the dsh-portable-tavern DSH plugin

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

Copying does not run this command. Review the repository and version before installing the dsh-portable-tavern DSH plugin.

dsh-portable-tavern DSH plugin data source

dsh-portable-tavern DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-portable-tavern DSH plugin can do

Visual RPG attribute panel (7 modules) for generating SillyTavern V2/V3 character cards.
AI chat with the generated character, supporting model switching via dropdown.
Custom model integration: uses DSH current configuration by default, or allows filling in own OpenAI-compatible endpoint, API Key, and model (Key stored only in browser, with one-click test connection).
Global system prompt injection before conversation (similar to SillyTavern's System Prompt / Jailbreak).
Local persistence of character cards, conversation history, world books, and settings via localStorage (auto-save and restore).
Character library: save multiple characters locally (each with own conversation history), 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 with embedded chara data).
Panel width, theme color, background image, local music (folder sequential playback) customization.
Draggable floating tab on the right side, can be docked left/right or floating as rounded square, can be disabled in settings (access from DSH settings page).

Where the dsh-portable-tavern DSH plugin fits

Create a unique RPG character with detailed stats and traits for roleplay.
Chat with the generated character in an immersive roleplay session.
Use your own OpenAI-compatible API endpoint to power the chat model.
Export character cards to share with other SillyTavern users.
Build a personal library of characters and their conversation histories.

Who the dsh-portable-tavern DSH plugin is for

SillyTavern users who want to generate and manage character cards.
Roleplay enthusiasts who enjoy AI-driven character interactions.
DSH Web GUI users looking for an integrated roleplay experience.

dsh-portable-tavern DSH plugin limitations

This plugin only works within the DSH Web GUI environment and cannot be used standalone.
Local storage relies on browser localStorage; clearing browser data will delete all saved characters, conversations, and settings.
Character card format is limited to SillyTavern V2/V3; other formats are not supported.
Custom model integration requires the user to provide their own API Key and endpoint, which are stored only in the browser and may not be secure for production use.
The plugin is in early development (v0.2.0) and may have incomplete features or bugs.

dsh-portable-tavern DSH plugin: from the repository README

Quoted from the XCNXNXNX/dsh-portable-tavern README, the upstream source of the dsh-portable-tavern DSH plugin. Copyright remains with the original authors.

DSH Web GUI 的「便携酒馆」插件：RPG 式 SillyTavern V2/V3 角色卡生成器 + 酒馆角色扮演聊天一体。 ## 界面预览 | 聊天 | 角色卡设定 | |---|---| | ![聊天](assets/chat.png) | ![设定](assets/settings.png) | - 可视化 RPG 属性面板（七大模块）生成 SillyTavern V2/V3 角色卡 - AI 聊天（与生成的角色对话，支持下拉切换模型） - 自定义模型接入：默认使用 DSH 当前配置的模型与密钥，也可填写自己的 OpenAI 兼容接口地址 / API Key / 模型（API Key 仅存本浏览器，测试连接一键验证） - 对话前注入的全局系统提示词（类似 SillyTavern 的 System Prompt / Jailbreak） - 角色卡 / 对话记录 / 世界书 / 设定本地持久化（localStorage 自动保存与恢复） - 角色库：本地保存多个角色（含各自对话记录），一键载入 / 删除 - 自定义聊天角色头像（上传图片自动压缩，随角色卡 JSON 导出/导入） - 世界书生成 / 补全（按人物卡）/ 导入 - 导出 / 导入角色卡（JSON 与 PNG 的 chara 内嵌数据） - 面板宽度 / 主题色 / 背景图 / 本地音乐（文件夹顺序播放） - 右侧悬浮标签可拖动，可贴左 / 贴右 / 浮动为圆角方形，可在设置里关闭（关闭后从 DSH 设置页进入）独立插件，仅依赖官方 `@deepseek-ai/*` SDK。 ## 安装 ```bash # npm dsh plugin --profile web add dsh-portable-tavern # GitHub（lib/ 已提交，无需构建授权） 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 ``` ## 架构标准双面 DSH 插件：Node 半（`src/index.ts`）通过 `webServer` 注册 `/api/dsh-portable-tavern` 路由，调用官方 `llm` 服务；浏览器半（`src/client/index.ts`）经 `dsh.client` 清单被发现，通过 `slots` 服务挂载悬浮面板与设置页入口，纯 `fetch` 调

Read the full READMERepository license: BSD-3-Clause

dsh-portable-tavern DSH plugin questions

How do I install dsh-portable-tavern?

You can install it using the DSH plugin manager. Open your terminal and run: `dsh plugin --profile web add dsh-portable-tavern`. Alternatively, you can install from GitHub or a release tarball as shown in the README.

Can I use my own API key for the chat model?

Yes, the plugin allows you to override the default DSH model configuration. In the settings, you can enter your own OpenAI-compatible endpoint, API Key, and model name. The API Key is stored only in your browser's local storage and is not sent to the server. You can also test the connection with a one-click button.

How do I export a character card?

In the character card settings, you can export the card as JSON or PNG. The PNG format embeds the character data inside the image (chara format), which is compatible with SillyTavern. The exported file will include the avatar, stats, and other settings.

Does the plugin support multiple characters?

Yes, the plugin has a character library where you can save multiple characters locally. Each character keeps its own conversation history. You can load any saved character with one click and delete them when needed.

How do I customize the plugin's appearance?

You can adjust the panel width, theme color, background image, and even play local music (folder sequential playback) from the settings. The floating right-side tab can be dragged, docked left/right, or floated as a rounded square. You can also disable the tab entirely from the settings page.