DSH 酒馆模式

当前预发布：0.4.2-rc.4。修复实时消息显示、共同记忆重复存储和失败后整轮重跑，安装包可直接使用。详见 更新说明 和 发布页面。

在 DeepSeek Harness 中导入 SillyTavern 角色卡、预设和世界书，使用原生聊天界面进行互动写作。

支持普通模式与多 agent 模式、HTML 前端组件、独立角色记忆、表格更新、台词框和跨会话共享头像。

安装

安装前需要：

当前版本已在 macOS arm64（Node.js 26.8.2、DSH 0.1.5-rc.1）完成插件运行验证。早期版本另有 Linux x86_64 验证；Windows 尚未完成运行实测。

先查看现有版本：

node --version
dsh --version
pnpm --version

缺少 pnpm 时安装：

npm install -g pnpm@11.21.0

以下短行命令适用于 macOS/Linux 的 zsh 或 bash，整块复制即可，保留续行符 \：

dsh_url=https://github.com
dsh_url+=/3121455692atou-sudo
dsh_url+=/dsh-tavern-mode
dsh_url+=/releases/download/v0.4.2-rc.4
dsh_url+=/dsh-tavern-mode-0.4.2-rc.4.tgz
dsh plugin --profile web add \
  --allow-build=esbuild "$dsh_url"

安装或升级前先停止正在运行的 dsh web。已有插件直接执行同一条 add 命令，无需卸载。安装后重新启动 dsh web 并刷新已打开的页面，在输入框上方的模式菜单选择「酒馆模式」，再导入自己的角色卡。发布包已经包含前端构建产物。安装参数 --allow-build=esbuild 用于安装脚本编译器，供 HTML 模块加载和酒馆助手更新使用。

使用 npx 启动 dsh 时，在上面的短行代码已设置 dsh_url 后执行：

npx @deepseek-ai/dsh@0.1.5-rc.1 \
  plugin --profile web add \
  --allow-build=esbuild "$dsh_url"
npx @deepseek-ai/dsh@0.1.5-rc.1 web

模型使用 dsh「设置 → 模型」中已经配置的提供方。插件的模型选项留空时跟随输入框中的模型。

使用

• 普通模式直接读取历史原文。最大输入默认为 200,000 个估算 token，应用不设置数值上限；超出预算时从最早的历史开始截断。入口为输入框上方的「最大输入与模型」。
• 多 agent 模式执行角色召回、场景组合、剧情推进、写作和状态更新。写作读取上一条正文原文、本轮输入，以及已有摘要、记忆和状态。各阶段模型和并发数可以单独配置。
• 台词框支持角色、玩家、情绪差分、格式和图片设置。头像全局共享、按内容去重，切换或删除对话后继续保留，手动删除后才从头像列表移除。
• 资源导入支持 PNG/JSON 角色卡、世界书、酒馆预设、正则和 ZIP 资源包。推进预设和表格模板可选。
• 共同事件记忆按知情范围保存一份事件正文，各角色保留引用与个人变化；私人信息仍隔离。表格或记忆失败后可仅重试未完成更新。
• 消息操作支持编辑、删除、重新生成和分支，关联的表格与角色记忆随剧情版本更新。

固定提示词和稳定工具 schema 优先复用前缀。普通模式的输入预算使用本地估算，实际分词和缓存命中率由所选模型与提供方决定。

酒馆助手接口随包提供，并可在设置中检查上游更新。直接依赖 SillyTavern 后端或其他扩展私有接口的脚本可能仍需适配。

数据位置

默认数据目录为 ~/.dsh/tavern/，设置 DSH_HOME 时使用对应目录。

插件文件按安装位置定位，数据文件按数据目录定位。dataDir 的相对路径以 dsh 数据目录为基准；本地导入的相对路径以酒馆数据目录为基准。资源和头像使用标识引用，移动数据目录后继续有效。

已有本地酒馆模式配置会保留，首次启动只创建缺少的模式注册文件。

开发

npm ci
npm test
npm run check
npm run build
npm pack

源码位于 src/，构建脚本位于 scripts/build.mjs。上游组件的来源和许可见 THIRD_PARTY_NOTICES.md。

卸载

dsh plugin --profile web remove dsh-tavern-mode

重启 dsh 后，在模式设置中删除「酒馆模式」的本地注册即可。剧情数据保留在数据目录中。

DSH 官方插件安装文档 · 发布版本