dsh-portable-tavern：DeepSeek Harness 的 RPG 角色卡生成与酒馆聊天插件

dsh-portable-tavern 是 DeepSeek Harness（DSH）的「便携酒馆」插件（DSH plugin），由 XCNXNXNX 维护，采用 BSD-3-Clause 协议，最近更新于 2026-08。它解决的是在 DSH Web GUI 中快速生成 RPG 式 SillyTavern V2/V3 角色卡并直接进行角色扮演聊天的问题，将角色卡生成、AI 对话、世界书与本地持久化整合为一体。核心能力包括可视化 RPG 属性面板（七大模块）生成角色卡、AI 聊天（支持下拉切换模型）、自定义模型接入（可填写 OpenAI 兼容接口）、全局系统提示词注入、角色库管理、自定义头像、世界书生成/补全/导入、角色卡 JSON/PNG 导入导出，以及面板宽度/主题色/背景图/本地音乐等个性化设置。该 DSH plugin 独立运行，仅依赖官方 @deepseek-ai SDK。

dsh-portable-tavern 这个 DSH plugin 支持哪些核心特性？

• 可视化 RPG 属性面板（七大模块）生成 SillyTavern V2/V3 角色卡。
• AI 聊天：与生成的角色对话，支持下拉切换模型。
• 自定义模型接入：默认使用 DSH 当前配置的模型与密钥，也可填写自己的 OpenAI 兼容接口地址 / API Key / 模型（API Key 仅存本浏览器，测试连接一键验证）。
• 对话前注入全局系统提示词（类似 SillyTavern 的 System Prompt / Jailbreak）。
• 角色卡 / 对话记录 / 世界书 / 设定本地持久化（localStorage 自动保存与恢复）。
• 角色库：本地保存多个角色（含各自对话记录），一键载入 / 删除。
• 自定义聊天角色头像（上传图片自动压缩，随角色卡 JSON 导出/导入）。
• 世界书生成 / 补全（按人物卡）/ 导入。
• 导出 / 导入角色卡（JSON 与 PNG 的 chara 内嵌数据）。
• 面板宽度 / 主题色 / 背景图 / 本地音乐（文件夹顺序播放）。
• 右侧悬浮标签可拖动，可贴左 / 贴右 / 浮动为圆角方形，可在设置里关闭（关闭后从 DSH 设置页进入）。

dsh-portable-tavern 怎么安装？

安装命令如下，支持 npm、GitHub 和 Release tarball 三种方式：

# 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-portable-tavern 的架构与开发方式是什么？

标准双面 DSH 插件：Node 半（src/index.ts）通过 webServer 注册 /api/dsh-portable-tavern 路由，调用官方 llm 服务；浏览器半（src/client/index.ts）经 dsh.client 清单被发现，通过 slots 服务挂载悬浮面板与设置页入口，纯 fetch 调用上述路由。开发时使用 pnpm install、pnpm build（esbuild 打包 + tsc 声明）、pnpm typecheck，lib/ 提交进仓库，profile 安装无需再构建。

dsh-portable-tavern 如何挂载到 DSH Web GUI？

本包 cordis.patch.yml 通过 dsh.bundle.patch 把插件行注入 web profile roster；package.json 的 dsh.client 声明让浏览器半在 Web GUI 中加载。

查看更多 DSH 插件，访问 dsh-plugin.org