dsh-portable-tavern 使用指南

为 DSH Web GUI 提供 SillyTavern V2/V3 角色卡生成器、世界书生成与角色扮演聊天，支持自定义 OpenAI 兼容模型，数据全部本地保存。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

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

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

可视化 RPG 属性面板（七大模块）生成 SillyTavern V2/V3 角色卡
AI 聊天（与生成的角色对话，支持下拉切换模型）
自定义模型接入：默认使用 DSH 当前配置的模型与密钥，也可填写自己的 OpenAI 兼容接口地址 / API Key / 模型（API Key 仅存本浏览器，测试连接一键验证）
对话前注入的全局系统提示词（类似 SillyTavern 的 System Prompt / Jailbreak）
角色卡 / 对话记录 / 世界书 / 设定本地持久化（localStorage 自动保存与恢复）

— 源: plugin_wiki.readme_zh (fallback readme_raw)

安装后界面在哪里？

安装到 web profile 后重启 DSH Web GUI，右侧会出现一个可拖动的「便携酒馆」悬浮标签，也可在 DSH 设置页找到「便携酒馆」入口；同时支持在设置里隐藏悬浮按钮。

是否需要自己配置模型？

默认直接使用 DSH 当前配置的模型与密钥，无需额外设置；如果想用自己的 OpenAI 兼容接口，在「设置 → 模型接入」里填入接口地址、API Key、模型名称，点「保存并测试连接」即可，API Key 仅保存在本浏览器。

角色卡、世界书和聊天记录存放在哪里？

全部保存在当前浏览器的 localStorage（音频用 IndexedDB），不会上传到服务器；卸载插件或清理浏览器数据会导致本地内容丢失，建议定期用「导出 JSON」备份。

能否在局域网或远程访问的 DSH 上使用？

不能。本插件的 /api/dsh-portable-tavern 路由只接受来自 127.0.0.1 / ::1 的请求，并校验浏览器同源标记；把 DSH 部署在 LAN 或公网时这些接口会返回 403。

角色卡可以导入到 SillyTavern 本体使用吗？

可以。插件导出的是标准 SillyTavern V2/V3 角色卡格式（JSON 或带 chara 块的 PNG），SillyTavern、酒馆助手机器人等兼容工具都能直接载入。

卸载或重装插件会不会丢失已保存的角色？

不会立刻丢失，但建议先导出备份。卸载插件不会清空浏览器 localStorage，但不同浏览器/隐私模式之间数据互不相通；重装后角色库、世界书、模板仍会保留。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则