前言¶
在 DeepSeek Harness（DSH）裏做角色扮演，常見做法是單獨打開 SillyTavern，或在 DSH 裏手寫 JSON 角色卡再對接聊天接口。前者與 DSH 工作流割裂，後者對 SillyTavern V2/V3 格式不熟時容易出錯。下面介紹維護者 XCNXNXNX 的 dsh-portable-tavern：把 RPG 式角色卡生成器和酒館聊天收進 DSH Web GUI 的一個獨立插件裏。
這是什麼¶
dsh-portable-tavern 是 DSH Web GUI 的「便攜酒館」插件：可視化生成 SillyTavern V2/V3 角色卡，並在同一面板裏與角色對話。支持世界書、角色卡 JSON/PNG 導入導出、面板主題與本地音樂。插件僅依賴官方 @deepseek-ai/* SDK，在 SkillHub 分類爲「趣味換裝」，GitHub 倉庫約 20 stars。
- 目錄頁：https://www.skillhub.cn/plugins/XCNXNXNX/dsh-portable-tavern
- GitHub：https://github.com/XCNXNXNX/dsh-portable-tavern
- 許可證：BSD-3-Clause（見倉庫
package.json）
核心功能¶
角色卡生成¶
通過可視化 RPG 屬性面板（七大模塊）生成 SillyTavern V2/V3 格式角色卡。可自定義聊天角色頭像（上傳圖片自動壓縮，隨角色卡 JSON 導出/導入）。
酒館聊天¶
與生成或導入的角色進行 AI 對話，支持下拉切換模型。對話前可注入全局系統提示詞，作用類似 SillyTavern 的 System Prompt / Jailbreak。
自定義模型接入¶
默認使用 DSH 當前配置的模型與密鑰；也可填寫自己的 OpenAI 兼容接口地址、API Key 和模型名。API Key 僅存本瀏覽器，提供測試連接一鍵驗證。
本地持久化與角色庫¶
角色卡、對話記錄、世界書、面板設定通過 localStorage 自動保存與恢復。角色庫可在本地保存多個角色（含各自對話記錄），支持一鍵載入或刪除。
世界書¶
支持世界書生成、按人物卡補全，以及導入。
導入導出¶
角色卡支持 JSON 與 PNG（chara 內嵌數據）兩種格式的導出與導入。
界面定製¶
可調整面板寬度、主題色、背景圖；支持本地音樂文件夾順序播放。右側懸浮標籤可拖動，可貼左、貼右或浮動爲圓角方形；可在設置裏關閉，關閉後從 DSH 設置頁進入。
架構簡述¶
標準雙面 DSH 插件：
- Node 半（
src/index.ts）通過webServer註冊/api/dsh-portable-tavern路由，調用官方llm服務。 - 瀏覽器半（
src/client/index.ts）經dsh.client清單被發現，通過slots服務掛載懸浮面板與設置頁入口，以fetch調用上述路由。
cordis.patch.yml 通過 dsh.bundle.patch 把插件行注入 web profile roster；package.json 的 dsh.client 聲明負責在 Web GUI 中加載瀏覽器半。倉庫已提交 lib/，profile 安裝無需再構建。
安裝與啓用¶
在 DSH Web profile 下執行以下任一命令：
# 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
安裝完成後，在 Web GUI 中通過右側懸浮標籤或 DSH 設置頁進入插件面板。
典型用法¶
從零創建角色並聊天¶
- 打開便攜酒館面板，在 RPG 屬性面板中填寫七大模塊，生成 SillyTavern V2/V3 角色卡。
- 可選：上傳頭像、編寫世界書，或在設置中調整全局系統提示詞。
- 在聊天區選擇模型（默認走 DSH 配置，或填寫自定義 OpenAI 兼容接口），開始與角色對話。
- 數據自動寫入
localStorage；多個角色可存入角色庫，隨時載入或刪除。
導入已有角色卡¶
- 通過 JSON 或 PNG（chara 內嵌）導入角色卡。
- 載入後對話記錄與世界書隨角色一併恢復（若此前已保存）。
- 修改後可再次導出 JSON 或 PNG，頭像隨 JSON 一併攜帶。
自定義模型¶
在模型設置中填寫 OpenAI 兼容接口地址、API Key 和模型名，點擊測試連接驗證。API Key 僅保存在當前瀏覽器，不會寫入 DSH 服務端配置。
適用場景與注意¶
適合誰
- 希望在 DSH 內完成 SillyTavern 角色卡編輯與聊天，不想切換外部工具的用戶。
- 需要本地管理多角色、世界書，並偶爾導入導出 JSON/PNG 角色卡的創作者。
- 想快速試用不同 OpenAI 兼容模型，又不想改動 DSH 全局 LLM 配置的場景。
注意事項
- 插件以當前 DSH 進程權限運行，安裝前建議閱讀倉庫源碼與 BSD-3-Clause 許可證。
- 角色卡、對話、世界書等主要存在瀏覽器
localStorage，清理站點數據會丟失本地內容；重要角色卡請定期導出 JSON/PNG 備份。 - Release tarball 安裝示例指向
v0.2.0；倉庫package.json當前版本爲0.3.0，按需選擇 npm、GitHub 或指定版本 tarball。 - SkillHub 爲社區目錄，與 DeepSeek / 幻方無官方從屬關係；插件由社區維護者 XCNXNXNX 發佈。
結尾¶
dsh-portable-tavern 把 SillyTavern 式角色卡工作流嵌進 DSH Web GUI：生成、世界書、導入導出與聊天在同一面板完成，不額外依賴非官方 SDK。若你已在 DSH 裏跑智能體，又需要輕量角色扮演環境，可從目錄頁或 GitHub 安裝試用。
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/XCNXNXNX/dsh-portable-tavern
- GitHub 倉庫：https://github.com/XCNXNXNX/dsh-portable-tavern
