wan-tavern：DSH 的酒館模式角色扮演插件

前言¶

DeepSeek Harness (DSH) 的核心設計理念之一是“一切皆插件”。wan-tavern 是爲 DSH 打造的一款角色扮演插件，它將 DSH 的能力封裝爲“酒館模式”。該插件讓 AI 在虛擬酒館中化身“老闆娘”，負責接待客人、記住用戶喜好、管理角色狀態，並提供完整的酒館互動體驗。

核心功能¶

wan-tavern 提供以下主要能力：

• 完整酒館體驗：在 DSH 左側欄底部提供「🍻 酒館」入口，進入專屬會話卡片。界面集成老闆娘立繪與狀態面板。
• 立繪情緒系統：支持正方形立繪與居中破窗效果，情緒邊框顏色隨狀態變化。
• 記賬式狀態管理：通過 manage_tavern_state 工具進行服務端原子寫入。custom 變量表支持 counter / meter / text 三種類型。
• 跨模式全局記憶：無論在酒館模式還是標準模式，AI 回覆中的 【記憶】 標記都會被自動捕獲並寫入記憶 API。
• 可視化酒館設置：提供配置面板，支持設定世界設定、氛圍、開場白、規則以及自定義狀態變量表。
• 配置防腐層：使用 M6 schema 校驗，防止非法值（如 NaN、越界值、非法鍵）寫入配置。
• 損壞自愈：配置文件損壞時，會自動回退到 last-good 備份。
• 診斷面板：實時展示 API 基址、配置來源、狀態權威源等關鍵信息。
• 零侵入 DSH：所有邏輯均封裝在插件內部，不修改 DSH 核心代碼。

安裝與啓用¶

前置要求¶

• Node.js ≥ 20
• deepseek-harness（宿主框架）

安裝步驟¶

1. 克隆或下載 wan-tavern 倉庫。
2. 進入項目目錄。
3. 執行安裝腳本：

node install.mjs preset

該腳本會自動將 presets/tavern 拷貝到 DSH 根目錄下的 .dsh/.agent-presets/tavern，並將插件登記到 dsh.profile.bundles 中。

使用方法¶

1. 啓動 DSH，在左側欄底部找到「🍻 酒館」入口。
2. 點擊進入酒館專屬會話，首次進入時會自動創建工作區。
3. 在「酒館設置」裏配置世界設定 / 自定義狀態變量 / 初始狀態。
4. 開始跟老闆娘聊天，AI 會自動通過 manage_tavern_state 工具推進狀態。

注意事項¶

• 插件依賴 Node.js ≥ 20 和 deepseek-harness。
• 配置文件（config.）和狀態文件（state）默認不覆蓋用戶已有數據，旨在保留用戶歷史狀態。
• 許可證：MIT。

總結¶

wan-tavern 爲 DSH 提供了一套可分發的酒館模式解決方案，通過工具調用和全局掃描機制實現了狀態管理與跨會話記憶，適合希望進行深度角色扮演的用戶。