前言¶
DeepSeek Harness（DSH）的 Web GUI 會話面板默認圍繞軌跡、工具調用與模型對話展開，適合智能體開發與調試。若你已在 MuseAI 桌面端維護世界書、角色卡、伴侶聊天或文字冒險會話，把這些資產搬進 DSH 往往需要另配 API、另起一套模型連接，數據和界面也難以與 DSH 已有配置對齊。
@yejiming/dsh-museai-tavern 在會話標籤欄「軌跡」右側註冊 MuseAI 標籤，把 MuseAI 桌面的五個頁面（背景 / 聊天 / 冒險 / 羈絆 / 設置）嵌入 DSH Web GUI，模型調用複用 DSH 已配置的 provider 與 model，無需額外 baseUrl 或 API Key。維護者爲 yejiming，SkillHub 分類爲「趣味換裝」，GitHub 約 18 stars。
這是什麼¶
一句話定位：MuseAI 會話視圖的 DSH 插件——在 conversation.view 插槽（order 15，位於「軌跡」右側）渲染完整 MuseAI 工作流，後端經插件路由橋接 ctx.llm，數據落盤於 $DSH_HOME/storages/museai.json。
與獨立運行 MuseAI 或 SillyTavern 的差異在於：模型目錄、默認選擇與流式生成均走 DSH 宿主已裝配的適配器；設置頁只提供「跟隨 DSH 默認模型」或從 DSH 模型列表中挑選，不出現憑據字段。
核心功能¶
MuseAI 會話標籤與五頁導航¶
點擊 MuseAI 標籤後，整個會話面板切換爲 MuseAI 視圖，內含背景、聊天、冒險、羈絆、設置五頁導航。
背景頁¶
世界書與角色卡的手動管理（不含 AI 智能提取）。支持自定義字段、按世界書分組的角色卡目錄、JSON 導入導出；MuseAI / SillyTavern 雙格式導出與 SillyTavern 轉換預覽；文風預設、記憶 AI 濃縮；刪除世界書時可選擇僅刪世界書或連帶刪除關聯角色卡。
聊天頁¶
伴侶對談：綁定世界書與角色卡，流式對話（Markdown、Thinking 摺疊、停止生成），會話歷史與標題編輯，文風預設，封存記憶，上下文用量圓環。
冒險頁¶
文字冒險 / GM 跑團：世界書加多角色卡選擇（勾選世界書可自動帶出角色卡），動態角色加載，三種輸入模式，流式故事輸出，支持 [[TOOL]] 特殊氣泡與 <choices> 候選選項，多角色卡封存記憶與會話保存。
羈絆頁¶
角色關係概覽、羈絆時間線，以及關聯的聊天 / 冒險會話展示。
設置頁¶
全部系統提示詞（默認逐字對應 MuseAI，可編輯或重置）與 Agent 採樣參數（temperature、maxOutputTokens、maxContextTokens、thinkingDepth 等）。模型區域爲 DSH 模型選擇器：跟隨 DSH 默認模型，或從已配置目錄中挑選，無 baseUrl、API Key 或連接測試入口。
持久化¶
世界書、角色卡、會話、設置、風格預設經插件服務端存儲域寫入 $DSH_HOME/storages/museai.json（storage-domain json backend）；瀏覽器 localStorage 僅作離線鏡像，重啓不丟。
安裝與啓用¶
插件支持 npm 與 GitHub 兩種安裝方式，倉庫已提交構建產物 lib/，無需本地構建。
方式一：npm 安裝（推薦）¶
dsh plugin --profile web add @yejiming/dsh-museai-tavern
方式二：GitHub 源碼安裝¶
dsh plugin --profile web add github:omdsh-dev/dsh-museai-tavern
安裝後驗證配置是否載入：
dsh --profile web --dump-config
輸出中應出現 museai 與 museai-routes 行。
啓動 Web GUI：
dsh --profile web
模型前提¶
DSH 中需已配置至少一個模型（provider / model）。未配置時，設置頁顯示空態引導，聊天與冒險請求會返回錯誤提示。
典型用法¶
經過上面的安裝步驟，按下面順序即可復現 README 中的工作流：
- 打開任意會話，在標籤欄「軌跡」右側點擊 MuseAI。
- 進入「設置」頁，確認模型：默認跟隨 DSH 默認模型，或從目錄中選擇具體 provider / model。
- 在「背景」頁創建世界書與角色卡，可按需導入 JSON 或從 SillyTavern 格式轉換預覽。
- 「聊天」頁綁定世界書與角色卡，進行伴侶對談；「冒險」頁選擇世界書與多角色卡跑團；「羈絆」頁查看關係與時間線。
可選配置項（均有 loader 默認值，無庫級默認值，無憑據字段）可通過 profile 或 cordis.patch.yml 覆蓋：
- id: museai
config:
chatTimeoutMs: 180000
| 鍵 | 說明 |
|---|---|
chatTimeoutMs |
流式生成端到端超時，默認 120000 毫秒 |
completeTimeoutMs |
非流式生成超時，默認 120000 毫秒 |
modelsTimeoutMs |
模型目錄查詢超時，默認 10000 毫秒 |
maxCompleteChars |
非流式輸出捕獲上限，默認 20000 字符 |
架構簡述¶
一個 npm 包對應三個裝載面：
| 面 | 入口 | 作用 |
|---|---|---|
| 宿主行 | lib/index.js（行 museai） |
打開 museai 存儲域，提供 museaiStore |
| 路由行 | lib/routes.js（行 museai-routes） |
webserver 存在時註冊 /plugins/museai/* |
| 瀏覽器半體 | lib/client.js |
註冊 MuseAI 標籤與五頁視圖 |
瀏覽器通過 fetch 訪問 /plugins/museai/models、/plugins/museai/chat、/plugins/museai/complete 及 store / sessions 相關路由，最終由宿主 ctx.llm 調用 DeepSeek 或其他已配置適配器。
適用場景與注意¶
適合誰
- 已在 MuseAI 維護世界書、角色卡，希望在 DSH Web GUI 內繼續聊天與跑團的用戶。
- 希望角色扮演與會話數據與 DSH 模型配置統一、避免重複填 API 的 DSH 用戶。
- 需要 SillyTavern 格式導入導出或轉換預覽的創作者。
注意事項
- 插件以當前
dsh進程權限運行，安裝前建議查閱源碼與 MIT 許可證，確認存儲路徑與網絡行爲符合你的環境要求。 - 背景頁不提供 AI 智能提取世界書 / 角色卡，需手動管理或通過 JSON 導入。
- SkillHub 社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；插件版本以 npm 與 GitHub 倉庫爲準（當前 package 版本 0.0.1）。
結尾¶
dsh-museai-tavern 把 MuseAI 的五頁工作流搬進 DSH 會話面板，模型與 DSH 共用一套配置，數據持久化到 $DSH_HOME/storages/museai.json。若你正在 DSH 裏做智能體開發，又希望順手用已有 MuseAI 角色資產，可先按 npm 命令安裝，在設置頁選好模型後從背景頁建卡開始。
- SkillHub 目錄頁：https://www.skillhub.cn/plugins/yejiming/dsh-museai-tavern
- GitHub：https://github.com/yejiming/dsh-museai-tavern
