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 提供了一套可分发的酒馆模式解决方案，通过工具调用和全局扫描机制实现了状态管理与跨会话记忆，适合希望进行深度角色扮演的用户。